Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pppoe-sniff(8) [linux man page]

PPPOE-SNIFF(8)						      System Manager's Manual						    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 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 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

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

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

Check Out this Related Man Page

PPPOE-DISCOVERY(8)					      System Manager's Manual						PPPOE-DISCOVERY(8)

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