PPPOE.CONF(5) PPPOE.CONF(5)
NAME
ifcfg-ppp0 - Configuration file used by adsl-start(8), adsl-stop(8), adsl-status(8)
and adsl-connect(8).
DESCRIPTION
/etc/sysconfig/network-scripts/ifcfg-ppp0 is a shell script which contains configu-
ration 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 meanings are:
ETH The Ethernet interface connected to the ADSL modem (for example, eth0).
USER The ADSL user-id (for example, b1xxnxnx AT sympatico.ca).
SERVICENAME
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 blank.
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.
DNSTYPE
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 supply the usepeerdns option to pppd, and make a symlink from
/etc/resolv.conf to /etc/ppp/resolv.conf.
DNS1, DNS2
IP addresses of DNS servers if you use DNSTYPE=SPECIFY.
USERCTL
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 conneciton up or down.
PEERDNS
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 cre-
ate a new /etc/resolv.conf file. Otherwise, adsl-connect will not supply
this option, and pppd will not modify /etc/resolv.conf.
CONNECT_POLL
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.
CONNECT_TIMEOUT
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.
FORCEPING
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 charac-
ter is echoed even if adsl-start’s standard output is not a tty.
PIDFILE
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 $PID-
FILE.pppoe) hold the process-ID’s of the pppd and pppoe processes, respec-
tively.
SYNCHRONOUS
An indication of whether or not to use synchronous PPP (yes or no). Syn-
chronous 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 discipline due to some known and unsolve-
able race conditions in a user-mode client.
CLAMPMSS
The value at which to "clamp" the advertised MSS for TCP sessions. The
default of 1412 should be fine.
LCP_INTERVAL
How often (in seconds) pppd sends out LCP echo-request packets.
LCP_FAILURE
How many unanswered LCP echo-requests must occur before pppd concludes the
link is dead.
PPPOE_TIMEOUT
If this many seconds elapse without any activity seen by pppoe, then pppoe
exits.
FIREWALL
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 firewall 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.
PPPOE_EXTRA
Any extra arguments to pass to pppoe
PPPD_EXTRA
Any extra arguments to pass to pppd
LINUX_PLUGIN
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, SYN-
CHRONOUS and PPPOE_TIMEOUT.
By using different configuration files with different PIDFILE settings, you can
manage multiple PPPoE connections. Just specify the configuration file as an argu-
ment to adsl-start and adsl-stop.
SEE ALSO
pppoe(8), adsl-connect(8), adsl-start(8), adsl-stop(8), pppd(8), adsl-setup(8),
pppoe-wrapper(8)
4th Berkeley Distribution 21 February 2000 PPPOE.CONF(5)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-10 10:59 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)