---
name: "l2tpns"
section: "8"
platform: "linux"
package: "l2tpns"
version: "2.4.1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/l2tpns"
---

# l2tpns(8)

Layer 2 tunneling protocol network server (LNS)

## 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)](/startup-config/5.md), [**nsctl**(8)](/nsctl/8.md)

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