Difference between revisions of "32v 1m cu"

From Computer History Wiki
Jump to: navigation, search
(New page: CU(1C) UNIX Programmer's Manual CU(1C) == NAME == cu - call UNIX == SYNOPSIS == cu telno [ -t ] [ -s speed ] [ -a acu ] [ -l line ] == DESCRIPTION...)
 
(DESCRIPTION)
 
(2 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
== NAME ==
 
== NAME ==
    cu - call UNIX
+
cu - call UNIX
  
 
== SYNOPSIS ==
 
== SYNOPSIS ==
    cu telno [ -t ] [ -s speed ] [ -a acu ] [ -l line ]
+
cu telno [ -t ] [ -s speed ] [ -a acu ] [ -l line ]
  
 
== DESCRIPTION ==
 
== DESCRIPTION ==
    _C_u calls up another UNIX system, a terminal, or possibly a
+
'''Cu''' calls up another UNIX system, a terminal, or possibly a
    non-UNIX system.  It manages an interactive conversation
+
non-UNIX system.  It manages an interactive conversation
    with possible transfers of text files.  _T_e_l_n_o is the tele-
+
with possible transfers of text files.  '''Telno''' is the telephone number, with minus signs at appropriate places for
    phone number, with minus signs at appropriate places for
+
delays.  The -t flag is used to dial out to a terminal.
    delays.  The -t flag is used to dial out to a terminal.
+
'''Speed''' gives the transmission speed (110, 134, 150, 300,
    _S_p_e_e_d gives the transmission speed (110, 134, 150, 300,
+
1200); 300 is the default value.
    1200); 300 is the default value.
 
  
    The -a and -l values may be used to specify pathnames for
+
The -a and -l values may be used to specify pathnames for
    the ACU and communications line devices.  They can be used
+
the ACU and communications line devices.  They can be used
    to override the following built-in choices:
+
to override the following built-in choices:
  
 
     -a /dev/cua0 -l /dev/cul0
 
     -a /dev/cua0 -l /dev/cul0
  
    After making the connection, _c_u runs as two processes: the
+
After making the connection, '''cu''' runs as two processes: the
    _s_e_n_d process reads the standard input and passes most of it
+
_s_e_n_d process reads the standard input and passes most of it
    to the remote system; the _r_e_c_e_i_v_e process reads from the
+
to the remote system; the '''receive''' process reads from the
    remote system and passes most data to the standard output.
+
remote system and passes most data to the standard output.
    Lines beginning with `~' have special meanings.
+
Lines beginning with `~' have special meanings.
  
    The _s_e_n_d process interprets the following:
+
The '''send''' process interprets the following:
  
    ~.                terminate the conversation.
+
~.                terminate the conversation.
    ~EOT              terminate the conversation
 
  
    ~<file            send the contents of _f_i_l_e to the remote
+
~EOT              terminate the conversation
                      system, as though typed at the terminal.
 
  
    ~!                invoke an interactive shell on the local
+
~<file            send the contents of '''file''' to the remote system, as though typed at the terminal.
                      system.
 
  
    ~!cmd ...        run the command on the local system (via
+
~!               invoke an interactive shell on the local system.
                      sh -c).
 
  
    ~$cmd ...        run the command locally and send its out-
+
~!cmd ...        run the command on the local system (via sh -c).
                      put to the remote system.
 
  
    ~%take from [to]  copy file `from' (on the remote system) to
+
~$cmd ...        run the command locally and send its output to the remote system.
                      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
+
~%take from [to] copy file `from' (on the remote system) to
                      `to' on remote system.  If `to' is omit-
+
file `to' on the local system.  If `to' is
                      ted, the `from' name is used both places.
+
omitted, the `from' name is used both
    ~~...            send the line `~...'.
+
places.
  
    The _r_e_c_e_i_v_e process handles output diversions of the follow-
+
~%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.
    ing form:
 
  
    ~>[>][:]file
+
~~...            send the line `~...'.
    zero or more lines to be written to file
 
    ~>
 
  
    In any case, output is diverted (or appended, if `>>' used)
+
The '''receive''' process handles output diversions of the following form:
    to the file.  If `:' is used, the diversion is _s_i_l_e_n_t, 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 _s_t_t_y and _c_a_t on the remote side.
+
~>[>][:]file
    It also requires that the current erase and kill characters
+
zero or more lines to be written to file
    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 _e_c_h_o and _t_e_e on
+
~>
    the remote system.  Also, stty tabs mode is required on the
+
In any case, output is diverted (or appended, if `>>' used)
    remote system if tabs are to be copied without expansion.
+
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 system if tabs are to be copied without expansion.
  
 
== FILES ==
 
== FILES ==
Line 86: Line 80:
  
 
== SEE ALSO ==
 
== SEE ALSO ==
    [[32v 4m dn|dn(4)]], [[32v 4m tty|tty(4)]]
+
[[32v 4m dn|dn(4)]], [[32v 4m tty|tty(4)]]
  
 
== DIAGNOSTICS ==
 
== DIAGNOSTICS ==
    Exit code is zero for normal exit, nonzero (various values)
+
Exit code is zero for normal exit, nonzero (various values) otherwise.
    otherwise.
 
  
 
== BUGS ==
 
== BUGS ==
    The syntax is unique.
+
The syntax is unique.
  
 
[[Category:32v man section 1]]
 
[[Category:32v man section 1]]

Latest revision as of 17:28, 12 August 2010

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


NAME

cu - call UNIX

SYNOPSIS

cu telno [ -t ] [ -s speed ] [ -a acu ] [ -l line ]

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); 300 is the default value.

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

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

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

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

The receive process 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 system if tabs are to be copied without expansion.

FILES

    /dev/cua0
    /dev/cul0
    /dev/null

SEE ALSO

dn(4), tty(4)

DIAGNOSTICS

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

BUGS

The syntax is unique.