1 .\" pppoe-discovery.8 written by
2 .\" Ben Hutchings <ben@decadentplace.org.uk>, based on pppoe.8.
3 .\" Licenced under the GPL version 2 or later.
6 pppoe\-discovery \- perform PPPoE discovery
13 .BR pppoe\-discovery " { " \-V " | " \-h " }"
16 \fBpppoe\-discovery\fR performs the same discovery process as
17 \fBpppoe\fR, but does not initiate a session.
18 It sends a PADI packet and then prints the names of access
19 concentrators in each PADO packet it receives.
24 The \fB\-I\fR option specifies the Ethernet interface to use.
25 Under Linux, it is typically eth0 or eth1.
26 The interface should be \(lqup\(rq before you start
27 \fBpppoe\-discovery\fR, but should \fInot\fR be configured to have an
29 This option is mandatory.
34 The \fB\-D\fR option causes every packet to be dumped to the specified
36 This is intended for debugging only.
41 Causes \fBpppoe\-discovery\fR to use the Host-Uniq tag in its discovery
43 This lets you run multiple instances of \fBpppoe\-discovery\fR and/or
44 \fBpppoe\fR without having their discovery packets interfere with one
46 You must supply this option to \fIall\fR instances that you intend to
50 .BI \-S " service_name"
52 Specifies the desired service name.
53 \fBpppoe\-discovery\fR will only accept access concentrators which can
54 provide the specified service.
55 In most cases, you should \fInot\fR specify this option.
56 Use it only if you know that there are multiple access concentrators
57 or know that you need a specific service name.
62 Specifies the desired access concentrator name.
63 \fBpppoe\-discovery\fR will only accept the specified access
65 In most cases, you should \fInot\fR specify this option.
66 Use it only if you know that there are multiple access concentrators.
67 If both the \fB\-S\fR and \fB\-C\fR options are specified, they must
73 This option is accepted for compatibility with \fBpppoe\fR, but has no
79 Either of these options causes \fBpppoe\-discovery\fR to print its
80 version number and usage information, then exit.
83 \fBpppoe\-discovery\fR was written by Marco d'Itri <md@linux.it>,
84 based on \fBpppoe\fR by Dianne Skoll <dianne@skoll.ca>.
86 pppoe(8), pppoe\-sniff(8)