314 lines
5 KiB
Text
314 lines
5 KiB
Text
.TH CON 1
|
|
.SH NAME
|
|
con, telnet, rx, hayes, xms, xmr \- remote login, execution, and XMODEM file transfer
|
|
.SH SYNOPSIS
|
|
.B con
|
|
[
|
|
.B -CdnrRsTv
|
|
]
|
|
[
|
|
.B -b
|
|
.I baud
|
|
]
|
|
[
|
|
.B -l
|
|
[
|
|
.I user
|
|
]
|
|
]
|
|
[
|
|
.B -S
|
|
.I svc
|
|
]
|
|
[
|
|
.B -c
|
|
.I cmd
|
|
]
|
|
.RI [ net !] machine
|
|
.PP
|
|
.B telnet
|
|
[
|
|
.B -dCrn
|
|
]
|
|
[
|
|
.B -s
|
|
.I svc
|
|
]
|
|
.RI [ net !] machine
|
|
.PP
|
|
.B rx
|
|
[
|
|
.B -eTr
|
|
]
|
|
[
|
|
.B -l
|
|
.I user
|
|
]
|
|
.RI [ net !] machine
|
|
[
|
|
.I command-word ...
|
|
]
|
|
.PP
|
|
.B hayes
|
|
[
|
|
.B -pv
|
|
]
|
|
.I number
|
|
[
|
|
.I device
|
|
]
|
|
.PP
|
|
.B xms
|
|
[
|
|
.B -1p
|
|
]
|
|
.I file
|
|
.PP
|
|
.B xmr
|
|
.I file
|
|
.SH DESCRIPTION
|
|
.I Con
|
|
connects to the computer whose network address is
|
|
.IR net ! machine
|
|
and logs in if possible.
|
|
With no options, the account name used on the remote system is the same
|
|
as that on the local system.
|
|
Standard input and output go to the local machine.
|
|
.PP
|
|
Options are:
|
|
.TP
|
|
.B -b
|
|
sets the baud rate of a dial-up connection to
|
|
.IR baud .
|
|
.TP
|
|
.B -n
|
|
if the input is a file or pipe, do not hang up the connection when EOF is received,
|
|
but instead wait for the remote end to hang up.
|
|
.TP
|
|
.B -l
|
|
with an argument causes
|
|
.I user
|
|
to be used as the account name on the remote system
|
|
when performing BSD
|
|
.I rlogin
|
|
authentication.
|
|
Without an argument this option disables automatic login
|
|
and a normal login session ensues.
|
|
.TP
|
|
.B -C
|
|
forces cooked mode, that is, local echo.
|
|
.TP
|
|
.B -c
|
|
runs
|
|
.I cmd
|
|
as if it had been typed as a command from the escape mode.
|
|
.TP
|
|
.B -v
|
|
(verbose mode) causes information about connection attempts
|
|
to be output to standard error. This can be useful when
|
|
trying to debug network connectivity.
|
|
.TP
|
|
.B -d
|
|
causes debugging information to be output to standard error.
|
|
.TP
|
|
.B -r
|
|
suppresses printing of any carriage return followed by a new line.
|
|
This is useful since carriage return is a printable character in
|
|
Plan 9.
|
|
.TP
|
|
.B -R
|
|
translates newlines to carriage returns and
|
|
.IR "vice versa" .
|
|
.TP
|
|
.B -T
|
|
translates incoming carriage returns to newlines.
|
|
.TP
|
|
.B -s
|
|
strips received characters to 7 bits to forestall
|
|
misinterpretation of
|
|
.SM ASCII
|
|
with parity as
|
|
.SM UTF\c
|
|
\&.
|
|
.TP
|
|
.B -S
|
|
Post a pipe as
|
|
.BI /srv/ svc
|
|
and connect it to standard input and output.
|
|
This can be used with
|
|
.B -n
|
|
to create a standing connection that
|
|
.IR consolefs (4),
|
|
for example,
|
|
can then open.
|
|
For
|
|
.IR telnet ,
|
|
this option is
|
|
.BR -s .
|
|
.PP
|
|
The
|
|
.RB control\- \e
|
|
character is a local escape.
|
|
It prompts with
|
|
.BR >>> .
|
|
Legitimate responses to the prompt are
|
|
.TP
|
|
.B i
|
|
Send a quit [sic] signal to the remote machine.
|
|
.PD0
|
|
.TP
|
|
.B q
|
|
Exit.
|
|
.TP
|
|
.B b
|
|
Send a break.
|
|
.TP
|
|
.B .
|
|
Return from the escape.
|
|
.TP
|
|
.B !cmd
|
|
Run the command with the network connection as its
|
|
standard input and standard output.
|
|
Standard error will go to the screen.
|
|
This is useful for transmitting and receiving files
|
|
over the connections using programs such as
|
|
.IR xms .
|
|
.TP
|
|
.B r
|
|
Toggle printing of carriage returns.
|
|
.PD
|
|
.PP
|
|
.I Telnet
|
|
is similar to con, but uses the
|
|
.I telnet
|
|
protocol to communicate with the remote machine.
|
|
It shares
|
|
.I con's
|
|
.BR -C ,
|
|
.BR -d ,
|
|
.BR -n ,
|
|
and
|
|
.BR -r
|
|
options.
|
|
.PP
|
|
.I Rx
|
|
executes one shell command
|
|
on the remote machine as if logged in there,
|
|
but with local standard input and output.
|
|
A rudimentary shell environment is provided.
|
|
If the target is a Plan 9 machine,
|
|
.B $service
|
|
there will be
|
|
.BR rx .
|
|
Options are:
|
|
.TP
|
|
.B \-e
|
|
a zero length message will not be written to the
|
|
connection when standard input is closed.
|
|
.TP
|
|
.B \-l
|
|
runs as
|
|
.I user
|
|
on the remote machine if the remote is a BSD machine.
|
|
.TP
|
|
.B \-r
|
|
same as for
|
|
.I con
|
|
.TP
|
|
.B -T
|
|
same as for
|
|
.I con
|
|
.PD
|
|
.PP
|
|
Network addresses for both
|
|
.I con
|
|
and
|
|
.I rx
|
|
have the form
|
|
.IB network ! machine\f1.
|
|
Supported networks are those listed in
|
|
.BR /net .
|
|
.PP
|
|
.I Hayes
|
|
dials
|
|
.I number
|
|
on a Hayes-compatible modem,
|
|
.IR device .
|
|
Under
|
|
.BR -p ,
|
|
it uses pulse dialing.
|
|
Upon connecting,
|
|
bytes are copied bidirectionally
|
|
between the connection and standard input and output.
|
|
.PP
|
|
The commands
|
|
.I xms
|
|
and
|
|
.I xmr
|
|
respectively send and receive a single file using the
|
|
XMODEM protocol.
|
|
They use standard input and standard output for communication
|
|
and are intended for use with
|
|
.IR con .
|
|
The
|
|
.B -1
|
|
option to
|
|
.I xms
|
|
causes it to use kilobyte packet size of 1024 bytes.
|
|
The
|
|
.B -p
|
|
option causes it to print a progress
|
|
message every ten kilobytes.
|
|
.SH EXAMPLES
|
|
.TP
|
|
.L
|
|
rx kremvax cat file1 >file2
|
|
Copy remote
|
|
.I file1
|
|
to local
|
|
.IR file2 .
|
|
.TP
|
|
.L
|
|
rx kremvax cat file1 '>file2'
|
|
Copy remote
|
|
.I file1
|
|
to remote
|
|
.IR file2.
|
|
.TP
|
|
.L
|
|
eqn paper | rx kremvax troff -ms | rx deepthought lp
|
|
Parallel processing:
|
|
do each stage of a pipeline on a different machine.
|
|
.SH SOURCE
|
|
.TF /sys/src/cmd/ip/telnet.c
|
|
.TP
|
|
.B /sys/src/cmd/rx.c
|
|
.TP
|
|
.B /sys/src/cmd/ip/telnet.c
|
|
.TP
|
|
.B /sys/src/cmd/con
|
|
for all other commands
|
|
.SH SEE ALSO
|
|
.IR rcpu (1),
|
|
.IR telco (4)
|
|
.SH BUGS
|
|
.I Con
|
|
and
|
|
.I telnet
|
|
are merely obsolescent;
|
|
the other commands are obsolete and deprecated.
|
|
.PP
|
|
Under
|
|
.IR rx ,
|
|
a program
|
|
that should behave specially towards terminals may not: e.g.,
|
|
remote shells will not prompt.
|
|
Also under
|
|
.IR rx ,
|
|
the remote standard error and standard output are combined
|
|
and go inseparably to the local standard output.
|
|
.I Rx
|
|
will consume its standard input by copying it to the remote system,
|
|
so redirect it from
|
|
.BR /dev/null
|
|
if that's not what you want.
|