TIP(1) UNIX Reference Manual TIP(1)
t
\bti
\bip
\bp, c
\bcu
\bu - 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 _
\bs_
\by_
\bs_
\bt_
\be_
\bm-_
\bn_
\ba_
\bm_
\be
t
\bti
\bip
\bp [-
\b-v
\bv] -
\b-_
\bs_
\bp_
\be_
\be_
\bd _
\bp_
\bh_
\bo_
\bn_
\be-_
\bn_
\bu_
\bm_
\bb_
\be_
\br
c
\bcu
\bu _
\bp_
\bh_
\bo_
\bn_
\be-_
\bn_
\bu_
\bm_
\bb_
\be_
\br [-
\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
T
\bTi
\bip
\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 t
\bti
\bip
\bp. The _
\bc_
\bu
interface is included for those people attached to the ``call UNIX'' com-
mand of version 7. This manual page describes only t
\bti
\bip
\bp.
-
\b-v
\bv Set verbose mode.
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:
Drop the connection and exit (you may still be logged in on the re-
~
\b~c
\bc [_
\bn_
\ba_
\bm_
\be]
Change directory to _
\bn_
\ba_
\bm_
\be (no argument implies change to your home
~
\b~!
\b! Escape to a shell (exiting the shell will return you to tip).
~
\b~>
\b> Copy file from local to remote. T
\bTi
\bip
\bp prompts for the name of a lo-
~
\b~<
\b< Copy file from remote to local. T
\bTi
\bip
\bp prompts first for the name of
the file to be sent, then for a command to be executed on the re-
~
\b~p
\bp _
\bf_
\br_
\bo_
\bm [_
\bt_
\bo]
Send a file to a remote UNIX host. The put command causes the
remote UNIX system to run the command string ``cat > 'to''', while
t
\bti
\bip
\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 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
\bti
\bip
\bp.
~
\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
~
\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
~
\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 t
\bti
\bip
\bp (only available with job control).
~
\b~^
\b^Y
\bY Stop only the ``local side'' of t
\bti
\bip
\bp (only available with job con-
trol); the ``remote side'' of t
\bti
\bip
\bp, the side that displays output
from the remote host, is left running.
~
\b~?
\b? Get a summary of the tilde escapes
T
\bTi
\bip
\bp uses the file /_
\be_
\bt_
\bc/_
\br_
\be_
\bm_
\bo_
\bt_
\be to find how to reach a particular system
and to find out how it should operate while talking to the system; refer
to remote(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
When t
\bti
\bip
\bp establishes a connection it sends out a connection message to
the remote system; the default value, if any, is defined in /_
\be_
\bt_
\bc/_
\br_
\be_
\bm_
\bo_
\bt_
\be
When t
\bti
\bip
\bp prompts for an argument (e.g. during setup of a file transfer)
the line typed may be edited with the standard erase and kill characters.
A null line in response to a prompt, or an interrupt, will abort the di-
alogue and return you to the remote machine.
T
\bTi
\bip
\bp guards against multiple users connecting to a remote system by open-
ing modems and terminal lines with exclusive access, and by honoring the
locking protocol used by uucp(1).
During file transfers t
\bti
\bip
\bp provides a running count of the number of lines
transferred. When using the ~> and ~< commands, 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 normal-
ly depend on tandem mode for flow control. If the remote system does not
support tandem mode, ``echocheck'' may be set to indicate t
\bti
\bip
\bp should syn-
chronize with the remote system on the echo of each transmitted charac-
When t
\bti
\bip
\bp must dial a phone number to connect to a system it will print
various messages indicating its actions. T
\bTi
\bip
\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
T
\bTi
\bip
\bp maintains a set of _
\bv_
\ba_
\br_
\bi_
\ba_
\bb_
\bl_
\be_
\bs which control its operation. 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 syntax for variables is patterned after vi(1) and
Mail(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 ex-
ample ``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 con-
catenating 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'' prefix in a file ._
\bt_
\bi_
\bp_
\br_
\bc in one's
home directory). The -
\b-v
\bv option causes t
\bti
\bip
\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
_
\bb_
\be_
\ba_
\bu_
\bt_
\bi_
\bf_
\by (bool) Discard unprintable characters when a session is being
scripted; abbreviated _
\bb_
\be.
_
\bb_
\ba_
\bu_
\bd_
\br_
\ba_
\bt_
\be (num) The baud rate at which the connection was established;
_
\bd_
\bi_
\ba_
\bl_
\bt_
\bi_
\bm_
\be_
\bo_
\bu_
\bt
(num) When dialing a phone number, the time (in seconds) to
wait for a connection to be established; abbreviated _
\bd_
\bi_
\ba_
\bl.
_
\be_
\bc_
\bh_
\bo_
\bc_
\bh_
\be_
\bc_
\bk (bool) Synchronize with the remote host during file transfer
by waiting for the echo of the last character transmitted;
_
\be_
\bo_
\bf_
\br_
\be_
\ba_
\bd (str) The set of characters which signify and end-of-
tranmission during a ~< file transfer command; abbreviated
_
\be_
\bo_
\bf_
\bw_
\br_
\bi_
\bt_
\be (str) The string sent to indicate end-of-transmission during
a ~> file transfer command; abbreviated _
\be_
\bo_
\bf_
\bw.
_
\be_
\bo_
\bl (str) The set of characters which indicate an end-of-line.
T
\bTi
\bip
\bp will recognize escape characters only after an end-of-
_
\be_
\bs_
\bc_
\ba_
\bp_
\be (char) The command prefix (escape) character; abbreviated _
\be_
\bs;
_
\be_
\bx_
\bc_
\be_
\bp_
\bt_
\bi_
\bo_
\bn_
\bs
(str) The set of characters which should not be discarded due
to the beautification switch; abbreviated _
\be_
\bx; default value
_
\bf_
\bo_
\br_
\bc_
\be (char) The character used to force literal data transmission;
abbreviated _
\bf_
\bo; default value is `^P'.
_
\bf_
\br_
\ba_
\bm_
\be_
\bs_
\bi_
\bz_
\be (num) The amount of data (in bytes) to buffer between file
system writes when receiving files; abbreviated _
\bf_
\br.
_
\bh_
\bo_
\bs_
\bt (str) The name of the host to which you are connected; abbre-
_
\bp_
\br_
\bo_
\bm_
\bp_
\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 character.
_
\br_
\ba_
\bi_
\bs_
\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 t
\bti
\bip
\bp for transmission to the
_
\br_
\ba_
\bi_
\bs_
\be_
\bc_
\bh_
\ba_
\br (char) The input character used to toggle upper case mapping
mode; abbreviated _
\br_
\bc; default value is `^A'.
_
\br_
\be_
\bc_
\bo_
\br_
\bd (str) The name of the file in which a session script is
recorded; abbreviated _
\br_
\be_
\bc; default value is ``tip.record''.
_
\bs_
\bc_
\br_
\bi_
\bp_
\bt (bool) Session scripting mode; abbreviated _
\bs_
\bc; default is
_
\bo_
\bf_
\bf. When _
\bs_
\bc_
\br_
\bi_
\bp_
\bt is true, t
\bti
\bip
\bp will record everything
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 excep-
tion to the normal beautification rules.
_
\bt_
\ba_
\bb_
\be_
\bx_
\bp_
\ba_
\bn_
\bd (bool) Expand tabs to spaces during file transfers; abbrevi-
ated _
\bt_
\ba_
\bb; default value is _
\bf_
\ba_
\bl_
\bs_
\be. Each tab is expanded to 8
_
\bv_
\be_
\br_
\bb_
\bo_
\bs_
\be (bool) Verbose mode; abbreviated _
\bv_
\be_
\br_
\bb; default is _
\bt_
\br_
\bu_
\be. When
verbose mode is enabled, t
\bti
\bip
\bp prints messages while dialing,
shows the current number of lines transferred during a file
transfer operations, and more.
E
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT
T
\bTi
\bip
\bp uses the following environment variables:
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.
HOST Check for a default host if none specified.
The variables ${REMOTE} and ${PHONES} are also exported.
/_
\be_
\bt_
\bc/_
\br_
\be_
\bm_
\bo_
\bt_
\be global system descriptions
/_
\be_
\bt_
\bc/_
\bp_
\bh_
\bo_
\bn_
\be_
\bs global phone number data base
${REMOTE} private system descriptions
${PHONES} private phone numbers
~/.tiprc initialization file.
_
\bt_
\bi_
\bp._
\br_
\be_
\bc_
\bo_
\br_
\bd record file
/var/log/aculog line access log
/_
\bv_
\ba_
\br/_
\bs_
\bp_
\bo_
\bo_
\bl/_
\bu_
\bu_
\bc_
\bp/_
\bL_
\bC_
\bK..* lock file to avoid conflicts with uucp
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
H
\bHI
\bIS
\bST
\bTO
\bOR
\bRY
\bY
T
\bTi
\bip
\bp appeared in 4.2 BSD.
The full set of variables is undocumented and should, probably, be paired