CU16(1)                 GENIX Programmer's Manual                 CU16(1)



      NAME
           cu16 - remote terminal program

      SYNOPSIS
           cu16 [ -s [ -b ] 110 300 600 1200 2400 4800 9600 ]

      DESCRIPTION
           Cu16 opens a remote line as a terminal.  It talks to  a  tty  device
           connected  to  a  serial  port  on  another  system.   It manages an
           interactive conversation and echoes terminal input.  Cu16  uses  the
           value  of  the  DDTPORT environment variable to find which device to
           open as a remote line.

           The default transmission speed for the port is 9600  baud.   The  -s
           flag sets transmission speeds (110, 300, 600, 1200, 2400, 4800, 9600
           baud).  Cu16 does not support modems for dial-up connections.

           The -b flag specifies that nulls are to be turned into breaks.  This
           allows the break key and the ASCII NUL character (control-shift-@ on
           many terminals) to send a break.

           After making the connection, cu16 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.

           The send process interprets the following:

           ~.                terminate the conversation.
           ~EOT              terminate the conversation.

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

           ~^ Z              suspend the cu16 program.  Note that the control-Z
                             must be followed by a newline.

           ~#                sends a break.

           ~!                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



      Printed 11/16/83                                                        1

      CU16(1)                 GENIX Programmer's Manual                 CU16(1)



                             remote  system.   If  `to'  is omitted, the `from'
                             name is used both places.

           ~:                during an output diversion, this  toggles  whether
                             the  operation  of  cu16  will  be  silent,  i.e.,
                             whether information received from the remote  sys-
                             tem  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
           ~>

           In any case, output is diverted (or appended, if `>>' used)  to  the
           file.   If `:' is used, the diversion is 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.

           The use of ~%put requires stty and cat on the remote side.  It  also
           requires  that the erase and kill characters on the remote system be
           identical to the 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 sys-
           tem if tabs are to be copied without expansion.

      FILES
           /dev/tty??     the remote line to open

      SEE ALSO
            tty(4), stty(1)

      DIAGNOSTICS
           Exit code is zero for normal exit, nonzero otherwise.













      Printed 11/16/83                                                        2