pppusers(4M)                    TCP/IP R4.11                    pppusers(4M)


NAME
       pppusers - PPP link parameters database

DESCRIPTION
       The pppusers file contains the link flags, Async Control Character
       Map, Maximum Receive unit, VJ compression negotiation mode, IP
       address negotiation mode, netmask, local IP address, and remote IP
       address used by pppd(1C).  The format of the /etc/pppusers file is as
       follows:

       paramstag linkflags ACCM MRU compmode addrmode netmask local remote

       Items are delimited by any number of space or tab characters.  A
       leading # character indicates the line is a comment.  Blank lines are
       ignored.

       Paramstag is simply a key for locating the appropriate negotiation
       options and parameters for a given PPP link.  For PPP daemon client-
       mode operation, the dialsystem name specified during PPP daemon
       startup is used as the paramstag.  For PPP daemon server-mode
       operation, the user's login name is used as the paramstag.

       linkflags values a, p, m, i, u, c, and r control the PPP link
       parameters and negotiation operations.  Each flag must be prefixed
       with a + to enable or - to disable the option.  The a flag controls
       Address/Control field compression negotiation, the p flag controls
       Protocol field compression negotiation, the m flag controls Magic
       Number negotiation, the i flag controls IP Address negotiation, the u
       flag controls the Username/Password Authentication Protocol (PAP)
       negotiation, and the c flag controls the Challenge Handshake
       Authentication Protocol (CHAP) negotiation.  If the a, p, m, or i
       flag is unspecified, the default action is to attempt negotiation of
       that particular option.  If the u flag is omitted, the default action
       is to require PAP authentication for the daemon operating in server
       mode and disable PAP negotiation for the daemon operating in client
       mode.  Likewise, if the c flag is omitted, the default action is to
       enable CHAP authentication for the daemon operating in server mode
       and disable CHAP negotiation for the daemon operating in client mode.
       The r flag controls the installation of a default route.  If prefixed
       with a +, the PPP daemon will attempt to install a default route via
       this PPP interface.  If a default route already exists, a warning
       will be reported to the user and link initialization will continue.
       If prefixed with a -, no default route installation will be
       attempted.

       ACCM specifies the Async Control Character Map (specified in hex with
       leading '0x') to negotiate or the string OFF to disable ACCM
       negotiation.

       MRU specifies the Maximum Receive Unit (specified in decimal) to
       negotiate or the string OFF to disable MRU negotiation.

       compmode specifies which version of Van Jacobson header compression
       negotiation (either old, current, or draft) to use or the string OFF
       to disable VJ header compression.

       addrmode specifies which version of IPCP address negotiation (either
       old or draft) to use.

       netmask specifies the netmask (specified in hex with leading '0x' or
       in dotted quad format) for the IP interface.

       local specifies the IP address for the local-side interface.  It may
       be specified as either a valid hostname (which will be looked up
       using gethostbyname(3N)), as a dotted quad IP address, or may be the
       string PEER to indicate that the address is negotiated/supplied by
       the peer.

       remote specifies the IP address for the remote-side interface.  It
       may be specified as either a valid hostname (which will be looked up
       using gethostbyname(3N)), as a dotted quad IP address, or may be the
       string PEER to indicate that the address is negotiated/supplied by
       the peer.

EXAMPLES
       The following example illustrates a /etc/pppusers entry for pppsrvr.
       This entry allows Address/Control field compression negotiation,
       Protocol field compression negotiation, Magic Number negotiation, IP
       address negotiation, disables Username/Password Authentication, and
       specifies the installation of a default route via this PPP interface.
       The PPP daemon will attempt to negotiate an Async Control Character
       Map of 0x0, a Maximum Receive Unit of 1500, VJ header compression
       using the draft negotiation mode, and IP addresses using the draft
       negotiation mode.  The local IP interface netmask will be 0xffffff00
       and ppp-loc will be the local PPP interface address.  The remote
       interface address will be supplied (during IPCP negotiation) by the
       peer.

         pppsrvr +a+p+m+i-u+r 0x0 1500 draft draft 0xffffff00 ppp-loc PEER


FILES
       /etc/pppusers   PPP link parameters database file

SEE ALSO
       pppd(1C), admpppuser(1M), gethostbyname(3N).


Licensed material--property of copyright holder(s)