NAME
pppoec — PPPoE (Point to Point Protocol over Ethernet) client
SYNOPSIS
pppoec
-i
interface-name
pppoec
-i
interface-name
[-c
config-file]
[-d
debug-level]
[-l
log-file]
[-r
retry-number]
DESCRIPTION
pppoec
discovers an access concentrator that is willing
to offer services to the client.
It obtains a unique session-id from the selected access concentrator.
pppoec
then forks a
pppd
daemon which performs the session phase
functionalities of PPPoE as mentioned in RFC 2516.
Options
pppoec
supports the following options:
- -c config-file
Specify the configuration file with absolute path
to be used by
pppoec.
The default configuration file is
/etc/ppp/pppoec.conf.
- -d debug-level
Specify the debug level at which logging has to be
enabled.
The three debug levels are:
- LOG_ERROR
Logs all error messages.
To log these messages, type
-d 0
on the command line.
- LOG_WARN
Logs all warning messages.
To log these messages, type
-d 1
on the command line.
- LOG_DEBUG
Logs function level debug messages.
To log these messages, type
-d 2
on the command line.
- -i interface-name
Specify the name of the network interface (e.g.,
lan0)
to be used for the PPPoE session.
- -l log-file
Specify the log file with absolute path, to which pppoec must
log all messages.
The default log file is
/var/adm/pppoec.log.
- -r retry-number
Specify the frequency of PADI (PPPoE Active
Discovery Initiation) or PADR (PPPoE Active
Discovery Request) packet retransmission when
an access concentrator does not respond to the client's request.
The default value is 3.
EXAMPLES
An example usage of the
pppoec
command is as follows:
/usr/bin/pppoec -i lan4 -c /tmp/ppp/pppoec.conf -d 2
WARNINGS
Note that, you cannot run the client daemon without
/etc/ppp/pppoec.conf
file. See
pppoec.conf(4)
for more information.
Also, do not use
SIGKILL
to terminate
pppoec.
Instead, use
SIGTERM
to kill the
pppoec
client daemon.
AUTHOR
pppoec
was developed by Hewlett-Packard.
FILES
- pppoesd
PPPoE server daemon
- pppoerd
PPPoE relay
- pppoec.conf
PPPoE client configuration file
- pppd
PPP daemon
Printable version
