1xl2tpd-control(8) System Manager's Manual xl2tpd-control(8)
2
6 xl2tpd-control - xl2tpd control utility.
7
10 xl2tpd is an implementation of the Layer 2 Tunneling Protocol (RFC
11 2661). L2TP allows to tunnel PPP over UDP. Some ISPs use L2TP to tun‐
12 nel user sessions from dial-in servers (modem banks, ADSL DSLAMs) to
13 back-end PPP servers. Another important application is Virtual Private
14 Networks where the IPsec protocol is used to secure the L2TP connection
15 (L2TP/IPsec, RFC 3193).
16 xl2tpd works by opening a pseudo-tty for communicating with pppd. It
18 runs completely in userspace but supports kernel mode L2TP.
19 xl2tpd supports IPsec SA Reference tracking to enable overlapping in‐
21 ternak NAT'ed IP's by different clients (eg all clients connecting from
22 their linksys internal IP 192.168.1.101) as well as multiple clients
23 behind the same NAT router.
24
27 xl2tpd-control [-c PATH] <COMMAND> <TUNNEL_NAME> [OPTIONS]
28
32 -c This option specifies xl2tpd control file.
33 -d This option enables debugging mode.
36
39 add-lac
40 Adds new or modify existing LAC (L2TP Access Concentrator) con‐
41 figuration. Configuration should be specified as a command op‐
42 tions in <key>=<value> pairs format. See available options in
43 xl2tpd.conf(5).
44 connect-lac
47 Establish new connection to LAC. Username and secret for tunnel
48 can be passed as a command options.
49 disconnect-lac
52 Disconnects tunnel.
53 remove-lac
56 Removes existing LAC configuration. xl2tpd disconnects the tun‐
57 nel before removing.
58 add-lns
61 Adds new or modify existing LNS (L2TP Network Server) configura‐
62 tion.
63 remove-lns
66 Removes existing LNS configuration.
67 status-lns
70 Check the status of LNS.
71 available
74 Check availability.
75
78 Please use the github project page https://github.com/xelerance/xl2tpd
79 to send bugreports, issues and any other feedback.
80
83 xl2tpd.conf(5), xl2tpd(8), pppd(8)
84
87 This program is free software; you can redistribute it and/or modify it
88 under the terms of the GNU General Public License as published by the
89 Free Software Foundation; either version 2 of the License, or (at your
90 option) any later version.
91 This program is distributed in the hope that it will be useful, but
93 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
94 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
95 Public License for more details.
96 You should have received a copy of the GNU General Public License along
98 with this program (see the file LICENSE); if not, see
99 https://www.gnu.org/licenses/, or contact Free Software Foundation,
100 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
101
104 Alexander Dorokhov <alex.dorokhov@gmail.com>
105 Alexander Naumov <alexander_naumov@opensuse.org>
106
109 Forked from l2tpd by Xelerance: https://github.com/xelerance/xl2tpd
110 Michael Richardson <mcr@xelerance.com>
112 Paul Wouters <paul@xelerance.com>
113 Samir Hussain <shussain@xelerance.com>
114 Previous development was hosted at sourceforge (http://www.source‐
116 forge.net/projects/l2tpd) by:
117 Scott Balmos <sbalmos@iglou.com>
119 David Stipp <dstipp@one.net>
120 Jeff McAdams <jeffm@iglou.com>
121 Based off of l2tpd version 0.61. Many thanks to Jacco de Leeuw
123 <jacco2@dds.nl> for maintaining l2tpd.
124 Copyright (C)1998 Adtran, Inc.
126 Mark Spencer <markster@marko.net>
127 Sep 2020 xl2tpd-control(8)