1tip(1) User Commands tip(1)
2
6 tip - connect to remote system
7
9 tip [-v] [-speed-entry] {hostname | phone-number | device}
10
13 The tip utility establishes a full-duplex terminal connection to a
14 remote host. Once the connection is established, a remote session using
15 tip behaves like an interactive session on a local terminal.
16 The remote file contains entries describing remote systems and line
19 speeds used by tip.
20 Each host has a default baud rate for the connection, or you can spec‐
23 ify a speed with the -speed-entry command line argument.
24 When phone-number is specified, tip looks for an entry in the remote
27 file of the form:
28 tip -speed-entry
30 When tip finds such an entry, it sets the connection speed accordingly.
35 If it finds no such entry, tip interprets -speed-entry as if it were a
36 system name, resulting in an error message.
37 If you omit -speed-entry, tip uses the tip0 entry to set a speed for
40 the connection.
41 When device is specified, tip attempts to open that device, but will do
44 so using the access privileges of the user, rather than tip's usual
45 access privileges (setuid uucp). The user must have read/write access
46 to the device. The tip utility interprets any character string begin‐
47 ning with the slash character (/) as a device name.
48 When establishing the connection, tip sends a connection message to the
51 remote system. The default value for this message can be found in the
52 remote file.
53 When tip attempts to connect to a remote system, it opens the associ‐
56 ated device with an exclusive-open ioctl(2) call. Thus, only one user
57 at a time may access a device. This is to prevent multiple processes
58 from sampling the terminal line. In addition, tip honors the locking
59 protocol used by uucp(1C).
60 When tip starts up, it reads commands from the file .tiprc in your home
63 directory.
64
66 -v Display commands from the .tiprc file as they are executed.
67
70 Typed characters are normally transmitted directly to the remote
71 machine, which does the echoing as well.
72 At any time that tip prompts for an argument (for example, during setup
75 of a file transfer), the line typed may be edited with the standard
76 erase and kill characters. A null line in response to a prompt, or an
77 interrupt, aborts the dialogue and returns you to the remote machine.
78 Commands
80 A tilde (~) appearing as the first character of a line is an escape
81 signal which directs tip to perform some special action. tip recognizes
82 the following escape sequences:
83 ~^D Drop the connection and exit (you may still be logged
85 ~. in on the remote machine). Note: If you rlogin and
86 then run tip on the remote host, you must type ~~.
87 (tilde tilde dot) to end the tip session. If you type
88 ~. (tilde dot), it terminates the rlogin.
89 ~c [name] Change directory to name. No argument implies change
92 to your home directory.
93 ~! Escape to an interactive shell on the local machine.
96 Exiting the shell returns you to tip.
97 ~> Copy file from local to remote.
100 ~< Copy file from remote to local.
103 ~p from [ to ] Send a file to a remote host running the UNIX system.
106 When you use the put command, the remote system runs
107 the command string
108 cat > to
110 while tip sends it the from file. If the to file is
113 not specified, the from file name is used. This com‐
114 mand is actually a UNIX-system-specific version of
115 the `~>' command.
116 ~t from [ to ] Take a file from a remote host running the UNIX sys‐
119 tem. As in the put command the to file defaults to
120 the from file name if it is not specified. The remote
121 host executes the command string
122 cat from; echo ^A
124 to send the file to tip.
127 ~| Pipe the output from a remote command to a local
130 process. The command string sent to the local system
131 is processed by the shell.
132 ~C Connect a program to the remote machine. The command
135 string sent to the program is processed by the shell.
136 The program inherits file descriptors 0 as remote
137 line input, 1 as remote line output, and 2 as tty
138 standard error.
139 ~$ Pipe the output from a local process to the remote
142 host. The command string sent to the local system is
143 processed by the shell.
144 ~# Send a BREAK to the remote system.
147 ~s Set a variable (see the discussion below).
150 ~^Z Stop tip. Only available when run under a shell that
153 supports job control, such as the C shell.
154 ~^Y Stop only the "local side" of tip. Only available
157 when run under a shell that supports job control,
158 such as the C shell. The "remote side" of tip, that
159 is, the side that displays output from the remote
160 host, is left running.
161 ~? Get a summary of the tilde escapes.
164 Copying files requires some cooperation on the part of the remote host.
168 When a ~> or ~< escape is used to send a file, tip prompts for a file
169 name (to be transmitted or received) and a command to be sent to the
170 remote system, in case the file is being transferred from the remote
171 system. While tip is transferring a file, the number of lines trans‐
172 ferred will be continuously displayed on the screen. A file transfer
173 may be aborted with an interrupt.
174 Auto-call Units
176 tip may be used to dial up remote systems using a number of auto-call
177 unit's (ACUs). When the remote system description contains the du capa‐
178 bility, tip uses the call-unit (cu), ACU type (at), and phone numbers
179 (pn) supplied. Normally, tip displays verbose messages as it dials.
180 Depending on the type of auto-dialer being used to establish a connec‐
183 tion, the remote host may have garbage characters sent to it upon con‐
184 nection. The user should never assume that the first characters typed
185 to the foreign host are the first ones presented to it. The recommended
186 practice is to immediately type a kill character upon establishing a
187 connection (most UNIX systems either support @ or Control-U as the ini‐
188 tial kill character).
189 tip currently supports the Ventel MD-212+ modem and DC Hayes-compatible
192 modems.
193 When tip initializes a Hayes-compatible modem for dialing, it sets up
196 the modem to auto-answer. Normally, after the conversation is complete,
197 tip drops DTR, which causes the modem to "hang up."
198 Most modems can be configured so that when DTR drops, they re-initial‐
201 ize themselves to a preprogrammed state. This can be used to reset the
202 modem and disable auto-answer, if desired.
203 Additionally, it is possible to start the phone number with a Hayes S
206 command so that you can configure the modem before dialing. For exam‐
207 ple, to disable auto-answer, set up all the phone numbers in
208 /etc/remote using something like pn=S0=0DT5551212. The S0=0 disables
209 auto-answer.
210 Remote Host Description
212 Descriptions of remote hosts are normally located in the system-wide
213 file /etc/remote. However, a user may maintain personal description
214 files (and phone numbers) by defining and exporting the REMOTE shell
215 variable. The remote file must be readable by tip, but a secondary file
216 describing phone numbers may be maintained readable only by the user.
217 This secondary phone number file is /etc/phones, unless the shell vari‐
218 able PHONES is defined and exported. The phone number file contains
219 lines of the form:
220 system-name phone-number
222 Each phone number found for a system is tried until either a connection
227 is established, or an end of file is reached. Phone numbers are con‐
228 structed from `0123456789−=*', where the `=' and `*' are used to indi‐
229 cate a second dial tone should be waited for (ACU dependent).
230 tip Internal Variables
232 tip maintains a set of variables which are used in normal operation.
233 Some of these variables are read-only to normal users (root is allowed
234 to change anything of interest). Variables may be displayed and set
235 through the ~s escape. The syntax for variables is patterned after
236 vi(1) and mail(1). Supplying all as an argument to the ~s escape dis‐
237 plays all variables that the user can read. Alternatively, the user
238 may request display of a particular variable by attaching a ? to the
239 end. For example, `~s escape?' displays the current escape character.
240 Variables are numeric (num), string (str), character (char), or Boolean
243 (bool) values. Boolean variables are set merely by specifying their
244 name. They may be reset by prepending a ! to the name. Other variable
245 types are set by appending an = and the value. The entire assignment
246 must not have any blanks in it. A single set command may be used to
247 interrogate as well as set a number of variables.
248 Variables may be initialized at run time by placing set commands (with‐
251 out the ~s prefix) in a .tiprc file in one's home directory. The -v
252 option makes tip display the sets as they are made. Comments preceded
253 by a # sign can appear in the .tiprc file.
254 Finally, the variable names must either be completely specified or an
257 abbreviation may be given. The following list details those variables
258 known to tip.
259 beautify (bool) Discard unprintable characters when a session is
261 being scripted; abbreviated be. If the nb capability
262 is present, beautify is initially set to off. Other‐
263 wise, beautify is initially set to on.
264 baudrate (num) The baud rate at which the connection was estab‐
267 lished; abbreviated ba. If a baud rate was specified on
268 the command line, baudrate is initially set to the
269 specified value. Or, if the br capability is present,
270 baudrate is initially set to the value of that capabil‐
271 ity. Otherwise, baudrate is set to 300 baud. Once tip
272 has been started, baudrate can only changed by the
273 super-user.
274 dialtimeout (num) When dialing a phone number, the time (in sec‐
277 onds) to wait for a connection to be established;
278 abbreviated dial. dialtimeout is initially set to 60
279 seconds, and can only changed by the super-user.
280 disconnect (str) The string to send to the remote host to discon‐
283 nect from it; abbreviated di. If the di capability is
284 present, disconnect is initially set to the value of
285 that capability. Otherwise, disconnect is set to a null
286 string ("").
287 echocheck (bool) Synchronize with the remote host during file
290 transfer by waiting for the echo of the last character
291 transmitted; abbreviated ec. If the ec capability is
292 present, echocheck is initially set to on. Otherwise,
293 echocheck is initially set to off.
294 eofread (str) The set of characters which signify an end-of-
297 transmission during a ~< file transfer command; abbre‐
298 viated eofr. If the ie capability is present, eofread
299 is initially set to the value of that capability. Oth‐
300 erwise, eofread is set to a null string ("").
301 eofwrite (str) The string sent to indicate end-of-transmission
304 during a ~> file transfer command; abbreviated eofw. If
305 the oe capability is present, eofread is initially set
306 to the value of that capability. Otherwise, eofread is
307 set to a null string ("").
308 eol (str) The set of characters which indicate an end-of-
311 line. tip will recognize escape characters only after
312 an end-of-line. If the el capability is present, eol is
313 initially set to the value of that capability. Other‐
314 wise, eol is set to a null string ("").
315 escape (char) The command prefix (escape) character; abbrevi‐
318 ated es. If the es capability is present, escape is
319 initially set to the value of that capability. Other‐
320 wise, escape is set to `~'.
321 etimeout (num) The amount of time, in seconds, that tip should
324 wait for the echo-check response when echocheck is set;
325 abbreviated et. If the et capability is present,
326 etimeout is initially set to the value of that capabil‐
327 ity. Otherwise, etimeout is set to 10 seconds.
328 exceptions (str) The set of characters which should not be dis‐
331 carded due to the beautification switch; abbreviated
332 ex. If the ex capability is present, exceptions is ini‐
333 tially set to the value of that capability. Otherwise,
334 exceptions is set to `\t\n\f\b'.
335 force (char) The character used to force literal data trans‐
338 mission; abbreviated fo. If the fo capability is
339 present, force is initially set to the value of that
340 capability. Otherwise, force is set to \377 (which dis‐
341 ables it).
342 framesize (num) The amount of data (in bytes) to buffer between
345 file system writes when receiving files; abbreviated
346 fr. If the fs capability is present, framesize is ini‐
347 tially set to the value of that capability. Otherwise,
348 framesize is set to 1024.
349 halfduplex (bool) Do local echoing because the host is half-
352 duplex; abbreviated hdx. If the hd capability is
353 present, halfduplex is initially set to on. Otherwise,
354 halfduplex is initially set to off.
355 hardwareflow (bool) Do hardware flow control; abbreviated hf. If the
358 hf capability is present, hardwareflow is initially set
359 to on. Otherwise, hardwareflowcontrol is initially set
360 to off.
361 host (str) The name of the host to which you are connected;
364 abbreviated ho. host is permanently set to the name
365 given on the command line or in the HOST environment
366 variable.
367 localecho (bool) A synonym for halfduplex; abbreviated le.
370 log (str) The name of the file to which to log information
373 about outgoing phone calls. log is initially set to
374 /var/adm/aculog, and can only be inspected or changed
375 by the super-user.
376 parity (str) The parity to be generated and checked when talk‐
379 ing to the remote host; abbreviated par. The possible
380 values are:
381 none> Parity is not checked on input, and the parity
383 zero bit is set to zero on output.
384 one Parity is not checked on input, and the parity
387 bit is set to one on output.
388 even Even parity is checked for on input and gener‐
391 ated on output.
392 odd Odd parity is checked for on input and gener‐
395 ated on output.
396 If the pa capability is present, parity is initially
398 set to the value of that capability; otherwise, parity
399 is set to none.
400 phones The file in which to find hidden phone numbers. If the
403 environment variable PHONES is set, phones is set to
404 the value of PHONES. Otherwise, phones is set to
405 /etc/phones. The value of phones cannot be changed from
406 within tip.
407 prompt (char) The character which indicates an end-of-line on
410 the remote host; abbreviated pr. This value is used to
411 synchronize during data transfers. The count of lines
412 transferred during a file transfer command is based on
413 receipt of this character. If the pr capability is
414 present, prompt is initially set to the value of that
415 capability. Otherwise, prompt is set to \n.
416 raise (bool) Upper case mapping mode; abbreviated ra. When
419 this mode is enabled, all lower case letters will be
420 mapped to upper case by tip for transmission to the
421 remote machine. If the ra capability is present, raise
422 is initially set to on. Otherwise, raise is initially
423 set to off.
424 raisechar (char) The input character used to toggle upper case
427 mapping mode; abbreviated rc. If the rc capability is
428 present, raisechar is initially set to the value of
429 that capability. Otherwise, raisechar is set to \377
430 (which disables it).
431 rawftp (bool) Send all characters during file transfers; do
434 not filter non-printable characters, and do not do
435 translations like \n to \r. Abbreviated raw. If the rw
436 capability is present, rawftp is initially set to on.
437 Otherwise, rawftp is initially set to off.
438 record (str) The name of the file in which a session script is
441 recorded; abbreviated rec. If the re capability is
442 present, record is initially set to the value of that
443 capability. Otherwise, record is set to tip.record.
444 remote The file in which to find descriptions of remote sys‐
447 tems. If the environment variable REMOTE is set, remote
448 is set to the value of REMOTE. Otherwise, remote is set
449 to /etc/remote. The value of remote cannot be changed
450 from within tip.
451 script (bool) Session scripting mode; abbreviated sc. When
454 script is on, tip will record everything transmitted
455 by the remote machine in the script record file speci‐
456 fied in record. If the beautify switch is on, only
457 printable ASCII characters will be included in the
458 script file (those characters between 040 and 0177).
459 The variable exceptions is used to indicate characters
460 which are an exception to the normal beautification
461 rules. If the sc capability is present, script is ini‐
462 tially set to on. Otherwise, script is initially set
463 to off.
464 tabexpand (bool) Expand TAB characters to SPACE characters during
467 file transfers; abbreviated tab. When tabexpand is on,
468 each tab is expanded to eight SPACE characters. If the
469 tb capability is present, tabexpand is initially set to
470 on. Otherwise, tabexpand is initially set to off.
471 tandem (bool) Use XON/XOFF flow control to limit the rate that
474 data is sent by the remote host; abbreviated ta. If the
475 nt capability is present, tandem is initially set to
476 off. Otherwise, tandem is initially set to on.
477 verbose (bool) Verbose mode; abbreviated verb; When verbose
480 mode is enabled, tip prints messages while dialing,
481 shows the current number of lines transferred during a
482 file transfer operations, and more. If the nv capabil‐
483 ity is present, verbose is initially set to off. Other‐
484 wise, verbose is initially set to on.
485 SHELL (str) The name of the shell to use for the ~! command;
488 default value is /bin/sh, or taken from the environ‐
489 ment.
490 HOME (str) The home directory to use for the ~c command.
493 Default value is taken from the environment.
494
497 Example 1 Using the tip command
498 An example of the dialog used to transfer files is given below.
501 arpa% tip monet
504 [connected]
505 ...(assume we are talking to a UNIX system)...
506 ucbmonet login: sam
507 Password:
508 monet% cat sylvester.c
509 ~> Filename: sylvester.c
510 32 lines transferred in 1 minute 3 seconds
511 monet%
512 monet% ~< Filename: reply.c
513 List command for remote host: cat reply.c
514 65 lines transferred in 2 minutes
515 monet%
516 ...(or, equivalently)...
517 monet% ~p sylvester.c
518 ...(actually echoes as ~[put] sylvester.c)...
519 32 lines transferred in 1 minute 3 seconds
520 monet%
521 monet% ~t reply.c
522 ...(actually echoes as ~[take] reply.c)...
523 65 lines transferred in 2 minutes
524 monet%
525 ...(to print a file locally)...
526 monet% ~|Local command: pr h sylvester.c | lpr
527 List command for remote host: cat sylvester.c
528 monet% ~^D
529 [EOT]
530 ...(back on the local system)...
531
535 The following environment variables are read by tip.
536 REMOTE The location of the remote file.
538 PHONES The location of the file containing private phone numbers.
541 HOST A default host to connect to.
544 HOME One's log-in directory (for chdirs).
547 SHELL The shell to fork on a `~!' escape.
550
553 /etc/phones
554 /etc/remote
557 /var/spool/locks/LCK..* lock file to avoid conflicts with UUCP
560 /var/adm/aculog file in which outgoing calls are logged
563 ~/.tiprc initialization file
566
569 See attributes(5) for descriptions of the following attributes:
570 ┌─────────────────────────────┬─────────────────────────────┐
575 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
576 ├─────────────────────────────┼─────────────────────────────┤
577 │Availability │SUNWcsu │
578 └─────────────────────────────┴─────────────────────────────┘
579
581 cu(1C), mail(1), uucp(1C), vi(1), ioctl(2), attributes(5)
582
584 There are two additional variables, chardelay and linedelay, that are
585 currently not implemented.
586SunOS 5.11 28 Nov 2001 tip(1)