NAME

cu_v7m, custat_v7m − call UNIX (V7M version)

SYNTAX

cu_v7m telno [-t] [-n] [-m] [-s speed] [-a acu] [-l line]
custat_v7m

DESCRIPTION

The cu_v7m command is the version of the cu command supplied with the ULTRIX-11 V1.0 software.  The cu_v7m command remains a part of the ULTRIX-11 system, but its use is not recommended.  Digital recommends use of the tip utility in place of cu, refer to tip(1c) for details. 

The cu_v7m command calls up another UNIX system, or possibly a non-UNIX system.  It manages an interactive conversation with possible transfers of text files.  The cu_v7m command establishes the system to system connection by calling the remote system via DF02-AC or DF03-AC auto call modem, or over a direct link with the remote system.  The telephone number is telno, with an equal sign at the appropriate place if an intermediate dial tone is expected.  The −t flag is used to access the remote system over a direct link instead of an auto call unit.  The transmission speed (110, 150, 300, 1200, 2400, 4800, 9600) is given by speed.  The default value is 9600 for direct connects (-t) and 1200 for auto dial connections. 

The −a and −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:

−a /dev/cua0 −l /dev/cul0

The −n option, where n is a single digit, changes the last character of the ACU and communications line to n.  It is an abbreviation for −a /dev/cuan −l /dev/culn. 

The −m option is used in conjunction with the −t flag when the direct link involves modems.  This option forces data terminal ready (DTR) to be asserted by the communications line device driver. 

After making the connection, cu_v7m runs as two processes.  The send process reads the standard input and passes most of it to the remote system.  The receive process reads from the remote system and passes most data to the standard output.  Lines beginning with “~“ have special meanings, which are acted upon only after the receipt of a newline. 

The send process interprets the following:

~. terminate the conversation. 

~<file send the contents of file to the remote system, as though typed at the terminal. 

~# sends a break (cycles speeds on auto bit rate lines). 

~!  invoke an interactive shell on the local system. 

~!cmd ...  run the command on the local system (via sh −c). 

~$cmd ...  run the command locally and send its output to the remote system. 

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

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

~: during an output diversion, this toggles whether the operation of cu_v7m will be silent, that is, whether information received from the remote system will be written to the standard output.  This allows a  "progress report" during long transfers. 

~~... send the line ’~...’.

Both the send and receive processes handle output diversions of the following form:

~>[>][:]file
zero or more lines to be written to file
~>

Output is diverted, or appended if “>>” used, to the file.  If “:” is used, the diversion is silent, that is, 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. 

The use of ~%put requires stty and 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. 

The use of ~%take requires the existence of echo and tee on the remote system.  Also, stty tabs mode is required on the remote system if tabs are to be copied without expansion. 

The custat_v7m command shows the status of all auto call units and communications lines. This enables the users of cu to more easily select an available ACU or line. 

RESTRICTIONS

The syntax is unique. 
A ~%put cannot be aborted by typing the interrupt character, ~. will stop the transfer and disconnect the line.
When typing lines that begin with “~”, erase and kill processing do not function properly, that is, the characters are deleted but still remain on the screen.
The lack of proper flow control causes file transfers at speeds of greater than 1200 BPS to be unreliable, depending on the amount of activity on the local and remote systems.

DIAGNOSTICS

Exit code is zero for normal exit, nonzero (various values) otherwise. 

FILES

/dev/cua[0-7]
/dev/cul[0-7]
/dev/null
/usr/spool/uucp/LCK..cu[al][0-7] - lock files
/usr/adm/culog - log file

SEE ALSO

tty(4)
ULTRIX-11 System Management Guide