BSD 4_3_Tahoe development

[unix-history] / usr / man / cat1 / tip.0

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



N\bNA\bAM\bME\bE
     tip, cu - 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 ] system-name
     t\bti\bip\bp [ -\b-v\bv ] [ -\b-_\bs_\bp_\be_\be_\bd ] phone-number
     c\bcu\bu phone-number [ -\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
     _\bT_\bi_\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 _\bt_\bi_\bp.	The _\bc_\bu
     interface is included for those people attached to the
     ``call UNIX'' command of version 7.  This manual page
     describes only _\bt_\bi_\bp.

     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:

     ~\b~^\b^D\bD ~\b~.\b.    Drop the connection and exit (you may still be
	       logged in on the remote machine).

     ~\b~c\bc  [_\bn_\ba_\bm_\be]
	       Change directory to name (no argument implies
	       change to your home directory).

     ~\b~!\b!        Escape to a shell (exiting the shell will return
	       you to tip).

     ~\b~>\b>        Copy file from local to remote.	_\bT_\bi_\bp prompts for
	       the name of a local file to transmit.

     ~\b~<\b<        Copy file from remote to local.	_\bT_\bi_\bp prompts first
	       for the name of the file to be sent, then for a
	       command to be executed on the remote machine.

     ~\b~p\bp _\bf_\br_\bo_\bm [ _\bt_\bo ]
	       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 _\bt_\bi_\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



Printed 7/9/88		   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 _\bt_\bi_\bp.

     ~\b~|\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 shell.

     ~\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 shell.

     ~\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 _\bt_\bi_\bp (only available with job control).

     ~\b~^\b^Y\bY       Stop only the ``local side'' of _\bt_\bi_\bp (only avail-
	       able with job control); the ``remote side'' of
	       _\bt_\bi_\bp, the side that displays output from the remote
	       host, is left running.

     ~\b~?\b?        Get a summary of the tilde escapes


     _\bT_\bi_\bp 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 _\br_\be_\bm_\bo_\bt_\be(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 _\bt_\bi_\bp establishes a connection it sends out a connection
     message to the remote system; the default value, if any, is
     defined in /etc/remote.

     When _\bt_\bi_\bp 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.

     _\bT_\bi_\bp 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
     _\bu_\bu_\bc_\bp(1C).



Printed 7/9/88		   May 5, 1986				2






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



     During file transfers _\bt_\bi_\bp 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 _\bt_\bi_\bp should synchronize with the remote system on
     the echo of each transmitted character.

     When _\bt_\bi_\bp must dial a phone number to connect to a system it
     will print various messages indicating its actions.  _\bT_\bi_\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

     _\bT_\bi_\bp maintains a set of _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs 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 _\bv_\bi(1) and _\bM_\ba_\bi_\bl(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 ._\bt_\bi_\bp_\br_\bc in one's home directory).  The -\b-v\bv
     option causes _\bt_\bi_\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 values.

     b\bbe\bea\bau\but\bti\bif\bfy\by
	  (bool) Discard unprintable characters when a session is
	  being scripted; abbreviated _\bb_\be.

     b\bba\bau\bud\bdr\bra\bat\bte\be
	  (num) The baud rate at which the connection was esta-
	  blished; abbreviated _\bb_\ba.

     d\bdi\bia\bal\blt\bti\bim\bme\beo\bou\but\bt



Printed 7/9/88		   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 _\bd_\bi_\ba_\bl.

     e\bec\bch\bho\boc\bch\bhe\bec\bck\bk
	  (bool) Synchronize with the remote host during file
	  transfer by waiting for the echo of the last character
	  transmitted; default is _\bo_\bf_\bf.

     e\beo\bof\bfr\bre\bea\bad\bd
	  (str) The set of characters which signify and end-of-
	  tranmission during a ~< file transfer command; abbrevi-
	  ated _\be_\bo_\bf_\br.

     e\beo\bof\bfw\bwr\bri\bit\bte\be
	  (str) The string sent to indicate end-of-transmission
	  during a ~> file transfer command; abbreviated _\be_\bo_\bf_\bw.

     e\beo\bol\bl
	  (str) The set of characters which indicate an end-of-
	  line.  _\bT_\bi_\bp will recognize escape characters only after
	  an end-of-line.

     e\bes\bsc\bca\bap\bpe\be
	  (char) The command prefix (escape) character; abbrevi-
	  ated _\be_\bs; default value is `~'.

     e\bex\bxc\bce\bep\bpt\bti\bio\bon\bns\bs
	  (str) The set of characters which should not be dis-
	  carded due to the beautification switch; abbreviated
	  _\be_\bx; default value is ``\t\n\f\b''.

     f\bfo\bor\brc\bce\be
	  (char) The character used to force literal data
	  transmission; abbreviated _\bf_\bo; default value is `^P'.

     f\bfr\bra\bam\bme\bes\bsi\biz\bze\be
	  (num) The amount of data (in bytes) to buffer between
	  file system writes when receiving files; abbreviated
	  _\bf_\br.

     h\bho\bos\bst\bt
	  (str) The name of the host to which you are connected;
	  abbreviated _\bh_\bo.

     p\bpr\bro\bom\bmp\bpt\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 char-
	  acter.



Printed 7/9/88		   May 5, 1986				4






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



     r\bra\bai\bis\bse\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 _\bt_\bi_\bp for
	  transmission to the remote machine.

     r\bra\bai\bis\bse\bec\bch\bha\bar\br
	  (char) The input character used to toggle upper case
	  mapping mode; abbreviated _\br_\bc; default value is `^A'.

     r\bre\bec\bco\bor\brd\bd
	  (str) The name of the file in which a session script is
	  recorded; abbreviated _\br_\be_\bc; default value is
	  ``tip.record''.

     s\bsc\bcr\bri\bip\bpt\bt
	  (bool) Session scripting mode; abbreviated _\bs_\bc; default
	  is _\bo_\bf_\bf.  When _\bs_\bc_\br_\bi_\bp_\bt is _\bt_\br_\bu_\be, _\bt_\bi_\bp will record every-
	  thing 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 exception to the nor-
	  mal beautification rules.

     t\bta\bab\bbe\bex\bxp\bpa\ban\bnd\bd
	  (bool) Expand tabs to spaces during file transfers;
	  abbreviated _\bt_\ba_\bb; default value is _\bf_\ba_\bl_\bs_\be.  Each tab is
	  expanded to 8 spaces.

     v\bve\ber\brb\bbo\bos\bse\be
	  (bool) Verbose mode; abbreviated _\bv_\be_\br_\bb; default is _\bt_\br_\bu_\be.
	  When verbose mode is enabled, _\bt_\bi_\bp prints messages while
	  dialing, shows the current number of lines transferred
	  during a file transfer operations, and more.

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

     H\bHO\bOM\bME\bE
	  (str) The home directory to use for the ~c command;
	  default value is taken from the environment.

F\bFI\bIL\bLE\bES\bS
     /etc/remote	      global system descriptions
     /etc/phones	      global phone number data base
     ${REMOTE}		      private system descriptions
     ${PHONES}		      private phone numbers
     ~/.tiprc		      initialization file.



Printed 7/9/88		   May 5, 1986				5






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



     /usr/spool/uucp/LCK..*   lock file to avoid conflicts with _\bu_\bu_\bc_\bp

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
     remote(5), phones(5)

B\bBU\bUG\bGS\bS
     The full set of variables is undocumented and should, prob-
     ably, be paired down.












































Printed 7/9/88		   May 5, 1986				6