| blob | f10639a1ff70c42af40a0645b85b1674eb569b4d |
1 '\" te
2 .\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved
3 .TH TIP 1 "Nov 28, 2001"
4 .SH NAME
5 tip \- connect to remote system
6 .SH SYNOPSIS
7 .LP
8 .nf
9 \fBtip\fR [\fB-v\fR] [\fB-speed-entry\fR] {\fIhostname\fR | \fIphone-number\fR | \fIdevice\fR}
10 .fi
12 .SH DESCRIPTION
13 .sp
14 .LP
15 The \fBtip\fR utility establishes a full-duplex terminal connection to a remote
16 host. Once the connection is established, a remote session using \fBtip\fR
17 behaves like an interactive session on a local terminal.
18 .sp
19 .LP
20 The \fBremote\fR file contains entries describing remote systems and line
21 speeds used by \fBtip\fR.
22 .sp
23 .LP
24 Each host has a default baud rate for the connection, or you can specify a
25 speed with the \fB-\fR\fIspeed-entry\fR command line argument.
26 .sp
27 .LP
28 When \fIphone-number\fR is specified, \fBtip\fR looks for an entry in the
29 \fBremote\fR file of the form:
30 .sp
31 .in +2
32 .nf
33 tip -\fIspeed-entry\fR
34 .fi
35 .in -2
36 .sp
38 .sp
39 .LP
40 When \fBtip\fR finds such an entry, it sets the connection speed accordingly.
41 If it finds no such entry, \fBtip\fR interprets \fB-\fR\fIspeed-entry\fR as if
42 it were a system name, resulting in an error message.
43 .sp
44 .LP
45 If you omit \fB-\fR\fIspeed-entry\fR, \fBtip\fR uses the \fBtip0\fR entry to
46 set a speed for the connection.
47 .sp
48 .LP
49 When \fIdevice\fR is specified, \fBtip\fR attempts to open that device, but
50 will do so using the access privileges of the user, rather than \fBtip\fR's
51 usual access privileges (\fBsetuid uucp\fR). The user must have read/write
52 access to the device. The \fBtip\fR utility interprets any character string
53 beginning with the slash character (\|\fB/\fR\|) as a device name.
54 .sp
55 .LP
56 When establishing the connection, \fBtip\fR sends a connection message to the
57 remote system. The default value for this message can be found in the
58 \fBremote\fR file.
59 .sp
60 .LP
61 When \fBtip\fR attempts to connect to a remote system, it opens the associated
62 device with an exclusive-open \fBioctl\fR(2) call. Thus, only one user at a
63 time may access a device. This is to prevent multiple processes from sampling
64 the terminal line. In addition, \fBtip\fR honors the locking protocol used by
65 \fBuucp\fR(1C).
66 .sp
67 .LP
68 When \fBtip\fR starts up, it reads commands from the file \fB\&.tiprc\fR in
69 your home directory.
70 .SH OPTIONS
71 .sp
72 .ne 2
73 .na
74 \fB\fB-v\fR\fR
75 .ad
76 .RS 6n
77 Display commands from the \fB\&.tiprc\fR file as they are executed.
78 .RE
80 .SH USAGE
81 .sp
82 .LP
83 Typed characters are normally transmitted directly to the remote machine, which
84 does the echoing as well.
85 .sp
86 .LP
87 At any time that \fBtip\fR prompts for an argument (for example, during setup
88 of a file transfer), the line typed may be edited with the standard erase and
89 kill characters. A null line in response to a prompt, or an interrupt, aborts
90 the dialogue and returns you to the remote machine.
91 .SS "Commands"
92 .sp
93 .LP
94 A tilde (\fB~\fR) appearing as the first character of a line is an escape
95 signal which directs \fBtip\fR to perform some special action. \fBtip\fR
96 recognizes the following escape sequences:
97 .sp
98 .ne 2
99 .na
100 \fB\fB~^D\fR\fR
101 .ad
102 .br
103 .na
104 \fB\fB~.\fR\fR
105 .ad
106 .RS 18n
107 Drop the connection and exit (you may still be logged in on the remote
108 machine). \fBNote:\fR If you rlogin and then run \fBtip\fR on the remote host,
109 you must type \fB~~.\fR (tilde tilde dot) to end the \fBtip\fR session. If you
110 type \fB~.\fR (tilde dot), it terminates the rlogin.
111 .RE
113 .sp
114 .ne 2
115 .na
116 \fB\fB~c\fR [\fIname\fR]\fR
117 .ad
118 .RS 18n
119 Change directory to \fIname\fR. No argument implies change to your home
120 directory.
121 .RE
123 .sp
124 .ne 2
125 .na
126 \fB\fB~!\fR\fR
127 .ad
128 .RS 18n
129 Escape to an interactive shell on the local machine. Exiting the shell returns
130 you to \fBtip\fR.
131 .RE
133 .sp
134 .ne 2
135 .na
136 \fB\fB~>\fR\fR
137 .ad
138 .RS 18n
139 Copy file from local to remote.
140 .RE
142 .sp
143 .ne 2
144 .na
145 \fB\fB~<\fR\fR
146 .ad
147 .RS 18n
148 Copy file from remote to local.
149 .RE
151 .sp
152 .ne 2
153 .na
154 \fB\fB~p\fR\fI from\fR [\fI to \fR]\fR
155 .ad
156 .RS 18n
157 Send a file to a remote host running the UNIX system. When you use the put
158 command, the remote system runs the command string
159 .sp
160 .in +2
161 .nf
162 \fBcat > \fR\fIto\fR
163 .fi
164 .in -2
165 .sp
167 while \fBtip\fR sends it the \fIfrom\fR file. If the \fIto\fR file is not
168 specified, the \fIfrom\fR file name is used. This command is actually a
169 UNIX-system-specific version of the `\fB~>\fR' command.
170 .RE
172 .sp
173 .ne 2
174 .na
175 \fB\fB~t\fR\fI from\fR [\fI to \fR]\fR
176 .ad
177 .RS 18n
178 Take a file from a remote host running the UNIX system. As in the put command
179 the \fIto\fR file defaults to the \fIfrom\fR file name if it is not specified.
180 The remote host executes the command string
181 .sp
182 .in +2
183 .nf
184 \fBcat \fR\fIfrom\fR\fB\|; echo ^A\fR
185 .fi
186 .in -2
187 .sp
189 to send the file to \fBtip\fR.
190 .RE
192 .sp
193 .ne 2
194 .na
195 \fB\fB~|\fR\fR
196 .ad
197 .RS 18n
198 Pipe the output from a remote command to a local process. The command string
199 sent to the local system is processed by the shell.
200 .RE
202 .sp
203 .ne 2
204 .na
205 \fB\fB~C\fR\fR
206 .ad
207 .RS 18n
208 Connect a program to the remote machine. The command string sent to the program
209 is processed by the shell. The program inherits file descriptors 0 as remote
210 line input, 1 as remote line output, and 2 as tty standard error.
211 .RE
213 .sp
214 .ne 2
215 .na
216 \fB\fB~$\fR\fR
217 .ad
218 .RS 18n
219 Pipe the output from a local process to the remote host. The command string
220 sent to the local system is processed by the shell.
221 .RE
223 .sp
224 .ne 2
225 .na
226 \fB\fB~#\fR\fR
227 .ad
228 .RS 18n
229 Send a \fBBREAK\fR to the remote system.
230 .RE
232 .sp
233 .ne 2
234 .na
235 \fB\fB~s\fR\fR
236 .ad
237 .RS 18n
238 Set a variable (see the discussion below).
239 .RE
241 .sp
242 .ne 2
243 .na
244 \fB\fB~^Z\fR\fR
245 .ad
246 .RS 18n
247 Stop \fBtip\fR. Only available when run under a shell that supports job
248 control, such as the C shell.
249 .RE
251 .sp
252 .ne 2
253 .na
254 \fB\fB~^Y\fR\fR
255 .ad
256 .RS 18n
257 Stop only the "local side" of \fBtip\fR. Only available when run under a shell
258 that supports job control, such as the C shell. The "remote side" of \fBtip\fR,
259 that is, the side that displays output from the remote host, is left running.
260 .RE
262 .sp
263 .ne 2
264 .na
265 \fB\fB~?\fR\fR
266 .ad
267 .RS 18n
268 Get a summary of the tilde escapes.
269 .RE
271 .sp
272 .LP
273 Copying files requires some cooperation on the part of the remote host. When a
274 \fB~>\fR or \fB~<\fR escape is used to send a file, \fBtip\fR prompts for a
275 file name (to be transmitted or received) and a command to be sent to the
276 remote system, in case the file is being transferred from the remote system.
277 While \fBtip\fR is transferring a file, the number of lines transferred will be
278 continuously displayed on the screen. A file transfer may be aborted with an
279 interrupt.
280 .SS "Auto-call Units"
281 .sp
282 .LP
283 \fBtip\fR may be used to dial up remote systems using a number of auto-call
284 unit's (\fBACU\fRs). When the remote system description contains the \fBdu\fR
285 capability, \fBtip\fR uses the call-unit (\fBcu\fR), \fBACU\fR type (\fBat\fR),
286 and phone numbers (\fBpn\fR) supplied. Normally, \fBtip\fR displays verbose
287 messages as it dials.
288 .sp
289 .LP
290 Depending on the type of auto-dialer being used to establish a connection, the
291 remote host may have garbage characters sent to it upon connection. The user
292 should never assume that the first characters typed to the foreign host are the
293 first ones presented to it. The recommended practice is to immediately type a
294 \fBkill\fR character upon establishing a connection (most UNIX systems either
295 support \fB@\fR or Control-U as the initial kill character).
296 .sp
297 .LP
298 \fBtip\fR currently supports the Ventel MD-212+ modem and DC Hayes-compatible
299 modems.
300 .sp
301 .LP
302 When \fBtip\fR initializes a Hayes-compatible modem for dialing, it sets up the
303 modem to auto-answer. Normally, after the conversation is complete, \fBtip\fR
304 drops \fBDTR\fR, which causes the modem to "hang up."
305 .sp
306 .LP
307 Most modems can be configured so that when \fBDTR\fR drops, they re-initialize
308 themselves to a preprogrammed state. This can be used to reset the modem and
309 disable auto-answer, if desired.
310 .sp
311 .LP
312 Additionally, it is possible to start the phone number with a Hayes \fBS\fR
313 command so that you can configure the modem before dialing. For example, to
314 disable auto-answer, set up all the phone numbers in \fB/etc/remote\fR using
315 something like \fBpn=S0=0DT5551212\fR. The \fBS0=0\fR disables auto-answer.
316 .SS "Remote Host Description"
317 .sp
318 .LP
319 Descriptions of remote hosts are normally located in the system-wide file
320 \fB/etc/remote\fR. However, a user may maintain personal description files (and
321 phone numbers) by defining and exporting the \fBREMOTE\fR shell variable. The
322 \fBremote\fR file must be readable by \fBtip\fR, but a secondary file
323 describing phone numbers may be maintained readable only by the user. This
324 secondary phone number file is \fB/etc/phones\fR, unless the shell variable
325 \fBPHONES\fR is defined and exported. The phone number file contains lines of
326 the form:
327 .sp
328 .in +2
329 .nf
330 \fIsystem-name phone-number\fR
331 .fi
332 .in -2
333 .sp
335 .sp
336 .LP
337 Each phone number found for a system is tried until either a connection is
338 established, or an end of file is reached. Phone numbers are constructed from
339 `\fB0123456789\(mi=*\fR', where the `\fB=\fR' and `\fB*\fR' are used to
340 indicate a second dial tone should be waited for (\fBACU\fR dependent).
341 .SS "tip Internal Variables"
342 .sp
343 .LP
344 \fBtip\fR maintains a set of variables which are used in normal operation. Some
345 of these variables are read-only to normal users (root is allowed to change
346 anything of interest). Variables may be displayed and set through the \fB~s\fR
347 escape. The syntax for variables is patterned after \fBvi\fR(1) and
348 \fBmail\fR(1). Supplying \fBall\fR as an argument to the \fB~s\fR escape
349 displays all variables that the user can read. Alternatively, the user may
350 request display of a particular variable by attaching a \fB?\fR to the end. For
351 example, `\fB~s escape?\fR' displays the current escape character.
352 .sp
353 .LP
354 Variables are numeric (num), string (str), character (char), or Boolean (bool)
355 values. Boolean variables are set merely by specifying their name. They may be
356 reset by prepending a \fB!\fR to the name. Other variable types are set by
357 appending an \fB=\fR and the value. The entire assignment must not have any
358 blanks in it. A single set command may be used to interrogate as well as set a
359 number of variables.
360 .sp
361 .LP
362 Variables may be initialized at run time by placing set commands (without the
363 \fB~s\fR prefix) in a \fB\&.tiprc\fR file in one's home directory. The \fB-v\fR
364 option makes \fBtip\fR display the sets as they are made. Comments preceded by
365 a \fB#\fR sign can appear in the \fB\&.tiprc\fR file.
366 .sp
367 .LP
368 Finally, the variable names must either be completely specified or an
369 abbreviation may be given. The following list details those variables known to
370 \fBtip\fR.
371 .sp
372 .ne 2
373 .na
374 \fB\fBbeautify\fR\fR
375 .ad
376 .RS 16n
377 (bool) Discard unprintable characters when a session is being scripted;
378 abbreviated \fBbe\fR. If the \fBnb\fR capability is present, \fBbeautify\fR is
379 initially set to \fBoff\fR. Otherwise, \fBbeautify\fR is initially set to
380 \fBon\fR.
381 .RE
383 .sp
384 .ne 2
385 .na
386 \fB\fBbaudrate\fR\fR
387 .ad
388 .RS 16n
389 (num) The baud rate at which the connection was established; abbreviated
390 \fBba\fR. If a baud rate was specified on the command line, \fBbaudrate\fR is
391 initially set to the specified value. Or, if the \fBbr\fR capability is
392 present, \fBbaudrate\fR is initially set to the value of that capability.
393 Otherwise, \fBbaudrate\fR is set to 300 baud. Once \fBtip\fR has been started,
394 \fBbaudrate\fR can only changed by the super-user.
395 .RE
397 .sp
398 .ne 2
399 .na
400 \fB\fBdialtimeout\fR\fR
401 .ad
402 .RS 16n
403 (num) When dialing a phone number, the time (in seconds) to wait for a
404 connection to be established; abbreviated \fBdial\fR. \fBdialtimeout\fR is
405 initially set to 60 seconds, and can only changed by the super-user.
406 .RE
408 .sp
409 .ne 2
410 .na
411 \fB\fBdisconnect\fR\fR
412 .ad
413 .RS 16n
414 (str) The string to send to the remote host to disconnect from it; abbreviated
415 \fBdi\fR. If the \fBdi\fR capability is present, \fBdisconnect\fR is initially
416 set to the value of that capability. Otherwise, \fBdisconnect\fR is set to a
417 null string (\fB""\fR).
418 .RE
420 .sp
421 .ne 2
422 .na
423 \fB\fBechocheck\fR\fR
424 .ad
425 .RS 16n
426 (bool) Synchronize with the remote host during file transfer by waiting for the
427 echo of the last character transmitted; abbreviated \fBec\fR. If the \fBec\fR
428 capability is present, \fBechocheck\fR is initially set to \fBon\fR. Otherwise,
429 \fBechocheck\fR is initially set to \fBoff\fR.
430 .RE
432 .sp
433 .ne 2
434 .na
435 \fB\fBeofread\fR\fR
436 .ad
437 .RS 16n
438 (str) The set of characters which signify an end-of-transmission during a
439 \fB~<\fR file transfer command; abbreviated \fBeofr\fR. If the \fBie\fR
440 capability is present, \fBeofread\fR is initially set to the value of that
441 capability. Otherwise, \fBeofread\fR is set to a null string (\fB""\fR).
442 .RE
444 .sp
445 .ne 2
446 .na
447 \fB\fBeofwrite\fR\fR
448 .ad
449 .RS 16n
450 (str) The string sent to indicate end-of-transmission during a \fB~>\fR file
451 transfer command; abbreviated \fBeofw\fR. If the \fBoe\fR capability is
452 present, \fBeofread\fR is initially set to the value of that capability.
453 Otherwise, \fBeofread\fR is set to a null string (\fB""\fR).
454 .RE
456 .sp
457 .ne 2
458 .na
459 \fB\fBeol\fR\fR
460 .ad
461 .RS 16n
462 (str) The set of characters which indicate an end-of-line. \fBtip\fR will
463 recognize escape characters only after an end-of-line. If the \fBel\fR
464 capability is present, \fBeol\fR is initially set to the value of that
465 capability. Otherwise, \fBeol\fR is set to a null string (\fB""\fR).
466 .RE
468 .sp
469 .ne 2
470 .na
471 \fB\fBescape\fR\fR
472 .ad
473 .RS 16n
474 (char) The command prefix (escape) character; abbreviated \fBes\fR. If the
475 \fBes\fR capability is present, \fBescape\fR is initially set to the value of
476 that capability. Otherwise, \fBescape\fR is set to `\fB\|~\|\fR\&'.
477 .RE
479 .sp
480 .ne 2
481 .na
482 \fB\fBetimeout\fR\fR
483 .ad
484 .RS 16n
485 (num) The amount of time, in seconds, that \fBtip\fR should wait for the
486 echo-check response when \fBechocheck\fR is set; abbreviated \fBet\fR. If the
487 \fBet\fR capability is present, \fBetimeout\fR is initially set to the value of
488 that capability. Otherwise, \fBetimeout\fR is set to 10 seconds.
489 .RE
491 .sp
492 .ne 2
493 .na
494 \fB\fBexceptions\fR\fR
495 .ad
496 .RS 16n
497 (str) The set of characters which should not be discarded due to the
498 beautification switch; abbreviated \fBex\fR. If the \fBex\fR capability is
499 present, \fBexceptions\fR is initially set to the value of that capability.
500 Otherwise, \fBexceptions\fR is set to `\fB\et\en\ef\eb\fR\&'.
501 .RE
503 .sp
504 .ne 2
505 .na
506 \fB\fBforce\fR\fR
507 .ad
508 .RS 16n
509 (char) The character used to force literal data transmission; abbreviated
510 \fBfo\fR. If the \fBfo\fR capability is present, \fBforce\fR is initially set
511 to the value of that capability. Otherwise, \fBforce\fR is set to \fB\e377\fR
512 (which disables it).
513 .RE
515 .sp
516 .ne 2
517 .na
518 \fB\fBframesize\fR\fR
519 .ad
520 .RS 16n
521 (num) The amount of data (in bytes) to buffer between file system writes when
522 receiving files; abbreviated \fBfr\fR. If the \fBfs\fR capability is present,
523 \fBframesize\fR is initially set to the value of that capability. Otherwise,
524 \fBframesize\fR is set to \fB1024\fR.
525 .RE
527 .sp
528 .ne 2
529 .na
530 \fB\fBhalfduplex\fR\fR
531 .ad
532 .RS 16n
533 (bool) Do local echoing because the host is half-duplex; abbreviated \fBhdx\fR.
534 If the \fBhd\fR capability is present, \fBhalfduplex\fR is initially set to
535 \fBon\fR. Otherwise, \fBhalfduplex\fR is initially set to \fBoff\fR.
536 .RE
538 .sp
539 .ne 2
540 .na
541 \fB\fBhardwareflow\fR\fR
542 .ad
543 .RS 16n
544 (bool) Do hardware flow control; abbreviated \fBhf\fR. If the \fBhf\fR
545 capability is present, \fBhardwareflow\fR is initially set to \fBon\fR.
546 Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR.
547 .RE
549 .sp
550 .ne 2
551 .na
552 \fB\fBhost\fR\fR
553 .ad
554 .RS 16n
555 (str) The name of the host to which you are connected; abbreviated \fBho\fR.
556 \fBhost\fR is permanently set to the name given on the command line or in the
557 \fBHOST\fR environment variable.
558 .RE
560 .sp
561 .ne 2
562 .na
563 \fB\fBlocalecho\fR\fR
564 .ad
565 .RS 16n
566 (bool) A synonym for \fBhalfduplex\fR; abbreviated \fBle\fR.
567 .RE
569 .sp
570 .ne 2
571 .na
572 \fB\fBlog\fR\fR
573 .ad
574 .RS 16n
575 (str) The name of the file to which to log information about outgoing phone
576 calls. \fBlog\fR is initially set to \fB/var/adm/aculog\fR, and can only be
577 inspected or changed by the super-user.
578 .RE
580 .sp
581 .ne 2
582 .na
583 \fB\fBparity\fR\fR
584 .ad
585 .RS 16n
586 (str) The parity to be generated and checked when talking to the remote host;
587 abbreviated \fBpar\fR. The possible values are:
588 .sp
589 .ne 2
590 .na
591 \fB\fBnone\fR>\fR
592 .ad
593 .br
594 .na
595 \fB\fBzero\fR\fR
596 .ad
597 .RS 9n
598 Parity is not checked on input, and the parity bit is set to zero on output.
599 .RE
601 .sp
602 .ne 2
603 .na
604 \fB\fBone\fR\fR
605 .ad
606 .RS 9n
607 Parity is not checked on input, and the parity bit is set to one on output.
608 .RE
610 .sp
611 .ne 2
612 .na
613 \fB\fBeven\fR\fR
614 .ad
615 .RS 9n
616 Even parity is checked for on input and generated on output.
617 .RE
619 .sp
620 .ne 2
621 .na
622 \fB\fBodd\fR\fR
623 .ad
624 .RS 9n
625 Odd parity is checked for on input and generated on output.
626 .RE
628 If the \fBpa\fR capability is present, \fBparity\fR is initially set to the
629 value of that capability; otherwise, \fBparity\fR is set to \fBnone\fR.
630 .RE
632 .sp
633 .ne 2
634 .na
635 \fB\fBphones\fR\fR
636 .ad
637 .RS 16n
638 The file in which to find hidden phone numbers. If the environment variable
639 \fBPHONES\fR is set, \fBphones\fR is set to the value of \fBPHONES\fR.
640 Otherwise, \fBphones\fR is set to \fB/etc/phones\fR. The value of \fBphones\fR
641 cannot be changed from within \fBtip\fR.
642 .RE
644 .sp
645 .ne 2
646 .na
647 \fB\fBprompt\fR\fR
648 .ad
649 .RS 16n
650 (char) The character which indicates an end-of-line on the remote host;
651 abbreviated \fBpr\fR. This value is used to synchronize during data transfers.
652 The count of lines transferred during a file transfer command is based on
653 receipt of this character. If the \fBpr\fR capability is present, \fBprompt\fR
654 is initially set to the value of that capability. Otherwise, \fBprompt\fR is
655 set to \fB\en\fR\&.
656 .RE
658 .sp
659 .ne 2
660 .na
661 \fB\fBraise\fR\fR
662 .ad
663 .RS 16n
664 (bool) Upper case mapping mode; abbreviated \fBra\fR. When this mode is
665 enabled, all lower case letters will be mapped to upper case by \fBtip\fR for
666 transmission to the remote machine. If the \fBra\fR capability is present,
667 \fBraise\fR is initially set to \fBon\fR. Otherwise, \fBraise\fR is initially
668 set to \fBoff\fR.
669 .RE
671 .sp
672 .ne 2
673 .na
674 \fB\fBraisechar\fR\fR
675 .ad
676 .RS 16n
677 (char) The input character used to toggle upper case mapping mode; abbreviated
678 \fBrc\fR. If the \fBrc\fR capability is present, \fBraisechar\fR is initially
679 set to the value of that capability. Otherwise, \fBraisechar\fR is set to
680 \fB\e377\fR (which disables it).
681 .RE
683 .sp
684 .ne 2
685 .na
686 \fB\fBrawftp\fR\fR
687 .ad
688 .RS 16n
689 (bool) Send all characters during file transfers; do not filter non-printable
690 characters, and do not do translations like \fB\en\fR to \fB\er\fR\&.
691 Abbreviated \fBraw\fR. If the \fBrw\fR capability is present, \fBrawftp\fR is
692 initially set to \fBon\fR. Otherwise, \fBrawftp\fR is initially set to
693 \fBoff\fR.
694 .RE
696 .sp
697 .ne 2
698 .na
699 \fB\fBrecord\fR\fR
700 .ad
701 .RS 16n
702 (str) The name of the file in which a session script is recorded; abbreviated
703 \fBrec\fR. If the \fBre\fR capability is present, \fBrecord\fR is initially set
704 to the value of that capability. Otherwise, \fBrecord\fR is set to
705 \fBtip.record\fR.
706 .RE
708 .sp
709 .ne 2
710 .na
711 \fB\fBremote\fR\fR
712 .ad
713 .RS 16n
714 The file in which to find descriptions of remote systems. If the environment
715 variable \fBREMOTE\fR is set, \fBremote\fR is set to the value of \fBREMOTE\fR.
716 Otherwise, \fBremote\fR is set to \fB/etc/remote\fR. The value of \fBremote\fR
717 cannot be changed from within \fBtip\fR.
718 .RE
720 .sp
721 .ne 2
722 .na
723 \fB\fBscript\fR\fR
724 .ad
725 .RS 16n
726 (bool) Session scripting mode; abbreviated \fBsc\fR. When \fBscript\fR is
727 \fBon\fR, \fBtip\fR will record everything transmitted by the remote machine in
728 the script record file specified in \fBrecord\fR. If the \fBbeautify\fR switch
729 is on, only printable \fBASCII\fR characters will be included in the script
730 file (those characters between 040 and 0177). The variable \fBexceptions\fR is
731 used to indicate characters which are an exception to the normal beautification
732 rules. If the \fBsc\fR capability is present, \fBscript\fR is initially set to
733 \fBon\fR. Otherwise, \fB script\fR is initially set to \fBoff\fR.
734 .RE
736 .sp
737 .ne 2
738 .na
739 \fB\fBtabexpand\fR\fR
740 .ad
741 .RS 16n
742 (bool) Expand \fBTAB\fR characters to \fBSPACE\fR characters during file
743 transfers; abbreviated \fBtab\fR. When \fBtabexpand\fR is \fBon\fR, each tab
744 is expanded to eight SPACE characters. If the \fBtb\fR capability is present,
745 \fBtabexpand\fR is initially set to \fBon\fR. Otherwise, \fBtabexpand\fR is
746 initially set to \fBoff\fR.
747 .RE
749 .sp
750 .ne 2
751 .na
752 \fB\fBtandem\fR\fR
753 .ad
754 .RS 16n
755 (bool) Use \fBXON\fR/\fBXOFF\fR flow control to limit the rate that data is
756 sent by the remote host; abbreviated \fBta\fR. If the \fBnt\fR capability is
757 present, \fBtandem\fR is initially set to \fBoff\fR. Otherwise, \fBtandem\fR is
758 initially set to \fBon\fR.
759 .RE
761 .sp
762 .ne 2
763 .na
764 \fB\fBverbose\fR\fR
765 .ad
766 .RS 16n
767 (bool) Verbose mode; abbreviated \fBverb\fR; When verbose mode is enabled,
768 \fBtip\fR prints messages while dialing, shows the current number of lines
769 transferred during a file transfer operations, and more. If the \fBnv\fR
770 capability is present, \fBverbose\fR is initially set to \fBoff\fR. Otherwise,
771 \fBverbose\fR is initially set to \fBon\fR.
772 .RE
774 .sp
775 .ne 2
776 .na
777 \fB\fBSHELL\fR\fR
778 .ad
779 .RS 16n
780 (str) The name of the shell to use for the \fB~!\fR command; default value is
781 \fB/bin/sh\fR, or taken from the environment.
782 .RE
784 .sp
785 .ne 2
786 .na
787 \fB\fBHOME\fR\fR
788 .ad
789 .RS 16n
790 (str) The home directory to use for the \fB~c\fR command. Default value is
791 taken from the environment.
792 .RE
794 .SH EXAMPLES
795 .LP
796 \fBExample 1 \fRUsing the tip command
797 .sp
798 .LP
799 An example of the dialog used to transfer files is given below.
801 .sp
802 .in +2
803 .nf
804 arpa% \fBtip monet\fR
805 [connected]
806 \&...(assume we are talking to a UNIX system)...
807 ucbmonet login: sam
808 Password:
809 monet% cat sylvester.c
810 ~> Filename: sylvester.c
811 32 lines transferred in 1 minute 3 seconds
812 monet%
813 monet% ~< Filename: reply.c
814 List command for remote host: cat reply.c
815 65 lines transferred in 2 minutes
816 monet%
817 \&...(or, equivalently)...
818 monet% ~p sylvester.c
819 \&...(actually echoes as ~[put] sylvester.c)...
820 32 lines transferred in 1 minute 3 seconds
821 monet%
822 monet% ~t reply.c
823 \&...(actually echoes as ~[take] reply.c)...
824 65 lines transferred in 2 minutes
825 monet%
826 \&...(to print a file locally)...
827 monet% ~|Local command: pr h sylvester.c | lpr
828 List command for remote host: cat sylvester.c
829 monet% ~^D
830 [EOT]
831 \&...(back on the local system)...
832 .fi
833 .in -2
834 .sp
836 .SH ENVIRONMENT VARIABLES
837 .sp
838 .LP
839 The following environment variables are read by \fBtip\fR.
840 .sp
841 .ne 2
842 .na
843 \fB\fBREMOTE\fR\fR
844 .ad
845 .RS 10n
846 The location of the \fBremote\fR file.
847 .RE
849 .sp
850 .ne 2
851 .na
852 \fB\fBPHONES\fR\fR
853 .ad
854 .RS 10n
855 The location of the file containing private phone numbers.
856 .RE
858 .sp
859 .ne 2
860 .na
861 \fB\fBHOST\fR\fR
862 .ad
863 .RS 10n
864 A default host to connect to.
865 .RE
867 .sp
868 .ne 2
869 .na
870 \fB\fBHOME\fR\fR
871 .ad
872 .RS 10n
873 One's log-in directory (for chdirs).
874 .RE
876 .sp
877 .ne 2
878 .na
879 \fB\fBSHELL\fR\fR
880 .ad
881 .RS 10n
882 The shell to fork on a `\fB~!\fR' escape.
883 .RE
885 .SH FILES
886 .sp
887 .ne 2
888 .na
889 \fB\fB/etc/phones\fR\fR
890 .ad
891 .RS 29n
893 .RE
895 .sp
896 .ne 2
897 .na
898 \fB\fB/etc/remote\fR\fR
899 .ad
900 .RS 29n
902 .RE
904 .sp
905 .ne 2
906 .na
907 \fB\fB/var/spool/locks/LCK.\|.*\fR\fR
908 .ad
909 .RS 29n
910 lock file to avoid conflicts with \fBUUCP\fR
911 .RE
913 .sp
914 .ne 2
915 .na
916 \fB\fB/var/adm/aculog\fR\fR
917 .ad
918 .RS 29n
919 file in which outgoing calls are logged
920 .RE
922 .sp
923 .ne 2
924 .na
925 \fB\fB~/.tiprc\fR\fR
926 .ad
927 .RS 29n
928 initialization file
929 .RE
931 .SH SEE ALSO
932 .sp
933 .LP
934 \fBcu\fR(1C), \fBmail\fR(1), \fBuucp\fR(1C), \fBvi\fR(1), \fBioctl\fR(2),
935 \fBattributes\fR(5)
936 .SH BUGS
937 .sp
938 .LP
939 There are two additional variables, \fBchardelay\fR and \fBlinedelay\fR, that
940 are currently not implemented.