diff options
Diffstat (limited to 'static/plan9-4e/man1/con.1')
| -rw-r--r-- | static/plan9-4e/man1/con.1 | 238 |
1 files changed, 238 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/con.1 b/static/plan9-4e/man1/con.1 new file mode 100644 index 00000000..293b0315 --- /dev/null +++ b/static/plan9-4e/man1/con.1 @@ -0,0 +1,238 @@ +.TH CON 1 +.SH NAME +con, telnet, rx, xms, xmr \- remote login, execution, and XMODEM file transfer +.SH SYNOPSIS +.B con +[ +.B -CdnrRvs +] +[ +.B -b +.I baud +] +[ +.B -l +[ +.I remuser +] +] +[ +.B -c +.I cmd +] +.RI [ net !] machine +.PP +.B telnet +[ +.B -dCrn +] +.RI [ net !] machine +.PP +.B cu +.I number +.PP +.B rx +[ +.B -e +] +[ +.B -l +.I remuser +] +.RI [ net !] machine +[ +.I command-word ... +] +.PP +.B xms +.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 remuser +to be used as the account name on the remote system. +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. +This is used by +.IR cu . +.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 -s +strips received characters to 7 bits to forestall +misinterpretation of +.SM ASCII +with parity as +.SM UTF\c +\&. +.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 . +The +.B \-e +option causes a zero length message to be written to the +connection when standard input is closed. +The +.B \-l +option causes +.I remuser +to be used on the remote machine if the remote +is a BSD machine. +.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 +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 . +.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/con +.TP +.B /sys/src/cmd/con +for +.IR con , +.IR xms , +and +.IR xmr . +.TP +.B /sys/src/cmd/ip +for +.IR telnet . +.SH BUGS +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. |