Documentation ¶
Overview ¶
The ql2tpd command is a daemon for creating static L2TPv3 tunnels and sessions.
ql2tpd is driven by a configuration file which describes the tunnel and session instances to create. For more information on the configuration file format please refer to package config's documentation.
Run with the -help argument for documentation of the command line arguments.
Two tunnel modes are supported.
By default tunnels are created in static mode, which means that the kernel-space L2TP data plane is created, but no control messages are sent. When running in this mode ql2tpd provides functionality equivalent to the iproute2 l2tp commands.
Alternatively, tunnels may be created with a hello_timeout configured, in which case a minimal control plane transport is set up to send and acknowledge keep-alive (HELLO) messages. This mode of operation extends static mode by allowing tunnel failure to be detected. If a given tunnel is determined to have failed (HELLO message transmission fails) then the sessions in that tunnel are automatically torn down.