Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for pppoe-server (redhat section 8)

PPPOE-SERVER(8) 		     System Manager's Manual			  PPPOE-SERVER(8)

NAME
       pppoe-server - user-space PPPoE server

SYNOPSIS
       pppoe-server [options]

DESCRIPTION
       pppoe-server  is a user-space server for PPPoE (Point-to-Point Protocol over Ethernet) for
       Linux and other UNIX systems.  pppoe-server works in concert  with  the	pppoe  client  to
       respond to PPPoE discovery packets and set up PPPoE sessions.

OPTIONS
       -F     The  -F option causes pppoe-server not to fork and become a daemon.  The default is
	      to fork and become a daemon.

       -I interface
	      The -I option specifies the Ethernet interface to use.  Under Linux,  it	is  typi-
	      cally  eth0  or  eth1.  The interface should be "up" before you start pppoe-server,
	      but should not be configured to have an IP address.  You	can  supply  multiple  -I
	      options if you want the server to respond on more than one interface.

       -T timeout
	      This  option  is	passed	directly  to pppoe; see pppoe(8) for details.  If you are
	      using kernel-mode PPPoE, this option has no effect.

       -C ac_name
	      Specifies which name to report as the access concentrator name.  If  not	supplied,
	      the host name is used.

       -S name
	      Offer  a service named name.  Multiple -S options may be specified; each one causes
	      the named service to be advertised in a Service-Name tag in the  PADO  frame.   The
	      first  -S  option  specifies  the  default service, and is used if the PPPoE client
	      requests a Service-Name of length zero.

       -m MSS This option is passed directly to pppoe; see pppoe(8)  for  details.   If  you  are
	      using kernel-mode PPPoE, this option has no effect.

       -s     This option is passed directly to pppoe; see pppoe(8) for details.  In addition, it
	      causes pppd to be invoked with the sync option.

       -L ip  Sets the local IP address.  This is passed to spawned pppd processes.  If not spec-
	      ified, the default is 10.0.0.1.

       -R ip  Sets the starting remote IP address.  As sessions are established, IP addresses are
	      assigned starting from ip.   pppoe-server automatically keeps track of the pool  of
	      addresses and passes a valid remote IP address to pppd.  If not specified, a start-
	      ing address of 10.67.15.1 is used.

       -N num Allows at most num concurrent PPPoE sessions.  If not specified, the default is 64.

       -p fname
	      Reads the specified file fname which is a text file consisting of  one  IP  address
	      per  line.  These IP addresses will be assigned to clients.  The number of sessions
	      allowed will equal the number of addresses found in the file.  The -p option  over-
	      rides both -R and -N.

	      In  addition  to	containing  IP	addresses, the pool file can contain lines of the
	      form:

		   a.b.c.d-e

	      which includes all IP addresses from a.b.c.d to a.b.c.e.	For example, the line:

		   1.2.3.4-7

	      is equivalent to:

		   1.2.3.4
		   1.2.3.5
		   1.2.3.6
		   1.2.3.7

       -r     Tells the PPPoE server to randomly permute session numbers.  Instead of handing out
	      sessions in order, the session numbers are assigned in an unpredictable order.

       -u     Tells  the  server to invoke pppd with the unit option.  Note that this option only
	      works for pppd version 2.4.0 or newer.

       -o offset
	      Instead of numbering PPPoE sessions starting at 1, they will be  numbered  starting
	      at offset+1.  This allows you to run multiple servers on a given machine; just make
	      sure that their session numbers do not overlap.

       -f disc:sess
	      The -f option sets the Ethernet frame types for PPPoE discovery and session frames.
	      The  types  are  specified  as  hexadecimal numbers separated by a colon.  Standard
	      PPPoE uses frame types 8863:8864.  You should not use this option  unless  you  are
	      absolutely sure the peer you are dealing with uses non-standard frame types.

       -k     The  -k  option tells the server to use kernel-mode PPPoE on Linux.  This option is
	      available only on Linux kernels 2.4.0 and later, and only if the server  was  built
	      with kernel-mode support.

       -h     The -h option prints a brief usage message and exits.

OPERATION
       pppoe-server listens for incoming PPPoE discovery packets.  When a session is established,
       it spawns a pppd process.  The following options are passed to pppd:

       nodetach noaccomp nobsdcom nodeflate nopcomp novj novjccomp
       default-asyncmap

       In addition, the local and remote IP address are set based on the -L and -R options.   The
       pty option is supplied along with a pppoe command to initiate the PPPoE session.  Finally,
       additional pppd options can be placed in  the  file  /etc/ppp/pppoe-server-options  (which
       must exist, even if it is just empty!)

       Note  that  pppoe-server is meant mainly for testing PPPoE clients.  It is not a high-per-
       formance server meant for production use.

AUTHORS
       pppoe-server was written by David F. Skoll <dfs@roaringpenguin.com>.

       The pppoe home page is http://www.roaringpenguin.com/pppoe/.

SEE ALSO
       adsl-start(8), adsl-stop(8), adsl-connect(8), pppd(8), pppoe.conf(5), pppoe(8),	adsl-set-
       up(8), adsl-status(8), pppoe-sniff(8), pppoe-relay(8)

4th Berkeley Distribution		   3 July 2000				  PPPOE-SERVER(8)


All times are GMT -4. The time now is 07:21 PM.

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