Commit | Line | Data |
---|---|---|
efdd6d01 C |
1 | .TH CU 1C 4/1/81 |
2 | .UC 4 | |
3 | .SH NAME | |
4 | cu \- call UNIX | |
5 | .SH SYNOPSIS | |
6 | .B cu | |
7 | telno | |
8 | [ | |
9 | .B \-t | |
10 | ] | |
11 | [ | |
12 | .BI \- n | |
13 | [ | |
14 | .B \-s | |
15 | speed ] | |
16 | [ | |
17 | .B \-a | |
18 | acu ] | |
19 | [ | |
20 | .B \-l | |
21 | line ] | |
22 | [ | |
23 | .B \-b | |
24 | ] | |
25 | .SH DESCRIPTION | |
26 | .I Cu | |
27 | calls up another UNIX system, | |
28 | a terminal, | |
29 | or possibly a non-UNIX system. | |
30 | It manages an interactive conversation with possible | |
31 | transfers of text files. | |
32 | .I Telno | |
33 | is the telephone number, | |
34 | with minus signs at appropriate places for delays. | |
35 | The | |
36 | .BR \-t "" | |
37 | flag is used to dial out to a terminal. | |
38 | .I Speed | |
39 | gives the transmission speed (110, 134, 150, 300, 1200); | |
40 | 300 is the default value. | |
41 | .PP | |
42 | The | |
43 | .B \-a | |
44 | and | |
45 | .B \-l | |
46 | values may be used to | |
47 | specify pathnames | |
48 | for the ACU and communications line devices. | |
49 | They can be used to override the following | |
50 | built-in choices: | |
51 | .PP | |
52 | .BR \-a " /dev/cua0" | |
53 | .BR \-l " /dev/cul0" | |
54 | .PP | |
55 | The | |
56 | .BI \- n | |
57 | option, where | |
58 | .I n | |
59 | is a single digit, | |
60 | changes the last character of the ACU and communications line to | |
61 | .IR n . | |
62 | It is an abbreviation for | |
63 | .BI "\-a /dev/cua" n " \-l /dev/cul" n . | |
64 | .PP | |
65 | After making the connection, | |
66 | .I cu | |
67 | runs as two processes: | |
68 | the | |
69 | .I send | |
70 | process reads the standard input and | |
71 | passes most of it to the remote system; | |
72 | the | |
73 | .I receive | |
74 | process reads from the remote system and passes | |
75 | most data to the standard output. | |
76 | Lines beginning with `~' have special meanings. | |
77 | .PP | |
78 | The | |
79 | .I send | |
80 | process interprets the following: | |
81 | .TP 18 | |
82 | ~\|\fB.\| | |
83 | terminate the conversation. | |
84 | .br | |
85 | .ns | |
86 | .TP 18 | |
87 | ~EOT | |
88 | terminate the conversation | |
89 | .TP 18 | |
90 | ~<file | |
91 | send the contents of | |
92 | .I file | |
93 | to the remote system, | |
94 | as though typed at the terminal. | |
95 | .TP 18 | |
96 | \~^Z | |
97 | suspend the cu process. | |
98 | Note that the control-Z must be followed by a newline. | |
99 | .TP 18 | |
100 | \~# | |
101 | sends a break. | |
102 | .TP 18 | |
103 | ~! | |
104 | invoke an interactive shell on the local system. | |
105 | .TP 18 | |
106 | ~!cmd ... | |
107 | run the command on the local system | |
108 | (via | |
109 | .BR "sh \-c" ")." | |
110 | .TP 18 | |
111 | ~$cmd ... | |
112 | run the command locally and send its output | |
113 | to the remote system. | |
114 | .TP 18 | |
115 | ~%take from [to] | |
116 | copy file `from' (on the remote system) | |
117 | to file `to' on the local system. | |
118 | If `to' is omitted, | |
119 | the `from' name is used both places. | |
120 | .TP 18 | |
121 | ~%put from [to] | |
122 | copy file `from' (on local system) | |
123 | to file `to' on remote system. | |
124 | If `to' is omitted, the `from' name is used both places. | |
125 | .TP 18 | |
126 | ~: | |
127 | during an output diversion, this toggles whether the operation of | |
128 | .I cu | |
129 | will be silent, i.e., whether information received from the foreign | |
130 | system will be written to the standard output. | |
131 | This allows a ``progress report'' during long transfers. | |
132 | .TP 18 | |
133 | ~~\fB\|.\|.\|.\fR | |
134 | send | |
135 | the line `~\|.\|.\|.'. | |
136 | .PP | |
137 | Both the | |
138 | .I send | |
139 | and | |
140 | .I receive | |
141 | processes handles output diversions of the following form: | |
142 | .PP | |
143 | \&~>[>][:]file | |
144 | .br | |
145 | zero or more lines to be written to file | |
146 | .br | |
147 | \&~> | |
148 | .PP | |
149 | In any case, output is diverted (or appended, if `>>' used) to the file. | |
150 | If `:' is used, | |
151 | the diversion is | |
152 | .I silent, | |
153 | i.e., it is written only to the file. | |
154 | If `:' is omitted, | |
155 | output is written both to the file and to the standard output. | |
156 | The trailing `~>' terminates the diversion. | |
157 | .PP | |
158 | The use of | |
159 | .B ~%put | |
160 | requires | |
161 | .I stty | |
162 | and | |
163 | .I cat | |
164 | on the remote side. | |
165 | It also requires that the | |
166 | current erase and kill characters on the remote | |
167 | system be identical to the current ones on the local system. | |
168 | Backslashes are inserted at appropriate places. | |
169 | .PP | |
170 | The use of | |
171 | .B ~%take | |
172 | requires the existence of | |
173 | .I echo | |
174 | and | |
175 | .I tee | |
176 | on the remote system. | |
177 | Also, | |
178 | .B "stty tabs" | |
179 | mode is required on the remote system if | |
180 | tabs are to be copied without expansion. | |
181 | .PP | |
182 | Finally, the | |
183 | .BR \-b | |
184 | flag specifies that nulls are to be turned into breaks. | |
185 | This allows the break key (and also control-shift-@) to send a break. | |
186 | .SH FILES | |
187 | /dev/cua0 | |
188 | .br | |
189 | /dev/cul0 | |
190 | .br | |
191 | /dev/null | |
192 | .br | |
193 | /usr/spool/uucp/LCK..cu[al][0-7] | |
194 | .SH "SEE ALSO" | |
195 | rv(4), tty(4) | |
196 | .SH DIAGNOSTICS | |
197 | Exit code is | |
198 | zero for normal exit, | |
199 | nonzero (various values) otherwise. | |
200 | .SH BUGS | |
201 | Only | |
202 | .IR mail (1) | |
203 | uses syntax anything like the syntax of | |
204 | .I cu. |