👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

RedHat 9 (Linux i386) - man page for pppoe.conf (redhat section 5)

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  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
       meanings are:

       ETH    The Ethernet interface connected to the ADSL modem (for example, eth0).

       USER   The ADSL user-id (for example, b1xxnxnx@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  sup-
	      ply  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 con-
	      neciton 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  create  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  character  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 $PIDFILE.pppoe)  hold
	      the process-ID's of the pppd and pppoe processes, respectively.

       SYNCHRONOUS
	      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.

       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 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.

       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,  SYNCHRONOUS  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 argument 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)


All times are GMT -4. The time now is 01:26 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password