ql2tpd(8)

📦
version 0.1.8 · 2 versions
  • 0.1.8 · debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 0.1.7 · ubuntu noble
, in debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ql2tpd — the girlies' guide to static L2TPv3 tunnels 💖

okay so bestie, listen. this is a page from section 8 of the manual (ql2tpd(8)), and it's all about ql2tpd, a daemon from the go-l2tp crew. it makes static (or "quiescent") L2TPv3 tunnels and sessions, and honestly? it's giving main character energy in the data plane. let's get into it 🦋

✨ NAME ✨

ql2tpd — a daemon for creating static (or quiescent) L2TPv3 tunnels and sessions 🎀

✨ SYNOPSIS ✨

ql2tpd [ arguments ]

like, you just run it with some arguments. that's the whole vibe.

🌸 DESCRIPTION 🌸

okay so ql2tpd is a daemon for creating static L2TPv3 (RFC 3931) tunnels and sessions. RFC 3931, noted, iconic, no cap.

Static (or quiescent) tunnels and sessions implement only the data plane transport: the L2TP control protocol is not used. literally not even invited to the party. this can be useful for setting up static L2TPv3 links where host configuration is known in advance. iykyk 💅

When configured to bring up static tunnel and session instances, ql2tpd represents a more convenient way to bring up static sessions than ip l2tp commands. yes, it's the upgrade. the glow-up. periodt.

Additionally, ql2tpd supports the use of a periodic keep-alive packet for tunnels it is managing (controlled by the configuration file hello_timeout parameter). a lil "hey bestie, you still there?" packet 🫶

This allows for the detection of tunnel failure, which will then tear down the sessions running in that tunnel. so if the tunnel ghosts you, the sessions get ghosted too. it's giving consequences.

⚠️ This mode of operation must only be enabled if the peer is also running ql2tpd. like, don't send keep-alives into the void, bestie. both sides need to be in on it.

ql2tpd requires root permissions to run 👑 (yes, actual root, we're not kidding), and is driven by a configuration file which details the tunnel and session instances to create.

For further details of the configuration format, please refer to ql2tpd.toml(5). go read it, it's short, i promise 🍓

✨ OPTIONS ✨

  • -config string — specify configuration file path (default "/etc/ql2tpd/ql2tpd.toml") 🎀 like if you wanna put your config somewhere else, this is the girl that tells ql2tpd where it lives
  • -verbose — toggle verbose log output 🔥 turn it on and suddenly you know everything that's happening. very nosy, very useful

💜 SEE ALSO 💜

👑 AUTHORS 👑

Katalix Systems, Ltd.

and that's the whole page, bestie! 🌈 this was ql2tpd(8) from go-l2tp v0.1.8, dated May 2024 — so yeah, fresh-ish, cute, done. go build some tunnels, stay rooted, and don't forget your config file 💖✨🎀🦋🌸💅🫶

📦 where this page comes from