ppphosts(SFF) ppphosts(SFF) Name ppphosts - Point-to-Point protocol host name database Description The /etc/ppphosts file contains information about known remote PPP hosts and specifies parameters for PPP connections. The contents of this file is used by the pppd daemon (see pppd(ADMN)). This file must contain one entry for each remote PPP host to which the local host will establish outgoing PPP connections. This file must also contain at least one login entry which specifies a login name that remote hosts can use to request connections with the local host. One login entry (*nppp) is created automatically when netconfig is executed to con- figure PPP. Additional login entries may be created manually. All login entries may contain options that specify parameters for incoming connec- tions to the local host. The data items in each entry should be separated by ``white space.'' A ``#'' indicates the beginning of a comment; characters appearing after ``#'' are ignored. An entry may be extended over more than one line by making a ``\'' the last character of all lines of the entry but the last line. This file should have the following format: name tty system [options] where: name is a remote host name or a PPP login name. A login name is prepended with ``*'' (see the examples). tty is the tty name for direct connection (defaulted by using ``-'' place holder). Use the default ``-'' for login entries. system is the UUCP system name for this remote host. Use the default ``-'' for login entries. options may be any combination of the following. Some of the options include default values if none are explicitly set. Timer options idle=idletime Set inactivity timeout to idletime minutes (default = ``for- ever''). tmout=restart-time Set packet timeout value for PPP configure-request and termination-request packets to restart-time (default = 3 seconds). conf=num Set the maximum number of PPP configure request retries to num (default = 10). term=num Set the maximum number of PPP termination request retries to num (default = 2). nak=num Set the maximum number of PPP configure nak retries to num (default = 10). Link options mru=num Set the maximum receive units to num (default = 296). accm=num Set the asynchronous control character map to num, which must be a hexadecimal number (default = 0x00000000). pap Do password authentication (default = no password authentica- tion). nomgc Disable magic number negotiation (default = enable magic number negotiation). protcomp Do protocol field compression (default = no protocol field compression). accomp Do address-control field compression (default = no address- control field compression). IP options ipaddr Do IP address negotiation (default = no IP address negotia- tion). rfc1172addr Using RFC 1172 IP address negotiation (default = using RFC 1332 IP address negotiation). VJ Do VJ Compressed TCP/IP (default = no VJ compressed TCP/IP). Other options old Remote side using SCO TCP/IP Release 1.2.0 (default = remote side not using SCO TCP/IP Release 1.2.0). paptmout=tmout Set the PPP PAP authenticate timeout to tmout (default = 1). rtscts Set the line to use hardware (RTS/CTS) flow control (default = no flow control). This file should be created and maintained by the Network Administrator. These guidelines should be followed in creating /etc/ppphosts: + The host name should have a corresponding entry in /etc/hosts, see hosts(SFF). + Optional parameters may be defaulted by omitting the item. + The tty name (if other than ``-'') should have a corresponding entry in /usr/lib/uucp/Devices. + The uucp system name should have a corresponding entry in /usr/lib/uucp/Systems. Examples Typical /etc/ppphosts file: # # Tty name UUCP Inactivity #Host (direct system timeout Conf #name connect) name (minutes) retries # homer_ppp - homer idle=5 bart_ppp tty01 bart idle=1 conf=5 *nppp - - idle=3 conf=5 In Example 1 above, the *nppp entry is added to /etc/ppphosts automati- cally when netconfig is executed to configure PPP. The ``*'' identifies this entry as the PPP login name for the local host. Modify the *nppp entry to specify PPP options for local host control of PPP connections originated by remote hosts. Using the guidelines shown in the ``Basic network utilities'' Section of the SCO UNIX System V Release 3.2 System Administrator's Guide, Examples 2 and 3 show how typical data in the /etc/ppphosts, /etc/hosts, /usr/lib/uucp/Systems, and /usr/lib/uucp/Devices files could be used for reaching a PPP host. A direct line between PPP hosts: ppphosts: bart_ppp tty01 bart idle=5 hosts: 128.2.129.2 bart_ppp Devices: Direct tty01 - 9600 direct Systems: bart Any Direct 9600 - login: nppp Password: PPP_password The special user_name nppp will initiate the remote login session; also note that the following four network-dependent data items in the above table entries must match: bart_ppp, bart, tty01, and Direct. A dial-up line between PPP hosts: ppphosts: homer_ppp - homer idle=5 hosts: 128.2.129.5 homer_ppp Devices: ACU tty1A - 2400 dial T1500 \T systems: homer Any ACU 2400 555-1234 login: nppp Password: PPP_password Files /etc/hosts /etc/ppphosts /usr/lib/uucp/Systems /usr/lib/uucp/Devices See also hosts(SFF), pppd(ADMN), devices(F), systems(F), uucp(C) System Administrator's Guide User considerations The Network Administrator should ensure consistent entries in the /etc/ppphosts, /etc/hosts, /usr/lib/uucp/Systems, and /usr/lib/uucp/De- vices files for the PPP hosts.