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)