+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved. The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\" @(#)tip.1 4.1 (Berkeley) %G%
+.\"
+.TH CU 1C 4/1/81
+.UC 4
+.SH NAME
+cu \- call UNIX
+.SH SYNOPSIS
+.B cu
+telno
+[
+.B \-t
+]
+[
+.BI \- n
+[
+.B \-s
+speed ]
+[
+.B \-a
+acu ]
+[
+.B \-l
+line ]
+[
+.B \-b
+]
+.SH DESCRIPTION
+.I Cu
+calls up another UNIX system,
+a terminal,
+or possibly a non-UNIX system.
+It manages an interactive conversation with possible
+transfers of text files.
+.I Telno
+is the telephone number,
+with minus signs at appropriate places for delays.
+The
+.BR \-t ""
+flag is used to dial out to a terminal.
+.I Speed
+gives the transmission speed (110, 134, 150, 300, 1200);
+300 is the default value.
+.PP
+The
+.B \-a
+and
+.B \-l
+values may be used to
+specify pathnames
+for the ACU and communications line devices.
+They can be used to override the following
+built-in choices:
+.PP
+.BR \-a " /dev/cua0"
+.BR \-l " /dev/cul0"
+.PP
+The
+.BI \- n
+option, where
+.I n
+is a single digit,
+changes the last character of the ACU and communications line to
+.IR n .
+It is an abbreviation for
+.BI "\-a /dev/cua" n " \-l /dev/cul" n .
+.PP
+After making the connection,
+.I cu
+runs as two processes:
+the
+.I send
+process reads the standard input and
+passes most of it to the remote system;
+the
+.I receive
+process reads from the remote system and passes
+most data to the standard output.
+Lines beginning with `~' have special meanings.
+.PP
+The
+.I send
+process interprets the following:
+.TP 18
+~\|\fB.\|
+terminate the conversation.
+.br
+.ns
+.TP 18
+~EOT
+terminate the conversation
+.TP 18
+~<file
+send the contents of
+.I file
+to the remote system,
+as though typed at the terminal.
+.TP 18
+\~^Z
+suspend the cu process.
+Note that the control-Z must be followed by a newline.
+.TP 18
+\~#
+sends a break.
+.TP 18
+~!
+invoke an interactive shell on the local system.
+.TP 18
+~!cmd ...
+run the command on the local system
+(via
+.BR "sh \-c" ")."
+.TP 18
+~$cmd ...
+run the command locally and send its output
+to the remote system.
+.TP 18
+~%take from [to]
+copy file `from' (on the remote system)
+to file `to' on the local system.
+If `to' is omitted,
+the `from' name is used both places.
+.TP 18
+~%put from [to]
+copy file `from' (on local system)
+to file `to' on remote system.
+If `to' is omitted, the `from' name is used both places.
+.TP 18
+~:
+during an output diversion, this toggles whether the operation of
+.I cu
+will be silent, i.e., whether information received from the foreign
+system will be written to the standard output.
+This allows a ``progress report'' during long transfers.
+.TP 18
+~~\fB\|.\|.\|.\fR
+send
+the line `~\|.\|.\|.'.
+.PP
+Both the
+.I send
+and
+.I receive
+processes handles output diversions of the following form:
+.PP
+\&~>[>][:]file
+.br
+zero or more lines to be written to file
+.br
+\&~>
+.PP
+In any case, output is diverted (or appended, if `>>' used) to the file.
+If `:' is used,
+the diversion is
+.I silent,
+i.e., it is written only to the file.
+If `:' is omitted,
+output is written both to the file and to the standard output.
+The trailing `~>' terminates the diversion.
+.PP
+The use of
+.B ~%put
+requires
+.I stty
+and
+.I cat
+on the remote side.
+It also requires that the
+current erase and kill characters on the remote
+system be identical to the current ones on the local system.
+Backslashes are inserted at appropriate places.
+.PP
+The use of
+.B ~%take
+requires the existence of
+.I echo
+and
+.I tee
+on the remote system.
+Also,
+.B "stty tabs"
+mode is required on the remote system if
+tabs are to be copied without expansion.
+.PP
+Finally, the
+.BR \-b
+flag specifies that nulls are to be turned into breaks.
+This allows the break key (and also control-shift-@) to send a break.
+.SH FILES
+/dev/cua0
+.br
+/dev/cul0
+.br
+/dev/null
+.br
+/usr/spool/uucp/LCK..cu[al][0-7]
+.SH "SEE ALSO"
+rv(4), tty(4)
+.SH DIAGNOSTICS
+Exit code is
+zero for normal exit,
+nonzero (various values) otherwise.
+.SH BUGS
+Only
+.IR mail (1)
+uses syntax anything like the syntax of
+.I cu.
projects / unix-history / commitdiff