1PPPOE-SERVER(8)             System Manager's Manual            PPPOE-SERVER(8)
2
3
4

NAME

6       pppoe-server - user-space PPPoE server
7

SYNOPSIS

9       pppoe-server [options]
10
11

DESCRIPTION

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

OPTIONS

20       -F     The -F option causes pppoe-server not to fork and become a  dae‐
21              mon.  The default is to fork and become a daemon.
22
23
24       -I interface
25              The  -I  option  specifies the Ethernet interface to use.  Under
26              Linux, it is typically eth0 or eth1.  The  interface  should  be
27              "up" before you start pppoe-server, but should not be configured
28              to have an IP address.  You can supply multiple  -I  options  if
29              you want the server to respond on more than one interface.
30
31
32       -T timeout
33              This  option  is  passed  directly  to  pppoe;  see pppoe(8) for
34              details.  If you are using kernel-mode PPPoE, this option has no
35              effect.
36
37
38       -C ac_name
39              Specifies  which name to report as the access concentrator name.
40              If not supplied, the host name is used.
41
42
43       -S name
44              Offer a service named name.  Multiple -S options may  be  speci‐
45              fied;  each  one  causes the named service to be advertised in a
46              Service-Name tag in the PADO frame.  The first -S option  speci‐
47              fies  the  default  service,  and  is  used  if the PPPoE client
48              requests a Service-Name of length zero.
49
50
51       -m MSS This option is  passed  directly  to  pppoe;  see  pppoe(8)  for
52              details.  If you are using kernel-mode PPPoE, this option has no
53              effect.
54
55
56       -s     This option is  passed  directly  to  pppoe;  see  pppoe(8)  for
57              details.   In  addition,  it  causes pppd to be invoked with the
58              sync option.
59
60
61       -L ip  Sets the local IP address.  This is passed to spawned pppd  pro‐
62              cesses.  If not specified, the default is 10.0.0.1.
63
64
65       -R ip  Sets  the  starting  remote  IP address.  As sessions are estab‐
66              lished, IP addresses are assigned  starting  from  ip.    pppoe-
67              server  automatically  keeps  track of the pool of addresses and
68              passes a valid remote IP address to pppd.  If not  specified,  a
69              starting address of 10.67.15.1 is used.
70
71
72       -N num Allows at most num concurrent PPPoE sessions.  If not specified,
73              the default is 64.
74
75
76       -O fname
77              This option causes pppoe-server to tell pppd to use  the  option
78              file fname instead of the default /etc/ppp/pppoe-server-options.
79
80
81       -p fname
82              Reads  the  specified file fname which is a text file consisting
83              of one IP address per line.  These IP addresses will be assigned
84              to  clients.  The number of sessions allowed will equal the num‐
85              ber of addresses found in the file.   The  -p  option  overrides
86              both -R and -N.
87
88              In  addition  to containing IP addresses, the pool file can con‐
89              tain lines of the form:
90
91                   a.b.c.d-e
92
93              which includes all IP addresses from a.b.c.d  to  a.b.c.e.   For
94              example, the line:
95
96                   1.2.3.4-7
97
98              is equivalent to:
99
100                   1.2.3.4
101                   1.2.3.5
102                   1.2.3.6
103                   1.2.3.7
104
105
106       -r     Tells  the  PPPoE  server  to  randomly permute session numbers.
107              Instead of handing out sessions in order,  the  session  numbers
108              are assigned in an unpredictable order.
109
110
111       -u     Tells the server to invoke pppd with the unit option.  Note that
112              this option only works for pppd version 2.4.0 or newer.
113
114
115       -o offset
116              Instead of numbering PPPoE sessions starting at 1, they will  be
117              numbered  starting at offset+1.  This allows you to run multiple
118              servers on a given machine; just make sure  that  their  session
119              numbers do not overlap.
120
121
122       -f disc:sess
123              The  -f option sets the Ethernet frame types for PPPoE discovery
124              and session frames.  The types are specified as hexadecimal num‐
125              bers  separated  by  a  colon.   Standard PPPoE uses frame types
126              8863:8864.  You should not use this option unless you are  abso‐
127              lutely  sure  the  peer  you  are dealing with uses non-standard
128              frame types.
129
130
131       -k     The -k option tells the  server  to  use  kernel-mode  PPPoE  on
132              Linux.  This option is available only on Linux kernels 2.4.0 and
133              later, and only if the server was built  with  kernel-mode  sup‐
134              port.
135
136
137       -h     The -h option prints a brief usage message and exits.
138
139

OPERATION

141       pppoe-server listens for incoming PPPoE discovery packets.  When a ses‐
142       sion is established, it spawns a pppd process.  The  following  options
143       are passed to pppd:
144
145       nodetach noaccomp nobsdcom nodeflate nopcomp novj novjccomp
146       default-asyncmap
147
148       In  addition,  the  local and remote IP address are set based on the -L
149       and -R options.  The pty option is supplied along with a pppoe  command
150       to initiate the PPPoE session.  Finally, additional pppd options can be
151       placed in the file  /etc/ppp/pppoe-server-options  (which  must  exist,
152       even if it is just empty!)
153
154       Note  that  pppoe-server is meant mainly for testing PPPoE clients.  It
155       is not a high-performance server meant for production use.
156
157

AUTHORS

159       pppoe-server was written by David F. Skoll <dfs@roaringpenguin.com>.
160
161       The pppoe home page is http://www.roaringpenguin.com/pppoe/.
162
163

SEE ALSO

165       pppoe-start(8),     pppoe-stop(8),      pppoe-connect(8),      pppd(8),
166       pppoe.conf(5),   pppoe(8),   pppoe-setup(8),   pppoe-status(8),  pppoe-
167       sniff(8), pppoe-relay(8)
168
169
170
171
1724th Berkeley Distribution         3 July 2000                  PPPOE-SERVER(8)
Impressum