176 lines
4 KiB
Groff
176 lines
4 KiB
Groff
.\" Automatically generated by Pandoc 3.0.1
|
|
.\"
|
|
.\" Define V font for inline verbatim, using C font in formats
|
|
.\" that render this, and otherwise B font.
|
|
.ie "\f[CB]x\f[]"x" \{\
|
|
. ftr V B
|
|
. ftr VI BI
|
|
. ftr VB B
|
|
. ftr VBI BI
|
|
.\}
|
|
.el \{\
|
|
. ftr V CR
|
|
. ftr VI CI
|
|
. ftr VB CB
|
|
. ftr VBI CBI
|
|
.\}
|
|
.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).
|