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