8 August 2001
for ppp-2.4.2
+ Updated for ppp-2.4.5 by Paul Mackerras, Sep 08
1. Introduction
---------------
This document describes the support for PPP over Ethernet (PPPoE)
-included with this packages. It is assumed that the reader is
+included with this package. It is assumed that the reader is
familiar with Linux PPP (as it pertains to tty/modem-based
connections). In particular, users of PPP in the Linux 2.2 series
kernels should ensure they are familiar with the changes to the PPP
If you are not familiar with PPP, I recommend looking at other
packages which include end-user configuration tools, such as Roaring
-Penguin (http://www.roaringpenguin.com/pppoe)
+Penguin (http://www.roaringpenguin.com/pppoe).
PPPoE is a protocol typically used by *DSL providers to manage IP
addresses and authenticate users. Essentially, PPPoE provides for a
With this in mind, the goal of the implementation of PPPoE support in
Linux is to allow users to simply specify that the device they intend
-to use for the PPP connection is an ethernet device (i.e. "eth0") and
+to use for the PPP connection is an ethernet device (e.g. "eth0") and
the rest of the system should function as usual.
2. Using PPPoE
to connect to their ISP who is providing PPPoE based services.
1. Enable "Prompt for development and/or incomplete code/drivers" and
- "PPP over Ethernet" in your kernel configuration. If you choose to
- use the PPP over Ethernet driver as a module adding "alias
- net-pf-24 pppoe" to /etc/modules.conf will enable auto-loading
- of the modules.
+ "PPP over Ethernet" in your kernel configuration. Most distributions
+ will include the kernel PPPoE module by default.
2. Compile and install your kernel.
4. Add the following line to /etc/ppp/options:
- plugin rp-pppoe.so
+ plugin pppoe.so
The effect of this line is simply to make "eth0", "eth1",
....,"ethx" all valid device names for pppd (just like ttyS0,
5. Add the necessary authentication options to your pppd
configuration (i.e. PAP/CHAP information). If you wish to
- maintain seperate configurations for different devices you may
+ maintain separate configurations for different devices you may
place configuration options in device-specific configuration
files: /etc/ppp/options.devname (devname=ttyS0, ttyS1, eth0, eth1
or any other valid device name).