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. The value of the tag  is
              derived  from  the  process's PID number.  This lets you run multiple instances of pppoe-discovery
              and/or pppd without having their discovery packets interfere with one another.   You  must  supply
              this  option  to  all  instances  that  you intend to run simultaneously.  This option is mutually
              exclusive with -W.

       -W value
              Causes pppoe-discovery to use the Host-Uniq tag in its discovery packets. The value of the tag  is
              taken  from  the  option  argument,  encoded as a string of hexadecimal digits.  This lets you run
              multiple instances of pppoe-discovery and/or pppd without having their discovery packets interfere
              with one another.  You  must  supply  this  option  to  all  instances  that  you  intend  to  run
              simultaneously.  This option is mutually exclusive with -U.

       -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.

       -Q
              Causes pppoe-discovery to avoid printing discovered access concentrator names.  This can be useful
              in  scripts,  which  can use the exit code of the program to determine whether any matching access
              concentrators were discovered.

       -t timeout
              Changes the discovery timeout for PADI requests, in seconds.  The default value is 5 seconds.

       -a attempts
              Changes the number of PADI discovery attempts made.  By default, 3 attempts are made  to  discover
              access concentrators before giving up.

       -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)

                                                 12 January 2019                              PPPOE-DISCOVERY(8)