.\" manual page v0.4 [3/3/93] for pppd 1.2beta
.\" SS subsection heading
.\" IP indented paragraph
pppd \- Point to Point Protocol daemon
The Point-to-Point Protocol (PPP) provides a method for transmitting
datagrams over serial point-to-point links.
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.
currently supports the encapsulation scheme, the basic LCP, and an
NCP for establishing and configuring the Internet Protocol (IP)
(called the IP Control Protocol, IPCP).
Don't request/allow any options
Disable Address/Control compression negotiation
Disable asyncmap negotiation
Set the desired async map to hex <n>. The default async map is 0xffffffff.
Don't fork to become a background process
Disable IP address negotiation
Disable magic number negotiation
Disable MRU [Maximum Receive Unit] negotiation
Disable protocol field compression negotiation
Require UPAP [User/Password Authentication Protocol] authentication.
Use the data in file <p> for the user and password to send to the
peer. The file contains the remote user name, followed by a newline,
followed by the remote password.
Don't allow UPAP authentication
Require CHAP [Cryptographic Handshake Authentication Protocol] authentication.
Use the data in file /usr/local/etc/ppp/chap, which contains
host name/secret pairs separated by newlines, to authenticate the peer.
In the data file, a host name of "default" will match any host name
not already specified in the file.
Don't allow CHAP authentication
Set the async character map to <map>.
This map describes which control characters to "escape" in the serial data
The argument is a 32 bit hex number represented as 8 hex characters,
with each bit representing a character to escape.
The lowest bit (i.e. 00000001) represents the character 0x00
The highest bit (i.e. 80000000) represents the character 0x1f or ^_.
Use the executable or shell command specified by <p> to set-up the
serial line. This script would typically use the "chat" program to
dial the modem and start the remote ppp session.
Use hardware flow control (i.e. RTS/CTS) to control the flow of data on
Append the domain name <d> to the local host name for authentication
purposes. I.e., if gethostname() returns the name porsche, but the
fully qualified domain name is porsche.Quotron.COM, you would use the
domain option to set the domain name to Quotron.COM.
Set MRU value to <n> for negotiation. The minimum MRU value is 128.
The default MRU value is 1500.
Set the interface netmask to <n>, a 32 bit netmask in "decimal dot notation"
Set passive mode; Don't send LCP configure requests. Sets initial state to
Specifies which version of IPCP Van Jacobson Compression negotiation
for <m> to have backward compatibility with early versions of
which operated "incorrectly" when negotiating Compression-Type due to a
typographical error in the RFC.
(4.1, patch level 4 and later)
have this problem corrected but to allow interoperability with older versions
you can force this "incorrect" behavior. Specify
for <m> to use the RFC1172 value for negotiation. To use the
new version of negotiation specified in RFC1132 for
IPCP (the default), specify
This disables the use of Van Jacobson style IP header compression
Communicate over the named device
Set the baud rate to <speed>
.B <local_IP_address>:<remote_IP_address>
Set the local and/or remote interface IP addresses. Either one may be omitted.
.I Compressing TCP/IP headers for low-speed serial links.
.I Point\-to\-Point Protocol for the transmission of multi\-protocol
.I datagrams over Point\-to\-Point links.
.I Point\-to\-Point Protocol (PPP) initial configuration options.
.I The Point\-to\-Point Protocol (PPP) for the Transmission of Multi-protocol
.I Datagrams over Point\-to\-Point Links
.I The PPP Internet Protocol Control Protocol (IPCP).
.I PPP Link Quality Monitoring
.I PPP Authentication Protocols.
.I The MD5 Message-Digest Algorithm.
There is, currently, only one level of debugging available. Debugging is
enabled by setting the -d or debug flag on the command line. Debugging may
is running by sending a SIGUSR1 to the
Debugging may be disabled by sending a SIGUSR2 to the
Error and warning messages are sent to the syslog daemon using facility
has been compiled with debugging code. In this case the logging
facility used will be LOG_LOCAL2 in order to allow separation of the debug
output from the other daemons using the LOG_DAEMON facility. You can
override this by defining the macro LOG_PPP to the desired facility
and recompiling. In order to see the error and debug messages, you
will need to edit your /etc/syslog.conf file to direct the messages to
the desired output device or file.
Debugging is currently available for
\- the {Link, IP} Control Protocol Finite State Machine module;
\- the PPP Link Control Protocol module;
\- the PPP IP Control Protocol module;
\- the User/Password Authentication Protocol module;
\- the Challenge Handshake Authentication Protocol module.
The following signals have the specified effect when sent to the
This signal is normally generated by a Ctrl-C or DEL.
to initiate a graceful disconnect and exit.
will adjust the timeouts and close the connection.
to initiate a graceful disconnect and exit.
will adjust the timeouts and close the connection.
Indicates that the physical layer has been disconnected. You will
probably see "Bad file number" errors in the log output due to the way
the STREAMS-based tty driver handles a hangup. You can ignore
these errors in this case.
will adjust the timeouts and reset the connection.
Note that sections the current implementation of
are based on older RFCs and draft RFCs and may not be fully
compatible with the latest draft RFC versions.
Brad Parker (brad@fcr.com)
projects / unix-history / blob