pppoesd.conf(4) Kernel Interfaces Manual pppoesd.conf(4)NAME
pppoesd.conf - PPPoE (Point to Point Protocol over Ethernet) server configuration file
DESCRIPTION
is the configuration file for the daemon. This file is read by to initialize the server. The default file is You can use this file to set
parameters for each network interface used by during PPPoE sessions. Each entry in the file is of the following format:
Each entry in the configuration file is separated by a blank line. Blank lines and lines that begin with are ignored.
Parameters
contains the following parameters:
Specify the name of the service that the server can offer to the client.
A value of implies that the server is ready to offer any service to the client.
Specify the name of the access concentrator from which you wish to make
services available.
Specify a tag used by the client to uniquely associate an access
concentrator's response (PADO or PADS) to a particular client request (PADI or PADR).
Specify the number of times
tries to retransmit either a PADI or PADR packet when an access concentrator does not respond to the client's request.
Specify the timeout value in seconds.
waits for this duration to receive either a PADO or PADS packet before retransmitting a PADI/PADR packet. The default
value is 15 seconds.
Specify the command-line options of
See pppd(1) for more information.
Sample pppoesd.conf File
[ lan4 ]
service=any
acname=gatt3
ac_cookie=1
#host_unique=0
timeout=1200
#retry-number=3
local-ipv4-address=1.2.3.4
ipv4-address-pool=5.6.7.8 - 5.6.7.101
pppd-options=mru 1492 debug 11
# Following entries are related to PPPoEv6
local-ipv6-identifier=::9
ipv6-identifier-pool=::10 - ::100
AUTHOR
was developed by Hewlett-Packard.
FILES
PPPoE server daemon
PPPoE relay
PPPoE client
PPP daemon
SEE ALSO pppd(1), pppoec(1), pppoerd(1M), pppoesd(1M).
pppoesd.conf(4)
Check Out this Related Man Page
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 typically eth0 or eth1. The interface should be "up"
before you start pppoe-server, but need not have an IP address. You can supply multiple -I options if you want the server to
respond on more than one interface.
-X pidfile
This option causes pppoe-server to write its process ID to pidfile. Additionally, it keeps the file locked so that only a single
process may be started for a given pidfile.
-q /path/to/pppd
Specifies the full path to the pppd program. The default is determined at compile time. One use of this option is to supply a
wrapper program that modifies the arguments passed to pppd. This lets you do things not directly supported by the server (for exam-
ple, specify IPv6 addresses.)
-Q /path/to/pppoe
Specifies the full path to the pppoe program. The default is determined at compile time. This option is only relevant if you are
not using kernel-mode PPPoE.
-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.
-x n Limit the number of sessions per peer MAC address to n. If a given MAC address attempts to create more than n sessions, then its
PADI and PADR packets are ignored. If you set n to 0 (the default), then no limit is imposed on the number of sessions per peer MAC
address.
-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 specified, 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 auto-
matically keeps track of the pool of addresses and passes a valid remote IP address to pppd. If not specified, a starting address
of 10.67.15.1 is used.
-D Delegate the allocation of IP addresses to pppd. If specified, no local and remote addresses passed to pppd.
-N num Allows at most num concurrent PPPoE sessions. If not specified, the default is 64.
-O fname
This option causes pppoe-server to tell pppd to use the option file fname instead of the default /etc/ppp/pppoe-server-options.
-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 overrides 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.
-i The -i option tells the server to completely ignore PADI frames if there are no free session slots.
-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-performance 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 pppoe-start(8), pppoe-stop(8), pppoe-connect(8), pppd(8), pppoe.conf(5), pppoe(8), pppoe-setup(8), pppoe-status(8), pppoe-sniff(8), pppoe-
relay(8)4th Berkeley Distribution 21 June 2008 PPPOE-SERVER(8)