![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to con CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Plan 9 NeXT] / lucent / sys / man / 1|
Return to con CVS log | Up to [Plan 9 NeXT] / lucent / sys / man / 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.