2.11BSD#431 - /usr/man/cat5/remote.0

REMOTE(5)	    UNIX Programmer's Manual		REMOTE(5)


NAME
     remote - remote host description file

DESCRIPTION
     The systems known by tip(1C) and their attributes are stored
     in an ASCII file which is structured somewhat like the
     termcap(5) file.  Each line in the file provides a descrip-
     tion for a single system.	Fields are separated by a colon
     (``:'').  Lines ending in a \ character with an immediately
     following newline are continued on the next line.

     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 fol-
     lowed by a `#' sign indicates a following numeric value.

     Entries named ``tip*'' and ``cu*'' are used as default
     entries by tip, and the cu interface to tip, as follows.
     When tip 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 cu inter-
     face is used, entries of the form ``cu300'' are used.

CAPABILITIES
     Capabilities are either strings (str), numbers (num), or
     boolean flags (bool).  A string capability is specified by
     capability=value; e.g. ``dv=/dev/harris''.  A numeric capa-
     bility is specified by capability#value; e.g. ``xa#99''.  A
     boolean capability is specified by simply listing the capa-
     bility.

     at   (str) Auto call unit type.

     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.

     cm   (str) An initial connection message to be sent to the
	  remote host.	For example, if a host is reached through
	  port selector, this might be set to the appropriate
	  sequence required to switch to the host.

     cu   (str) Call unit if making a phone call.  Default is the
	  same as the `dv' field.

     di   (str) Disconnect message sent to the host when a
	  disconnect is requested by the user.

     du   (bool) This host is on a dial-up line.


Printed 11/26/99	  May 15, 1985				1


REMOTE(5)	    UNIX Programmer's Manual		REMOTE(5)


     dv   (str) UNIX device(s) to open to establish a connection.
	  If this file refers to a terminal line, tip(1C)
	  attempts to perform an exclusive open on the device to
	  insure only one user at a time has access to the port.

     el   (str) Characters marking an end-of-line. The default is
	  NULL.  `~' escapes are only recognized by tip after one
	  of the characters in `el', or after a carriage-return.

     fs   (str) Frame size for transfers. The default frame size
	  is equal to BUFSIZ.

     hd   (bool) The host uses half-duplex communication, local
	  echo should be performed.

     ie   (str) Input end-of-file marks.  The default is NULL.

     oe   (str) Output end-of-file string.  The default is NULL.
	  When tip is transferring a file, this string is sent at
	  end-of-file.

     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.

     pn   (str) Telephone number(s) for this host.  If the tele-
	  phone number field contains an @ sign, tip searches the
	  file /etc/phones file for a list of telephone numbers;
	  c.f.	phones(5).

     tc   (str) Indicates that the list of capabilities is con-
	  tinued in the named description.  This is used pri-
	  marily to share common capability information.

     Here is a short example showing the use of the capability
     continuation feature:

     UNIX-1200:\
	  :dv=/dev/cau0:el=^D^U^C^S^Q^O@:du:at=ventel:ie=#$%:oe=^D:br#1200:
     arpavax|ax:\
	  :pn=7654321%:tc=UNIX-1200

FILES
     /etc/remote

SEE ALSO
     tip(1C), phones(5)


Printed 11/26/99	  May 15, 1985				2