--- ../ztelnet/telnet/telnet.1.orig Wed Mar 18 10:54:02 1998 +++ ../ztelnet/telnet/telnet.1 Wed Mar 18 10:59:53 1998 @@ -18,15 +18,15 @@ .\" @(#)telnet.1 6.13 (Berkeley) 7/28/90 .\" .Dd July 28, 1990 -.Dt TELNET 1 +.Dt ZTELNET 1 .Os BSD 4.2 .Sh NAME -.Nm telnet +.Nm ztelnet .Nd User interface to the .Li TELNET -protocol +protocol, with support for Zmodem file transfers. .Sh SYNOPSIS -.Nm telnet +.Nm ztelnet .Op Fl 8 .Op Fl E .Op Fl K @@ -47,23 +47,32 @@ .Oe .Sh DESCRIPTION The -.Nm telnet +.Nm ztelnet command is used to communicate with another host using the .Li TELNET protocol. If -.Nm telnet +.Nm ztelnet is invoked without the .Ar host argument, it enters command mode, indicated by its prompt -.Pq Nm telnet\&> . +.Pq Nm ztelnet\&> . In this mode, it accepts and executes the commands listed below. If it is invoked with arguments, it performs an .Ic open command with those arguments. .Pp +To perform Zmodem file transfers, issue the appropriate Zmodem command on +the remote host. Then hit the +.Nm +command line escape key (^]) and issue the appropriate Zmodem command for +the local host. Typically these commands would be +.Nm sz +and +.Nm rz . +.Pp Options: .Tw Fl .Tp Fl 8 @@ -116,7 +125,7 @@ .Cx Sets the initial .Nm -.B telnet +.B ztelnet escape character to .Ar escape char. If @@ -130,7 +139,7 @@ If Kerberos authentication is being used, the .Fl k option requests that -.Nm telnet +.Nm ztelnet obtain tickets for the remote host in realm .Ar realm instead of the remote host's @@ -175,13 +184,13 @@ .Tp Ar port Indicates a port number (address of an application) or name. If a number is not specified, the default -.Nm telnet +.Nm ztelnet port is used. Port names are mapped to port numbers via the /etc/services file. Normally when a port number is specified, -.Nm telnet +.Nm ztelnet will not send out any initial .Li TELNET option negotiation. @@ -199,19 +208,19 @@ .Nm escape character. Similarly, the line ``~^Z'' will suspend the -.Nm telnet +.Nm ztelnet session. The line ``~^]'' will escape to the normal -.Nm telnet +.Nm ztelnet escape prompt. .Pp Once a connection has been opened, -.Nm telnet +.Nm ztelnet will attempt to enable the .Li TELNET LINEMODE option. If this fails, then -.Nm telnet +.Nm ztelnet will revert to one of two input modes: either \*(Lqcharacter at a time\*(Rq or \*(Lqold line by line\*(Rq @@ -281,15 +290,15 @@ .Ic intr ) . .Pp While connected to a remote host, -.Nm telnet +.Nm ztelnet command mode may be entered by typing the -.Nm telnet +.Nm ztelnet \*(Lqescape character\*(Rq (initially \*(Lq^ \*(Rq). When in command mode, the normal terminal editing conventions are available. .Pp The following -.Nm telnet +.Nm ztelnet commands are available. Only enough of each command to uniquely identify it need be typed (this is also true for most of the arguments to the @@ -659,7 +668,7 @@ Open a connection to the named host. If no port number is specified, -.Nm telnet +.Nm ztelnet will attempt to contact a .Li TELNET server at the default port. @@ -674,7 +683,7 @@ .Li ENVIRON option. When connecting to a non-standard port, -.Nm telnet +.Nm ztelnet omits any automatic initiation of .Li TELNET options. When the port number is preceded by a minus sign, @@ -696,10 +705,10 @@ first thing on the line is the name of the machine that is being connected to. The rest of the line, and successive lines that begin with whitespace are assumed to be -.Nm telnet +.Nm ztelnet commands and are processed as if they had been typed in manually to the -.Nm telnet +.Nm ztelnet command prompt. The special machine name .Ic DEFAULT @@ -714,7 +723,7 @@ Close any open .Li TELNET session and exit -.Nm telnet . +.Nm ztelnet . An end of file (in command mode) will also close a session and exit. .\" ######## END the "quit" command .\" @@ -776,7 +785,7 @@ sequence. .Tp Ic escape Sends the current -.Nm telnet +.Nm ztelnet escape character (initially \*(Lq^\*(Rq). .Tp Ic ga Sends the @@ -833,7 +842,7 @@ The .Ic set command will set any one of a number of -.Nm telnet +.Nm ztelnet variables to a specific value or to TRUE. The special value .Ic off @@ -859,7 +868,7 @@ .Tw Fl .Tp Ic ayt If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode, or @@ -884,7 +893,7 @@ echoing of entered characters (for entering, say, a password). .Tp Ic eof If -.Nm telnet +.Nm ztelnet is operating in .Li LINEMODE or \*(Lqold line by line\*(Rq mode, entering this character @@ -895,7 +904,7 @@ character. .Tp Ic erase If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode (see @@ -904,7 +913,7 @@ below), .Sy and if -.Nm telnet +.Nm ztelnet is operating in \*(Lqcharacter at a time\*(Rq mode, then when this character is typed, a .Li TELNET EC @@ -919,14 +928,14 @@ character. .Tp Ic escape This is the -.Nm telnet +.Nm ztelnet escape character (initially \*(Lq^[\*(Rq) which causes entry into -.Nm telnet +.Nm ztelnet command mode (when connected to a remote system). .Tp Ic flushoutput If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode (see @@ -949,7 +958,7 @@ .Tp Ic forw1 .Tp Ic forw2 If -.Nm telnet +.Nm ztelnet is operating in .Li LINEMODE, these are the characters that, when typed, @@ -962,7 +971,7 @@ characters. .Tp Ic interrupt If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode (see @@ -984,7 +993,7 @@ character. .Tp Ic kill If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode (see @@ -993,7 +1002,7 @@ below), .Ic and if -.Nm telnet +.Nm ztelnet is operating in \*(Lqcharacter at a time\*(Rq mode, then when this character is typed, a .Li TELNET EL @@ -1008,7 +1017,7 @@ character. .Tp Ic lnext If -.Nm telnet +.Nm ztelnet is operating in .Li LINEMODE or \*(Lqold line by line\*(Lq mode, then this character is taken to @@ -1021,7 +1030,7 @@ character. .Tp Ic quit If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode (see @@ -1043,7 +1052,7 @@ character. .Tp Ic reprint If -.Nm telnet +.Nm ztelnet is operating in .Li LINEMODE or \*(Lqold line by line\*(Lq mode, then this character is taken to @@ -1057,14 +1066,14 @@ .Tp Ic rlogin This is the rlogin escape character. If set, the normal -.Nm telnet +.Nm ztelnet .Ic escape character will be ignored unless it is preceded by this character at the beginning of a line. This character, at the beginning of a line, followed by a ``.'' will close the connection; when followed by a ``^Z'' it will suspend the -.Nm telnet +.Nm ztelnet command. The initial state is to have the .Ic rlogin @@ -1095,7 +1104,7 @@ character. .Tp Ic susp If -.Nm telnet +.Nm ztelnet is in .Ic localchars mode, or @@ -1124,7 +1133,7 @@ then tracing information will be written to standard output (the default). .Tp Ic worderase If -.Nm telnet +.Nm ztelnet is operating in .Li LINEMODE or \*(Lqold line by line\*(Lq mode, then this character is taken to @@ -1172,7 +1181,7 @@ Switch to the local defaults for the special characters. The local default characters are those of the local terminal at the time when -.Nm telnet +.Nm ztelnet was started. .Tp Ic import Switch to the remote defaults for the special characters. @@ -1195,7 +1204,7 @@ .\" ######## BEGIN the "status" command .Tp Ic status Show the current status of -.Nm telnet . +.Nm ztelnet . This includes the peer one is connected to, as well as the current mode. .\" ######## END the "status" command @@ -1210,7 +1219,7 @@ and FALSE) various flags that control how -.Nm telnet +.Nm ztelnet responds to events. These flags may be set explicitly to TRUE or FALSE using the @@ -1242,7 +1251,7 @@ sequences; see .Ic set above for details), -.Nm telnet +.Nm ztelnet refuses to display any data on the user's terminal until the remote system acknowledges (via a .Li TELNET TIMING MARK @@ -1269,7 +1278,7 @@ If the .Li TELNET AUTHENTICATION option is supported by the remote side, then -.Nm telnet +.Nm ztelnet will attempt to use it to perform automatic authentication. If the .Li AUTHENTICATION @@ -1395,7 +1404,7 @@ The initial value for this toggle is FALSE. .Tp Ic options Toggles the display of some internal -.Nm telnet +.Nm ztelnet protocol processing (having to do with .Li TELNET options). @@ -1421,7 +1430,7 @@ .Ic skiprc toggle is TRUE, then -.Nm telnet +.Nm ztelnet will skip the reading of the .Pa \&.telnetrc file in the users home directory @@ -1434,7 +1443,7 @@ When the .Ic verbose_encrypt toggle is TRUE, then -.Nm telnet +.Nm ztelnet will print out a message each time encryption is enabled or disabled. The initial value for this toggle is FALSE. @@ -1448,7 +1457,7 @@ .\" ######## BEGIN the "z" command .Tp Ic z Suspend -.Nm telnet . +.Nm ztelnet . This command only works when the user is using the .Xr csh 1 . .\" ######## END the "z" command @@ -1471,10 +1480,10 @@ .Op Ar command .Cx Get help. With no arguments, -.Nm telnet +.Nm ztelnet prints a help summary. If a command is specified, -.Nm telnet +.Nm ztelnet will print the help information for just that command. .\" ######## END the "!" command .Sh ENVIRONMENT