ifcfg-ppp0 - Configuration file used by adsl-start(8), adsl-stop(8), adsl-status(8) and
/etc/sysconfig/network-scripts/ifcfg-ppp0 is a shell script which contains configuration
information for Roaring Penguin's ADSL scripts. Note that pppoe.conf is used only by the
various adsl-* shell scripts, not by pppoe itself.
ifcfg-ppp0 consists of a sequence of shell variable assignments. The variables and their
ETH The Ethernet interface connected to the ADSL modem (for example, eth0).
USER The ADSL user-id (for example, firstname.lastname@example.org).
If this is not blank, then it is passed with the -S option to pppoe. It specifies
a service name to ask for. Usually, you should leave it blank.
ACNAME If this is not blank, then it is passed with the -C option to pppoe. It specifies
the name of the access concentrator to connect to. Usually, you should leave it
DEMAND If set to a number, the link is activated on demand and brought down after after
DEMAND seconds. If set to no, the link is kept up all the time rather than being
activated on demand.
One of NOCHANGE, SPECIFY or SERVER. If set to NOCHANGE, adsl-connect will not
adjust the DNS setup in any way. If set to SPECIFY, it will re-write
/etc/resolv.conf with the values of DNS1 and DNS2. If set to SERVER, it will sup-
ply the usepeerdns option to pppd, and make a symlink from /etc/resolv.conf to
IP addresses of DNS servers if you use DNSTYPE=SPECIFY.
If the line USERCTL=yes (exactly like that; no whitespace or comments) appears in
the configuration file, then /sbin/ifup will allow non-root users to bring the con-
neciton up or down.
If set to "yes", then adsl-connect will supply the usepeerdns option to pppd, which
causes it to obtain DNS server addresses from the peer and create a new
/etc/resolv.conf file. Otherwise, adsl-connect will not supply this option, and
pppd will not modify /etc/resolv.conf.
How often (in seconds) adsl-start should check to see if a new PPP interface has
come up. If this is set to 0, the adsl-start simply initiates the PPP session, but
does not wait to see if it comes up successfully.
How long (in seconds) adsl-start should wait for a new PPP interface to come up
before concluding that adsl-connect has failed and killing the session.
PING A character which is echoed every CONNECT_POLL seconds while adsl-start is waiting
for the PPP interface to come up.
A character which is echoed every CONNECT_POLL seconds while adsl-start is waiting
for the PPP interface to come up. Similar to PING, but the character is echoed
even if adsl-start's standard output is not a tty.
A file in which to write the process-ID of the adsl-connect process (for example,
/var/run/pppoe.pid). Two additional files ($PIDFILE.pppd and $PIDFILE.pppoe) hold
the process-ID's of the pppd and pppoe processes, respectively.
An indication of whether or not to use synchronous PPP (yes or no). Synchronous
PPP is safe on Linux machines with the n_hdlc line discipline. (If you have a file
called "n_hdlc.o" in your modules directory, you have the line discipline.) It is
not recommended on other machines or on Linux machines without the n_hdlc line dis-
cipline due to some known and unsolveable race conditions in a user-mode client.
The value at which to "clamp" the advertised MSS for TCP sessions. The default of
1412 should be fine.
How often (in seconds) pppd sends out LCP echo-request packets.
How many unanswered LCP echo-requests must occur before pppd concludes the link is
If this many seconds elapse without any activity seen by pppoe, then pppoe exits.
One of NONE, STANDALONE or MASQUERADE. If NONE, then adsl-connect does not add any
firewall rules. If STANDALONE, then it clears existing firewall rules and sets up
basic rules for a standalone machine. If MASQUERADE, then it clears existing fire-
wall rules and sets up basic rules for an Internet gateway. If you run services on
your machine, these simple firewall scripts are inadequate; you'll have to make
your own firewall rules and set FIREWALL to NONE.
Any extra arguments to pass to pppoe
Any extra arguments to pass to pppd
If non-blank, the full path of the Linux kernel-mode PPPoE plugin (typically
/etc/ppp/plugins/rp-pppoe.so.) This forces adsl-connect to use kernel-mode PPPoE
on Linux 2.4.x systems. This code is experimental and unsupported. Use of the
plugin causes adsl-connect to ignore CLAMPMSS, PPPOE_EXTRA, SYNCHRONOUS and
By using different configuration files with different PIDFILE settings, you can manage
multiple PPPoE connections. Just specify the configuration file as an argument to adsl-
start and adsl-stop.
pppoe(8), adsl-connect(8), adsl-start(8), adsl-stop(8), pppd(8), adsl-setup(8), pppoe-
4th Berkeley Distribution 21 February 2000 PPPOE.CONF(5)