


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



