/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. A /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.
Example 36–10 /etc/ppp/peers/peer-name to Define a Remote
Access Server
# vi /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.
|