[0m


TIP(1C)             UNIX Programmer's Manual		  TIP(1C)



[1mNAME
     [0mtip, cu - connect to a remote system

[1mSYNOPSIS
     tip [0m[ [1m-v [0m] [ [1m-[0m_s_p_e_e_d ] system-name
     [1mtip [0m[ [1m-v [0m] [ [1m-[0m_s_p_e_e_d ] phone-number
     [1mcu [0mphone-number [ [1m-t [0m] [ [1m-s [0m_s_p_e_e_d ] [  [1m-a [0m_a_c_u ] [ [1m-l [0m_l_i_n_e ]
     [ [1m-# [0m]

[1mDESCRIPTION
     [0m_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:

     [1m~^D ~.    [0mDrop the connection and exit (you may still be
	       logged in on the remote machine).

     [1m~c  [0m[_n_a_m_e]
	       Change directory to name (no argument implies
	       change to your home directory).

     [1m~!        [0mEscape to a shell (exiting the shell will return
	       you to tip).

     [1m~>        [0mCopy file from local to remote.	_T_i_p prompts for
	       the name of a local file to transmit.

     [1m~<        [0mCopy 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.

     [1m~p [0m_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.

     [1m~t [0m_f_r_o_m [ _t_o ]
	       Take a file from a remote UNIX host. As in the put



Printed 27/11/91    Revision 1.4 of 23/11/90			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.

     [1m~|        [0mPipe 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.

     [1m~$        [0mPipe 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.

     [1m~#        [0mSend 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.

     [1m~s        [0mSet a variable (see the discussion below).

     [1m~^Z       [0mStop _t_i_p (only available with job control).

     [1m~^Y       [0mStop 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.

     [1m~?        [0mGet 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. If the `[1mtip [0mphone-number' variant of
     the command is used then _t_i_p will look for an entry in
     /etc/remote with a name [1mtip[0m_s_p_e_e_d where _s_p_e_e_d is the baud
     rate (default 300) specified.  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.





Printed 27/11/91    Revision 1.4 of 23/11/90			2






TIP(1C)             UNIX Programmer's Manual		  TIP(1C)



     _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).

     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 autodialing using `Hayes' compatible modems. Two
     type of dialling are supported: Pulse (by far the commonest
     technique in the UK) and Tone (used by many modern
     exchanges, particularly PABXs) selected by using the follow-
     ing names for the _a_t field in /_e_t_c/_r_e_m_o_t_e:

     [1mhayesp    [0mUse pulse dialling.

     [1mhayest    [0mUse tone dialling.

     [1mhayes     [0ma synonym for [1mhayesp[0m.

     [1mVARIABLES

     [0m_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 [1m-v
     [0moption causes _t_i_p to display the sets as they are made.



Printed 27/11/91    Revision 1.4 of 23/11/90			3






TIP(1C)             UNIX Programmer's Manual		  TIP(1C)



     Certain common variables have abbreviations. The following
     is a list of common variables, their abbreviations, and
     their default values.

     [1mbeautify
	  [0m(bool) Discard unprintable characters when a session is
	  being scripted; abbreviated _b_e.

     [1mbaudrate
	  [0m(num) The baud rate at which the connection was esta-
	  blished; abbreviated _b_a.

     [1mdialtimeout
	  [0m(num) When dialing a phone number, the time (in
	  seconds) to wait for a connection to be established;
	  abbreviated _d_i_a_l.

     [1mechocheck
	  [0m(bool) Synchronize with the remote host during file
	  transfer by waiting for the echo of the last character
	  transmitted; default is _o_f_f.

     [1meofread
	  [0m(str) The set of characters which signify and end-of-
	  tranmission during a ~< file transfer command; abbrevi-
	  ated _e_o_f_r.

     [1meofwrite
	  [0m(str) The string sent to indicate end-of-transmission
	  during a ~> file transfer command; abbreviated _e_o_f_w.

     [1meol
	  [0m(str) The set of characters which indicate an end-of-
	  line.  _T_i_p will recognize escape characters only after
	  an end-of-line.

     [1mescape
	  [0m(char) The command prefix (escape) character; abbrevi-
	  ated _e_s; default value is `~'.

     [1mexceptions
	  [0m(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''.

     [1mforce
	  [0m(char) The character used to force literal data
	  transmission; abbreviated _f_o; default value is `^P'.

     [1mframesize
	  [0m(num) The amount of data (in bytes) to buffer between
	  file system writes when receiving files; abbreviated



Printed 27/11/91    Revision 1.4 of 23/11/90			4






TIP(1C)             UNIX Programmer's Manual		  TIP(1C)



	  _f_r; limited to 1024. Larger values will not be used.

     [1mhost
	  [0m(str) The name of the host to which you are connected;
	  abbreviated _h_o.

     [1mprompt
	  [0m(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.

     [1mraise
	  [0m(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.

     [1mraisechar
	  [0m(char) The input character used to toggle upper case
	  mapping mode; abbreviated _r_c; default value is `^A'.

     [1mrecord
	  [0m(str) The name of the file in which a session script is
	  recorded; abbreviated _r_e_c; default value is
	  ``tip.record''.

     [1mscript
	  [0m(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.

     [1mtabexpand
	  [0m(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.

     [1mverbose
	  [0m(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.

     [1mSHELL



[0mPrinted 27/11/91    Revision 1.4 of 23/11/90			5






TIP(1C)             UNIX Programmer's Manual		  TIP(1C)



	  (str) The name of the shell to use for the ~! command;
	  default value is ``/bin/sh'', or taken from the
	  environment.

     [1mHOME
	  [0m(str) The home directory to use for the ~c command;
	  default value is taken from the environment.

[1mFILES
     [0m/etc/remote	      global system descriptions
     /etc/phones	      global phone number data base
     ${REMOTE}		      private system descriptions
     ${PHONES}		      private phone numbers
     ~/.tiprc		      initialization file.
     /usr/spool/uucp/LCK..*   lock file to avoid conflicts with _u_u_c_p

[1mDIAGNOSTICS
     [0mDiagnostics are, hopefully, self explanatory.

[1mSEE ALSO
     [0mremote(5), phones(5)

[1mBUGS
     [0mThe full set of variables is undocumented and should, prob-
     ably, be paired down.






























Printed 27/11/91    Revision 1.4 of 23/11/90			6



[0m