pppoec(1)                                                         pppoec(1)




 NAME    [Toc]    [Back]
      pppoec - PPPoE (Point to Point Protocol over Ethernet) client

 SYNOPSIS    [Toc]    [Back]
      pppoec -i interface-name

      pppoec -i interface-name [-c config-file] [-d debug-level]
           [-l log-file] [-r retry-number]

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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.




 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004






 pppoec(1)                                                         pppoec(1)




 EXAMPLES    [Toc]    [Back]
      An example usage of the pppoec command is as follows:

           /usr/bin/pppoec -i lan4 -c /tmp/ppp/pppoec.conf -d 2

 WARNINGS    [Toc]    [Back]
      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    [Toc]    [Back]
      pppoec was developed by Hewlett-Packard.

 FILES    [Toc]    [Back]
      pppoesd       PPPoE server daemon
      pppoerd       PPPoE relay
      pppoec.conf   PPPoE client configuration file
      pppd          PPP daemon

 SEE ALSO    [Toc]    [Back]
      pppd(1M), pppoerd(1M), pppoesd(1M), pppoec.conf(4).


 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004