Provided by: pppoe_3.11-0ubuntu1_amd64 bug

NAME

       pppoe-sniff - examine network for non-standard PPPoE frames

SYNOPSIS

       pppoe-sniff [options]

DESCRIPTION

       pppoe-sniff  listens  for likely-looking PPPoE PADR and session frames and deduces extra options required
       for pppoe(8) to work.

       Some DSL providers seem to use non-standard frame types for PPPoE frames, and/or require a certain  value
       in  the  Service-Name  field.   It  is  often  easier  to  sniff  those  values  from a machine which can
       successfully connect rather than try to pry them out of the DSL provider.

       To use pppoe-sniff, you need two computers, a DSL modem and an Ethernet hub (not an Ethernet switch.)

       If the DSL modem normally connects directly to your computer's Ethernet card, connect it to the  "uplink"
       port  on  the  Ethernet  hub.   Plug  two  computers  into normal ports on the hub.  On one computer, run
       whatever software the DSL provider gave you on whatever operating system the DSL provider  supports.   On
       the other computer, run Linux and log in as root.

       On  the  Linux  machine,  put the Ethernet interface into promiscuous mode and start pppoe-sniff.  If the
       ethernet interface is eth0, for example, type these commands:

            ifconfig eth0 promisc
            pppoe-sniff -I eth0

       On the other machine, start your DSL connection as usual.  After a short time, pppoe-sniff  should  print
       recommendations  for  the  value  of PPPOE_EXTRA.  Set this value in /etc/ppp/pppoe.conf.  If pppoe-sniff
       indicates   that   something   special   is   required   in   PPPOE_EXTRA,   please   e-mail   this    to
       pppoe@roaringpenguin.com  along  with  the name of your ISP and the manufacturer and model number of your
       DSL modem.  This information will be collated and provided on the PPPoE web page for  users  who  do  not
       have two computers.

       After pppoe-sniff finishes (or you stop it if it seems hung), remember to turn off promiscuous mode:

            ifconfig eth0 -promisc

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" and in promiscuous mode before you start pppoe-sniff.

       -V     The -V option causes pppoe-sniff to print its version number and exit.

BUGS

       pppoe-sniff only works on Linux.

AUTHORS

       pppoe-sniff was written by David F. Skoll <dfs@roaringpenguin.com>.

       The pppoe home page is http://www.roaringpenguin.com/pppoe/.

SEE ALSO

       pppd(8), pppoe(8), pppoe-sniff(8), pppoe-relay(8), /usr/share/doc/pppoe/README.Debian.gz