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