Provided by: pppoe_3.5-4ubuntu1_i386 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