pppd(1)

Start in "autocall" mode and detach from the controlling terminal to run as a daemon. Initiate a connection in response to a packet specified in the "bringup" category in filter-file. Requires the remote address.

When used with auto, bring the link up immediately rather than waiting for traffic. If the link goes down, attempt to restart it (after the call retry delay timer expires) without waiting for an outbound packet.

Treat the connection as a dedicated line rather than a demand-dial connection. This option tells pppd to never give up on the connection; that is, if the peer tries to shut down the link, go ahead and do so, but then immediately try to reestablish the connection. Similarly, when first trying to connect, pppd will not give up after sending a fixed number of Configure-Request messages.

Hangup events (LQM failures, loss of Carrier Detect) will still cause the device to be closed, just as with dial-up connections, and the Systems file will then be checked for alternate entries. If none are available, the connection will be reestablished after the call retry delay timer expires. Use a short call retry delay timer on dedicated circuits; something like Any;5-30 should work well. Implies up.

Set the delay of delay seconds between dialing each alternate numbers in the Systems file for the same destination. The default value is 1 second.

Don't detach from the controlling terminal in "autocall" mode. When used with log -, this can be useful for watching the progress of the PPP session.

Append logging messages to log-file (default: /var/adm/pppd.log).

Append session accounting messages to acct-file. If acct-file is the same as log-file, the session accounting messages will be interleaved with other logging information.

Look in filter-file for packet filtering and link management information (default: /etc/ppp/Filter).

Set the log file verbosity to the following debug-level and each debugging verbosity level also provides the information of all the lower-numbered levels.

Run exec-cmd up addr args when the link comes up, and exec-cmd down addr args when it goes down; where addr is the IP address of the peer, and args is the list of arguments given to pppd.

Run exec-cmd up interface-id args when the link comes up, and exec-cmd down interface-id args when it goes down; where interfac-id is the 64-bit IPv6 interface identifier of the peer, and args is the list of arguments supplied to pppd.

When IPv6 is enabled, the IFF_PRIVATE flag will not be set to IPv6 interface so that the interface is able to forward IPv6 datagrams. Also, this interface will not be able to receive any router advertisement packets for configuring the IPv6 secondary interface. Instead, use the ifconfig command or stateful configuration methods like DHCPv6 to configure the IPv6 secondary interface.

When specified, IPCP negotiation will not take place and no IPv4 datagrams will pass through the link.

When specified, IPV6CP negotiation will not take place and no IPv6 datagrams will pass through the link.

Run at a normal user process priority, rather than using the nice() library routine to elevate pppd scheduling priority to -10.

Set the desired Async Control Character Map to async-map, expressed in C-style hexadecimal notation (default 0xA0000).

Disable LCP Async Control Character Map negotiation.

In addition to those characters specified in the PPP Async Control Character Map (which can include only 0x00 through 0x1F), also apply the escaping algorithm when transmitting odd-character. The value of odd-character must be between 0x00 and 0xFF, and cannot be any of 0x5E, 0x7D or 0x7E.

odd-character can be specified as a decimal number, in C-style hexadecimal notation, or as an ASCII character with optional ^ control-character notation. For example, the XON character could be specified as 17, 0x11, or ^Q.

If a character specified with the escape argument, when transformed into its escaped form, would be the same as a character contained in the peer's negotiated Async Control Character Map, a warning will be printed in the log file and the character specified on the command line will not be escaped.

If a character specified with the escape argument, when transformed into its escaped form, would be the same as a character specified in another escape argument on the daemon's command line, pppd will print an error message and exit.

Communicate over the named device (default /dev/tty).

Set communications rate to comm-speed bits per second.

Ignore the state of the CD (Carrier Detect, also called DCD, Data Carrier Detect) signal. This is useful for systems that don't support CD but want to run PPP over a dedicated line.

Set the line to use in-band ("software") flow control, using the characters DC3 (^S, XOFF, ASCII 0x13) to stop the flow and DC1 (^Q, XON, ASCII 0x11) to resume. (The default is to use no flow control.) For an outbound connection, this may be specified either in Devices or on the pppd command line.

When used on an answering pppd command line, negotiate the telnet binary option and understand telnet escape processing. Not for use with device or auto.

Disable all LCP and IPCP options.

Disable HDLC Address and Control Field compression.

Disable LCP Protocol Field Compression.

Use RFC 1055 SLIP packet framing rather than PPP packet framing. Disables all option negotiation, and implies noasyncmap, noipaddress, vjslots 16, novjcid, nomagic, nomru, and mru 1006. Implies vjcomp if peer sends a header-compressed TCP packet.

When running in SLIP mode, prepend a SLIP packet framing character (0xC0) to each frame before transmission, even if this frame immediately follows the previous frame. By default, pppd transmits only one framing character between adjacent SLIP frames.

When running in PPP mode, prepend a PPP packet framing character (0x7E) to each frame before transmission, even if this frame immediately follows the previous frame. By default, pppd transmits only one framing character between adjacent PPP frames.

Disable LCP Magic Number negotiation.

Set LCP Maximum Receive Unit value to mru-size for negotiation. The default is 1500 for PPP and 1006 for SLIP.

Disable LCP Maximum Receive Unit negotiation, and use 1500 for our interface.

Begin LCP parameter negotiation immediately (the default).

Do not send our first LCP packet until we receive an LCP packet from the peer.

Set the LCP, IPCP, CCP, PAP, and CHAP option negotiation restart timers to restart-time (default 3 seconds).

Send Link-Quality-Reports or Echo-Requests every time seconds (default 10 seconds). If the peer responds with a Protocol-Reject, send LCP Echo-Requests every time seconds instead, and use the received LCP Echo-Replies for link status policy decisions.

Set a minimum standard for link quality by considering the connection to have failed if fewer than min out of the last per LQRs we sent have been responded to by the peer (default 1/5).

Use LCP Echo-Requests rather than standard Link-Quality-Report messages for link quality assessment and policy decisions. The peer can override this if it actively tries to configure Link Quality Monitoring unless the nolqm parameter is also specified.

Don't send or recognize Link-Quality-Report messages. If echolqm is also specified, Echo-Request messages will be used to detect link failures.

Shut down the link when idle-time seconds pass without receiving or transmitting a packet specified in the "keepup" category in the filter file (default is to never consider the link idle).

If session-idle-time is specified and any TCP sessions are open, shut down the link when session-idle-time seconds pass without receiving or transmitting a packet.

Set the PPP Max-Configure counter (the maximum number of Configure-Requests sent without a response) to tries.

Set the PPP Max-Terminate counter (the maximum number of Terminate-Requests sent without a response) to tries.

Set the PPP Max-Failure counter (the maximum number of Configure-Naks sent without a positive response) to tries.

The address of this machine, followed by the expected address for the remote machine. Can be specified either as symbolic names or as literal IP addresses, if their addresses cannot be discovered locally without using the PPP link.

Both addresses are optional, but a colon by itself is not valid, and the remote address is required when running as a daemon in "autocall" mode. If only local: is specified when receiving an incoming call, the remote address will be discovered during IPCP IP-Address negotiations.

If either address is followed by a tilde character (~), or if the tilde appears alone, pppd accepts the IP address given by the peer during IPCP negotiations, whether for the local end or the peer's end of the link (not available in SLIP mode).

Because SLIP cannot perform option negotiations, including IPCP, both addresses should normally be specified, and the tilde option is unavailable. To obtain a similar "feature", the peer must provide the IP address textually during the login process, and a new value must be obtained using the Systems file "\A" chat script feature (see ppp.Systems(4)).

ipv6 should be followed by two 64-bit IPv6 interface identifiers namely, the interface identifier of this machine and the expected interface identifier for the remote machine.

Both interface identifiers are optional, but a comma by itself is not valid, and the remote address is required when running as a daemon in the "autocall" mode. If only local-ifid: is specified when receiving an incoming call, the remote interface identifier will be discovered during IPV6CP interface id negotiations.

If either interface identifier is followed by a tilde character ~, or if the tilde appears alone, pppd accepts the interface identifier given by the peer during IPV6CP negotiations, whether for the local end or the peer's end of the link. Note that, SLIP is not supported for IPv6 transmission. When this option is specified along with slip option, pppd will exit with error message.

Set the subnet mask of the interface to subnet-mask, expressed either in C-style hexadecimal (for example, 0xffffff00) or in decimal dotted-quad notation (for example, 255.255.255.0). The default subnet mask will be appropriate for the network (class A, B, or C), assuming no subnetting.

Ask the peer to assign us an IP address.

Get a 64-bit IPv6 interface identifier assigned by the peer.

Disable IPCP IP-Address negotiation.

Disable IPV6CP interface identifier negotiation.

Enable RFC 1144 "VJ" Van Jacobson TCP header compression negotiation with 16 slots and slot ID compression (this is the default with PPP framing). "VJ" compression is enabled by default for async connections, and disabled by default for sync connections.

Disable RFC 1144 "VJ" Van Jacobson TCP header compression (this is the default with SLIP framing, until the peer sends a header-compressed TCP packet).

Set the number of VJ compression slots (min 3, max 256, default 16).

Disable VJ compression slot ID compression (enabled by default).

Backwards compatibility with older PPP implementations (4-byte VJ configuration option), but with the correct option negotiation value of 0x002d.

Backwards compatibility with older PPP implementations (4-byte VJ configuration option) that conform to the typographical error in RFC 1172 section 5.2 (Compression-Type value 0x0037).

Backwards compatibility with older PPP implementations that conform to RFC 1172 section 5.1 (IP-Addresses, IPCP configuration option 1) and not with the newer RFC 1332 (IP-Address, IPCP configuration option 3), but that respond with something besides a Configure-Reject when they receive an IPCP Configure-Request containing an option 3.

Do not send nak (negative acknowledgement) if the IPV6CP interface identifier option has already been sent negative acknowledgements during previous replies.

Require either PAP or CHAP authentication.

Require CHAP authentication as described in RFC 1334.

Require MS-CHAP authentication.

Require PAP authentication.

Demand that the peer re-authenticate itself (using CHAP) every interval seconds. If the peer fails the new challenge, the link is terminated.

Provide the identifier used during PAP or CHAP negotiation. This option is necessary if the PPP peer requires authentication. The default value is the value returned by the gethostname(2) system call or the hostname(1) command.

Set the MS DNS address to provide to the peer. First occurrence of this option on the command line sets the primary address; the second occurrence sets the secondary address.

Set the MS NBNS address to provide to the peer. First occurrence of this option on the command line sets the primary address; the second occurrence sets the secondary address.

Offer all supported link compression types (currently only Predictor-1) when negotiating. The default is to propose and accept no link compression type.

Accept any supported compression type, but prefer Predictor type 1 compression.

Never use Predictor-1 compression.