212 lines
6.1 KiB
Groff
212 lines
6.1 KiB
Groff
.\" $NetBSD: remote.5,v 1.8 1999/03/17 20:19:47 garbled Exp $
|
|
.\"
|
|
.\" Copyright (c) 1983, 1991, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)remote.5 8.1 (Berkeley) 6/5/93
|
|
.\"
|
|
.Dd June 5, 1993
|
|
.Dt REMOTE 5
|
|
.Os
|
|
.Sh NAME
|
|
.Nm remote
|
|
.Nd remote host description file
|
|
.Sh DESCRIPTION
|
|
The systems known by
|
|
.Xr tip 1
|
|
and their attributes are stored in an
|
|
.Tn ASCII
|
|
file which
|
|
is structured somewhat like the
|
|
.Xr termcap 5
|
|
file.
|
|
Each line in the file provides a description for a single
|
|
.Em system .
|
|
Fields are separated by a colon (``:'').
|
|
Lines ending in a \e character with an immediately following newline are
|
|
continued on the next line.
|
|
.Pp
|
|
The first entry is the name(s) of the host system.
|
|
If there is more than one name for a system, the names are separated
|
|
by vertical bars.
|
|
After the name of the system comes the fields of the description.
|
|
A field name followed by an `=' sign indicates a string value follows.
|
|
A field name followed by a `#' sign indicates a following numeric value.
|
|
.Pp
|
|
Entries named ``tip*'' and ``cu*''
|
|
are used as default entries by
|
|
.Xr tip 1 ,
|
|
and the
|
|
.Xr cu 1
|
|
interface to
|
|
.Xr tip 1 ,
|
|
as follows.
|
|
When
|
|
.Xr tip 1
|
|
is invoked with only a phone number, it looks for an entry
|
|
of the form ``tip300'', where 300 is the baud rate with
|
|
which the connection is to be made.
|
|
When the
|
|
.Xr cu 1
|
|
interface is used, entries of the form ``cu300'' are used.
|
|
.Sh CAPABILITIES
|
|
Capabilities are either strings (str), numbers (num), or boolean flags (bool).
|
|
A string capability is specified by
|
|
.Em capability Ns Ar = Ns Em value ;
|
|
for example, ``dv=/dev/harris''.
|
|
A numeric capability is specified by
|
|
.Em capability Ns Ar # Ns Em value ;
|
|
for example, ``xa#99''.
|
|
A boolean capability is specified by simply listing the capability.
|
|
.Bl -tag -width indent
|
|
.It Cm \&at
|
|
(str)
|
|
Auto call unit type.
|
|
.It Cm \&br
|
|
(num)
|
|
The baud rate used in establishing
|
|
a connection to the remote host.
|
|
This is a decimal number.
|
|
The default baud rate is 300 baud.
|
|
.It Cm \&cm
|
|
(str)
|
|
An initial connection message to be sent to the remote host.
|
|
For example, if a host is reached through a port selector, this might
|
|
be set to the appropriate sequence required to switch to the host.
|
|
.It Cm \&cu
|
|
(str)
|
|
Call unit if making a phone call.
|
|
Default is the same as the `dv' field.
|
|
.It Cm \&dc
|
|
(bool)
|
|
This host is directly connected, and tip should not expect carrier detect
|
|
to be high, nor should it exit if carrier detect drops.
|
|
.It Cm \&di
|
|
(str)
|
|
Disconnect message sent to the host when a
|
|
disconnect is requested by the user.
|
|
.It Cm \&du
|
|
(bool)
|
|
This host is on a dial-up line.
|
|
.It Cm \&dv
|
|
(str)
|
|
.Ux
|
|
device(s) to open to establish a connection.
|
|
If this file refers to a terminal line,
|
|
.Xr tip 1
|
|
attempts to perform an exclusive open on the device to insure only
|
|
one user at a time has access to the port.
|
|
.It Cm \&el
|
|
(str)
|
|
Characters marking an end-of-line.
|
|
The default is
|
|
.Dv NULL .
|
|
`~' escapes are only
|
|
recognized by
|
|
.Xr tip 1
|
|
after one of the characters in `el',
|
|
or after a carriage-return.
|
|
.It Cm \&fs
|
|
(str)
|
|
Frame size for transfers.
|
|
The default frame size is equal to
|
|
.Dv BUFSIZ .
|
|
.It Cm \&hd
|
|
(bool)
|
|
The host uses half-duplex communication, local
|
|
echo should be performed.
|
|
.It Cm \&hf
|
|
(bool)
|
|
Use hardware (RTS/CTS) flow control.
|
|
.It Cm \&ie
|
|
(str)
|
|
Input end-of-file marks.
|
|
The default is
|
|
.Dv NULL .
|
|
.It Cm \&oe
|
|
(str)
|
|
Output end-of-file string.
|
|
The default is
|
|
.Dv NULL .
|
|
When
|
|
.Xr tip 1
|
|
is transferring a file, this
|
|
string is sent at end-of-file.
|
|
.It Cm \&pa
|
|
(str)
|
|
The type of parity to use when sending data
|
|
to the host.
|
|
This may be one of ``even'', ``odd'', ``none'', ``zero'' (always
|
|
set bit 8 to zero), ``one'' (always set bit 8 to 1).
|
|
The default is even parity.
|
|
.It Cm \&pn
|
|
(str)
|
|
Telephone number(s) for this host.
|
|
If the telephone number field contains an @ sign,
|
|
.Xr tip 1
|
|
searches the file
|
|
.Pa /etc/phones
|
|
file for a list of telephone numbers;
|
|
see
|
|
.Xr phones 5 .
|
|
.It Cm \&tc
|
|
(str)
|
|
Indicates that the list of capabilities is continued in the named
|
|
description.
|
|
This is used primarily to share common capability information.
|
|
.El
|
|
.Pp
|
|
Here is a short example showing the use of the capability continuation
|
|
feature:
|
|
.Bd -literal
|
|
UNIX-1200:\e
|
|
:dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200:
|
|
arpavax|ax:\e
|
|
:pn=7654321%:tc=UNIX-1200
|
|
.Ed
|
|
.Sh FILES
|
|
.Bl -tag -width /etc/remote -compact
|
|
.It Pa /etc/remote
|
|
The
|
|
.Nm remote
|
|
host description file
|
|
resides in
|
|
.Pa /etc .
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr tip 1 ,
|
|
.Xr phones 5
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
file format appeared in
|
|
.Bx 4.2 .
|