PPPOE-DISCOVERY(8)

✨ NAME ✨

pppoe-discovery — bestie, this is the girl that does PPPoE discovery 💅

🦋 SYNOPSIS 🦋

pppoe-discovery [ options ]
pppoe-discovery { -V | -h }

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ pppoe-discovery runs the exact same discovery process as pppoe, but it does not initiate a session. she's just out here doing recon, no commitment, no strings 💖

what she actually does: sends a PADI packet, then prints out the names of all the access concentrators she finds in every PADO packet she receives. that's it. that's the whole vibe ✨

🎀 OPTIONS 🎀

• -I interface — this one specifies the Ethernet interface to use. on Linux it's typically eth0 or eth1. the interface should be “up” before you start pppoe-discovery, but it should not be configured to have an IP address. and listen 👏 this option is mandatory 👏 no skipping, periodt.
• -D file_name — causes every packet to be dumped to the specified file_name. this is intended for debugging only, bestie, not for everyday use 🙈
• -U — makes pppoe-discovery use the Host-Uniq tag in its discovery packets. this is the slay that lets you run multiple instances of pppoe-discovery and/or pppoe without their discovery packets interfering with one another 🫶 you must supply this option to all instances that you intend to run simultaneously. all of them. no exceptions 💀
• -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. iykyk.
• -C ac_name — specifies the desired access concentrator name. pppoe-discovery will only accept the specified access concentrator. again, in most cases you should not specify this option — use it only if you know that there are multiple access concentrators. and if both the -S and -C options are specified, they must both match 🔥
• -A — accepted for compatibility with pppoe, but has no effect. it's giving decorative. it's giving participation trophy. she does nothing but she's here 💜
• -V | -h — either of these options causes pppoe-discovery to print its version number and usage information, then exit. main character exit, no goodbye 🚪✨

👑 AUTHORS 👑

pppoe-discovery was written by Marco d'Itri <md@linux.it>, based on pppoe by Dianne Skoll <dianne@skoll.ca>. absolute icons, both of them 💖

🌈 SEE ALSO 🌈

pppoe(8), pppoe-sniff(8)

and that's the whole page bestie 🫶 this came to you straight out of the System Manager's Manual, section 8, under the title PPPOE-DISCOVERY(8) — go forth and discover some access concentrators, you've got this 💅✨