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