1.\" $OpenBSD: remote.5,v 1.14 2003/09/20 18:15:32 millert Exp $ 2.\" $NetBSD: remote.5,v 1.4 1997/04/20 00:05:27 mellon Exp $ 3.\" 4.\" Copyright (c) 1983, 1991, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. Neither the name of the University nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)remote.5 8.1 (Berkeley) 6/5/93 32.\" 33.Dd June 5, 1993 34.Dt REMOTE 5 35.Os 36.Sh NAME 37.Nm remote 38.Nd remote host description file 39.Sh DESCRIPTION 40The systems known by 41.Xr tip 1 42and their attributes are stored in an 43.Tn ASCII 44file which is structured somewhat like the 45.Xr termcap 5 46file. 47Each line in the file provides a description for a single remote host. 48Fields are separated by a colon 49.Pq Sq \&: . 50Lines ending with a 51.Dq \e 52character immediately followed by a newline are continued on the next line. 53.Pp 54The first entry is the name(s) of the host system. 55If there is more than one name for a system, the names are separated by 56vertical bars 57.Pq Sq \&| . 58After the name of the system comes the fields of the description. 59A field name followed by an equal sign 60.Pq Sq = 61indicates a string value follows. 62A field name followed by a pound sign 63.Pq Sq # 64indicates a following numeric value. 65.Pp 66Entries named 67.Dq tip\&* 68.\"and 69.\".Dq cu\&* 70are used as default entries by 71.Xr tip 1 72.\"and the 73.\".Xr cu 1 74.\"interface to 75.\".Xr tip 1 , 76as follows. 77When 78.Xr tip 1 79is invoked with only a baud rate, it looks for an entry of the form 80.Dq tip<baud rate> . 81E.g. 82.Ic tip -300 83will cause 84.Xr tip 1 85to look for the system tip300. 86.\"When the 87.\".Xr cu 1 88.\"interface is used, entries of the form 89.\".Dq cu300 90.\"are used. 91.Sh CAPABILITIES 92Capabilities are either strings (str), numbers (num), or boolean flags (bool). 93A string capability is specified by 94.Em capability Ns Ar = Ns Em value ; 95for example, 96.Dq dv=/dev/harris . 97A numeric capability is specified by 98.Em capability Ns Ar # Ns Em value ; 99for example, 100.Dq xa#99 . 101A boolean capability is specified by simply listing the capability. 102.Bl -tag -width indent 103.It Sy \&at 104(str) 105Auto call unit type. 106.It Sy \&be 107(bool) 108Initialize the 109.Xr tip 1 110variable 111.Dq beautify 112to 113.Sy on , 114so that non-printable characters will be discarded when scripting. 115.It Sy \&br 116(num) 117The baud rate used in establishing 118a connection to the remote host. 119This is a decimal number. 120The default baud rate is 300 baud. 121.It Sy \&cm 122(str) 123An initial connection message to be sent to the remote host. 124For example, if a host is reached through port selector, this 125might be set to the appropriate sequence required to switch to the host. 126.It Sy \&cu 127(str) 128Call unit if making a phone call. 129Default is the same as the 130.Sy dv 131field. 132.It Sy \&dc 133(bool) 134This host is directly connected, and 135.Xr tip 1 136should not expect carrier detect to be high, nor should it exit if 137carrier detect drops. 138.It Sy \&di 139(str) 140Disconnect message sent to the host when a disconnect is requested by the user. 141.It Sy \&du 142(bool) 143This host is on a dial-up line. 144.It Sy \&dv 145(str) 146.Tn UNIX 147device(s) to open to establish a connection. 148If this file refers to a terminal line, 149.Xr tip 1 150attempts to perform an exclusive open on the device to ensure only 151one user at a time has access to the port. 152.It Sy \&ec 153(bool) 154Initialize the 155.Xr tip 1 156variable 157.Dq echocheck 158to 159.Sy on , 160so that 161.Xr tip 1 162will synchronize with the remote host during file 163transfer by waiting for the last character transmitted to echo. 164.It Sy \&el 165(str) 166Characters marking an end-of-line. 167The default is 168.Dv NULL . 169.Dq ~ 170escapes are only recognized by 171.Xr tip 1 172after one of the characters in 173.Sy el , 174or after a carriage-return. 175.It Sy \&es 176(str) 177The escape character for 178.Xr tip 1 . 179The default is 180.Dq ~ . 181.It Sy \&et 182(num) 183Number of seconds to wait for an echo response when 184.Dq echocheck 185mode is on. 186The default value is 10 seconds. 187.It Sy \&ex 188(str) 189Set of non-printable characters not to be discarded when scripting 190with beautification turned on. 191The default value is 192.Dq \et\en\eb\ef . 193.It Sy \&fo 194(str) 195Character used to force literal data transmission. 196The default value is 197.Sq \e020 198(^P). 199.It Sy \&fs 200(str) 201Frame size for transfers. 202The default frame size is equal to 203.Dv BUFSIZ . 204.It Sy \&hd 205(bool) 206The host uses half-duplex communication, local echo should be performed. 207.It Sy \&hf 208(bool) 209Initialize the 210.Xr tip 1 211variable 212.Dq hardwareflow 213to 214.Sy on , 215so that hardware flow control (CRTSCTS) will be used for the 216connection with the remote host. 217.It Sy \&ie 218(str) 219Input end-of-file marks. 220The default is 221.Dv NULL . 222.It Sy \&nb 223(bool) 224Initialize the 225.Xr tip 1 226variable 227.Dq beautify 228to 229.Sy off , 230so that non-printable characters will not be discarded when scripting. 231.It Sy \&nt 232(bool) 233Initialize the 234.Xr tip 1 235variable 236.Dq tandem 237to 238.Sy off , 239so that XON/XOFF flow control will not be used to throttle data 240from the remote host. 241.It Sy \&nv 242(bool) 243Initialize the 244.Xr tip 1 245variable 246.Dq verbose 247to 248.Sy off , 249so that verbose mode will be turned off. 250.It Sy \&oe 251(str) 252Output end-of-file string. 253The default is 254.Dv NULL . 255When 256.Xr tip 1 257is transferring a file, this string is sent at end-of-file. 258.It Sy \&pa 259(str) 260The type of parity to use when sending data to the host. 261This may be one of 262.Dq even , 263.Dq odd , 264.Dq none , 265.Dq zero 266(always set bit 8 to zero), 267or 268.Dq one 269(always set bit 8 to 1). 270The default is no parity. 271.It Sy \&pn 272(str) 273Telephone number(s) for this host. 274Either a list of arbitrary dialing strings separated by 275commas, or a 276.Ql @ . 277An at sign, 278.Ql @ , 279tells 280.Xr tip 1 281to search the 282.Xr phones 5 283database for the list of telephone numbers. 284.Pp 285For modems or auto-call units that use a 286.Ql \&, 287in their dialing strings (hayes, courier, t3000) 288.Xr tip 1 289will convert any 290.Ql \&= 291in the string to a 292.Ql \&, 293when dialing. 294For modems or auto-call units that use a 295.Ql \&= 296in their dial strings, (v831), 297.Xr tip 1 298will convert any 299.Ql \&_ 300to a 301.Ql \&= 302when dialing. 303.It Sy \&pr 304(str) 305Character that indicates end-of-line on the remote host. 306The default value is 307.Sq \en . 308.It Sy \&ra 309(bool) 310Initialize the 311.Xr tip 1 312variable 313.Dq raise 314to 315.Sy on , 316so that lowercase letters are mapped to uppercase before sending 317them to the remote host. 318.It Sy \&rc 319(str) 320Character that toggles case-mapping mode. 321The default value is 322.Sq \e001 323(^A). 324.It Sy \&re 325(str) 326The file in which to record session scripts. 327The default value is 328.Pa tip.record . 329.It Sy \&rw 330(str) 331Initialize the 332.Xr tip 1 333variable 334.Dq rawftp 335to 336.Sy on , 337so that all characters will be sent as is during file transfers. 338.It Sy \&sc 339(bool) 340Initialize the 341.Xr tip 1 342variable 343.Dq script 344to 345.Sy on , 346so that everything transmitted by the remote host will be recorded. 347.It Sy \&ta 348(bool) 349Initialize the 350.Xr tip 1 351variable 352.Dq tandem 353to 354.Sy on , 355so that XON/XOFF flow control will be used to throttle data 356from the remote host. 357.It Sy \&tb 358(bool) 359Initialize the 360.Xr tip 1 361variable 362.Dq tabexpand 363to 364.Sy on , 365so that each tab will be expanded to 8 spaces during file transfers. 366.It Sy \&tc 367(str) 368Indicates that the list of capabilities is continued in the named description. 369This is used primarily to share common capability information. 370.It Sy \&vb 371(bool) 372Initialize the 373.Xr tip 1 374variable 375.Dq verbose 376to 377.Sy on , 378so that verbose mode will be turned on. 379.El 380.Pp 381Here is a short example showing the use of the capability continuation 382feature: 383.Bd -literal 384UNIX-1200:\e 385:dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200: 386arpavax|ax:\e 387:pn=7654321%:tc=UNIX-1200 388.Ed 389.Sh FILES 390.Bl -tag -width /etc/remote -compact 391.It Pa /etc/remote 392Global database. 393.El 394.Sh SEE ALSO 395.Xr tip 1 , 396.Xr phones 5 397.Sh HISTORY 398The 399.Nm 400file format appeared in 401.Bx 4.2 . 402