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