CU(1C)                  GENIX Programmer's Manual                  CU(1C)



      NAME
           cu - call UNIX

      SYNOPSIS
           cu telno [ -t ] [ -n [ -s speed ] [ -l line ] [ -b ]

      DESCRIPTION
           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.  Telno is the telephone number, with  minus
           signs at appropriate places for delays.  The -t flag is used to dial
           out to a terminal.  Speed gives the transmission  speed  (110,  134,
           150, 300, 1200); 1200 is the default value.

           The -l value may be used to specify a pathname  for  the  communica-
           tions  line device.  It can be used to override the following built-
           in choice:

           -l /dev/ttyd0

           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
           -l /dev/ttydn.

           After making the connection, cu runs as two processes: the send pro-
           cess  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 cu process.  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



      Printed 11/16/83                                                        1

      CU(1C)                  GENIX Programmer's Manual                  CU(1C)



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

           ~~...             send the line `~...'.

           Both the send and receive processes handles 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  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 sys-
           tem if tabs are to be copied without expansion.

           Finally, the -b flag specifies that nulls  are  to  be  turned  into
           breaks.   This  allows  the  break key (and also control-shift-@) to
           send a break.

      FILES
           /dev/ttyd0                    default dialout line
           /dev/null
           /usr/spool/uucp/LCK..ttyd[0-7]

      SEE ALSO
           tty(4)

      DIAGNOSTICS
           Exit code is zero for normal exit, nonzero (various  values)  other-
           wise.




      Printed 11/16/83                                                        2

      CU(1C)                  GENIX Programmer's Manual                  CU(1C)



      BUGS
           Only mail(1) uses syntax anything like the syntax of cu.

           This version of cu expects the dialer and modem to be a Hayes Smart-
           Modem or SmartModem 1200.


















































      Printed 11/16/83                                                        3