pppd(1C) DG/UX R4.11MU05 pppd(1C)
NAME
pppd - Point to Point Protocol Daemon
SYNOPSIS
For outbound (client-mode) connections:
pppd ttyname speed [option ...] connect dialsystem
For inbound (server-mode) connections:
pppd [option ...]
DESCRIPTION
The Point-to-Point Protocol (PPP) provides a method for transmitting
datagrams over serial point-to-point links. PPP is composed of three
parts:
1. A method for encapsulating datagrams over serial links.
2. An extensible Link Control Protocol (LCP).
3. A family of Network Control Protocols (NCP) for establishing and
configuring different network-layer protocols.
pppd currently supports the encapsulation scheme, the LCP protocol,
and an NCP for establishing and configuring the Internet Protocol
(IP) (called the IP Control Protocol, IPCP).
For outbound (client-mode) connections, ttyname, speed, and
dialsystem must be specified on the command line. Specifying these
options will force pppd to initiate a dial-out sequence. The
$HOME/.pppdialinfo file is consulted first in an attempt to find the
send-expect strings for dialing and logging-in on the remote host.
If the appropriate entry cannot be found, or if the file does not
exist, then pppd will attempt to read from /etc/pppdialinfo.
dialsystem is used as a key to obtain entries from both databases.
The /etc/pppusers file is then consulted, using dialsystem as a key,
for the various PPP link parameters and negotiation options. Any of
the link parameters and negotiation options initialized from the
/etc/pppusers file may be overridden using the pppd command options.
If link negotiation completes successfully, the PPP daemon (operating
in client mode) will disassociate from the controlling terminal.
For inbound (server-mode) connections, the /etc/pppusers file is
consulted to establish the various link parameters and negotiation
options associated with a PPP link. The key used to locate the
parameters record for the server-mode PPP daemon is the user's login
name. Any of the link parameters and negotiation options initialized
from the /etc/pppusers file may be overridden using the pppd command
options. A PPP daemon operating in server mode will not detach from
its controlling terminal.
OPTIONS
-all Don't request/allow any options.
-ac Disable Address/Control field compression negotiation. If
unspecified, the default action is to negotiate
Address/Control field compression.
addrmode <m>
Specifies the IPCP address negotiation mode. Specify old for
<m> to utilize the old IPCP 'IP-Addresses' negotiation mode.
Specify draft for <m> to utilize the new IPCP 'IP-Address'
negotiation mode. See RFC-1332 for details regarding IPCP
address negotiation.
-am Disable the Async Control Character Map (ACCM) negotiation.
If negotiation is disabled, the default ACCM is 0x00000000.
-as <n>
Set the desired Async Control Character Map (ACCM) to <n>.
The ACCM value must be specified in hex with leading '0x'.
The default async map is 0x00000000.
+chap Enable the Challenge Handshake Authentication Protocol (CHAP).
This option forces pppd to negotiate CHAP during the LCP
negotiation phase and forces CHAP authentication to occur
prior to IPCP negotiation. During the CHAP authentication
phase, a CHAP challenge packet containing the servers hostname
is transmitted by the PPP server. The client uses this
hostname to locate the secretkey for the PPP server and
generates a CHAP response based on this secretkey. The
server, performing a similar secretkey lookup based on its own
hostname, uses this secretkey to authenticate the CHAP
response and to grant or deny access the client. The
hostname/secretkey pairs are defined in /etc/ppp.chap.
-chap Disable the Challenge Handshake Authentication Protocol
(CHAP).
connect <dialsystem>
Sets the <dialsystem> identifier for locating parameters in
/etc/pppdialinfo and /etc/pppusers. If this option is
specified, the PPP daemon will operate in client or dial-out
mode. If unspecified, the PPP daemon will operate in server
mode.
-d Enable debugging. This option forces pppd to print debug
output to the controlling terminal if operating in client-mode
or to the file /tmp/ppp<pid>.<hostname> if operating in
server-mode. Debug output includes all send-expect dialogue,
LCP negotiation sequences, PAP negotiation sequences, CHAP
negotiation sequences, IPCP negotiation sequences, PPP finite
state machine (FSM) transitions, and a report of the final
link parameters negotiated. If debugging is enabled, pppd
will remain attached to the controlling terminal.
debug Enable debugging. See the -d option for details.
droute Install a default route. If this option is specified, pppd
will attempt to install a default route via this PPP interface
if no default route currently exists. A warning message will
be presented if an existing default route is detected. If
unspecified, the default action is not to install a default
route.
domain <d>
Append domain name <d> to hostname.
flow <m>
Specifies the async flow control mode. Specify hard for <m>
to utilize the CTS/RTS modem control signals for async port
flow control. Specify soft for <m> to utilize the XON/XOFF
characters for async port flow control. Specify none for <m>
if no async port flow control is desired.
-ip Disable IP address negotiation. If this option is specified,
each end of the PPP link must specify its local IP address and
the IP address of its peer. If unspecified, the default
action is to negotiate.
-mn Disable magic number negotiation. Magic number negotiation
provides a means of detecting looped-back connections. If
unspecified, the default action is to negotiate.
-mru Disable MRU [Maximum Receive Unit] negotiation. If
unspecified, the default MRU is 1500 bytes.
mru <n>
Set the MRU value for negotiation to <n> bytes. The MRU value
must be specified in decimal and must be between 128 and 8192
inclusive. The default MRU value for PPP links is 1500.
-p Set passive mode. This option forces the PPP daemon to
initialize in a passive state (startup without requesting
option negotiation and wait indefinitely for the peer to
request option negotiation). The default mode is to startup
in active mode (request option negotiation and terminate if
negotiation response is not detected within 10 requests).
passive
Set passive mode. See the -p option for details.
-pc Disable protocol field compression negotiation. If
unspecified, the default action is to negotiate Protocol field
compression.
+ua <p>
Support the Password Authentication Protocol (PAP) and use
file <p> to supply PAP account information to the remote. The
PAP account information file specified by <p> contains a
single username and password (listed on separate lines with no
leading spaces) to use for remote authentication. This option
is applicable only for client-mode PPP daemon operation. By
default, the PPP daemon does not support PAP authentication
when operating in client-mode.
-ua Disable PAP authentication requirement. This option is
applicable only for server-mode PPP daemon operation. By
default, the PPP daemon requires PAP authentication if running
in server mode. This option specifies that PAP authentication
is not required for dial-in clients.
-vj Disable Van Jacobson TCP/IP header compression. If
unspecified, the default action is to negotiate VJ TCP/IP
header compression.
vjmode <m>
Specifies which version of IPCP Van Jacobson TCP/IP header
compression negotiation to use. Specify old for <m> to have
backward compatibility with early versions of PPP which
operated "incorrectly" when negotiating Compression-Type due
to a typographical error in the RFC. Specify current for <m>
to use the 2-byte '002d' value for negotiation (the default).
Specify draft for <m> to use the new 4-byte '002d' value for
negotiation. See RFC-1332 for details regarding Van Jacobson
TCP/IP header compression negotiation.
<device>
Communicate over the named device (e.g. tty00). If
unspecified, the default action is to communicate over the TTY
which started the PPP daemon. The <device> must exist in the
/dev directory and may be specified without the "/dev" prefix.
<speed>
Set the TTY baud rate to <speed>. Supported baud rates
include 300, 1200, 2400, 4800, 9600, 19200, and 38400 (if
supported by the async hardware).
<localIPaddress>:<remoteIPaddress>
Set the local and/or remote interface IP addresses. Either
one may be omitted. If either is omitted, the associated IP
address must be negotiated/obtained from the peer.
FILES
/etc/pppdialinfo
System PPP send-expect string database
$HOME/.pppdialinfo
Local PPP send-expect string database
/etc/pppusers
PPP link parameters and negotiation options database
/etc/ppp.chap
PPP hostname/secretkey pairs for CHAP authentication
EXAMPLES
In the following example, a client-mode PPP link will be initiated at
19200 baud using /dev/tty00. Send-expect strings and link
parameters/negotiation options are obtained using the dialsystem
pppserver.
pppd 19200 tty00 connect pppserver
In this example, a server-mode PPP link will be initiated using
/dev/tty. Link parameters/negotiation options are obtained using the
user's login name. Diagnostic output will be written to
/tmp/ppp<pid>.<hostname>.
pppd -d
DIAGNOSTICS
Debugging is enabled by setting the -d or debug flag on the command
line.
Debugging messages are by default sent to stdout for client-mode
operation and sent to /tmp/ppp<pid>.<hostname> for server-mode
operation.
Debugging is currently available for the dial/chat module (applicable
for client-mode operation only), the PPP Link Control Protocol
module, the Password Authentication Protocol module, the PPP IP
Control Protocol module and the Link/IP Control Protocol Finite State
Machine module.
NOTES
The following signals have the specified effect when sent to the pppd
process.
SIGINT This signal is normally generated by a Ctrl-C or DEL. Causes
pppd to initiate a graceful disconnect and exit. pppd will
adjust the timeouts and close the connection.
SIGTERM
Causes pppd to initiate a graceful disconnect and exit. pppd
will adjust the timeouts and close the connection.
SIGHUP Indicates that the physical layer has been disconnected. pppd
will adjust the timeouts and reset the connection.
OTHER REFERENCES
RFC1144
Jacobson, V. Compressing TCP/IP Headers for Low-Speed Serial
Links. 1990 February.
RFC1332
McGregor, G. The PPP Internet Protocol Control Protocol
(IPCP). 1992 May.
RFC1334
Lloyd, B. and Simpson, W. PPP Authentication Protocols. 1992
October.
RFC1548
Simpson, W. The Point-to-Point Protocol (PPP). 1993
December.
SEE ALSO
admpppdial(1M), admpppuser(1M), pppdialinfo(4M), pppusers(4M).
Licensed material--property of copyright holder(s)