1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
|
.\" Automatically generated by Pandoc 3.1.8
.\"
.TH "ql2tpd" "8" "May 2024" "go-l2tp v0.1.8" "go-l2tp"
.SH NAME
ql2tpd - a daemon for creating static (or quiescent) L2TPv3 tunnels and
sessions
.SH SYNOPSIS
\f[B]ql2tpd\f[R] [ arguments ]
.SH DESCRIPTION
\f[B]ql2tpd\f[R] is a daemon for creating static L2TPv3 (RFC 3931)
tunnels and sessions.
.PP
Static (or quiescent) tunnels and sessions implement
\f[B]\f[BI]only\f[B]\f[R] the data plane transport: the L2TP control
protocol is not used.
This can be useful for setting up static L2TPv3 links where host
configuration is known in advance.
.PP
When configured to bring up static tunnel and session instances,
\f[B]ql2tpd\f[R] represents a more convenient way to bring up static
sessions than \f[B]ip l2tp\f[R] commands.
.PP
Additionally, \f[B]ql2tpd\f[R] supports the use of a periodic keep-alive
packet for tunnels it is managing (controlled by the configuration file
\f[B]\f[BI]hello_timeout\f[B]\f[R] parameter).
.PP
This allows for the detection of tunnel failure, which will then tear
down the sessions running in that tunnel.
This mode of operation must only be enabled if the peer is also running
\f[B]ql2tpd\f[R].
.PP
\f[B]ql2tpd\f[R] requires root permissions to run, and is driven by a
configuration file which details the tunnel and session instances to
create.
.PP
For further details of the configuration format, please refer to
\f[B]ql2tpd.toml\f[R](5).
.SH OPTIONS
.TP
-config string
specify configuration file path (default
\[lq]/etc/ql2tpd/ql2tpd.toml\[rq])
.TP
-verbose
toggle verbose log output
.SH SEE ALSO
\f[B]ql2tpd.toml\f[R](5), \f[B]ip-l2tp\f[R](8)
.SH AUTHORS
Katalix Systems, Ltd.
|