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