kl2tpd(8)

✨ kl2tpd — the manual page, but make it cute ✨

okay bestie, sit down, hydrate, and let me tell you about kl2tpd — it's a page from the go-l2tp manual, section 8 (that's the sysadmin section, very demure, very powerful 💅), and it's genuinely so much less scary than it looks.

---

🎀 NAME 🎀

kl2tpd — a minimal L2TPv2 client daemon. that's it. that's the whole name. minimal, client, daemon. she's giving understated icon ✨

---

🌸 SYNOPSIS 🌸

kl2tpd [ arguments ]

yeah that's the whole thing. you just run her with some arguments and she goes. no cap 🫶

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie: kl2tpd is a client/LAC-mode daemon — LAC stands for L2TP Access Concentrator, iykyk — and what she does is create L2TPv2 tunnels and sessions. that's the protocol from RFC 2661, so if you wanna go read the actual spec, go off, it's right there 📖

important!! kl2tpd needs root permissions to run. like, she will not be doing her little thing without them. no root, no tunnel, periodt. 👑

and she's not one of those daemons you configure with a hundred CLI flags — she's driven by a configuration file that lays out exactly which tunnel and session instances to create. the config file is the main character here, fr fr.

want the full details of that config format? that lives in its own page: kl2tpd.toml(5). go read that one, it's the lore drop. 📜

and by default? kl2tpd spawns the standard Linux pppd for PPP protocol support. so she's not doing PPP herself, she's calling in the professional. delegation! we love to see it 💅

---

💖 OPTIONS 💖

three options. THREE. that's the whole menu. she's a minimalist queen and we respect her for it ✨

• -config string — specify the configuration file path. the default is /etc/kl2tpd/kl2tpd.toml. so if your config lives somewhere else, this is how you tell her. 🗂️
• -null — toggle the null data plane. what does that mean? it means she establishes the L2TP tunnel and session but does not spawn pppd. just the tunnel and session, nothing more. like showing up to the party but not dancing. still valid! 🙈
• -verbose — toggle verbose log output. turn this on when you want her to tell you everything she's doing. absolute yapper mode, and honestly? sometimes you need that. 🔍

note that -config takes a value (string), while -null and -verbose are toggles — no value, they just flip a switch. don't @ me, that's just how she is 🎀

---

🌈 SEE ALSO 🌈

• kl2tpd.toml(5) — the config file format, aka where the real power lives
• pppd(8) — the PPP daemon she spawns by default

---

👑 AUTHORS 👑

Katalix Systems, Ltd. — the legends who made her 💜

---

and that's the page!! you understood all of it, I know you did, look at you go 🧚

cute little sign-off for the record: this was written for go-l2tp v0.1.8, dated May 2024. so if you're reading this way in the future, hi, hope the tunnels are tunnelling 💖✨🦋