Annotation of 43BSDReno/libexec/telnetd/telnetd.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted
                      5: .\" provided that the above copyright notice and this paragraph are
                      6: .\" duplicated in all such forms and that any documentation,
                      7: .\" advertising materials, and other materials related to such
                      8: .\" distribution and use acknowledge that the software was developed
                      9: .\" by the University of California, Berkeley.  The name of the
                     10: .\" University may not be used to endorse or promote products derived
                     11: .\" from this software without specific prior written permission.
                     12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     15: .\"
                     16: .\"    @(#)telnetd.8   6.7 (Berkeley) 6/28/90
                     17: .\"
                     18: .TH TELNETD 8 "June 28, 1990"
                     19: .UC 5
                     20: .SH NAME
                     21: telnetd \- DARPA TELNET protocol server
                     22: .SH SYNOPSIS
                     23: .B /etc/telnetd
                     24: [\fB\-debug\fP [\fIport\fP]]
                     25: [\fB\-l]
                     26: [\fB\-D options\fP]
                     27: [\fB\-D report\fP]
                     28: [\fB\-D exercise\fP]
                     29: [\fB\-D netdata\fP]
                     30: [\fB\-D ptydata\fP]
                     31: .SH DESCRIPTION
                     32: .I Telnetd
                     33: is a server which supports the DARPA standard
                     34: .B TELNET
                     35: virtual terminal protocol.
                     36: .I Telnetd
                     37: is invoked by the internet server (see
                     38: .IR inetd (8)),
                     39: normally for requests to connect to the
                     40: .B TELNET
                     41: port as indicated by the
                     42: .I /etc/services
                     43: file (see
                     44: .IR services (5)).
                     45: If the \fB\-debug\fP may be used, to start up \fBtelnetd\fP
                     46: manually, instead of through
                     47: .IR inetd (8).
                     48: If started up this way, \fIport\fP may be specified to
                     49: run \fItelnetd\fP on an alternate TCP port number.
                     50: .PP
                     51: The \fB\-D\fP option may be used for debugging purposes.
                     52: This allows \fItelnet\fR to print out debugging information
                     53: to the connection, allowing the user to see what telnetd
                     54: is doing.
                     55: There are several modifiers:
                     56: \fBoptions\fR prints information about the negotiation
                     57: of \fBTELNET\fR options,
                     58: \fBreport\fR prints the \fBoptions\fR information, plus
                     59: some additional information about what processing is going on,
                     60: \fBnetdata\fP displays the data stream received by \fItelnetd\fP,
                     61: \fBptydata\fP displays data written to the pty, and
                     62: \fBexercise\fR has not been implemented yet.
                     63: .PP
                     64: .I Telnetd
                     65: operates by allocating a pseudo-terminal device (see
                     66: .IR pty (4))
                     67: for a client, then creating a login process which has
                     68: the slave side of the pseudo-terminal as 
                     69: .BR stdin ,
                     70: .BR stdout ,
                     71: and
                     72: .BR stderr .
                     73: .I Telnetd
                     74: manipulates the master side of the pseudo-terminal,
                     75: implementing the
                     76: .B TELNET
                     77: protocol and passing characters
                     78: between the remote client and the login process.
                     79: .PP
                     80: When a
                     81: .B TELNET
                     82: session is started up, 
                     83: .I telnetd
                     84: sends
                     85: .B TELNET
                     86: options to the client side indicating
                     87: a willingness to do
                     88: .I remote echo
                     89: of characters, to
                     90: .I suppress go
                     91: .IR ahead ,
                     92: to do
                     93: .I remote flow
                     94: .IR control ,
                     95: and to receive
                     96: .I terminal type
                     97: .IR information ,
                     98: .I terminal speed
                     99: .IR information ,
                    100: and
                    101: .I window size information
                    102: from the remote client.
                    103: If the remote client is willing, the remote terminal type is
                    104: propagated in the environment of the created login process.
                    105: The pseudo-terminal allocated to the client is configured
                    106: to operate in \*(lqcooked\*(rq mode, and with XTABS and CRMOD
                    107: enabled (see
                    108: .IR tty (4)).
                    109: .PP
                    110: .I Telnetd
                    111: is willing to
                    112: .IR do :
                    113: .IR echo ,
                    114: .IR binary ,
                    115: .I suppress go
                    116: .IR ahead ,
                    117: and
                    118: .I timing
                    119: .IR mark .
                    120: .I Telnetd
                    121: is willing to have the remote client
                    122: .IR do :
                    123: .IR linemode ,
                    124: .IR binary ,
                    125: .I terminal
                    126: .IR type ,
                    127: .I terminal
                    128: .IR speed ,
                    129: .I window
                    130: .IR size ,
                    131: .I toggle flow
                    132: .IR control ,
                    133: .IR environment ,
                    134: .I X display
                    135: .IR location ,
                    136: and
                    137: .I suppress go
                    138: .IR ahead .
                    139: .SH "SEE ALSO"
                    140: telnet(1)
                    141: .SH BUGS
                    142: Some
                    143: .B TELNET
                    144: commands are only partially implemented.
                    145: .PP
                    146: Because of bugs in the original 4.2 BSD
                    147: .IR telnet (1),
                    148: .I telnetd
                    149: performs some dubious protocol exchanges to try to discover if the remote
                    150: client is, in fact, a 4.2 BSD
                    151: .IR telnet (1).
                    152: .PP
                    153: .I Binary mode
                    154: has no common interpretation except between similar operating systems
                    155: (Unix in this case).
                    156: .PP
                    157: The terminal type name received from the remote client is converted to
                    158: lower case.
                    159: .PP
                    160: .I Telnetd
                    161: never sends
                    162: .B TELNET
                    163: .I go ahead
                    164: commands.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.