ppphosts(4) ppphosts(4)
NAME
ppphosts - Point-to-Point Protocol host name data base
SYNOPSIS
/etc/inet/ppphosts
DESCRIPTION
The /etc/inet/ppphosts file contains information about known
PPP hosts and specifies parameters for PPP connections. The
contents of this file are used by the pppd daemon [see
pppd(1M)].
Files
/etc/hosts
/usr/lib/uucp/Systems
/usr/lib/uucp/Devices
USAGE
The ppphosts file contains one entry for each PPP host to
which the local host supports outgoing PPP connections. The
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. Note that you must create
this login, and any additional ones, manually.
The data items in each entry are separated by white space. A
# indicates the beginning of a comment; characters appearing
after the # are ignored. An entry may be extended over more
than one line by making a \ the last character of all lines of
the entry except the last line.
The ppphosts file contains lines of the form:
name tty system [options]
where:
name is the remote host name or a PPP login name. A
login name is prepended with * (see examples).
tty is the tty name for direct connection (set to
the default by using - as a place-holder)
system is the UUCP system name for this remote host.
Use the default - for login entries.
Copyright 1994 Novell, Inc. Page 1
ppphosts(4) ppphosts(4)
options may be any combination of the options described
below. 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 is forever)
tmout=restart-time
Set packet timeout value for PPP configure-
request and termination-request packets to
restart-time (default is 3 seconds)
conf=num Set the maximum number of PPP configure request
retries to num (default is 10)
term=num Set the maximum number of PPP termination
request retries to num (default is 2)
nak=num Set the maximum number of PPP configure nak
retries to num (default is 10)
Link Options
mru=num Set the maximum receive units to num (default
is 296)
accm=num Set the asynchronous control character map to
num, which must be a hexadecimal number
(default is 0x00000000)
pap Do password authentication (default is no
password authentication)
nomgc Disable magic number negotiation (default is
enable magic number negotiation)
protcomp Do protocol field compression (default is no
protocol field compression)
accomp Do address-control field compression (default
is no address-control field compression)
IP Options
ipaddr Do IP address negotiation (default is no IP
address negotiation)
Copyright 1994 Novell, Inc. Page 2
ppphosts(4) ppphosts(4)
rfc1172addr Using RFC1172 IP address negotiation (default
is using RFC1332 IP address negotiation)
VJ Do VJ Compressed TCP/IP (default is no VJ
compressed TCP/IP)
Other Options
old Remote side using ISC TCP Release 4 (default is
remote side not using ISC TCP Release 4)
paptmout=tmout Set the PPP PAP authenticate timeout to tmout
minutes (default is 1)
debug=level Set the level of debugging to level. The value
of level is the result of or'ing the following
flags. Flags may be specified in decimal, or
in octal (must be prefixed with 0), or in
hexadecimal (must be prefixed with 0x). The
flags are:
0 Disable debugging (the default value).
1 Log option negotiation messages.
2 Log state transition messages.
4 Log PPP-level packet trace messages.
8 Log ASYH-level packet trace messages.
All debug messages are printed to syslog(3G).
Warnings
The following guidelines should be followed by the Network
Administrator when creating and maintaining the
/etc/inet/ppphosts file:
The host name should have a corresponding entry in
/etc/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
Copyright 1994 Novell, Inc. Page 3
ppphosts(4) ppphosts(4)
The uucp system name should have a corresponding entry
in /usr/lib/uucp/Systems
The Network Administrator should ensure consistent entries in
the /etc/inet/ppphosts, /usr/lib/uucp/Systems, and
/usr/lib/uucp/Devices files for the PPP hosts.
The PPP user login is not an ordinary login: it should be
/usr/lib/ppp, and the shell should be /usr/lib/ppp/ppp.
Example 1
Example 1 shows a typical /etc/inet/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
The * indicates this entry as the PPP login name for the local
host. Modify this entry to specify PPP options for local host
control of PPP connections originated by remote hosts.
Example 2
Examples 2 and 3 show how typical data in the
/etc/inet/ppphosts, /etc/hosts, /usr/lib/uucp/Systems, and
/usr/lib/uucp/Devices files could be used for reaching a PPP
host.
Example 2 shows a Direct Line between PPP Hosts:
PPP hosts: 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
Example 3 shows a Dial-up Line between PPP Hosts:
Copyright 1994 Novell, Inc. Page 4
ppphosts(4) ppphosts(4)
PPP hosts: homer_ppp - homer idle=5
hosts: 128.2.129.5 homer_ppp
Devices: ACU tty1A - 2400 dialT1500 T
Systems: homer Any ACU 2400 555-1234 login: nppp Password: PPP_password
REFERENCES
hosts(4), pppd(1M), uucp(1C)
Copyright 1994 Novell, Inc. Page 5