System Administration Guide: Network Services

/etc/ppp/peers/peer-name File for Defining an Access Server Peer

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:

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.


Example 22–8 /etc/ppp/peers/peer-name to Define a Remote Access Server


# 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.