1.\" $OpenBSD: remote.5,v 1.13 2003/06/06 13:28:13 jmc 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 \&ie 208(str) 209Input end-of-file marks. 210The default is 211.Dv NULL . 212.It Sy \&nb 213(bool) 214Initialize the 215.Xr tip 1 216variable 217.Dq beautify 218to 219.Sy off , 220so that non-printable characters will not be discarded when scripting. 221.It Sy \&nt 222(bool) 223Initialize the 224.Xr tip 1 225variable 226.Dq tandem 227to 228.Sy off , 229so that XON/XOFF flow control will not be used to throttle data 230from the remote host. 231.It Sy \&nv 232(bool) 233Initialize the 234.Xr tip 1 235variable 236.Dq verbose 237to 238.Sy off , 239so that verbose mode will be turned off. 240.It Sy \&oe 241(str) 242Output end-of-file string. 243The default is 244.Dv NULL . 245When 246.Xr tip 1 247is transferring a file, this string is sent at end-of-file. 248.It Sy \&pa 249(str) 250The type of parity to use when sending data to the host. 251This may be one of 252.Dq even , 253.Dq odd , 254.Dq none , 255.Dq zero 256(always set bit 8 to zero), 257or 258.Dq one 259(always set bit 8 to 1). 260The default is no parity. 261.It Sy \&pn 262(str) 263Telephone number(s) for this host. 264Either a list of arbitrary dialing strings separated by 265commas, or a 266.Ql @ . 267An at sign, 268.Ql @ , 269tells 270.Xr tip 1 271to search the 272.Xr phones 5 273database for the list of telephone numbers. 274.Pp 275For modems or auto-call units that use a 276.Ql \&, 277in their dialing strings (hayes, courier, t3000) 278.Xr tip 1 279will convert any 280.Ql \&= 281in the string to a 282.Ql \&, 283when dialing. 284For modems or auto-call units that use a 285.Ql \&= 286in their dial strings, (v831), 287.Xr tip 1 288will convert any 289.Ql \&_ 290to a 291.Ql \&= 292when dialing. 293.It Sy \&pr 294(str) 295Character that indicates end-of-line on the remote host. 296The default value is 297.Sq \en . 298.It Sy \&ra 299(bool) 300Initialize the 301.Xr tip 1 302variable 303.Dq raise 304to 305.Sy on , 306so that lowercase letters are mapped to uppercase before sending 307them to the remote host. 308.It Sy \&rc 309(str) 310Character that toggles case-mapping mode. 311The default value is 312.Sq \e001 313(^A). 314.It Sy \&re 315(str) 316The file in which to record session scripts. 317The default value is 318.Pa tip.record . 319.It Sy \&rw 320(str) 321Initialize the 322.Xr tip 1 323variable 324.Dq rawftp 325to 326.Sy on , 327so that all characters will be sent as is during file transfers. 328.It Sy \&sc 329(bool) 330Initialize the 331.Xr tip 1 332variable 333.Dq script 334to 335.Sy on , 336so that everything transmitted by the remote host will be recorded. 337.It Sy \&ta 338(bool) 339Initialize the 340.Xr tip 1 341variable 342.Dq tandem 343to 344.Sy on , 345so that XON/XOFF flow control will be used to throttle data 346from the remote host. 347.It Sy \&tb 348(bool) 349Initialize the 350.Xr tip 1 351variable 352.Dq tabexpand 353to 354.Sy on , 355so that each tab will be expanded to 8 spaces during file transfers. 356.It Sy \&tc 357(str) 358Indicates that the list of capabilities is continued in the named description. 359This is used primarily to share common capability information. 360.It Sy \&vb 361(bool) 362Initialize the 363.Xr tip 1 364variable 365.Dq verbose 366to 367.Sy on , 368so that verbose mode will be turned on. 369.El 370.Pp 371Here is a short example showing the use of the capability continuation 372feature: 373.Bd -literal 374UNIX-1200:\e 375:dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200: 376arpavax|ax:\e 377:pn=7654321%:tc=UNIX-1200 378.Ed 379.Sh FILES 380.Bl -tag -width /etc/remote -compact 381.It Pa /etc/remote 382Global database. 383.El 384.Sh SEE ALSO 385.Xr tip 1 , 386.Xr phones 5 387.Sh HISTORY 388The 389.Nm 390file format appeared in 391.Bx 4.2 . 392