.TH CON 1.SH NAMEcon, 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 Conconnects to the computer whose network address is.IR net ! machineand logs in if possible.With no options, the account name used on the remote system is the sameas that on the local system.Standard input and output go to the local machine..PPOptions are:.TP.B -bsets the baud rate of a dial-up connection to.IR baud ..TP.B -nif 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 -lwith an argument causes.I userto be used as the account name on the remote systemwhen performing BSD.I rloginauthentication.Without an argument this option disables automatic loginand a normal login session ensues..TP.B -Cforces cooked mode, that is, local echo..TP.B -cruns.I cmdas if it had been typed as a command from the escape mode..TP.B -v(verbose mode) causes information about connection attemptsto be output to standard error. This can be useful whentrying to debug network connectivity..TP.B -dcauses debugging information to be output to standard error..TP.B -rsuppresses printing of any carriage return followed by a new line.This is useful since carriage return is a printable character inPlan 9..TP.B -Rtranslates newlines to carriage returns and.IR "vice versa" ..TP.B -Ttranslates incoming carriage returns to newlines..TP.B -sstrips received characters to 7 bits to forestallmisinterpretation of.SM ASCIIwith parity as.SM UTF\c\&..TP.B -SPost a pipe as.BI /srv/ svcand connect it to standard input and output.This can be used with.B -nto create a standing connection that.IR consolefs (4),for example,can then open.For.IR telnet ,this option is.BR -s ..PPThe.RB control\- \echaracter is a local escape.It prompts with.BR >>> .Legitimate responses to the prompt are.TP.B iSend a quit [sic] signal to the remote machine..PD0.TP.B qExit..TP.B bSend a break..TP.B .Return from the escape..TP.B !cmdRun the command with the network connection as itsstandard input and standard output.Standard error will go to the screen.This is useful for transmitting and receiving filesover the connections using programs such as.IR xms ..TP.B rToggle printing of carriage returns..PD.PP.I Telnetis similar to con, but uses the.I telnetprotocol to communicate with the remote machine.It shares.I con's.BR -C ,.BR -d ,.BR -n ,and.BR -roptions..PP.I Rxexecutes one shell commandon 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 $servicethere will be.BR rx .Options are:.TP.B \-ea zero length message will not be written to theconnection when standard input is closed..TP.B \-lruns as.I useron the remote machine if the remote is a BSD machine..TP.B \-rsame as for.I con.TP.B -Tsame as for.I con.PD.PPNetwork addresses for both.I conand.I rxhave the form.IB network ! machine\f1.Supported networks are those listed in.BR /net ..PP.I Hayesdials.I numberon a Hayes-compatible modem,.IR device .Under.BR -p ,it uses pulse dialing.Upon connecting,bytes are copied bidirectionallybetween the connection and standard input and output..PPThe commands.I xmsand.I xmrrespectively send and receive a single file using theXMODEM protocol.They use standard input and standard output for communicationand are intended for use with.IR con .The.B -1option to.I xmscauses it to use kilobyte packet size of 1024 bytes.The.B -poption causes it to print a progressmessage every ten kilobytes..SH EXAMPLES.TP.Lrx kremvax cat file1 >file2Copy remote.I file1to local.IR file2 ..TP.Lrx kremvax cat file1 '>file2'Copy remote.I file1to remote.IR file2..TP.Leqn paper | rx kremvax troff -ms | rx deepthought lpParallel 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/confor all other commands.SH SEE ALSO.IR cpu (1),.IR ssh (1),.IR telco (4).SH BUGS.I Conand.I telnetare merely obsolescent;the other commands are obsolete and deprecated..PPUnder.IR rx ,a programthat 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 Rxwill consume its standard input by copying it to the remote system,so redirect it from.BR /dev/nullif that's not what you want.
.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 cpu (1),
.IR ssh (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.