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