fix pty allocation
[unix-history] / usr / src / libexec / telnetd / telnetd.8
CommitLineData
ea3f50ea
KM
1.\" Copyright (c) 1983 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
b78cbcc5 5.\" @(#)telnetd.8 6.1 (Berkeley) %G%
ea3f50ea 6.\"
b78cbcc5 7.TH TELNETD 8C ""
ea3f50ea
KM
8.UC 5
9.SH NAME
10telnetd \- DARPA TELNET protocol server
11.SH SYNOPSIS
12.B /etc/telnetd
13[
14.B \-d
15] [
16.I port
17]
18.SH DESCRIPTION
19.I Telnetd
20is a server which supports the DARPA standard TELNET
21virtual terminal protocol. The TELNET server operates
22at the port indicated in the ``telnet'' service description;
23see
24.IR services (5).
25This port number may be overridden (for debugging purposes)
26by specifying a port number on the command line. If the
27.B \-d
28option is specified, each socket created by
29.I telnetd
30will have debugging enabled (see SO_DEBUG in
31.IR socket (2)).
32.PP
33.I Telnetd
34operates by allocating a pseudo-terminal device (see
35.IR pty (4))
36for a client, then creating a login process which has
37the slave side of the pseudo-terminal as
38.BR stdin ,
39.BR stdout ,
40and
41.BR stderr .
42.I Telnetd
43manipulates the master side of the pseudo terminal,
44implementing the TELNET protocol and passing characters
45between the client and login process.
46.PP
47When a TELNET session is started up,
48.I telnetd
49sends a TELNET option to the client side indicating
50a willingness to do ``remote echo'' of characters.
51The pseudo terminal allocated to the client is configured
52to operate in ``cooked'' mode, and with XTABS and CRMOD
53enabled (see
54.IR tty (4)).
55Aside from this initial setup, the only mode changes
56.I telnetd
57will carry out are those required for echoing characters
58at the client side of the connection.
59.PP
60.I Telnetd
61supports binary mode, and most of the common TELNET options,
62but does not, for instance, support timing marks. Consult
63the source code for an exact list of which options are not
64implemented.
65.SH "SEE ALSO"
66telnet(1C)
67.SH BUGS
68A complete list of the options supported should be given here.