|
|
1.1 root 1: .TH TIP 1C "18 July 1983"
2: .UC 4
3: .SH NAME
4: tip, cu \- connect to a remote system
5: .SH SYNOPSIS
6: .B tip
7: [
8: .B \-v
9: ] [
10: .BI \- speed
11: ] system-name
12: .br
13: .B tip
14: [
15: .B \-v
16: ] [
17: .BI \- speed
18: ] phone-number
19: .br
20: .B cu
21: phone-number
22: [
23: .B \-t
24: ] [
25: .B \-s
26: .I speed
27: ] [
28: .B \ -a
29: .I acu
30: ] [
31: .B \-l
32: .I line
33: ] [
34: .B \-#
35: ]
36: .SH DESCRIPTION
37: .I Tip
38: and
39: .I cu
40: establish a full-duplex connection to another machine,
41: giving the appearance of being logged in directly on the
42: remote cpu. It goes without saying that you must have a login
43: on the machine (or equivalent) to which you wish to connect.
44: The preferred interface is
45: .IR tip .
46: The
47: .I cu
48: interface is included for those people attached to the
49: ``call UNIX'' command of version 7. This manual page
50: describes only
51: .IR tip .
52: .PP
53: Typed characters are normally transmitted directly to the remote
54: machine (which does the echoing as well). A tilde (`~') appearing
55: as the first character of a line is an escape signal; the following
56: are recognized:
57: .TP 10
58: .B ~^D ~.
59: Drop the connection and exit
60: (you may still be logged in on the
61: remote machine).
62: .TP 10
63: \fB~c \fP [\fIname\fP]
64: Change directory to name (no argument
65: implies change to your home directory).
66: .TP 10
67: .B ~!
68: Escape to a shell (exiting the shell will
69: return you to tip).
70: .TP 10
71: .B ~>
72: Copy file from local to remote.
73: .I Tip
74: prompts for the name of a local file to transmit.
75: .TP 10
76: .B ~<
77: Copy file from remote to local.
78: .I Tip
79: prompts first for the name of the file to be sent, then for
80: a command to be executed on the remote machine.
81: .TP 10
82: \fB~p\fP \fIfrom\fP [ \fIto\fP ]
83: Send a file to a remote UNIX host. The put command causes the remote UNIX
84: system to run the command string ``cat > 'to''', while
85: .I tip
86: sends it the ``from''
87: file. If the ``to'' file isn't specified the ``from'' file name is used.
88: This command is actually a UNIX specific version of the ``~>'' command.
89: .TP 10
90: \fB~t\fP \fIfrom\fP [ \fIto\fP ]
91: Take a file from a remote UNIX host.
92: As in the put command the ``to'' file
93: defaults to the ``from'' file name if it isn't specified.
94: The remote host
95: executes the command string ``cat 'from';echo ^A'' to send the file to
96: .IR tip .
97: .TP 10
98: .B ~|
99: Pipe the output from a remote command to a local UNIX process.
100: The command string sent to the local UNIX system is processed by the shell.
101: .TP 10
102: .B ~#
103: Send a BREAK to the remote system.
104: For systems which don't support the
105: necessary
106: .I ioctl
107: call the break is simulated by a sequence of line speed changes
108: and DEL characters.
109: .TP 10
110: .B ~s
111: Set a variable (see the discussion below).
112: .TP 10
113: .B ~^Z
114: Stop
115: .I tip
116: (only available with job control).
117: .TP 10
118: .B ~?
119: Get a summary of the tilde escapes
120: .sp
121: .PP
122: .I Tip
123: uses the file /etc/remote to find how to reach a particular
124: system and to find out how it should operate while talking
125: to the system;
126: refer to
127: .IR remote (5)
128: for a full description.
129: Each system has a default baud rate with which to
130: establish a connection. If this value is not suitable, the baud rate
131: to be used may be specified on the command line, e.g. ``tip -300 mds''.
132: .PP
133: When
134: .I tip
135: establishes a connection it sends out a
136: connection message to the remote system; the default value, if any,
137: is defined in /etc/remote.
138: .PP
139: When
140: .I tip
141: prompts for an argument (e.g. during setup of
142: a file transfer) the line typed may be edited with the standard
143: erase and kill characters. A null line in response to a prompt,
144: or an interrupt, will abort the dialogue and return you to the
145: remote machine.
146: .PP
147: .I Tip
148: guards against multiple users connecting to a remote system
149: by opening modems and terminal lines with exclusive access,
150: and by honoring the locking protocol used by
151: .IR uucp (1C).
152: .PP
153: During file transfers
154: .I tip
155: provides a running count of the number of lines transferred.
156: When using the ~> and ~< commands, the ``eofread'' and ``eofwrite''
157: variables are used to recognize end-of-file when reading, and
158: specify end-of-file when writing (see below). File transfers
159: normally depend on tandem mode for flow control. If the remote
160: system does not support tandem mode, ``echocheck'' may be set
161: to indicate
162: .I tip
163: should synchronize with the remote system on the echo of each
164: transmitted character.
165: .PP
166: When
167: .I tip
168: must dial a phone number to connect to a system it will print
169: various messages indicating its actions.
170: .PP
171: .SM
172: .B VARIABLES
173: .PP
174: .I Tip
175: maintains a set of
176: .I variables
177: which control its operation.
178: Some of these variable are read-only to normal users (root is allowed
179: to change anything of interest). Variables may be displayed
180: and set through the ``s'' escape. The syntax for variables is patterned
181: after
182: .IR vi (1)
183: and
184: .IR Mail (1).
185: Supplying ``all''
186: as an argument to the set command displays all variables readable by
187: the user. Alternatively, the user may request display of a particular
188: variable by attaching a `?' to the end. For example ``escape?''
189: displays the current escape character.
190: .PP
191: Variables are numeric, string, character, or boolean values. Boolean
192: variables are set merely by specifying their name; they may be reset
193: by prepending a `!' to the name. Other variable types are set by
194: concatenating an `=' and the value. The entire assignment must not
195: have any blanks in it. A single set command may be used to interrogate
196: as well as set a number of variables.
197: Variables may be initialized at run time by placing set commands
198: (without the ``~s'' prefix in a file
199: .I .tiprc
200: in one's home directory). The
201: .B \-v
202: option causes
203: .I tip
204: to display the sets as they are made.
205: Certain common variables have abbreviations.
206: The following is a list of common variables,
207: their abbreviations, and their default values.
208: .TP
209: .B beautify
210: .br
211: (bool) Discard unprintable characters when a session is being scripted;
212: abbreviated
213: .IR be .
214: .TP
215: .B baudrate
216: .br
217: (num) The baud rate at which the connection was established;
218: abbreviated
219: .IR ba .
220: .TP
221: .B dialtimeout
222: .br
223: (num) When dialing a phone number, the time (in seconds)
224: to wait for a connection to be established; abbreviated
225: .IR dial .
226: .TP
227: .B echocheck
228: .br
229: (bool) Synchronize with the remote host during file transfer by
230: waiting for the echo of the last character transmitted; default is
231: .IR off .
232: .TP
233: .B eofread
234: .br
235: (str) The set of characters which signify and end-of-tranmission
236: during a ~< file transfer command; abbreviated
237: .IR eofr .
238: .TP
239: .B eofwrite
240: .br
241: (str) The string sent to indicate end-of-transmission during
242: a ~> file transfer command; abbreviated
243: .IR eofw .
244: .TP
245: .B eol
246: .br
247: (str) The set of characters which indicate an end-of-line.
248: .I Tip
249: will recognize escape characters only after an end-of-line.
250: .TP
251: .B escape
252: .br
253: (char) The command prefix (escape) character; abbreviated
254: .IR es ;
255: default value is `~'.
256: .TP
257: .B exceptions
258: .br
259: (str) The set of characters which should not be discarded
260: due to the beautification switch; abbreviated
261: .IR ex ;
262: default value is ``\et\en\ef\eb''.
263: .TP
264: .B force
265: .br
266: (char) The character used to force literal data transmission;
267: abbreviated
268: .IR fo ;
269: default value is `^P'.
270: .TP
271: .B framesize
272: .br
273: (num) The amount of data (in bytes) to buffer between file system
274: writes when receiving files; abbreviated
275: .IR fr .
276: .TP
277: .B host
278: .br
279: (str) The name of the host to which you are connected; abbreviated
280: .IR ho .
281: .TP
282: .B prompt
283: .br
284: (char) The character which indicates and end-of-line on the remote
285: host; abbreviated
286: .IR pr ;
287: default value is `\en'. This value is used to synchronize during
288: data transfers. The count of lines transferred during a file transfer
289: command is based on recipt of this character.
290: .TP
291: .B raise
292: .br
293: (bool) Upper case mapping mode; abbreviated
294: .IR ra ;
295: default value is
296: .IR off .
297: When this mode is enabled, all lower case letters will be mapped to
298: upper case by
299: .I tip
300: for transmission to the remote machine.
301: .TP
302: .B raisechar
303: .br
304: (char) The input character used to toggle upper case mapping mode;
305: abbreviated
306: .IR rc ;
307: default value is `^A'.
308: .TP
309: .B record
310: .br
311: (str) The name of the file in which a session script is recorded;
312: abbreviated
313: .IR rec ;
314: default value is ``tip.record''.
315: .TP
316: .B script
317: .br
318: (bool) Session scripting mode; abbreviated
319: .IR sc ;
320: default is
321: .IR off .
322: When
323: .I script
324: is
325: .IR true ,
326: .I tip
327: will record everything transmitted by the remote machine in
328: the script record file specified in
329: .IR record .
330: If the
331: .I beautify
332: switch is on, only printable ASCII characters will be included in
333: the script file (those characters betwee 040 and 0177). The
334: variable
335: .I exceptions
336: is used to indicate characters which are an exception to the normal
337: beautification rules.
338: .TP
339: .B tabexpand
340: .br
341: (bool) Expand tabs to spaces during file transfers; abbreviated
342: .IR tab ;
343: default value is
344: .IR false .
345: Each tab is expanded to 8 spaces.
346: .TP
347: .B verbose
348: .br
349: (bool) Verbose mode; abbreviated
350: .IR verb ;
351: default is
352: .IR true .
353: When verbose mode is enabled,
354: .I tip
355: prints messages while dialing, shows the current number
356: of lines transferred during a file transfer operations,
357: and more.
358: .TP
359: .B SHELL
360: .br
361: (str) The name of the shell to use for the ~! command; default
362: value is ``/bin/sh'', or taken from the environment.
363: .TP
364: .B HOME
365: .br
366: (str) The home directory to use for the ~c command; default
367: value is taken from the environment.
368: .PP
369: .SH FILES
370: .ta \w'/usr/spool/uucp/LCK..* 'u
371: .nf
372: /etc/remote global system descriptions
373: /etc/phones global phone number data base
374: ${REMOTE} private system descriptions
375: ${PHONES} private phone numbers
376: ~/.tiprc initialization file.
377: /usr/spool/uucp/LCK..* lock file to avoid conflicts with \fIuucp\fP
378: .fi
379: .SH DIAGNOSTICS
380: Diagnostics are, hopefully, self explanatory.
381: .SH "SEE ALSO"
382: remote(5),
383: phones(5)
384: .SH BUGS
385: The full set of variables is undocumented and should, probably, be
386: paired down.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.