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