pppoe.conf - phpMan

Command: man perldoc info search(apropos)  


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)
Valid XHTML 1.0!Valid CSS!