1PPPOE-SNIFF(8) System Manager's Manual PPPOE-SNIFF(8)
2
3
4
6 pppoe-sniff - examine network for non-standard PPPoE frames
7
9 pppoe-sniff [options]
10
11
13 pppoe-sniff listens for likely-looking PPPoE PADR and session frames
14 and deduces extra options required for pppoe(8) to work.
15
16 Some DSL providers seem to use non-standard frame types for PPPoE
17 frames, and/or require a certain value in the Service-Name field. It
18 is often easier to sniff those values from a machine which can success‐
19 fully connect rather than try to pry them out of the DSL provider.
20
21 To use pppoe-sniff, you need two computers, a DSL modem and an Ethernet
22 hub (not an Ethernet switch.)
23
24 If the DSL modem normally connects directly to your computer's Ethernet
25 card, connect it to the "uplink" port on the Ethernet hub. Plug two
26 computers into normal ports on the hub. On one computer, run whatever
27 software the DSL provider gave you on whatever operating system the DSL
28 provider supports. On the other computer, run Linux and log in as
29 root.
30
31 On the Linux machine, put the Ethernet interface into promiscuous mode
32 and start pppoe-sniff. If the ethernet interface is eth0, for example,
33 type these commands:
34
35 ifconfig eth0 promisc
36 pppoe-sniff -I eth0
37
38 On the other machine, start your DSL connection as usual. After a
39 short time, pppoe-sniff should print recommendations for the value of
40 PPPOE_EXTRA. Set this value in /etc/ppp/pppoe.conf. If pppoe-sniff
41 indicates that something special is required in PPPOE_EXTRA, please e-
42 mail this to pppoe@roaringpenguin.com along with the name of your ISP
43 and the manufacturer and model number of your DSL modem. This informa‐
44 tion will be collated and provided on the PPPoE web page for users who
45 do not have two computers.
46
47 After pppoe-sniff finishes (or you stop it if it seems hung), remember
48 to turn off promiscuous mode:
49
50 ifconfig eth0 -promisc
51
52
54 -I interface
55 The -I option specifies the Ethernet interface to use. Under
56 Linux, it is typically eth0 or eth1. The interface should be
57 "up" and in promiscuous mode before you start pppoe-sniff.
58
59
60 -V The -V option causes pppoe-sniff to print its version number and
61 exit.
62
63
65 pppoe-sniff only works on Linux.
66
67
69 pppoe-sniff was written by David F. Skoll <dfs@roaringpenguin.com>.
70
71 The pppoe home page is http://www.roaringpenguin.com/pppoe/.
72
73
75 pppoe-start(8), pppoe-stop(8), pppoe-connect(8), pppd(8),
76 pppoe.conf(5), pppoe(8), pppoe-setup(8), pppoe-status(8), pppoe-
77 server(8), pppoe-relay(8)
78
79
80
81
824th Berkeley Distribution 3 July 2000 PPPOE-SNIFF(8)