L2TPD(8)

NAME
l2tpd - user-space L2TP daemon.

SYNOPSIS
l2tpd [options]

DESCRIPTION
l2tpd is a user-space L2TP daemon. L2TP is the Layer Two Tunneling Protocol described in RFC 2661. It allows you to tunnel PPP sessions over a network or transport protocol (in this case, UDP.)

OPTIONS

-d num
    Sets the debug level to num. Of interest mostly to l2tpd developers. num is a bitmask; set it to 65535 for maximum debugging information.

-f  Do not fork. Normally, l2tpd forks and puts itself in the background. This option causes it to stay running in the foreground.

L2TPD ARCHITECTURE
The l2tpd program itself contains only code necessary for processing L2TP datagrams and maintaining L2TP tunnels and sessions. It does not contain code for interacting with pppd or for users to control session establishment and teardown. These functions are performed by handlers, which are shared-object libraries dynamically loaded at run-time.

The handlers currently distributed with l2tpd include:

sync-pppd.so
    A shared-library which interfaces with pppd and allows l2tpd to act as both an LAC and an LNS.

cmd.so
    A simple command-interpreter which listens on a UNIX-domain socket and allows you to start and stop L2TP sessions.

l2tpd is a single-threaded, event-driven program. It should be fairly lightweight and efficient.

L2TPD CONFIGURATION
On startup, l2tpd reads the configuration file /usr/pkg/etc/l2tp.conf. This configuration file sets operating parameters, describes peers and loads and configures handlers. See l2tp.conf(5) for configuration file details.

FILES

/usr/pkg/etc/l2tp.conf
    Main configuration file.

/var/run/l2tpctrl
    Control socket for cmd.so handler.

AUTHORS
l2tpd was written by David F. Skoll <dfs@roaringpenguin.com>.