freebsd-ports/net/ztelnet/files/patch-ba
1998-03-18 19:05:35 +00:00

440 lines
9.0 KiB
Plaintext

--- ../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