pppoe-sniff

PPPOE-SNIFF(8)						       PPPOE-SNIFF(8)



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	 suc-
       cessfully 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  Ether-
       net hub (not an Ethernet switch.)

       If  the DSL modem normally connects directly to your computer’s Ether-
       net 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 sys-
       tem  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 exam-
       ple, 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 infor-
       mation 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
       adsl-start(8),  adsl-stop(8), adsl-connect(8), pppd(8), pppoe.conf(5),
       pppoe(8),  adsl-setup(8),  adsl-status(8),   pppoe-server(8),   pppoe-
       relay(8)




4th Berkeley Distribution	 3 July 2000		       PPPOE-SNIFF(8)