projects / unix-history / blob
? search:
summary | tags | clone url | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
BSD 4_3_Tahoe development
[unix-history] / usr / man / cat1 / cu.0
TIP(1C) UNIX Programmer's Manual TIP(1C)
N\bNA\bAM\bME\bE
tip, cu - connect to a remote system
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
t\bti\bip\bp [ -\b-v\bv ] [ -\b-_\bs_\bp_\be_\be_\bd ] system-name
t\bti\bip\bp [ -\b-v\bv ] [ -\b-_\bs_\bp_\be_\be_\bd ] phone-number
c\bcu\bu phone-number [ -\b-t\bt ] [ -\b-s\bs _\bs_\bp_\be_\be_\bd ] [ -\b-a\ba _\ba_\bc_\bu ] [ -\b-l\bl _\bl_\bi_\bn_\be ]
[ -\b-#\b# ]
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
_\bT_\bi_\bp and _\bc_\bu 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 _\bt_\bi_\bp. The _\bc_\bu
interface is included for those people attached to the
``call UNIX'' command of version 7. This manual page
describes only _\bt_\bi_\bp.
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:
~\b~^\b^D\bD ~\b~.\b. Drop the connection and exit (you may still be
logged in on the remote machine).
~\b~c\bc [_\bn_\ba_\bm_\be]
Change directory to name (no argument implies
change to your home directory).
~\b~!\b! Escape to a shell (exiting the shell will return
you to tip).
~\b~>\b> Copy file from local to remote. _\bT_\bi_\bp prompts for
the name of a local file to transmit.
~\b~<\b< Copy file from remote to local. _\bT_\bi_\bp prompts first
for the name of the file to be sent, then for a
command to be executed on the remote machine.
~\b~p\bp _\bf_\br_\bo_\bm [ _\bt_\bo ]
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 _\bt_\bi_\bp 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.
~\b~t\bt _\bf_\br_\bo_\bm [ _\bt_\bo ]
Take a file from a remote UNIX host. As in the put
Printed 7/9/88 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 _\bt_\bi_\bp.
~\b~|\b| 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.
~\b~$\b$ 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.
~\b~#\b# Send a BREAK to the remote system. For systems
which don't support the necessary _\bi_\bo_\bc_\bt_\bl call the
break is simulated by a sequence of line speed
changes and DEL characters.
~\b~s\bs Set a variable (see the discussion below).
~\b~^\b^Z\bZ Stop _\bt_\bi_\bp (only available with job control).
~\b~^\b^Y\bY Stop only the ``local side'' of _\bt_\bi_\bp (only avail-
able with job control); the ``remote side'' of
_\bt_\bi_\bp, the side that displays output from the remote
host, is left running.
~\b~?\b? Get a summary of the tilde escapes
_\bT_\bi_\bp 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 _\br_\be_\bm_\bo_\bt_\be(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 _\bt_\bi_\bp establishes a connection it sends out a connection
message to the remote system; the default value, if any, is
defined in /etc/remote.
When _\bt_\bi_\bp 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.
_\bT_\bi_\bp 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
_\bu_\bu_\bc_\bp(1C).
Printed 7/9/88 May 5, 1986 2
TIP(1C) UNIX Programmer's Manual TIP(1C)
During file transfers _\bt_\bi_\bp 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 _\bt_\bi_\bp should synchronize with the remote system on
the echo of each transmitted character.
When _\bt_\bi_\bp must dial a phone number to connect to a system it
will print various messages indicating its actions. _\bT_\bi_\bp
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.
V\bVA\bAR\bRI\bIA\bAB\bBL\bLE\bES\bS
_\bT_\bi_\bp maintains a set of _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs 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 _\bv_\bi(1) and _\bM_\ba_\bi_\bl(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 ._\bt_\bi_\bp_\br_\bc in one's home directory). The -\b-v\bv
option causes _\bt_\bi_\bp 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.
b\bbe\bea\bau\but\bti\bif\bfy\by
(bool) Discard unprintable characters when a session is
being scripted; abbreviated _\bb_\be.
b\bba\bau\bud\bdr\bra\bat\bte\be
(num) The baud rate at which the connection was esta-
blished; abbreviated _\bb_\ba.
d\bdi\bia\bal\blt\bti\bim\bme\beo\bou\but\bt
Printed 7/9/88 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 _\bd_\bi_\ba_\bl.
e\bec\bch\bho\boc\bch\bhe\bec\bck\bk
(bool) Synchronize with the remote host during file
transfer by waiting for the echo of the last character
transmitted; default is _\bo_\bf_\bf.
e\beo\bof\bfr\bre\bea\bad\bd
(str) The set of characters which signify and end-of-
tranmission during a ~< file transfer command; abbrevi-
ated _\be_\bo_\bf_\br.
e\beo\bof\bfw\bwr\bri\bit\bte\be
(str) The string sent to indicate end-of-transmission
during a ~> file transfer command; abbreviated _\be_\bo_\bf_\bw.
e\beo\bol\bl
(str) The set of characters which indicate an end-of-
line. _\bT_\bi_\bp will recognize escape characters only after
an end-of-line.
e\bes\bsc\bca\bap\bpe\be
(char) The command prefix (escape) character; abbrevi-
ated _\be_\bs; default value is `~'.
e\bex\bxc\bce\bep\bpt\bti\bio\bon\bns\bs
(str) The set of characters which should not be dis-
carded due to the beautification switch; abbreviated
_\be_\bx; default value is ``\t\n\f\b''.
f\bfo\bor\brc\bce\be
(char) The character used to force literal data
transmission; abbreviated _\bf_\bo; default value is `^P'.
f\bfr\bra\bam\bme\bes\bsi\biz\bze\be
(num) The amount of data (in bytes) to buffer between
file system writes when receiving files; abbreviated
_\bf_\br.
h\bho\bos\bst\bt
(str) The name of the host to which you are connected;
abbreviated _\bh_\bo.
p\bpr\bro\bom\bmp\bpt\bt
(char) The character which indicates and end-of-line on
the remote host; abbreviated _\bp_\br; 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 7/9/88 May 5, 1986 4
TIP(1C) UNIX Programmer's Manual TIP(1C)
r\bra\bai\bis\bse\be
(bool) Upper case mapping mode; abbreviated _\br_\ba; default
value is _\bo_\bf_\bf. When this mode is enabled, all lower
case letters will be mapped to upper case by _\bt_\bi_\bp for
transmission to the remote machine.
r\bra\bai\bis\bse\bec\bch\bha\bar\br
(char) The input character used to toggle upper case
mapping mode; abbreviated _\br_\bc; default value is `^A'.
r\bre\bec\bco\bor\brd\bd
(str) The name of the file in which a session script is
recorded; abbreviated _\br_\be_\bc; default value is
``tip.record''.
s\bsc\bcr\bri\bip\bpt\bt
(bool) Session scripting mode; abbreviated _\bs_\bc; default
is _\bo_\bf_\bf. When _\bs_\bc_\br_\bi_\bp_\bt is _\bt_\br_\bu_\be, _\bt_\bi_\bp will record every-
thing transmitted by the remote machine in the script
record file specified in _\br_\be_\bc_\bo_\br_\bd. If the _\bb_\be_\ba_\bu_\bt_\bi_\bf_\by
switch is on, only printable ASCII characters will be
included in the script file (those characters betwee
040 and 0177). The variable _\be_\bx_\bc_\be_\bp_\bt_\bi_\bo_\bn_\bs is used to
indicate characters which are an exception to the nor-
mal beautification rules.
t\bta\bab\bbe\bex\bxp\bpa\ban\bnd\bd
(bool) Expand tabs to spaces during file transfers;
abbreviated _\bt_\ba_\bb; default value is _\bf_\ba_\bl_\bs_\be. Each tab is
expanded to 8 spaces.
v\bve\ber\brb\bbo\bos\bse\be
(bool) Verbose mode; abbreviated _\bv_\be_\br_\bb; default is _\bt_\br_\bu_\be.
When verbose mode is enabled, _\bt_\bi_\bp prints messages while
dialing, shows the current number of lines transferred
during a file transfer operations, and more.
S\bSH\bHE\bEL\bLL\bL
(str) The name of the shell to use for the ~! command;
default value is ``/bin/sh'', or taken from the
environment.
H\bHO\bOM\bME\bE
(str) The home directory to use for the ~c command;
default value is taken from the environment.
F\bFI\bIL\bLE\bES\bS
/etc/remote global system descriptions
/etc/phones global phone number data base
${REMOTE} private system descriptions
${PHONES} private phone numbers
~/.tiprc initialization file.
Printed 7/9/88 May 5, 1986 5
TIP(1C) UNIX Programmer's Manual TIP(1C)
/usr/spool/uucp/LCK..* lock file to avoid conflicts with _\bu_\bu_\bc_\bp
D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
Diagnostics are, hopefully, self explanatory.
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
remote(5), phones(5)
B\bBU\bUG\bGS\bS
The full set of variables is undocumented and should, prob-
ably, be paired down.
Printed 7/9/88 May 5, 1986 6
Continuous source code history from original PDP-7 UNIX to FreeBSD 2, the first fully unencumbered FreeBSD release.