Commit | Line | Data |
---|---|---|
3acf4594 KM |
1 | .\" Copyright (c) 1983 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
f661e5fb | 5 | .\" @(#)remote.5 6.1 (Berkeley) %G% |
3acf4594 | 6 | .\" |
f661e5fb | 7 | .TH REMOTE 5 "" |
3acf4594 KM |
8 | .UC 5 |
9 | .SH NAME | |
10 | remote \- remote host description file | |
11 | .SH DESCRIPTION | |
12 | The systems known by | |
13 | .IR tip (1C) | |
14 | and their attributes are stored in an ASCII file which | |
15 | is structured somewhat like the | |
16 | .IR termcap (5) | |
17 | file. Each line in the file provides a description for a single | |
18 | .IR system . | |
19 | Fields are separated by a colon (``:''). | |
20 | Lines ending in a \e character with an immediately following newline are | |
21 | continued on the next line. | |
22 | .PP | |
23 | The first entry is the name(s) of the host system. If there is more | |
24 | than one name for a system, the names are separated by vertical bars. | |
25 | After the name of the system comes the fields of the description. A | |
26 | field name followed by an `=' sign indicates a string value follows. A field | |
27 | name followed by a `#' sign indicates a following numeric value. | |
28 | .PP | |
29 | Entries named ``tip*'' and ``cu*'' | |
30 | are used as default entries by | |
31 | .IR tip , | |
32 | and the | |
33 | .I cu | |
34 | interface to | |
35 | .IR tip , | |
36 | as follows. When | |
37 | .I tip | |
38 | is invoked with only a phone number, it looks for an entry | |
39 | of the form ``tip300'', where 300 is the baud rate with | |
40 | which the connection is to be made. When the | |
41 | .I cu | |
42 | interface is used, entries of the form ``cu300'' are used. | |
43 | .SH CAPABILITIES | |
44 | Capabilities are either strings (str), numbers (num), or boolean | |
45 | flags (bool). A string capability is specified by | |
46 | .IR capability = value ; | |
47 | e.g. ``dv=/dev/harris''. A numeric capability is specified by | |
48 | .IR capability # value ; | |
49 | e.g. ``xa#99''. A boolean capability is specified by simply listing | |
50 | the capability. | |
51 | .TP 0.5i | |
52 | .B at | |
53 | (str) | |
54 | Auto call unit type. | |
55 | .TP 0.5i | |
56 | .B br | |
57 | (num) | |
58 | The baud rate used in establishing | |
59 | a connection to the remote host. | |
60 | This is a decimal number. | |
61 | The default baud rate is 300 baud. | |
62 | .TP 0.5i | |
63 | .B cm | |
64 | (str) | |
65 | An initial connection message to be sent | |
66 | to the remote host. For example, if a | |
67 | host is reached through port selector, this | |
68 | might be set to the appropriate sequence | |
69 | required to switch to the host. | |
70 | .TP 0.5i | |
71 | .B cu | |
72 | (str) | |
73 | Call unit if making a phone call. | |
74 | Default is the same as the `dv' field. | |
75 | .TP 0.5i | |
76 | .B di | |
77 | (str) | |
78 | Disconnect message sent to the host when a | |
79 | disconnect is requested by the user. | |
80 | .TP 0.5i | |
81 | .B du | |
82 | (bool) | |
83 | This host is on a dial-up line. | |
84 | .TP 0.5i | |
85 | .B dv | |
86 | (str) | |
87 | UNIX device(s) to open to establish a connection. | |
88 | If this file refers to a terminal line, | |
89 | .IR tip (1C) | |
90 | attempts to perform an exclusive open on the device to insure only | |
91 | one user at a time has access to the port. | |
92 | .TP 0.5i | |
93 | .B el | |
94 | (str) | |
95 | Characters marking an end-of-line. | |
96 | The default is NULL. `~' escapes are only | |
97 | recognized by | |
98 | .I tip | |
99 | after one of the characters in `el', | |
100 | or after a carriage-return. | |
101 | .TP 0.5i | |
102 | .B fs | |
103 | (str) | |
104 | Frame size for transfers. | |
105 | The default frame size is equal to BUFSIZ. | |
106 | .TP 0.5i | |
107 | .B hd | |
108 | (bool) | |
109 | The host uses half-duplex communication, local | |
110 | echo should be performed. | |
111 | .TP 0.5i | |
112 | .B ie | |
113 | (str) | |
114 | Input end-of-file marks. | |
115 | The default is NULL. | |
116 | .TP 0.5i | |
117 | .B oe | |
118 | (str) | |
119 | Output end-of-file string. | |
120 | The default is NULL. When | |
121 | .I tip | |
122 | is transferring a file, this | |
123 | string is sent at end-of-file. | |
124 | .TP 0.5i | |
125 | .B pa | |
126 | (str) | |
127 | The type of parity to use when sending data | |
128 | to the host. This may be one of ``even'', | |
129 | ``odd'', ``none'', ``zero'' (always set bit 8 to zero), | |
130 | ``one'' (always set bit 8 to 1). The default | |
131 | is even parity. | |
132 | .TP 0.5i | |
133 | .B pn | |
134 | (str) | |
135 | Telephone number(s) for this host. | |
136 | If the telephone number field contains | |
137 | an @ sign, | |
138 | .I tip | |
139 | searches the file | |
140 | .I /etc/phones | |
141 | file for a list of telephone numbers; | |
142 | c.f. | |
143 | .IR phones (5). | |
144 | .TP 0.5i | |
145 | .B tc | |
146 | (str) | |
147 | Indicates that the list of capabilities is continued | |
148 | in the named description. This is used | |
149 | primarily to share common capability information. | |
150 | .PP | |
151 | Here is a short example showing the use of the capability continuation | |
152 | feature: | |
153 | .PP | |
154 | .nf | |
155 | .ta 0.5i | |
156 | UNIX-1200:\e | |
157 | :dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200: | |
158 | arpavax|ax:\e | |
159 | :pn=7654321%:tc=UNIX-1200 | |
160 | .fi | |
161 | .SH FILES | |
162 | /etc/remote | |
163 | .SH "SEE ALSO" | |
164 | tip(1C), | |
165 | phones(5) |