pppoe-discovery8
Perform pppoe discovery
Usage
pppoe-discovery [options]
pppoe-discovery {-V | -h}
Overview
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
-Iinterface-
The
-Ioption specifies the Ethernet interface to use. Under Linux, it is typically eth0 or eth1. The interface should be “up” before you startpppoe-discovery, but should not be configured to have an IP address. This option is mandatory.
-Dfile_name-
The
-Doption causes every packet to be dumped to the specified file_name. This is intended for debugging only.
-
-U -
Causes
pppoe-discoveryto use the Host-Uniq tag in its discovery packets. This lets you run multiple instances ofpppoe-discoveryand/orpppoewithout having their discovery packets interfere with one another. You must supply this option to all instances that you intend to run simultaneously.
-Sservice_name-
Specifies the desired service name.
pppoe-discoverywill 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.
-Cac_name-
Specifies the desired access concentrator name.
pppoe-discoverywill 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-Sand-Coptions 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-discoveryto print its version number and usage information, then exit.
History
- Arch Linux 2026-11-01: the text shown here
- Debian 13 (Trixie) to Debian 11 (Bullseye)
- Debian 10 (Buster) to Debian 4.0 (Etch)
-A since Arch Linux 2026-11-01.
-Q until Debian 13 (Trixie).