PPPOECONF(8)

👑 PPPOECONF — the pppoeconf(8) page, but make it cute 💖

okay bestie, welcome to pppoeconf, section 8 of the System Manager's Manual. she's the one who sets up your PPPoE (ADSL) connection and she does it so politely. no cap.

✨ NAME ✨

pppoeconf — configures a PPPoE (ADSL) connection 🦋

🎀 SYNOPSIS 🎀

pppoeconf [-nox] [iface]

💅 DESCRIPTION 💅

so like. pppoeconf is a user-friendly, dialog-based setup tool for pppd (and pppoe too, if it turns out you need it). she's not scary. she holds your hand. 🫶

here's the vibe check on what she does:

1. she goes looking for any existing ethernet cards you've got 💻
2. she looks for ADSL hardware plugged into one of them 🔌
3. if you want to force her hand, you can hand her an interface name — that's the iface argument — and she'll use exactly that one, no debate, periodt 💁‍♀️
4. then she gets some login info out of you 🔑
5. and she makes some minor modifications so you end up with settings that actually work ✨

pro tip from your girl: you can hit the ESC key to exit the program whenever you want. no trap, no guilt trip. 🙈

🌸 OPTIONS 🌸

• -nox — Force ncurses use. 💀 (yes bestie, she said force. she's serious about the terminal.)

🎀 FILES 🎀

• /etc/ppp/peers/dsl-provider — this is the pppd options file for your dsl provider. it's giving "the main character file." 👑
• /etc/ppp/pap-secrets and /etc/ppp/chap-secrets — these are described over in the pppd documentation. heads up: pppoeconf may add lines to these files. 🫣 so yeah, she edits them. that's the whole point of her.
• /etc/ppp/ip-up.d/0clampmss and /etc/ppp/ip-down.d/0clampmss — these two cuties are used to clamp MSS if it's needed. ✂️
• /etc/network/interfaces — the network interface file for your system. 🧚

🌈 SEE ALSO 🌈

pppd(8), interfaces(5), pon(1) and pppoe(8). go read them, iykyk 💜

💖 AUTHOR 💖

this manual page was originally written by Eduard Bloch (blade@debian.org) and is now maintained by Gregory Colpart (reg@evolix.fr) for the Debian GNU/Linux system (but may be used by others — she's generous like that 🫶).

this document is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. slay. 💅

on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. 📜

and that's the whole page bestie!! this was System Manager's Manual, page PPPOECONF(8), and no we did not forget the header or the footer — we just made them cute. 💖✨ mwah, go set up your ADSL. 🦋🌸🎀