2.11BSD/man/cat1/cu.0
TIP(1C) UNIX Programmer's Manual TIP(1C)
NAME
tip, cu - connect to a remote system
SYNOPSIS
tip [ -v ] [ -_s_p_e_e_d ] system-name
tip [ -v ] [ -_s_p_e_e_d ] phone-number
cu phone-number [ -t ] [ -s _s_p_e_e_d ] [ -a _a_c_u ] [ -l _l_i_n_e ]
[ -# ]
DESCRIPTION
_T_i_p and _c_u establish a full-duplex connection to another
machine, giving the appearance of being logged in directly
on the remote cpu. It goes without saying that you must
have a login on the machine (or equivalent) to which you
wish to connect. The preferred interface is _t_i_p. The _c_u
interface is included for those people attached to the
``call UNIX'' command of version 7. This manual page
describes only _t_i_p.
Typed characters are normally transmitted directly to the
remote machine (which does the echoing as well). A tilde
(`~') appearing as the first character of a line is an
escape signal; the following are recognized:
~^D ~. Drop the connection and exit (you may still be
logged in on the remote machine).
~c [_n_a_m_e]
Change directory to name (no argument implies
change to your home directory).
~! Escape to a shell (exiting the shell will return
you to tip).
~> Copy file from local to remote. _T_i_p prompts for
the name of a local file to transmit.
~< Copy file from remote to local. _T_i_p prompts first
for the name of the file to be sent, then for a
command to be executed on the remote machine.
~p _f_r_o_m [ _t_o ]
Send a file to a remote UNIX host. The put com-
mand causes the remote UNIX system to run the com-
mand string ``cat > 'to''', while _t_i_p sends it the
``from'' file. If the ``to'' file isn't specified
the ``from'' file name is used. This command is
actually a UNIX specific version of the ``~>''
command.
~t _f_r_o_m [ _t_o ]
Take a file from a remote UNIX host. As in the put
Printed 11/26/99 May 5, 1986 1
TIP(1C) UNIX Programmer's Manual TIP(1C)
command the ``to'' file defaults to the ``from''
file name if it isn't specified. The remote host
executes the command string ``cat 'from';echo ^A''
to send the file to _t_i_p.
~| Pipe the output from a remote command to a local
UNIX process. The command string sent to the
local UNIX system is processed by the shell.
~$ Pipe the output from a local UNIX process to the
remote host. The command string sent to the local
UNIX system is processed by the shell.
~# Send a BREAK to the remote system. For systems
which don't support the necessary _i_o_c_t_l call the
break is simulated by a sequence of line speed
changes and DEL characters.
~s Set a variable (see the discussion below).
~^Z Stop _t_i_p (only available with job control).
~^Y Stop only the ``local side'' of _t_i_p (only avail-
able with job control); the ``remote side'' of
_t_i_p, the side that displays output from the remote
host, is left running.
~? Get a summary of the tilde escapes
_T_i_p uses the file /etc/remote to find how to reach a partic-
ular system and to find out how it should operate while
talking to the system; refer to _r_e_m_o_t_e(5) for a full
description. Each system has a default baud rate with which
to establish a connection. If this value is not suitable,
the baud rate to be used may be specified on the command
line, e.g. ``tip -300 mds''.
When _t_i_p establishes a connection it sends out a connection
message to the remote system; the default value, if any, is
defined in /etc/remote.
When _t_i_p prompts for an argument (e.g. during setup of a
file transfer) the line typed may be edited with the stan-
dard erase and kill characters. A null line in response to
a prompt, or an interrupt, will abort the dialogue and
return you to the remote machine.
_T_i_p guards against multiple users connecting to a remote
system by opening modems and terminal lines with exclusive
access, and by honoring the locking protocol used by
_u_u_c_p(1C).
Printed 11/26/99 May 5, 1986 2
TIP(1C) UNIX Programmer's Manual TIP(1C)
During file transfers _t_i_p provides a running count of the
number of lines transferred. When using the ~> and ~< com-
mands, the ``eofread'' and ``eofwrite'' variables are used
to recognize end-of-file when reading, and specify end-of-
file when writing (see below). File transfers normally
depend on tandem mode for flow control. If the remote sys-
tem does not support tandem mode, ``echocheck'' may be set
to indicate _t_i_p should synchronize with the remote system on
the echo of each transmitted character.
When _t_i_p must dial a phone number to connect to a system it
will print various messages indicating its actions. _T_i_p
supports the DEC DN-11 and Racal-Vadic 831 auto-call-units;
the DEC DF02 and DF03, Ventel 212+, Racal-Vadic 3451, and
Bizcomp 1031 and 1032 integral call unit/modems.
VARIABLES
_T_i_p maintains a set of _v_a_r_i_a_b_l_e_s which control its opera-
tion. Some of these variable are read-only to normal users
(root is allowed to change anything of interest). Variables
may be displayed and set through the ``s'' escape. The syn-
tax for variables is patterned after _v_i(1) and _M_a_i_l(1).
Supplying ``all'' as an argument to the set command displays
all variables readable by the user. Alternatively, the user
may request display of a particular variable by attaching a
`?' to the end. For example ``escape?'' displays the
current escape character.
Variables are numeric, string, character, or boolean values.
Boolean variables are set merely by specifying their name;
they may be reset by prepending a `!' to the name. Other
variable types are set by concatenating an `=' and the
value. The entire assignment must not have any blanks in
it. A single set command may be used to interrogate as well
as set a number of variables. Variables may be initialized
at run time by placing set commands (without the ``~s'' pre-
fix in a file ._t_i_p_r_c in one's home directory). The -v
option causes _t_i_p to display the sets as they are made.
Certain common variables have abbreviations. The following
is a list of common variables, their abbreviations, and
their default values.
beautify
(bool) Discard unprintable characters when a session is
being scripted; abbreviated _b_e.
baudrate
(num) The baud rate at which the connection was esta-
blished; abbreviated _b_a.
dialtimeout
Printed 11/26/99 May 5, 1986 3
TIP(1C) UNIX Programmer's Manual TIP(1C)
(num) When dialing a phone number, the time (in
seconds) to wait for a connection to be established;
abbreviated _d_i_a_l.
echocheck
(bool) Synchronize with the remote host during file
transfer by waiting for the echo of the last character
transmitted; default is _o_f_f.
eofread
(str) The set of characters which signify and end-of-
tranmission during a ~< file transfer command; abbrevi-
ated _e_o_f_r.
eofwrite
(str) The string sent to indicate end-of-transmission
during a ~> file transfer command; abbreviated _e_o_f_w.
eol
(str) The set of characters which indicate an end-of-
line. _T_i_p will recognize escape characters only after
an end-of-line.
escape
(char) The command prefix (escape) character; abbrevi-
ated _e_s; default value is `~'.
exceptions
(str) The set of characters which should not be dis-
carded due to the beautification switch; abbreviated
_e_x; default value is ``\t\n\f\b''.
force
(char) The character used to force literal data
transmission; abbreviated _f_o; default value is `^P'.
framesize
(num) The amount of data (in bytes) to buffer between
file system writes when receiving files; abbreviated
_f_r.
host
(str) The name of the host to which you are connected;
abbreviated _h_o.
prompt
(char) The character which indicates and end-of-line on
the remote host; abbreviated _p_r; default value is `\n'.
This value is used to synchronize during data
transfers. The count of lines transferred during a
file transfer command is based on recipt of this char-
acter.
Printed 11/26/99 May 5, 1986 4
TIP(1C) UNIX Programmer's Manual TIP(1C)
raise
(bool) Upper case mapping mode; abbreviated _r_a; default
value is _o_f_f. When this mode is enabled, all lower
case letters will be mapped to upper case by _t_i_p for
transmission to the remote machine.
raisechar
(char) The input character used to toggle upper case
mapping mode; abbreviated _r_c; default value is `^A'.
record
(str) The name of the file in which a session script is
recorded; abbreviated _r_e_c; default value is
``tip.record''.
script
(bool) Session scripting mode; abbreviated _s_c; default
is _o_f_f. When _s_c_r_i_p_t is _t_r_u_e, _t_i_p will record every-
thing transmitted by the remote machine in the script
record file specified in _r_e_c_o_r_d. If the _b_e_a_u_t_i_f_y
switch is on, only printable ASCII characters will be
included in the script file (those characters betwee
040 and 0177). The variable _e_x_c_e_p_t_i_o_n_s is used to
indicate characters which are an exception to the nor-
mal beautification rules.
tabexpand
(bool) Expand tabs to spaces during file transfers;
abbreviated _t_a_b; default value is _f_a_l_s_e. Each tab is
expanded to 8 spaces.
verbose
(bool) Verbose mode; abbreviated _v_e_r_b; default is _t_r_u_e.
When verbose mode is enabled, _t_i_p prints messages while
dialing, shows the current number of lines transferred
during a file transfer operations, and more.
SHELL
(str) The name of the shell to use for the ~! command;
default value is ``/bin/sh'', or taken from the
environment.
HOME
(str) The home directory to use for the ~c command;
default value is taken from the environment.
FILES
/etc/remote global system descriptions
/etc/phones global phone number data base
${REMOTE} private system descriptions
${PHONES} private phone numbers
~/.tiprc initialization file.
Printed 11/26/99 May 5, 1986 5
TIP(1C) UNIX Programmer's Manual TIP(1C)
/usr/spool/uucp/LCK..* lock file to avoid conflicts with _u_u_c_p
DIAGNOSTICS
Diagnostics are, hopefully, self explanatory.
SEE ALSO
remote(5), phones(5)
BUGS
The full set of variables is undocumented and should, prob-
ably, be paired down.
Printed 11/26/99 May 5, 1986 6