|
|
1.1 root 1: .TH CU 1
2: .CT 1 comm_mach
3: .SH NAME
4: cu, ct \- call out to a terminal or another system
5: .SH SYNOPSIS
6: .B cu
7: [
8: .B -htn
9: ] [
10: .B -p
11: .I parity
12: ] [
13: .B -s
14: .I speed
15: ]
16: .I telno
17: [
18: .I service-class
19: ]
20: .PP
21: .B ct
22: [ option ...
23: ]
24: .I phone-number
25: [
26: .I service-class
27: ]
28: .SH DESCRIPTION
29: .I Cu
30: places a data call to a given telephone number
31: and expects a computer to answer.
32: It manages an interactive conversation with possible
33: transfers of text files.
34: .I Telno
35: is the telephone number, consisting of digits with minus signs at appropriate
36: places to indicate delay for second or subsequent dial tones.
37: A telephone number may also be expressed symbolically.
38: A symbolic number is looked up in the files
39: .F $HOME/lib/cunumber
40: and
41: .F /usr/lib/cunumber
42: whose lines look like this:
43: .IP
44: symbolic-number
45: actual-number
46: service-class
47: comment
48: .LP
49: The actual number
50: may be preceded by options
51: such as
52: .BR \-t .
53: The
54: .I comment,
55: if present, is printed out when the connection is made.
56: .PP
57: The options are
58: .TP
59: .B -n
60: Print the the called number but do not call it.
61: .TP
62: .B -t
63: Tandem:
64: use DC1/DC3
65: .RB (control- S /control- Q )
66: protocol to stop transmission from
67: the remote system when the local terminal buffers are almost full.
68: This argument should only be used if the remote system
69: understands that protocol.
70: .TP
71: .B -h
72: Half-duplex:
73: echo locally the characters that are sent to the remote system.
74: .TP
75: .BI -s " speed"
76: Set the line speed;
77: .L 1200
78: means 1200 baud, etc.
79: The default depends on service class.
80: .TP
81: .BI -p " parity"
82: Set the parity of transmitted characters:
83: .BR 0 ,
84: .BR 1 ,
85: .BR e ,
86: .BR o
87: mean
88: zero,
89: one,
90: even,
91: odd parity.
92: .B 0
93: is the default.
94: .PP
95: The service class is expressed as in
96: .IR dialout (3).
97: A special class
98: .L direct
99: causes the
100: .I telno
101: argument to be taken
102: as the pathname
103: of a terminal line.
104: .I Cu
105: opens the file,
106: sets line speed and other modes,
107: and proceeds as if connected.
108: The default line speed is
109: 9600 baud.
110: .PP
111: An explicit service class on the command line overrides
112: any specified in a
113: .L cunumber
114: file.
115: .PP
116: After making the connection,
117: .I cu
118: runs as two processes:
119: the sending
120: process reads the standard input and
121: passes most of it to the remote system;
122: the receiving
123: process reads from the remote system and passes
124: most data to the standard output.
125: Lines beginning with
126: .L ~
127: have special meanings.
128: .PP
129: The sending
130: process interprets:
131: .TP `\fL~%break\ 'u
132: .B ~.
133: .br
134: .ns
135: .TP
136: .BR ~ EOT
137: Terminate the conversation.
138: .TP
139: .BI ~< file
140: Send the contents of
141: .I file
142: to the remote system,
143: as though typed at the terminal.
144: .TP
145: .B ~!
146: Invoke an interactive shell on the local system.
147: .TP
148: .BI ~! cmd
149: Run the command on the local system
150: (via
151: .LR "sh -c" ).
152: .TP
153: .BI ~$ cmd
154: Run the command locally and send its output
155: to the remote system.
156: .TP
157: .B ~b
158: .br
159: .ns
160: .TP
161: .B ~%break
162: Send a break (300 ms space).
163: .TP
164: .BI ~%take " from \fR[\fIto\fR]"
165: Copy file
166: .I from
167: (on the remote system)
168: to file
169: .I to
170: on the local system.
171: If
172: .I to
173: is omitted,
174: the
175: .I from
176: name is used both places.
177: .TP
178: .BI ~%put " from \fR[\fIto\fR]"
179: Copy file
180: .I from
181: (on local system)
182: to file
183: .I to
184: on remote system.
185: If
186: .I to
187: is omitted, the
188: .I from
189: name is used both places.
190: .TP
191: .BI ~~ text
192: send
193: the line
194: .BI ~ text .
195: .PD
196: .PP
197: WARNING: Using
198: .I cu
199: to reach your home machine from a machine you don't trust
200: can be hazardous to your password.
201: .PP
202: .I Ct
203: places a telephone call to a remote terminal
204: and allows a user to log in on that terminal
205: in the normal fashion.
206: The terminal must be equipped with an auto-answer
207: modem.
208: .PP
209: The
210: phone number and service class
211: are as in
212: .I cu.
213: The options are
214: .TP
215: .BI -c " count"
216: If the number doesn't answer, try
217: .I count
218: times before giving up (default 5).
219: .TP
220: .BI -w " interval
221: Space retries
222: .I interval
223: seconds apart (default 60).
224: .TP
225: .B -h
226: Try to hang up the phone before placing the
227: call.
228: This is useful for a
229: `call me right back' arrangement.
230: .SH FILES
231: .F /usr/lib/cunumber
232: .br
233: .F $HOME/lib/cunumber
234: .SH "SEE ALSO"
235: .IR con (1),
236: .IR ttyld (4),
237: .IR dialout (3)
238: .SH BUGS
239: Unless erase and kill characters are the same on the two machines,
240: they will be damaged by
241: .BR ~%put .
242: .br
243: .B ~%take
244: uses
245: .BR ~>
246: at the beginning of line to synchronize transmission.
247: This sequence can cause misfunction if it is received
248: for any other purpose.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.