NAME

       pppoe-discovery - perform PPPoE discovery

SYNOPSIS

       pppoe-discovery [ options ]
       pppoe-discovery { -V | -h }

DESCRIPTION

       pppoe-discovery  performs the same discovery process as pppoe, but does not initiate a session.  It sends
       a PADI packet and then prints the names of access concentrators in each PADO packet it receives.

OPTIONS

       -I interface
              The -I option specifies the Ethernet interface to use.  Under Linux, it is typically eth0 or eth1.
              The interface should be “up” before you start pppoe-discovery, but should  not  be  configured  to
              have an IP address.  The default interface is eth0.

       -D file_name
              The  -D  option causes every packet to be dumped to the specified file_name.  This is intended for
              debugging only.

       -U
              Causes pppoe-discovery to use the Host-Uniq tag in its  discovery  packets.   This  lets  you  run
              multiple  instances  of  pppoe-discovery  and/or  pppoe  without  having  their  discovery packets
              interfere with one another.  You must supply this option to all instances that you intend  to  run
              simultaneously.

       -S service_name
              Specifies  the  desired service name.  pppoe-discovery will only accept access concentrators which
              can provide the specified service.  In most cases, you should not specify  this  option.   Use  it
              only  if  you  know  that there are multiple access concentrators or know that you need a specific
              service name.

       -C ac_name
              Specifies the desired access concentrator name.  pppoe-discovery will only  accept  the  specified
              access  concentrator.  In most cases, you should not specify this option.  Use it only if you know
              that there are multiple access concentrators.  If both the -S and -C options are  specified,  they
              must both match.

       -A
              This option is accepted for compatibility with pppoe, but has no effect.

       -V | -h
              Either  of these options causes pppoe-discovery to print its version number and usage information,
              then exit.

AUTHORS

       pppoe-discovery  was  written  by  Marco  d'Itri  <md@linux.it>,  based  on  pppoe  by  David  F.   Skoll
       <dfs@roaringpenguin.com>.

SEE ALSO

       pppoe(8), pppoe-sniff(8)

                                                 22 January 2006                              PPPOE-DISCOVERY(8)