Return to con CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/con, revision 1.1

1.1     ! root        1: .TH CON 1
        !             2: .SH NAME
        !             3: con, telnet, cu, rx, xms, xmr \- remote login, execution, and XMODEM file transfer
        !             4: .SH SYNOPSIS
        !             5: .B con
        !             6: [
        !             7: .B -dCrvs
        !             8: ]
        !             9: [
        !            10: .B -l
        !            11: [
        !            12: .I remuser
        !            13: ]
        !            14: ]
        !            15: [
        !            16: .B -c
        !            17: .I cmd
        !            18: ]
        !            19: .RI [ net !] machine
        !            20: .PP
        !            21: .B telnet
        !            22: [
        !            23: .B -dCrn
        !            24: ]
        !            25: .RI [ net !] machine
        !            26: .PP
        !            27: .B cu
        !            28: .I number
        !            29: .PP
        !            30: .B rx
        !            31: [
        !            32: .B -n
        !            33: ]
        !            34: .RI [ net !] machine
        !            35: [
        !            36: .I command-word ...
        !            37: ]
        !            38: .PP
        !            39: .B xms
        !            40: .I file
        !            41: .PP
        !            42: .B xmr
        !            43: .I file
        !            44: .SH DESCRIPTION
        !            45: .I Con
        !            46: connects to the computer whose network address is
        !            47: .IR net ! machine
        !            48: and logs in if possible.
        !            49: With no options, the account name used on the remote system is the same
        !            50: as that on the local system.
        !            51: Standard input and output go to the local machine.
        !            52: .PP
        !            53: Options are:
        !            54: .TP
        !            55: .B -l
        !            56: with an argument causes
        !            57: .I remuser
        !            58: to be used as the account name on the remote system.
        !            59: Without an argument this option disables automatic login
        !            60: and a normal login session ensues.
        !            61: .TP
        !            62: .B -C
        !            63: forces cooked mode, that is, local echo.
        !            64: .TP
        !            65: .B -c
        !            66: runs
        !            67: .I cmd
        !            68: as if it had been typed as a command from the escape mode.
        !            69: This is used by
        !            70: .IR cu .
        !            71: .TP
        !            72: .B -v
        !            73: (verbose mode) causes information about connection attempts
        !            74: to be output to standard error.  This can be useful when
        !            75: trying to debug network connectivity.
        !            76: .TP
        !            77: .B -d
        !            78: causes debugging information to be output to standard error.
        !            79: .TP
        !            80: .B -r
        !            81: suppresses printing of any carriage return followed by a new line.
        !            82: This is useful since carriage return is a printable character in
        !            83: Plan 9.
        !            84: .TP
        !            85: .B -s
        !            86: strips received characters to 7 bits to forestall
        !            87: misinterpretation of ASCII with parity as UTF.
        !            88: .PP
        !            89: The
        !            90: .RB control\- \e
        !            91: character is a local escape.
        !            92: It prompts with the local machine name and
        !            93: .BR >>> .
        !            94: Legitimate responses to the prompt are
        !            95: .TP
        !            96: .B i
        !            97: Send a quit [sic] signal to the remote machine.
        !            98: .PD0
        !            99: .TP
        !           100: .B q
        !           101: Exit.
        !           102: .TP
        !           103: .B b
        !           104: Send a break.
        !           105: .TP
        !           106: .B .
        !           107: Return from the escape.
        !           108: .TP
        !           109: .B !cmd
        !           110: Run the command with the network connection as its
        !           111: standard input and standard output.
        !           112: Standard error will go to the screen.
        !           113: This is useful for transmitting and receiving files
        !           114: over the connections using programs such as
        !           115: .IR xms .
        !           116: .PD
        !           117: .PP
        !           118: .I Telnet
        !           119: is similar to con, but uses the
        !           120: .I telnet
        !           121: protocol to communicate with the remote machine.
        !           122: If standard input is a file or a pipe, the
        !           123: .B -n
        !           124: option causes
        !           125: .I telnet
        !           126: not to hang up the connection when it receives EOF on its standard input;
        !           127: instead it waits for the remote end to hang up.
        !           128: It shares
        !           129: .I con's
        !           130: .BR -C ,
        !           131: .BR -d ,
        !           132: and
        !           133: .BR -r
        !           134: options.
        !           135: .PP
        !           136: .I Cu
        !           137: is a shell script that uses
        !           138: .IR telco (4)
        !           139: and
        !           140: .I con
        !           141: to connect to a machine via a modem.
        !           142: If the machine is equipped with a local modem, it is used.
        !           143: Otherwise, the call is placed through Datakit.
        !           144: .PP
        !           145: .I Rx
        !           146: executes one shell command
        !           147: on the remote machine as if logged in there,
        !           148: but with local standard input and output.
        !           149: A rudimentary shell environment is provided.
        !           150: If the target is a Plan 9 machine,
        !           151: .B $service
        !           152: there will be
        !           153: .BR rx .
        !           154: .PP
        !           155: Network addresses for both
        !           156: .I con
        !           157: and
        !           158: .I rx
        !           159: have the form
        !           160: .IB network ! machine\f1.
        !           161: Supported networks are those listed in
        !           162: .BR /net .
        !           163: .PP
        !           164: The commands
        !           165: .I xms
        !           166: and
        !           167: .I xmr
        !           168: respectively send and receive a single file using the
        !           169: XMODEM protocol.
        !           170: They use standard input and standard output for communication
        !           171: and are intended for use with
        !           172: .IR con .
        !           173: .SH EXAMPLES
        !           174: .TP
        !           175: .L
        !           176: rx kremvax cat file1 >file2
        !           177: Copy remote
        !           178: .I file1
        !           179: to local
        !           180: .IR file2 .
        !           181: .TP
        !           182: .L
        !           183: rx kremvax cat file1 '>file2'
        !           184: Copy remote
        !           185: .I file1
        !           186: to remote
        !           187: .IR file2.
        !           188: .TP
        !           189: .L
        !           190: eqn paper | rx kremvax troff -ms | rx deepthought lp
        !           191: Parallel processing:
        !           192: do each stage of a pipeline on a different machine.
        !           193: .SH SOURCE
        !           194: .TF /sys/src/cmd/con
        !           195: .TP
        !           196: .B /sys/src/cmd/con
        !           197: for
        !           198: .IR con ,
        !           199: .IR xms ,
        !           200: and
        !           201: .IR xmr .
        !           202: .TP
        !           203: .B /sys/src/cmd/ip
        !           204: for
        !           205: .IR telnet .
        !           206: .TP
        !           207: .B /rc/bin/cu
        !           208: .SH BUGS
        !           209: Under
        !           210: .IR rx ,
        !           211: a program
        !           212: that should behave specially towards terminals may not: e.g.,
        !           213: remote shells will not prompt.
        !           214: Also under
        !           215: .IR rx ,
        !           216: the remote standard error and standard output are combined 
        !           217: and go inseparably to the local standard output.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.