NAME

ppphosts − Point-to-Point Protocol Host name database

SYNOPSIS

/etc/inet/ppphosts

DESCRIPTION

The /etc/inet/ppphosts file contains information about known PPP hosts.  The contents of this file will be used by the in.pppd daemon [see pppd(1M)].  This file contains one entry for each PPP host.  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:

namettysystem[options]

where

name is the remote host name or PPP login name

tty is the tty name for direct connection (defaulted by using ’-’ place-holder)

system is the UUCP system name for this remote host

options
may be any combination of the following.  Some of the options include default values if none are explicitly set.

Timer options

idle=idle_time
Set inactivity timeout to idle_time minutes (default = 0 (forever))

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 authentication)

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 negotiation)

rfc1172addr
Using RFC1172 IP address negotiation (default = using RFC1332 IP address negotiation)

VJ Do VJ Compressed TCP/IP (default = no VJ compressed TCP/IP)

Other options

old Remote side using ISC TCP Release 4 (default = remote side not using ISC TCP Release 4)

paptmout=tmout
Set the PPP PAP authenticate timeout to tmout (default = 1)

These data items should be separated by “white space”.  A ‘#’ indicates the beginning of a comment; characters appearing after ‘#’ are ignored. 

This file should be created and maintained by the Network Administrator.  These guidelines should be followed in creating /etc/inet/ppphosts :

• The host name should have a corresponding entry in /etc/inet/hosts [see hosts(4)]

• 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

        Example 1  −  Typical /etc/inet/ppphosts File

#
#dstttySystemmodifiers
#
homer_ppp−homeridle=5
bart_ppptty01bartidle=10conf=5

Using the guidelines shown in the “Basic Network Utilities”, Examples 2 and 3 show how typical data in the /etc/inet/ppphosts, /usr/lib/uucp/Systems, and /usr/lib/uucp/Devices files could be used for reaching a PPP host. 
 
        Example 2  −  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. 
 
        Example 3  −  A Dial-up Line between PPP Hosts

   ppphosts:   homer_ppp   -    homer   idle=5

   hosts:        128.2.129.5   homer_ppp

   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
/usr/lib/uucp/Dialers

SEE ALSO

uucp(1), pppd(1M), host(4)

USER CONSIDERATIONS

The Network Administrator should ensure consistent entries in the /etc/inet/ppphosts, /usr/lib/uucp/Systems, /usr/lib/uucp/Devices, and /usr/lib/uucp/Dialers files for the PPP hosts.