1PPPOE-SERVER(8) System Manager's Manual PPPOE-SERVER(8)
2
3
4
6 pppoe-server - user-space PPPoE server
7
9 pppoe-server [options]
10
11
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
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
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
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
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)