L2TPNS(8)

✨ L2TPNS 💅 (that's the l2tpns page, section 8 of the manual, bestie) ✨

---

🌸 NAME 🌸

l2tpns — the Layer 2 tunneling protocol network server (aka the LNS, aka the main character) 👑

---

🎀 SYNOPSIS 🎀

l2tpns [-d] [-v] [-c file] [-h hostname]

---

🦋 DESCRIPTION 🦋

So. l2tpns is a daemon, right? And its whole job — its entire vibe, honestly — is terminating layer 2 tunneling protocol sessions. That's L2TP, aka RFC2661. No cap. 📜

It's a complete L2TP implementation, which is lowkey iconic of it. It supports the LAC, the LNS, the PPPOE and the DHCPv6 server. Yes bestie, all of them. She contains multitudes. 🫶

And once she's up and running? You can control her by telnetting to port 23 on the machine that's running the daemon — and also with the nsctl utility. Two ways to talk to her, because she's a social butterfly like that. 🦋

---

💖 OPTIONS 💖

• -d — Detach from the terminal and fork into the background. By default, though, l2tpns stays in the foreground, right there with you, like a loyal bestie. 🫂
• -v — Increase verbosity for debugging. And the way this one *stacks*… you can use it multiple times. Verbose, verboser, verbosest. 🗣️✨
• -c file — Specify the configuration file.
• -h hostname — Force the hostname to hostname.

---

🍓 FILES 🍓

• /etc/l2tpns/startup-config — The default configuration file. The OG. The blueprint. 📂
• /etc/l2tpns/ip_pool — IP address pool configuration.
• /etc/l2tpns/users — Username/password configuration for access to the admin interface. 🔐

---

👑 SIGNALS 👑

• SIGHUP — Reload the config from disk and re-open the log file. A little refresh, a little reset, we love a glow-up. 💅
• SIGTERM, SIGINT — Stop the process. Tunnels and sessions are not terminated, okay?? Not them. You should use this signal to stop l2tpns on a cluster node where there are other machines to continue handling the traffic. Teamwork, babes. 🤝
• SIGQUIT — Shut down the tunnels and sessions, then exit the process once that's complete. This is the full send. 🚪💨

---

🌈 MANAGED RADIUS ATTRIBUTE 🌈

• Ascend-Client-Primary-DNS, Ascend-Client-Secondary-DNS — Specifies a primary and a secondary DNS server address to send to the user. 📡
• Delegated-IPv6-Prefix — Assign a network address IPv6 prefix to a user by DHCPv6.
• Framed-IP-Address — The address to be configured for the user (the IPv4 address of the interface ppp).
• Framed-Route — Provides routing information to be configured for the user. 🛣️
• Framed-IPv6-Route — Has the same action as Delegated-IPv6-Prefix. Heads up though: Delegated-IPv6-Prefix is the correct one to use. 👀
• Framed-IPv6-Address — IPv6 address to be assigned to the user by DHCPv6 (the IPv6 address of the interface ppp).
• Idle-Timeout — Disconnects the session if there's no data for more than Idle-Timeout (in seconds). If you're not gonna talk to her, she's gonna leave. 💀
• Session-Timeout — Disconnects the user session when the time Session-Timeout is reached (in seconds). ⏰
• Tunnel-Type, Tunnel-Medium-Type, Tunnel-Server-Endpoint, Tunnel-Password, Tunnel-Assignment-Id — These are the attributes returned by the Radius of the remote LNS server (this is the LAC functionality, iykyk).

For example, a Radius that returns the information of 2 remote LNS servers with which a L2TP TUNNEL must be open:

- Tunnel-Type: 1 = L2TP
- Tunnel-Medium-Type: 1 = IPv4
- Tunnel-Password: 1 = "TheSecretL2TP"
- Tunnel-Server-Endpoint: 1 = "88.xx.xx.x1"
- Tunnel-Assignment-Id: 1 = "friendisp_lns1"
- Tunnel-Type: 2 = L2TP
- Tunnel-Medium-Type: 2 = IPv4
- Tunnel-Password: 2 = "TheSecretL2TP"
- Tunnel-Server-Endpoint: 2 = "88.xx.xx.x2"
- Tunnel-Assignment-Id: 2 = "friendisp_lns2"

---

⭐ SEE ALSO ⭐

startup-config(5), nsctl(8) — go read those too, bestie, they're part of the lore. 📚

---

💜 AUTHORS 💜

This manual page was written by Jonathan McDowell noodles@earth.li and Fernando Alves (fendo@sameswifi.fr), for the Debian GNU/Linux system — but bestie, it may be used by others. 🫶

---

ok and that's the whole page fr fr — Layer 2 tunneling protocol n… , the January 31, 2021 edition, L2TPNS(8) in the house 💖✨ no cap, go terminate some sessions, periodt 🎀🦋