Annotation of 43BSDReno/libexec/telnetd/telnetd.8, revision 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.