| 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. |