admpppuser(1M) DG/UX R4.11 admpppuser(1M)
NAME
admpppuser - manage pppusers database
SYNOPSIS
admpppuser -o add -f linkflags -A ACCM -M MRU -c compmode -a
addrmode -m netmask -h local -r remote paramstag
admpppuser -o modify [-n newparamstag] [-f linkflags] [-A ACCM]
[-M MRU] [-c compmode] [-a addrmode] [-m netmask] [-h local] [-r
remote] paramstag
admpppuser -o delete paramstag
admpppuser -o list [ -qv ] [ paramstag ... ]
where:
linkflags PPP negotiation and link parameter flags: a, p, m, i, u,
c, and r preceded by + or -
ACCM The Async Control Character Map
MRU The Maximum Receive Unit
compmode The header compression negotiation mode
addrmode The IP address negotiation mode
netmask A number specifying the network mask
local The hostname or IP address assigned to the local host
remote The hostname or IP address assigned to the remote host
newparamstag
A new tag specifying an entry in the pppusers database;
this tag will replace the existing tag in the pppusers
database
paramstag A tag specifying an entry in the pppusers database
DESCRIPTION
Admpppuser manages the /etc/pppusers database. This database
contains the PPP link flags, Async Control Character Map, Maximum
Receive Unit, VJ compression negotiation mode, Address negotiation
mode, netmask, local IP address, and remote IP address used by
pppd(1C).
Operations
add Create a new entry.
modify Change an existing entry.
delete Remove an entry.
list List one or more entries. Information is listed about each of
the paramstag given; if paramstag is all or unspecified,
information about all entries is listed.
Options
-f linkflags
PPP link parameter and negotiation flags: a, p, m, i, u,
c, and r preceded by + or -. This option specifies a
series of flags which control the PPP link options and
negotiation parameters. 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. 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.
-A ACCM A number (specified in hex with leading '0x') specifying
the Async Control Character Map (ACCM) to negotiate or
the string OFF to disable ACCM negotiation.
-M MRU A number (specified in decimal) specifying the Maximum
Receive Unit to negotiate or the string OFF to disable
MRU negotiation.
-c compmode A string (old, current, draft) specifying which version
of Van Jacobson header compression negotiation to use or
the string OFF to disable VJ header compression.
-a addrmode A string (old, draft) specifying which version of IPCP
address negotiation to use.
-m netmask A number (specified in hex with leading '0x' or in dotted
quad format) specifying the netmask for the interface.
-h local A hostname or IP address assigned to the local-side PPP
interface. This can be expressed either as a name (found
in the hosts database) or as an Internet address
expressed in the Internet standard dot notation.
Alternatively, local may contain the string 'PEER' to
indicate that the address is obtained from the peer
during link negotiation.
-r remote A hostname or IP address assigned to the remote-side PPP
interface. This can be expressed either as a name (found
in the hosts database) or as an Internet address
expressed in the Internet standard dot notation.
Alternatively, remote may contain the string 'PEER' to
indicate that the address is obtained from the peer
during link negotiation.
-q Behave quietly, producing an unformatted listing. Print
no headers and no comments, print each entry on a
separate line, and delimit fields within an entry with a
single space character.
-v Behave verbosely, producing a formatted listing with
headers and aligned columns. This is the default.
Output
The list operation writes its output to stdout.
The verbose form of the list operation outputs labels and the link
parameters for each paramstag name. Comments contained in the
/etc/pppusers database are suppressed. Information is printed in
vertical format.
If -q option is specified with the list operation, headers and
comments are suppressed and each entry is printed on a separate line.
The fields within the entry are delimited by a single space, and are
in the following order:
paramstag linkflags ACCM MRU compmode addrmode netmask local remote
EXAMPLES
The following example adds a PPP link params entry for pppsrvr. This
entry allows Address/Control field compression negotiation, Protocol
field compression negotiation, Magic Number negotiation, IP address
negotiation, disables PAP Authentication, and disables CHAP
Authentication. 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. If link initialization is successful, the
PPP daemon will install a default route via this new PPP interface.
admpppuser -o add -f +a+p+m+i-u-c+r -A 0x0 -M 1500 -c draft \
-a draft -m 0xffffff00 -h ppp-loc -r PEER pppsrvr
This example modifies the existing pppuser PPP link params entry.
The Async Control Character Map will be changed to 0xffffffff.
admpppuser -o modify -A 0xffffffff smith
FILES
/etc/pppusers PPP link parameters database file
DIAGNOSTICS
Warnings
None.
Errors
· The add operation is requested, and params_tag already exists
in the /etc/pppusers database.
· The delete or modify operation is requested, and paramstag
does not exist in the /etc/pppusers database.
· The IP address is invalid.
· The network mask is invalid.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
pppd(1C), sysadm(1M), pppusers(4M), capdefaults(5).
NOTES
You must have write permission to the /etc/pppusers database to use
the add, delete, and modify operations. To have such permission, you
must have appropriate privilege, which, on a generic DG/UX system,
means that you have superuser privilege, or an effective UID of root.
See the appropriateprivilege(5) man page for more information.
On a system that supports the DG/UX Capability option, appropriate
privilege is defined as having one one or more specific capabilities
enabled in the effective capability set of the user. See
capdefaults(5) for the default capabilities for this command.
Licensed material--property of copyright holder(s)