5 kx # /etc/ppp/options
5 kx #
5 kx # $Id: options,v 1.4 1996/05/01 18:57:04 alvar Exp $
5 kx #
5 kx # Originally created by Jim Knoble <jmknoble@mercury.interpath.net>
5 kx # Modified for Debian by alvar Bray <alvar@meiko.co.uk>
5 kx # Modified for PPP Server setup by Christoph Lameter <clameter@debian.org>
5 kx # Modified for Slackware by Pat Volkerding <volkerdi@slackware.com>
5 kx #
5 kx # Use the command egrep -v '#|^ *$' /etc/ppp/options to quickly see what
5 kx # options are active in this file.
5 kx
5 kx # Specify which DNS Servers the incoming Win95 or WinNT Connection should use
5 kx # Two Servers can be remotely configured
5 kx # dns-addr 192.168.1.1
5 kx # dns-addr 192.168.1.2
5 kx
5 kx # Specify which WINS Servers the incoming connection Win95 or WinNT should use
5 kx # wins-addr 192.168.1.50
5 kx # wins-addr 192.168.1.51
5 kx
5 kx # Run the executable or shell command specified after pppd has
5 kx # terminated the link. This script could, for example, issue commands
5 kx # to the modem to cause it to hang up if hardware modem control signals
5 kx # were not available.
5 kx #disconnect "chat -- \d+++\d\c OK ath0 OK"
5 kx
5 kx # async character map -- 32-bit hex; each bit is a character
5 kx # that needs to be escaped for pppd to receive it. 0x00000001
5 kx # represents '\x01', and 0x80000000 represents '\x1f'.
5 kx asyncmap 0
5 kx
5 kx # Require the peer to authenticate itself before allowing network
5 kx # packets to be sent or received.
5 kx # For a PPP Server with script based logins not using PAP or CHAP
5 kx # you need to disable this setting.
5 kx #auth
5 kx
5 kx # Do not require the other end of the connection to authenticate itself.
5 kx # This option is dangerous if pppd is setuid.
5 kx # If you also have ethernet and are having problems getting PPP to connect
5 kx # over a modem, try this option.
5 kx #noauth
5 kx
5 kx # Use hardware flow control (i.e. RTS/CTS) to control the flow of data
5 kx # on the serial port.
5 kx crtscts
5 kx
5 kx # Use software flow control (i.e. XON/XOFF) to control the flow of data
5 kx # on the serial port.
5 kx #xonxoff
5 kx
5 kx # Specifies that certain characters should be escaped on transmission
5 kx # (regardless of whether the peer requests them to be escaped with its
5 kx # async control character map). The characters to be escaped are
5 kx # specified as a list of hex numbers separated by commas. Note that
5 kx # almost any character can be specified for the escape option, unlike
5 kx # the asyncmap option which only allows control characters to be
5 kx # specified. The characters which may not be escaped are those with hex
5 kx # values 0x20 - 0x3f or 0x5e.
5 kx #escape 11,13,ff
5 kx
5 kx # Don't use the modem control lines.
5 kx #local
5 kx
5 kx # Specifies that pppd should use a UUCP-style lock on the serial device
5 kx # to ensure exclusive access to the device.
5 kx lock
5 kx
5 kx # Use the modem control lines. On Ultrix, this option implies hardware
5 kx # flow control, as for the crtscts option. (This option is not fully
5 kx # implemented.)
5 kx modem
5 kx
5 kx # Set the MRU [Maximum Receive Unit] value to <n> for negotiation. pppd
5 kx # will ask the peer to send packets of no more than <n> bytes. The
5 kx # minimum MRU value is 128. The default MRU value is 1500. A value of
5 kx # 296 is recommended for slow links (40 bytes for TCP/IP header + 256
5 kx # bytes of data).
5 kx #mru 542
5 kx
5 kx # Set the interface netmask to <n>, a 32 bit netmask in "decimal dot"
5 kx # notation (e.g. 255.255.255.0).
5 kx #netmask 255.255.255.0
5 kx
5 kx # Disables the default behaviour when no local IP address is specified,
5 kx # which is to determine (if possible) the local IP address from the
5 kx # hostname. With this option, the peer will have to supply the local IP
5 kx # address during IPCP negotiation (unless it specified explicitly on the
5 kx # command line or in an options file).
5 kx #noipdefault
5 kx
5 kx # Enables the "passive" option in the LCP. With this option, pppd will
5 kx # attempt to initiate a connection; if no reply is received from the
5 kx # peer, pppd will then just wait passively for a valid LCP packet from
5 kx # the peer (instead of exiting, as it does without this option).
5 kx #passive
5 kx
5 kx # With this option, pppd will not transmit LCP packets to initiate a
5 kx # connection until a valid LCP packet is received from the peer (as for
5 kx # the "passive" option with old versions of pppd).
5 kx #silent
5 kx
5 kx # Don't request or allow negotiation of any options for LCP and IPCP
5 kx # (use default values).
5 kx #-all
5 kx
5 kx # Disable Address/Control compression negotiation (use default, i.e.
5 kx # address/control field disabled).
5 kx #-ac
5 kx
5 kx # Disable asyncmap negotiation (use the default asyncmap, i.e. escape
5 kx # all control characters).
5 kx #-am
5 kx
5 kx # Don't fork to become a background process (otherwise pppd will do so
5 kx # if a serial device is specified).
5 kx #-detach
5 kx
5 kx # Disable IP address negotiation (with this option, the remote IP
5 kx # address must be specified with an option on the command line or in an
5 kx # options file).
5 kx #-ip
5 kx
5 kx # Disable magic number negotiation. With this option, pppd cannot
5 kx # detect a looped-back line.
5 kx #-mn
5 kx
5 kx # Disable MRU [Maximum Receive Unit] negotiation (use default, i.e.
5 kx # 1500).
5 kx #-mru
5 kx
5 kx # Disable protocol field compression negotiation (use default, i.e.
5 kx # protocol field compression disabled).
5 kx #-pc
5 kx
5 kx # Require the peer to authenticate itself using PAP.
5 kx #+pap
5 kx
5 kx # Don't agree to authenticate using PAP.
5 kx #-pap
5 kx
5 kx # Require the peer to authenticate itself using CHAP [Cryptographic
5 kx # Handshake Authentication Protocol] authentication.
5 kx #+chap
5 kx
5 kx # Don't agree to authenticate using CHAP.
5 kx #-chap
5 kx
5 kx # Disable negotiation of Van Jacobson style IP header compression (use
5 kx # default, i.e. no compression).
5 kx #-vj
5 kx
5 kx # Increase debugging level (same as -d). If this option is given, pppd
5 kx # will log the contents of all control packets sent or received in a
5 kx # readable form. The packets are logged through syslog with facility
5 kx # daemon and level debug. This information can be directed to a file by
5 kx # setting up /etc/syslog.conf appropriately (see syslog.conf(5)). (If
5 kx # pppd is compiled with extra debugging enabled, it will log messages
5 kx # using facility local2 instead of daemon).
5 kx #debug
5 kx
5 kx # Append the domain name <d> to the local host name for authentication
5 kx # purposes. For example, if gethostname() returns the name porsche,
5 kx # but the fully qualified domain name is porsche.Quotron.COM, you would
5 kx # use the domain option to set the domain name to Quotron.COM.
5 kx #domain <d>
5 kx
5 kx # Enable debugging code in the kernel-level PPP driver. The argument n
5 kx # is a number which is the sum of the following values: 1 to enable
5 kx # general debug messages, 2 to request that the contents of received
5 kx # packets be printed, and 4 to request that the contents of transmitted
5 kx # packets be printed.
5 kx #kdebug n
5 kx
5 kx # Set the MTU [Maximum Transmit Unit] value to <n>. Unless the peer
5 kx # requests a smaller value via MRU negotiation, pppd will request that
5 kx # the kernel networking code send data packets of no more than n bytes
5 kx # through the PPP network interface.
5 kx #mtu <n>
5 kx
5 kx # Enforce the use of the hostname as the name of the local system for
5 kx # authentication purposes (overrides the name option).
5 kx #usehostname
5 kx
5 kx # Set the assumed name of the remote system for authentication purposes
5 kx # to <n>.
5 kx #remotename <n>
5 kx
5 kx # Add an entry to this system's ARP [Address Resolution Protocol]
5 kx # table with the IP address of the peer and the Ethernet address of this
5 kx # system.
5 kx proxyarp
5 kx
5 kx # Use the system password database for authenticating the peer using
5 kx # PAP. Note: mgetty already provides this option. If this is specified
5 kx # then dialin from users using a script under Linux to fire up ppp wont work.
5 kx # login
5 kx
5 kx # If this option is given, pppd will send an LCP echo-request frame to
5 kx # the peer every n seconds. Under Linux, the echo-request is sent when
5 kx # no packets have been received from the peer for n seconds. Normally
5 kx # the peer should respond to the echo-request by sending an echo-reply.
5 kx # This option can be used with the lcp-echo-failure option to detect
5 kx # that the peer is no longer connected.
5 kx lcp-echo-interval 30
5 kx
5 kx # If this option is given, pppd will presume the peer to be dead if n
5 kx # LCP echo-requests are sent without receiving a valid LCP echo-reply.
5 kx # If this happens, pppd will terminate the connection. Use of this
5 kx # option requires a non-zero value for the lcp-echo-interval parameter.
5 kx # This option can be used to enable pppd to terminate after the physical
5 kx # connection has been broken (e.g., the modem has hung up) in
5 kx # situations where no hardware modem control lines are available.
5 kx lcp-echo-failure 4
5 kx
5 kx # Set the LCP restart interval (retransmission timeout) to <n> seconds
5 kx # (default 3).
5 kx #lcp-restart <n>
5 kx
5 kx # Set the maximum number of LCP terminate-request transmissions to <n>
5 kx # (default 3).
5 kx #lcp-max-terminate <n>
5 kx
5 kx # Set the maximum number of LCP configure-request transmissions to <n>
5 kx # (default 10).
5 kx #lcp-max-configure <n>
5 kx
5 kx # Set the maximum number of LCP configure-NAKs returned before starting
5 kx # to send configure-Rejects instead to <n> (default 10).
5 kx #lcp-max-failure <n>
5 kx
5 kx # Set the IPCP restart interval (retransmission timeout) to <n>
5 kx # seconds (default 3).
5 kx #ipcp-restart <n>
5 kx
5 kx # Set the maximum number of IPCP terminate-request transmissions to <n>
5 kx # (default 3).
5 kx #ipcp-max-terminate <n>
5 kx
5 kx # Set the maximum number of IPCP configure-request transmissions to <n>
5 kx # (default 10).
5 kx #ipcp-max-configure <n>
5 kx
5 kx # Set the maximum number of IPCP configure-NAKs returned before starting
5 kx # to send configure-Rejects instead to <n> (default 10).
5 kx #ipcp-max-failure <n>
5 kx
5 kx # Set the PAP restart interval (retransmission timeout) to <n> seconds
5 kx # (default 3).
5 kx #pap-restart <n>
5 kx
5 kx # Set the maximum number of PAP authenticate-request transmissions to
5 kx # <n> (default 10).
5 kx #pap-max-authreq <n>
5 kx
5 kx # Set the CHAP restart interval (retransmission timeout for
5 kx # challenges) to <n> seconds (default 3).
5 kx #chap-restart <n>
5 kx
5 kx # Set the maximum number of CHAP challenge transmissions to <n>
5 kx # (default 10).
5 kx #chap-max-challenge
5 kx
5 kx # If this option is given, pppd will rechallenge the peer every <n>
5 kx # seconds.
5 kx #chap-interval <n>
5 kx
5 kx # With this option, pppd will accept the peer's idea of our local IP
5 kx # address, even if the local IP address was specified in an option.
5 kx #ipcp-accept-local
5 kx
5 kx # With this option, pppd will accept the peer's idea of its (remote) IP
5 kx # address, even if the remote IP address was specified in an option.
5 kx #ipcp-accept-remote
5 kx