1TIP(1C)                                                                TIP(1C)
2
3
4

NAME

6       tip, cu - connect to a remote system
7

SYNOPSIS

9       tip [ -v ] [ -speed ] system-name
10       tip [ -v ] [ -speed ] phone-number
11       cu phone-number [ -t ] [ -s speed ] [  -a acu ] [ -l line ] [ -# ]
12

DESCRIPTION

14       Tip  and cu establish a full-duplex connection to another machine, giv‐
15       ing the appearance of being logged in directly on the remote  cpu.   It
16       goes  without  saying  that  you  must  have a login on the machine (or
17       equivalent) to which you wish to connect.  The preferred  interface  is
18       tip.   The  cu  interface  is included for those people attached to the
19       ``call UNIX'' command of version 7.  This manual  page  describes  only
20       tip.
21
22       Typed  characters  are  normally  transmitted  directly  to  the remote
23       machine (which does the echoing as well).  A tilde (`~')  appearing  as
24       the  first  character  of a line is an escape signal; the following are
25       recognized:
26
27       ~^D ~.    Drop the connection and exit (you may still be logged  in  on
28                 the remote machine).
29
30       ~c  [name]
31                 Change  directory to name (no argument implies change to your
32                 home directory).
33
34       ~!        Escape to a shell (exiting the shell will return you to tip).
35
36       ~>        Copy file from local to remote.  Tip prompts for the name  of
37                 a local file to transmit.
38
39       ~<        Copy  file  from  remote to local.  Tip prompts first for the
40                 name of the file to be sent, then for a command  to  be  exe‐
41                 cuted on the remote machine.
42
43       ~p from [ to ]
44                 Send  a  file  to a remote UNIX host.  The put command causes
45                 the remote UNIX system to run  the  command  string  ``cat  >
46                 'to''',  while tip sends it the ``from'' file.  If the ``to''
47                 file isn't specified the ``from'' file name  is  used.   This
48                 command  is  actually  a  UNIX specific version of the ``~>''
49                 command.
50
51       ~t from [ to ]
52                 Take a file from a remote UNIX host.  As in the  put  command
53                 the  ``to''  file  defaults  to  the ``from'' file name if it
54                 isn't specified.  The remote host executes the command string
55                 ``cat 'from';echo ^A'' to send the file to tip.
56
57       ~|        Pipe  the  output  from  a  remote  command  to  a local UNIX
58                 process.  The command string sent to the local UNIX system is
59                 processed by the shell.
60
61       ~$        Pipe the output from a local UNIX process to the remote host.
62                 The command string sent to the local UNIX system is processed
63                 by the shell.
64
65       ~#        Send  a  BREAK to the remote system.  For systems which don't
66                 support the necessary ioctl call the break is simulated by  a
67                 sequence of line speed changes and DEL characters.
68
69       ~s        Set a variable (see the discussion below).
70
71       ~^Z       Stop tip (only available with job control).
72
73       ~^Y       Stop  only the ``local side'' of tip (only available with job
74                 control); the ``remote side'' of tip, the side that  displays
75                 output from the remote host, is left running.
76
77       ~?        Get a summary of the tilde escapes
78
79
80       Tip  uses the file /etc/remote to find how to reach a particular system
81       and to find out how it should operate  while  talking  to  the  system;
82       refer  to  remote(5) for a full description.  Each system has a default
83       baud rate with which to establish a connection.  If this value  is  not
84       suitable,  the  baud  rate  to  be used may be specified on the command
85       line, e.g. ``tip -300 mds''.
86
87       When tip establishes a connection it sends out a connection message  to
88       the   remote   system;  the  default  value,  if  any,  is  defined  in
89       /etc/remote.
90
91       When tip prompts for an argument (e.g. during setup of a file transfer)
92       the  line  typed may be edited with the standard erase and kill charac‐
93       ters.  A null line in response to a prompt, or an interrupt, will abort
94       the dialogue and return you to the remote machine.
95
96       Tip  guards  against  multiple  users  connecting to a remote system by
97       opening modems and terminal lines with exclusive access, and by  honor‐
98       ing the locking protocol used by uucp(1C).
99
100       During  file  transfers  tip  provides a running count of the number of
101       lines transferred.  When using the ~> and ~< commands, the  ``eofread''
102       and ``eofwrite'' variables are used to recognize end-of-file when read‐
103       ing, and specify end-of-file when writing (see below).  File  transfers
104       normally  depend on tandem mode for flow control.  If the remote system
105       does not support tandem mode, ``echocheck'' may be set to indicate  tip
106       should synchronize with the remote system on the echo of each transmit‐
107       ted character.
108
109       When tip must dial a phone number to connect to a system it will  print
110       various  messages  indicating  its actions.  Tip supports the DEC DN-11
111       and Racal-Vadic 831 auto-call-units; the  DEC  DF02  and  DF03,  Ventel
112       212+,  Racal-Vadic  3451,  and  Bizcomp  1031  and  1032  integral call
113       unit/modems.
114
115       VARIABLES
116
117       Tip maintains a set of variables which control its operation.  Some  of
118       these variable are read-only to normal users (root is allowed to change
119       anything of interest).  Variables may be displayed and set through  the
120       ``s''  escape.   The  syntax for variables is patterned after vi(1) and
121       Mail(1).  Supplying ``all'' as an argument to the set command  displays
122       all  variables  readable  by  the  user.   Alternatively,  the user may
123       request display of a particular variable by attaching a `?' to the end.
124       For example ``escape?''  displays the current escape character.
125
126       Variables  are  numeric, string, character, or boolean values.  Boolean
127       variables are set merely by specifying their name; they may be reset by
128       prepending a `!' to the name.  Other variable types are set by concate‐
129       nating an `=' and the value.  The entire assignment must not  have  any
130       blanks  in it.  A single set command may be used to interrogate as well
131       as set a number of variables.  Variables may be initialized at run time
132       by  placing set commands (without the ``~s'' prefix in a file .tiprc in
133       one's home directory).  The -v option causes tip to display the sets as
134       they  are made.  Certain common variables have abbreviations.  The fol‐
135       lowing is a list of common variables, their  abbreviations,  and  their
136       default values.
137
138       beautify
139              (bool)  Discard  unprintable  characters when a session is being
140              scripted; abbreviated be.
141
142       baudrate
143              (num) The baud rate at which  the  connection  was  established;
144              abbreviated ba.
145
146       dialtimeout
147              (num) When dialing a phone number, the time (in seconds) to wait
148              for a connection to be established; abbreviated dial.
149
150       echocheck
151              (bool) Synchronize with the remote host during file transfer  by
152              waiting  for the echo of the last character transmitted; default
153              is off.
154
155       eofread
156              (str) The set of characters which signify and end-of-tranmission
157              during a ~< file transfer command; abbreviated eofr.
158
159       eofwrite
160              (str)  The  string sent to indicate end-of-transmission during a
161              ~> file transfer command; abbreviated eofw.
162
163       eol
164              (str) The set of characters which indicate an end-of-line.   Tip
165              will recognize escape characters only after an end-of-line.
166
167       escape
168              (char)  The  command  prefix (escape) character; abbreviated es;
169              default value is `~'.
170
171       exceptions
172              (str) The set of characters which should not be discarded due to
173              the  beautification  switch;  abbreviated  ex;  default value is
174              ``\t\n\f\b''.
175
176       force
177              (char) The character used to force  literal  data  transmission;
178              abbreviated fo; default value is `^P'.
179
180       framesize
181              (num)  The amount of data (in bytes) to buffer between file sys‐
182              tem writes when receiving files; abbreviated fr.
183
184       host
185              (str) The name of the host to which you are connected;  abbrevi‐
186              ated ho.
187
188       prompt
189              (char)  The  character  which  indicates  and end-of-line on the
190              remote host; abbreviated pr; default value is `\n'.  This  value
191              is  used  to  synchronize  during  data transfers.  The count of
192              lines transferred during a file transfer  command  is  based  on
193              recipt of this character.
194
195       raise
196              (bool) Upper case mapping mode; abbreviated ra; default value is
197              off.  When this mode is enabled, all lower case letters will  be
198              mapped  to  upper  case  by  tip  for transmission to the remote
199              machine.
200
201       raisechar
202              (char) The input character used to  toggle  upper  case  mapping
203              mode; abbreviated rc; default value is `^A'.
204
205       record
206              (str)  The  name  of  the  file  in  which  a  session script is
207              recorded; abbreviated rec; default value is ``tip.record''.
208
209       script
210              (bool) Session scripting mode; abbreviated sc; default  is  off.
211              When  script  is true, tip will record everything transmitted by
212              the remote machine  in  the  script  record  file  specified  in
213              record.   If  the  beautify  switch  is on, only printable ASCII
214              characters will be included in the script file (those characters
215              betwee  040 and 0177).  The variable exceptions is used to indi‐
216              cate characters which are an exception to the normal beautifica‐
217              tion rules.
218
219       tabexpand
220              (bool)  Expand tabs to spaces during file transfers; abbreviated
221              tab; default value is false.  Each tab is expanded to 8 spaces.
222
223       verbose
224              (bool) Verbose mode; abbreviated verb; default  is  true.   When
225              verbose  mode  is  enabled,  tip  prints messages while dialing,
226              shows the current number of  lines  transferred  during  a  file
227              transfer operations, and more.
228
229       SHELL
230              (str)  The  name of the shell to use for the ~! command; default
231              value is ``/bin/sh'', or taken from the environment.
232
233       HOME
234              (str) The home directory to use  for  the  ~c  command;  default
235              value is taken from the environment.
236

FILES

238       /etc/remote              global system descriptions
239       /etc/phones              global phone number data base
240       ${REMOTE}                private system descriptions
241       ${PHONES}                private phone numbers
242       ~/.tiprc                 initialization file.
243       /usr/spool/uucp/LCK..*   lock file to avoid conflicts with uucp
244

DIAGNOSTICS

246       Diagnostics are, hopefully, self explanatory.
247

SEE ALSO

249       remote(5), phones(5)
250

BUGS

252       The  full  set  of  variables  is undocumented and should, probably, be
253       paired down.
254
255
256
2574th Berkeley Distribution         May 5, 1986                          TIP(1C)
Impressum