BSD 4_3_Tahoe development

[unix-history] / usr / man / cat5 / remote.0

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



N\bNA\bAM\bME\bE
     remote - remote host description file

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     The systems known by _\bt_\bi_\bp(1C) and their attributes are stored
     in an ASCII file which is structured somewhat like the
     _\bt_\be_\br_\bm_\bc_\ba_\bp(5) file.  Each line in the file provides a descrip-
     tion for a single _\bs_\by_\bs_\bt_\be_\bm.	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 _\bt_\bi_\bp, and the _\bc_\bu interface to _\bt_\bi_\bp, as follows.
     When _\bt_\bi_\bp 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 _\bc_\bu inter-
     face is used, entries of the form ``cu300'' are used.

C\bCA\bAP\bPA\bAB\bBI\bIL\bLI\bIT\bTI\bIE\bES\bS
     Capabilities are either strings (str), numbers (num), or
     boolean flags (bool).  A string capability is specified by
     _\bc_\ba_\bp_\ba_\bb_\bi_\bl_\bi_\bt_\by=_\bv_\ba_\bl_\bu_\be; e.g. ``dv=/dev/harris''.  A numeric capa-
     bility is specified by _\bc_\ba_\bp_\ba_\bb_\bi_\bl_\bi_\bt_\by#_\bv_\ba_\bl_\bu_\be; e.g. ``xa#99''.  A
     boolean capability is specified by simply listing the capa-
     bility.

     a\bat\bt   (str) Auto call unit type.

     b\bbr\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.

     c\bcm\bm   (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.

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

     d\bdi\bi   (str) Disconnect message sent to the host when a
	  disconnect is requested by the user.

     d\bdu\bu   (bool) This host is on a dial-up line.




Printed 7/9/88		  May 15, 1985				1






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



     d\bdv\bv   (str) UNIX device(s) to open to establish a connection.
	  If this file refers to a terminal line, _\bt_\bi_\bp(1C)
	  attempts to perform an exclusive open on the device to
	  insure only one user at a time has access to the port.

     e\bel\bl   (str) Characters marking an end-of-line. The default is
	  NULL.  `~' escapes are only recognized by _\bt_\bi_\bp after one
	  of the characters in `el', or after a carriage-return.

     f\bfs\bs   (str) Frame size for transfers. The default frame size
	  is equal to BUFSIZ.

     h\bhd\bd   (bool) The host uses half-duplex communication, local
	  echo should be performed.

     i\bie\be   (str) Input end-of-file marks.  The default is NULL.

     o\boe\be   (str) Output end-of-file string.  The default is NULL.
	  When _\bt_\bi_\bp is transferring a file, this string is sent at
	  end-of-file.

     p\bpa\ba   (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.

     p\bpn\bn   (str) Telephone number(s) for this host.  If the tele-
	  phone number field contains an @ sign, _\bt_\bi_\bp searches the
	  file /_\be_\bt_\bc/_\bp_\bh_\bo_\bn_\be_\bs file for a list of telephone numbers;
	  c.f.	_\bp_\bh_\bo_\bn_\be_\bs(5).

     t\btc\bc   (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

F\bFI\bIL\bLE\bES\bS
     /etc/remote

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     tip(1C), phones(5)







Printed 7/9/88		  May 15, 1985				2