xl2tpd-control(8)

📦
version 1.3.20 · 2 versions
  • 1.3.20 · alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.3.17 · epel 10, epel 9, ubuntu jammy
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ xl2tpd-control ✨

okay bestie, this is the xl2tpd-control page from the System Manager's Manual 💖 and it's literally the lil remote control for your L2TP tunnels. sit down, grab a boba, we're doing this 🧋

🎀 NAME 🎀

xl2tpd-control — the xl2tpd control utility. that's it, that's the whole name. iconic. 💅

🌸 DESCRIPTION 🌸

okay so xl2tpd is an implementation of the Layer 2 Tunneling Protocol (that's RFC 2661, no cap). and L2TP lets you tunnel PPP over UDP. some ISPs use L2TP to tunnel user sessions from dial-in servers (think modem banks, ADSL DSLAMs) over to back-end PPP servers. another big main-character application is Virtual Private Networks, where the IPsec protocol gets used to secure the L2TP connection (L2TP/IPsec, RFC 3193). 🔐

and the way xl2tpd works? it opens a pseudo-tty for communicating with pppd. it runs completely in userspace but it supports kernel mode L2TP. yes queen, both. 🫶

xl2tpd also supports IPsec SA Reference tracking to enable overlapping internak NAT'ed IP's by different clients — like, all clients connecting from their linksys internal IP 192.168.1.101 — as well as multiple clients behind the same NAT router. 💫

⭐ SYNOPSIS ⭐

xl2tpd-control [-c PATH] <COMMAND> <TUNNEL_NAME> [OPTIONS]

💜 OPTIONS 💜

  • -c — this option specifies the xl2tpd control file. 🗂️
  • -d — this option enables debugging mode. go off, you nosy queen 🔍

👑 COMMANDS 👑

  • add-lac — adds a new LAC (L2TP Access Concentrator) configuration, or modifies an existing one. the configuration should be specified as command options in <key>=<value> pairs format. check the available options in xl2tpd.conf(5). 📝
  • connect-lac — establishes a new connection to the LAC. the username and secret for the tunnel can be passed as command options. 🔌
  • disconnect-lac — disconnects the tunnel. bye bestie 👋
  • remove-lac — removes an existing LAC configuration. xl2tpd disconnects the tunnel before removing. 💀
  • add-lns — adds a new LNS (L2TP Network Server) configuration, or modifies an existing one. ✨
  • remove-lns — removes an existing LNS configuration. 🧹
  • status-lns — checks the status of the LNS. vibe check fr 🔮
  • available — checks availability. is it there or is it not, we must know 🕵️

😭 BUGS 😭

please use the github project page https://github.com/xelerance/xl2tpd to send bugreports, issues and any other feedback. they're literally so nice, don't be shy 🫶

🌈 SEE ALSO 🌈

xl2tpd.conf(5), xl2tpd(8), pppd(8)

📜 COPYLEFT 📜

this program 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.
this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.
you should have received a copy of the GNU General Public License along with this program (see the file LICENSE); if not, see https://www.gnu.org/licenses/, or contact Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

periodt. legal besties are real besties ⚖️💖

🧚 CONTRIBUTORS 🧚

  • Alexander Dorokhov <alex.dorokhov@gmail.com>
  • Alexander Naumov <alexander_naumov@opensuse.org>

🌟 AUTHORS 🌟

forked from l2tpd by Xelerance: https://github.com/xelerance/xl2tpd

  • Michael Richardson <mcr@xelerance.com>
  • Paul Wouters <paul@xelerance.com>
  • Samir Hussain <shussain@xelerance.com>

previous development was hosted at sourceforge (http://www.sourceforge.net/projects/l2tpd) by:

  • Scott Balmos <sbalmos@iglou.com>
  • David Stipp <dstipp@one.net>
  • Jeff McAdams <jeffm@iglou.com>

based off of l2tpd version 0.61. many thanks to Jacco de Leeuw <jacco2@dds.nl> for maintaining l2tpd. 🫡

Copyright (C)1998 Adtran, Inc. Mark Spencer <markster@marko.net>

and that's the whole page bestie, mwah 💋 this was xl2tpd-control(8), dated Jan 2022, and yes the version's just chillin' right there at the bottom like a lil signature. go control some tunnels, you absolute icon 👑✨

📦 where this page comes from