User Commands tip(1)
NAME
tip - connect to remote system
SYNOPSIS
tip [-v] [-speed-entry] {hostname | phone-number | device}
DESCRIPTION
The tip utility establishes a full-duplex terminal connec-
tion to a remote host. Once the connection is established, a
remote session using tip behaves like an interactive ses-
sion on a local terminal.
The remote file contains entries describing remote systems
and line speeds used by tip.
Each host has a default baud rate for the connection, or you
can specify a speed with the -speed-entry command line argu-
ment.
When phone-number is specified, tip looks for an entry in
the remote file of the form:
tip -speed-entry
When tip finds such an entry, it sets the connection speed
accordingly. If it finds no such entry, tip interprets
-speed-entry as if it were a system name, resulting in an
error message.
If you omit -speed-entry, tip uses the tip0 entry to set a
speed for the connection.
When device is specified, tip attempts to open that device,
but will do so using the access privileges of the user,
rather than tip's usual access privileges (setuid uucp). The
user must have read/write access to the device. The tip
utility interprets any character string beginning with the
slash character (/) as a device name.
When establishing the connection, tip sends a connection
message to the remote system. The default value for this
message can be found in the remote file.
When tip attempts to connect to a remote system, it opens
the associated device with an exclusive-open ioctl(2) call.
Thus, only one user at a time may access a device. This is
to prevent multiple processes from sampling the terminal
line. In addition, tip honors the locking protocol used by
uucp(1C).
When tip starts up, it reads commands from the file .tiprc
in your home directory.
OPTIONS
-v Display commands from the .tiprc file as they are
executed.
USAGE
Typed characters are normally transmitted directly to the
remote machine, which does the echoing as well.
At any time that tip prompts for an argument (for example,
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, aborts the
dialogue and returns you to the remote machine.
Commands
A tilde (~) appearing as the first character of a line is an
escape signal which directs tip to perform some special
action. tip recognizes the following escape sequences:
~^D Drop the connection and exit (you may still
~. be logged in on the remote machine). Note:
If you rlogin and then run tip on the remote
host, you must type ~~. (tilde tilde dot) to
end the tip session. If you type ~. (tilde
dot), it terminates the rlogin.
~c [name] Change directory to name. No argument
implies change to your home directory.
~! Escape to an interactive shell on the local
machine. Exiting the shell returns you to
tip.
~> Copy file from local to remote.
~< Copy file from remote to local.
~p from [ to ] Send a file to a remote host running the
UNIX system. When you use the put command,
the remote system runs the command string
cat > to
while tip sends it the from file. If the to
file is not specified, the from file name is
used. This command is actually a UNIX-
system-specific version of the `~>' command.
~t from [ to ] Take a file from a remote host running the
UNIX system. As in the put command the to
file defaults to the from file name if it is
not specified. The remote host executes the
command string
cat from; echo ^A
to send the file to tip.
~| Pipe the output from a remote command to a
local process. The command string sent to
the local system is processed by the shell.
~C Connect a program to the remote machine. The
command string sent to the program is pro-
cessed by the shell. The program inherits
file descriptors 0 as remote line input, 1
as remote line output, and 2 as tty standard
error.
~$ Pipe the output from a local process to the
remote host. The command string sent to the
local system is processed by the shell.
~# Send a BREAK to the remote system.
~s Set a variable (see the discussion below).
~^Z Stop tip. Only available when run under a
shell that supports job control, such as the
C shell.
~^Y Stop only the "local side" of tip. Only
available when run under a shell that sup-
ports job control, such as the C shell. The
"remote side" of tip, that is, the side that
displays output from the remote host, is
left running.
~? Get a summary of the tilde escapes.
Copying files requires some cooperation on the part of the
remote host. When a ~> or ~< escape is used to send a file,
tip prompts for a file name (to be transmitted or received)
and a command to be sent to the remote system, in case the
file is being transferred from the remote system. While tip
is transferring a file, the number of lines transferred will
be continuously displayed on the screen. A file transfer may
be aborted with an interrupt.
Auto-call Units
tip may be used to dial up remote systems using a number of
auto-call unit's (ACUs). When the remote system description
contains the du capability, tip uses the call-unit (cu), ACU
type (at), and phone numbers (pn) supplied. Normally, tip
displays verbose messages as it dials.
Depending on the type of auto-dialer being used to establish
a connection, the remote host may have garbage characters
sent to it upon connection. The user should never assume
that the first characters typed to the foreign host are the
first ones presented to it. The recommended practice is to
immediately type a kill character upon establishing a con-
nection (most UNIX systems either support @ or Control-U as
the initial kill character).
tip currently supports the Ventel MD-212+ modem and DC
Hayes-compatible modems.
When tip initializes a Hayes-compatible modem for dialing,
it sets up the modem to auto-answer. Normally, after the
conversation is complete, tip drops DTR, which causes the
modem to "hang up."
Most modems can be configured so that when DTR drops, they
re-initialize themselves to a preprogrammed state. This can
be used to reset the modem and disable auto-answer, if
desired.
Additionally, it is possible to start the phone number with
a Hayes S command so that you can configure the modem before
dialing. For example, to disable auto-answer, set up all the
phone numbers in /etc/remote using something like
pn=S0=0DT5551212. The S0=0 disables auto-answer.
Remote Host Description
Descriptions of remote hosts are normally located in the
system-wide file /etc/remote. However, a user may maintain
personal description files (and phone numbers) by defining
and exporting the REMOTE shell variable. The remote file
must be readable by tip, but a secondary file describing
phone numbers may be maintained readable only by the user.
This secondary phone number file is /etc/phones, unless the
shell variable PHONES is defined and exported. The phone
number file contains lines of the form:
system-name phone-number
Each phone number found for a system is tried until either a
connection is established, or an end of file is reached.
Phone numbers are constructed from `0123456789-=*', where
the `=' and `*' are used to indicate a second dial tone
should be waited for (ACU dependent).
tip Internal Variables
tip maintains a set of variables which are used in normal
operation. Some of these variables 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 ~s escape
displays all variables that the user can read. Alterna-
tively, the user may request display of a particular vari-
able by attaching a ? to the end. For example, `~s escape?'
displays the current escape character.
Variables are numeric (num), string (str), character (char),
or Boolean (bool) 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 appending an
= and the value. The entire assignment must not have any
blanks in it. A single set command may be used to interro-
gate as well as set a number of variables.
Variables may be initialized at run time by placing set com-
mands (without the ~s prefix) in a .tiprc file in one's home
directory. The -v option makes tip display the sets as they
are made. Comments preceded by a # sign can appear in the
.tiprc file.
Finally, the variable names must either be completely speci-
fied or an abbreviation may be given. The following list
details those variables known to tip.
beautify (bool) Discard unprintable characters when a
session is being scripted; abbreviated be.
If the nb capability is present, beautify is
initially set to off. Otherwise, beautify is
initially set to on.
baudrate (num) The baud rate at which the connection
was established; abbreviated ba. If a baud
rate was specified on the command line, bau-
drate is initially set to the specified
value. Or, if the br capability is present,
baudrate is initially set to the value of
that capability. Otherwise, baudrate is set
to 300 baud. Once tip has been started, bau-
drate can only changed by the super-user.
dialtimeout (num) When dialing a phone number, the time
(in seconds) to wait for a connection to be
established; abbreviated dial. dialtimeout
is initially set to 60 seconds, and can only
changed by the super-user.
disconnect (str) The string to send to the remote host
to disconnect from it; abbreviated di. If
the di capability is present, disconnect is
initially set to the value of that capabil-
ity. Otherwise, disconnect is set to a null
string ("").
echocheck (bool) Synchronize with the remote host dur-
ing file transfer by waiting for the echo of
the last character transmitted; abbreviated
ec. If the ec capability is present, echo-
check is initially set to on. Otherwise,
echocheck is initially set to off.
eofread (str) The set of characters which signify an
end-of-transmission during a ~< file
transfer command; abbreviated eofr. If the
ie capability is present, eofread is ini-
tially set to the value of that capability.
Otherwise, eofread is set to a null string
("").
eofwrite (str) The string sent to indicate end-of-
transmission during a ~> file transfer com-
mand; abbreviated eofw. If the oe capability
is present, eofread is initially set to the
value of that capability. Otherwise, eofread
is set to a null string ("").
eol (str) The set of characters which indicate
an end-of-line. tip will recognize escape
characters only after an end-of-line. If the
el capability is present, eol is initially
set to the value of that capability. Other-
wise, eol is set to a null string ("").
escape (char) The command prefix (escape) charac-
ter; abbreviated es. If the es capability is
present, escape is initially set to the
value of that capability. Otherwise, escape
is set to `~'.
etimeout (num) The amount of time, in seconds, that
tip should wait for the echo-check response
when echocheck is set; abbreviated et. If
the et capability is present, etimeout is
initially set to the value of that capabil-
ity. Otherwise, etimeout is set to 10
seconds.
exceptions (str) The set of characters which should not
be discarded due to the beautification
switch; abbreviated ex. If the ex capability
is present, exceptions is initially set to
the value of that capability. Otherwise,
exceptions is set to `\t\n\f\b'.
force (char) The character used to force literal
data transmission; abbreviated fo. If the fo
capability is present, force is initially
set to the value of that capability. Other-
wise, force is set to \377 (which disables
it).
framesize (num) The amount of data (in bytes) to
buffer between file system writes when
receiving files; abbreviated fr. If the fs
capability is present, framesize is ini-
tially set to the value of that capability.
Otherwise, framesize is set to 1024.
halfduplex (bool) Do local echoing because the host is
half-duplex; abbreviated hdx. If the hd
capability is present, halfduplex is ini-
tially set to on. Otherwise, halfduplex is
initially set to off.
hardwareflow (bool) Do hardware flow control; abbreviated
hf. If the hf capability is present,
hardwareflow is initially set to on. Other-
wise, hardwareflowcontrol is initially set
to off.
host (str) The name of the host to which you are
connected; abbreviated ho. host is per-
manently set to the name given on the com-
mand line or in the HOST environment vari-
able.
localecho (bool) A synonym for halfduplex; abbreviated
le.
log (str) The name of the file to which to log
information about outgoing phone calls. log
is initially set to /var/adm/aculog, and can
only be inspected or changed by the super-
user.
parity (str) The parity to be generated and checked
when talking to the remote host; abbreviated
par. The possible values are:
none> Parity is not checked on input, and
zero the parity bit is set to zero on
output.
one Parity is not checked on input, and
the parity bit is set to one on
output.
even Even parity is checked for on input
and generated on output.
odd Odd parity is checked for on input
and generated on output.
If the pa capability is present, parity is
initially set to the value of that capabil-
ity; otherwise, parity is set to none.
phones The file in which to find hidden phone
numbers. If the environment variable PHONES
is set, phones is set to the value of
PHONES. Otherwise, phones is set to
/etc/phones. The value of phones cannot be
changed from within tip.
prompt (char) The character which indicates an
end-of-line on the remote host; abbreviated
pr. This value is used to synchronize during
data transfers. The count of lines
transferred during a file transfer command
is based on receipt of this character. If
the pr capability is present, prompt is ini-
tially set to the value of that capability.
Otherwise, prompt is set to \n.
raise (bool) Upper case mapping mode; abbreviated
ra. When this mode is enabled, all lower
case letters will be mapped to upper case by
tip for transmission to the remote machine.
If the ra capability is present, raise is
initially set to on. Otherwise, raise is
initially set to off.
raisechar (char) The input character used to toggle
upper case mapping mode; abbreviated rc. If
the rc capability is present, raisechar is
initially set to the value of that capabil-
ity. Otherwise, raisechar is set to \377
(which disables it).
rawftp (bool) Send all characters during file
transfers; do not filter non-printable char-
acters, and do not do translations like \n
to \r. Abbreviated raw. If the rw capability
is present, rawftp is initially set to on.
Otherwise, rawftp is initially set to off.
record (str) The name of the file in which a ses-
sion script is recorded; abbreviated rec. If
the re capability is present, record is ini-
tially set to the value of that capability.
Otherwise, record is set to tip.record.
remote The file in which to find descriptions of
remote systems. If the environment variable
REMOTE is set, remote is set to the value of
REMOTE. Otherwise, remote is set to
/etc/remote. The value of remote cannot be
changed from within tip.
script (bool) Session scripting mode; abbreviated
sc. When script is on, tip will record
everything transmitted by the remote machine
in the script record file specified in
record. If the beautify switch is on, only
printable ASCII characters will be included
in the script file (those characters between
040 and 0177). The variable exceptions is
used to indicate characters which are an
exception to the normal beautification
rules. If the sc capability is present,
script is initially set to on. Otherwise,
script is initially set to off.
tabexpand (bool) Expand TAB characters to SPACE char-
acters during file transfers; abbreviated
tab. When tabexpand is on, each tab is
expanded to eight SPACE characters. If the
tb capability is present, tabexpand is ini-
tially set to on. Otherwise, tabexpand is
initially set to off.
tandem (bool) Use XON/XOFF flow control to limit
the rate that data is sent by the remote
host; abbreviated ta. If the nt capability
is present, tandem is initially set to off.
Otherwise, tandem is initially set to on.
verbose (bool) Verbose mode; abbreviated verb; When
verbose mode is enabled, tip prints mes-
sages while dialing, shows the current
number of lines transferred during a file
transfer operations, and more. If the nv
capability is present, verbose is initially
set to off. Otherwise, verbose is initially
set to on.
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.
EXAMPLES
Example 1: Using the tip command
An example of the dialog used to transfer files is given
below.
arpa% tip monet
[connected]
...(assume we are talking to a UNIX system)...
ucbmonet login: sam
Password:
monet% cat sylvester.c
~> Filename: sylvester.c
32 lines transferred in 1 minute 3 seconds
monet%
monet% ~< Filename: reply.c
List command for remote host: cat reply.c
65 lines transferred in 2 minutes
monet%
...(or, equivalently)...
monet% ~p sylvester.c
...(actually echoes as ~[put] sylvester.c)...
32 lines transferred in 1 minute 3 seconds
monet%
monet% ~t reply.c
...(actually echoes as ~[take] reply.c)...
65 lines transferred in 2 minutes
monet%
...(to print a file locally)...
monet% ~|Local command: pr h sylvester.c | lpr
List command for remote host: cat sylvester.c
monet% ~^D
[EOT]
...(back on the local system)...
ENVIRONMENT VARIABLES
The following environment variables are read by tip.
REMOTE The location of the remote file.
PHONES The location of the file containing private phone
numbers.
HOST A default host to connect to.
HOME One's log-in directory (for chdirs).
SHELL The shell to fork on a `~!' escape.
FILES
/etc/phones
/etc/remote
/var/spool/locks/LCK..* lock file to avoid
conflicts with UUCP
/var/adm/aculog file in which outgo-
ing calls are logged
~/.tiprc initialization file
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
cu(1C), mail(1), uucp(1C), vi(1), ioctl(2), attributes( 5)
BUGS
There are two additional variables, chardelay and linedelay,
that are currently not implemented.
|
|