When you define an access server to be discovered by pppoec, you use options that apply to both pppoec and the pppd daemon. An /etc/ppp/peers/peer-name file for an access server requires the following parameters:
sppptun – Name for the serial device that is used by the PPPoE tunnel.
plugin pppoe.so – Instructs pppd to load the pppoe.so shared object.
connect "/usr/lib/inet/pppoec device" – Starts a connection. connect then invokes the pppoec utility over device, the interface that is plumbed for PPPoE.
The remaining parameters in the /etc/ppp/peers/peer-name file should apply to the PPP link on the server. Use the same options that you would for /etc/ppp/peers/peer-name on a dial-out machine. Try to limit the number of options to the minimum you need for the PPP link.
The following example is introduced in How to Define a PPPoE Access Server Peer.
# cat /etc/ppp/peers/dslserve sppptun plugin pppoe.so connect "/usr/lib/inet/pppoec hme0" noccp noauth user Red password redsecret noipdefault defaultroute |
This file defines parameters to be used when setting up a PPPoE tunnel and PPP link to access server dslserve. The options that are included are as follows.
Option |
Description |
---|---|
sppptun |
Defines sppptun as the name of the serial device. |
plugin pppoe.so |
Instructs pppd to load the pppoe.so shared object. |
connect "/usr/lib/inet/pppoec hme0" |
Runs pppoec and designates hme0 as the interface for the PPPoE tunnel and PPP link. |
noccp |
Turns off CCP compression on the link. Note – Many ISPs use only proprietary compression algorithms. Turning off the publicly available CCP algorithm saves negotiation time and avoids very occasional interoperability problems. |
noauth |
Stops pppd from demanding authentication credentials from the access server. Most ISPs do not provide authentication credentials to customers. |
user Red |
Sets the name Red as the user name for the client, which is required for PAP authentication by the access server. |
password redsecret |
Defines redsecret as the password to be provided to the access server for PAP authentication. |
noipdefault |
Assigns 0.0.0.0 as the initial IP address. |
defaultroute |
Tells pppd to install a default IPv4 route after IPCP negotiation. You should include defaultroute in /etc/ppp/peers/peer-name when the link is the system's link to the Internet, which is true for a PPPoE client. |