L2TPNS

NAME

l2tpns - Layer 2 tunneling protocol network server (LNS)

SYNOPSIS

l2tpns [-d] [-v] [-c file] [-h hostname]

DESCRIPTION

l2tpns is a daemon for terminating layer 2 tunneling protocol (L2TP: RFC2661) sessions.

l2tpns is a complete L2TP implementation. It supports the LAC, LNS, PPPOE and DHCPv6 server.

Once running, l2tpns may be controlled by telnetting to port 23 on the machine running the daemon and with the nsctl utility.

OPTIONS

-d Detach from terminal and fork into the background. By default l2tpns will stay in the foreground

-v Increase verbosity for debugging. Can be used multiple times

-c file Specify configuration file

-h hostname Force hostname to hostname

FILES

/etc/l2tpns/startup-config
The default configuration file

/etc/l2tpns/ip_pool
IP address pool configuration

/etc/l2tpns/users
Username/password configuration for access to admin interface

SIGNALS

SIGHUP
Reload the config from disk and re-open log file

SIGTERM, SIGINT
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

SIGQUIT
Shut down tunnels and sessions, exit process when complete

MANAGED RADIUS ATTRIBUTE

Ascend-Client-Primary-DNS, Ascend-Client-Secondary-DNS
Specifies a primary and secondary DNS server address to send to user

Delegated-IPv6-Prefix
Assign a network address IPv6 prefix to a user by DHCPv6

Framed-IP-Address
The address to be configured for the user (IPv4 address of the interface ppp)

Framed-Route
provides routing information to be configured for the user

Framed-IPv6-Route
Has the same action as Delegated-IPv6-Prefix. Delegated-IPv6-Prefix is the correct one to use

Framed-IPv6-Address
IPv6 address to be assigned to the user by DHCPv6 (IPv6 address of the interface ppp)

Idle-Timeout
disconnects the session if no data for more than Idle-Timeout (in seconds)

Session-Timeout
disconnects the user session when the time Session-Timeout is reached (in seconds)

Tunnel-Type, Tunnel-Medium-Type, Tunnel-Server-Endpoint, Tunnel-Password, Tunnel-Assignment-Id
attributes returned by the Radius of the remote LNS server (LAC functionality)

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 = "TheSecretL2TP"
- Tunnel-Server-Endpoint: 1 = "88.xx.xx.x1"
- Tunnel-Assignment-Id: 1 = "friendisp_lns1"
- Tunnel-Type: 2 = L2TP
- Tunnel-Medium-Type: 2 = IPv4
- Tunnel-Password: 2 = "TheSecretL2TP"
- Tunnel-Server-Endpoint: 2 = "88.xx.xx.x2"
- Tunnel-Assignment-Id: 2 = "friendisp_lns2"

SEE ALSO

startup-config(5), nsctl(8)

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).