version 1.15, 1999/02/21 02:50:04 |
version 1.16, 1999/06/05 01:21:42 |
|
|
.\" |
.\" |
.Dd February 3, 1994 |
.Dd February 3, 1994 |
.Dt TELNET 1 |
.Dt TELNET 1 |
.Os BSD 4.2 |
.Os |
.Sh NAME |
.Sh NAME |
.Nm telnet |
.Nm telnet |
.Nd user interface to the |
.Nd user interface to the |
.Tn TELNET |
.Tn TELNET |
protocol |
protocol |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
|
|
The |
The |
.Nm telnet |
.Nm telnet |
command |
command |
is used to communicate with another host using the |
is used to communicate with another host using the |
.Tn TELNET |
.Tn TELNET |
protocol. |
protocol. |
If |
If |
|
|
TOS name found in the |
TOS name found in the |
.Pa /etc/iptos |
.Pa /etc/iptos |
file. |
file. |
.It Fl X Ar atype |
.It Fl X Ar atype |
Disables the |
Disables the |
.Ar atype |
.Ar atype |
type of authentication. |
type of authentication. |
|
|
.Ic debug |
.Ic debug |
toggle to |
toggle to |
.Dv TRUE . |
.Dv TRUE . |
.It Fl e Ar escapechar |
.It Fl e Ar escapechar |
Sets the initial |
Sets the initial |
.Nm |
.Nm |
escape character to |
escape character to |
|
|
instead of the remote host's realm, as determined |
instead of the remote host's realm, as determined |
by |
by |
.Xr krb_realmofhost 3 . |
.Xr krb_realmofhost 3 . |
.It Fl l Ar user |
.It Fl l Ar user |
When connecting to the remote system, if the remote system |
When connecting to the remote system, if the remote system |
understands the |
understands the |
.Ev ENVIRON |
.Ev ENVIRON |
|
|
This option may also be used with the |
This option may also be used with the |
.Ic open |
.Ic open |
command. |
command. |
.It Fl n Ar tracefile |
.It Fl n Ar tracefile |
Opens |
Opens |
.Ar tracefile |
.Ar tracefile |
for recording trace information. |
for recording trace information. |
|
|
or ``old line by line'' |
or ``old line by line'' |
depending on what the remote system supports. |
depending on what the remote system supports. |
.Pp |
.Pp |
When |
When |
.Dv LINEMODE |
.Dv LINEMODE |
is enabled, character processing is done on the |
is enabled, character processing is done on the |
local system, under the control of the remote system. When input |
local system, under the control of the remote system. When input |
|
|
(this would mostly be used to enter passwords |
(this would mostly be used to enter passwords |
without the password being echoed). |
without the password being echoed). |
.Pp |
.Pp |
If the |
If the |
.Dv LINEMODE |
.Dv LINEMODE |
option is enabled, or if the |
option is enabled, or if the |
.Ic localchars |
.Ic localchars |
|
|
characters are trapped locally, and sent as |
characters are trapped locally, and sent as |
.Tn TELNET |
.Tn TELNET |
protocol sequences to the remote side. |
protocol sequences to the remote side. |
If |
If |
.Dv LINEMODE |
.Dv LINEMODE |
has ever been enabled, then the user's |
has ever been enabled, then the user's |
.Ic susp |
.Ic susp |
|
|
protocol sequences, |
protocol sequences, |
and |
and |
.Ic quit |
.Ic quit |
is sent as a |
is sent as a |
.Dv TELNET ABORT |
.Dv TELNET ABORT |
instead of |
instead of |
.Dv BREAK . |
.Dv BREAK . |
There are options (see |
There are options (see |
.Ic toggle |
.Ic toggle |
|
|
.Ic display |
.Ic display |
commands). |
commands). |
.Bl -tag -width "mode type" |
.Bl -tag -width "mode type" |
.It Ic auth Ar argument Op Ar ... |
.It Ic auth Ar argument Op Ar ... |
The |
The |
.Ic auth |
.Ic auth |
command manipulates the information sent through the |
command manipulates the information sent through the |
|
|
Close a |
Close a |
.Tn TELNET |
.Tn TELNET |
session and return to command mode. |
session and return to command mode. |
.It Ic display Ar argument Op Ar ... |
.It Ic display Ar argument Op Ar ... |
Displays all, or some, of the |
Displays all, or some, of the |
.Ic set |
.Ic set |
and |
and |
|
|
.Ic encrypt stop |
.Ic encrypt stop |
commands. |
commands. |
.El |
.El |
.It Ic environ Ar arguments Op Ar ... |
.It Ic environ Ar arguments Op Ar ... |
The |
The |
.Ic environ |
.Ic environ |
command is used to manipulate the |
command is used to manipulate the |
|
|
.Ic environ |
.Ic environ |
command are: |
command are: |
.Bl -tag -width Fl |
.Bl -tag -width Fl |
.It Ic define Ar variable value |
.It Ic define Ar variable value |
Define the variable |
Define the variable |
.Ar variable |
.Ar variable |
to have a value of |
to have a value of |
|
|
.Ar value |
.Ar value |
may be enclosed in single or double quotes so |
may be enclosed in single or double quotes so |
that tabs and spaces may be included. |
that tabs and spaces may be included. |
.It Ic undefine Ar variable |
.It Ic undefine Ar variable |
Remove |
Remove |
.Ar variable |
.Ar variable |
from the list of environment variables. |
from the list of environment variables. |
.It Ic export Ar variable |
.It Ic export Ar variable |
Mark the variable |
Mark the variable |
.Ar variable |
.Ar variable |
to be exported to the remote side. |
to be exported to the remote side. |
.It Ic unexport Ar variable |
.It Ic unexport Ar variable |
Mark the variable |
Mark the variable |
.Ar variable |
.Ar variable |
to not be exported unless |
to not be exported unless |
|
|
suspending a user's session for later reattachment, |
suspending a user's session for later reattachment, |
the logout argument indicates that you |
the logout argument indicates that you |
should terminate the session immediately. |
should terminate the session immediately. |
.It Ic mode Ar type |
.It Ic mode Ar type |
.Ar type |
.Ar type |
is one of several options, depending on the state of the |
is one of several options, depending on the state of the |
.Tn TELNET |
.Tn TELNET |
|
|
option, or, if the remote side does not understand the |
option, or, if the remote side does not understand the |
.Dv LINEMODE |
.Dv LINEMODE |
option, then attempt to enter ``old-line-by-line'' mode. |
option, then attempt to enter ``old-line-by-line'' mode. |
.It Ic isig Pq Ic \-isig |
.It Ic isig Pq Ic \-isig |
Attempt to enable (disable) the |
Attempt to enable (disable) the |
.Dv TRAPSIG |
.Dv TRAPSIG |
mode of the |
mode of the |
.Dv LINEMODE |
.Dv LINEMODE |
option. |
option. |
This requires that the |
This requires that the |
.Dv LINEMODE |
.Dv LINEMODE |
option be enabled. |
option be enabled. |
.It Ic edit Pq Ic \-edit |
.It Ic edit Pq Ic \-edit |
Attempt to enable (disable) the |
Attempt to enable (disable) the |
.Dv EDIT |
.Dv EDIT |
mode of the |
mode of the |
.Dv LINEMODE |
.Dv LINEMODE |
option. |
option. |
This requires that the |
This requires that the |
.Dv LINEMODE |
.Dv LINEMODE |
option be enabled. |
option be enabled. |
.It Ic softtabs Pq Ic \-softtabs |
.It Ic softtabs Pq Ic \-softtabs |
Attempt to enable (disable) the |
Attempt to enable (disable) the |
.Dv SOFT_TAB |
.Dv SOFT_TAB |
mode of the |
mode of the |
.Dv LINEMODE |
.Dv LINEMODE |
option. |
option. |
This requires that the |
This requires that the |
.Dv LINEMODE |
.Dv LINEMODE |
option be enabled. |
option be enabled. |
.It Ic litecho Pq Ic \-litecho |
.It Ic litecho Pq Ic \-litecho |
Attempt to enable (disable) the |
Attempt to enable (disable) the |
.Dv LIT_ECHO |
.Dv LIT_ECHO |
mode of the |
mode of the |
.Dv LINEMODE |
.Dv LINEMODE |
option. |
option. |
This requires that the |
This requires that the |
.Dv LINEMODE |
.Dv LINEMODE |
option be enabled. |
option be enabled. |
.It Ic \&? |
.It Ic \&? |
|
|
session and exit |
session and exit |
.Nm telnet . |
.Nm telnet . |
An end-of-file (in command mode) will also close a session and exit. |
An end-of-file (in command mode) will also close a session and exit. |
.It Ic send Ar arguments |
.It Ic send Ar arguments |
Sends one or more special character sequences to the remote host. |
Sends one or more special character sequences to the remote host. |
The following are the arguments which may be specified |
The following are the arguments which may be specified |
(more than one argument may be specified at a time): |
(more than one argument may be specified at a time): |
|
|
.Ic send |
.Ic send |
command. |
command. |
.El |
.El |
.It Ic set Ar argument value |
.It Ic set Ar argument value |
.It Ic unset Ar argument value |
.It Ic unset Ar argument value |
The |
The |
.Ic set |
.Ic set |
command will set any one of a number of |
command will set any one of a number of |
|
|
.Pq Ic unset |
.Pq Ic unset |
commands. |
commands. |
.El |
.El |
.It Ic slc Ar state |
.It Ic slc Ar state |
The |
The |
.Ic slc |
.Ic slc |
command (Set Local Characters) is used to set |
command (Set Local Characters) is used to set |
or change the state of the special |
or change the state of the special |
characters when the |
characters when the |
.Dv TELNET LINEMODE |
.Dv TELNET LINEMODE |
option has |
option has |
been enabled. Special characters are characters that get |
been enabled. Special characters are characters that get |
mapped to |
mapped to |
.Tn TELNET |
.Tn TELNET |
commands sequences (like |
commands sequences (like |
.Ic ip |
.Ic ip |
|
|
.It Ic import |
.It Ic import |
Switch to the remote defaults for the special characters. |
Switch to the remote defaults for the special characters. |
The remote default characters are those of the remote system |
The remote default characters are those of the remote system |
at the time when the |
at the time when the |
.Tn TELNET |
.Tn TELNET |
connection was established. |
connection was established. |
.It Ic \&? |
.It Ic \&? |
|
|
.Nm telnet . |
.Nm telnet . |
This includes the peer one is connected to, as well |
This includes the peer one is connected to, as well |
as the current mode. |
as the current mode. |
.It Ic toggle Ar arguments Op Ar ... |
.It Ic toggle Ar arguments Op Ar ... |
Toggle (between |
Toggle (between |
.Dv TRUE |
.Dv TRUE |
and |
and |
|
|
.Nm telnet . |
.Nm telnet . |
This command only works when the user is using the |
This command only works when the user is using the |
.Xr csh 1 . |
.Xr csh 1 . |
.It Ic \&! Op Ar command |
.It Ic \&! Op Ar command |
Execute a single command in a subshell on the local |
Execute a single command in a subshell on the local |
system. If |
system. If |
.Ar command |
.Ar command |
is omitted, then an interactive |
is omitted, then an interactive |
subshell is invoked. |
subshell is invoked. |
.It Ic \&? Op Ar command |
.It Ic \&? Op Ar command |
Get help. With no arguments, |
Get help. With no arguments, |
.Nm telnet |
.Nm telnet |
prints a help summary. |
prints a help summary. |
|
|
On some remote systems, echo has to be turned off manually when in |
On some remote systems, echo has to be turned off manually when in |
``old line by line'' mode. |
``old line by line'' mode. |
.Pp |
.Pp |
In ``old line by line'' mode or |
In ``old line by line'' mode or |
.Dv LINEMODE |
.Dv LINEMODE |
the terminal's |
the terminal's |
.Ic eof |
.Ic eof |