.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "L2TPNS" "8" "January 31, 2021" "Layer 2 tunneling protocol network server (LNS)" ""
.hy
.SH NAME
.PP
l2tpns - Layer 2 tunneling protocol network server (LNS)
.SH SYNOPSIS
.PP
\f[B]l2tpns\f[R] [-\f[B]d\f[R]] [-\f[B]v\f[R]] [-\f[B]c\f[R]
\f[I]file\f[R]] [-\f[B]h\f[R] \f[I]hostname\f[R]]
.SH DESCRIPTION
.PP
\f[B]l2tpns\f[R] is a daemon for terminating layer 2 tunneling protocol
(L2TP: RFC2661) sessions.
.PP
\f[B]l2tpns\f[R] is a complete L2TP implementation.
It supports the LAC, LNS, PPPOE and DHCPv6 server.
.PP
Once running, \f[B]l2tpns\f[R] may be controlled by telnetting to port
23 on the machine running the daemon and with the \f[B]nsctl\f[R]
utility.
.SH OPTIONS
.PP
\f[B]-d\f[R] Detach from terminal and fork into the background.
By default l2tpns will stay in the foreground
.PP
\f[B]-v\f[R] Increase verbosity for debugging.
Can be used multiple times
.PP
\f[B]-c\f[R] \f[I]file\f[R] Specify configuration file
.PP
\f[B]-h\f[R] \f[I]hostname\f[R] Force hostname to \f[I]hostname\f[R]
.SH FILES
.PP
\f[I]/etc/l2tpns/startup-config\f[R]
.PD 0
.P
.PD
The default configuration file
.PP
\f[I]/etc/l2tpns/ip_pool\f[R]
.PD 0
.P
.PD
IP address pool configuration
.PP
\f[I]/etc/l2tpns/users\f[R]
.PD 0
.P
.PD
Username/password configuration for access to admin interface
.SH SIGNALS
.PP
\f[B]SIGHUP\f[R]
.PD 0
.P
.PD
Reload the config from disk and re-open log file
.PP
\f[B]SIGTERM\f[R], \f[B]SIGINT\f[R]
.PD 0
.P
.PD
Stop process.
Tunnels and sessions are not terminated.
This signal should be used to stop l2tpns on a cluster node where there
are other machines to continue handling traffic
.PP
\f[B]SIGQUIT\f[R]
.PD 0
.P
.PD
Shut down tunnels and sessions, exit process when complete
.SH MANAGED RADIUS ATTRIBUTE
.PP
\f[B]Ascend-Client-Primary-DNS\f[R],
\f[B]Ascend-Client-Secondary-DNS\f[R]
.PD 0
.P
.PD
Specifies a primary and secondary DNS server address to send to user
.PP
\f[B]Delegated-IPv6-Prefix\f[R]
.PD 0
.P
.PD
Assign a network address IPv6 prefix to a user by DHCPv6
.PP
\f[B]Framed-IP-Address\f[R]
.PD 0
.P
.PD
The address to be configured for the user (IPv4 address of the interface
ppp)
.PP
\f[B]Framed-Route\f[R]
.PD 0
.P
.PD
provides routing information to be configured for the user
.PP
\f[B]Framed-IPv6-Route\f[R]
.PD 0
.P
.PD
Has the same action as \f[B]Delegated-IPv6-Prefix\f[R].
\f[B]Delegated-IPv6-Prefix\f[R] is the correct one to use
.PP
\f[B]Framed-IPv6-Address\f[R]
.PD 0
.P
.PD
IPv6 address to be assigned to the user by DHCPv6 (IPv6 address of the
interface ppp)
.PP
\f[B]Idle-Timeout\f[R]
.PD 0
.P
.PD
disconnects the session if no data for more than \f[B]Idle-Timeout\f[R]
(in seconds)
.PP
\f[B]Session-Timeout\f[R]
.PD 0
.P
.PD
disconnects the user session when the time \f[B]Session-Timeout\f[R] is
reached (in seconds)
.PP
\f[B]Tunnel-Type\f[R], \f[B]Tunnel-Medium-Type\f[R],
\f[B]Tunnel-Server-Endpoint\f[R], \f[B]Tunnel-Password\f[R],
\f[B]Tunnel-Assignment-Id\f[R]
.PD 0
.P
.PD
attributes returned by the Radius of the remote LNS server (LAC
functionality)
.IP
.nf
\f[C]
example, Radius that return the information of 2 remote LNS server with which must be open a L2TP TUNNEL:

- Tunnel-Type: 1 = L2TP
- Tunnel-Medium-Type: 1 = IPv4
- Tunnel-Password: 1 = \[dq]TheSecretL2TP\[dq]
- Tunnel-Server-Endpoint: 1 = \[dq]88.xx.xx.x1\[dq]
- Tunnel-Assignment-Id: 1 = \[dq]friendisp_lns1\[dq]
- Tunnel-Type: 2 = L2TP
- Tunnel-Medium-Type: 2 = IPv4
- Tunnel-Password: 2 = \[dq]TheSecretL2TP\[dq]
- Tunnel-Server-Endpoint: 2 = \[dq]88.xx.xx.x2\[dq]
- Tunnel-Assignment-Id: 2 = \[dq]friendisp_lns2\[dq]
\f[R]
.fi
.SH SEE ALSO
.PP
\f[B]startup-config\f[R](5), \f[B]nsctl\f[R](8)
.SH 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 may be used by others).