proacd(8) ProL2TP Manual proacd(8)
NAME
proacd - ProL2TP Access Concentrator Daemon
SYNOPSIS
proacd [-h] [-v] [-f] [-c config] [-l license] [-n] [-o output] [-D]
[-d debugmask] [-L facility]
DESCRIPTION
proacd is a PPP Access Concentrator, designed to route PPP traffic from
remote clients to remote access servers. At this time, only PPPoE
clients are supported.
User PPP traffic may be routed through L2TP tunnels, or terminated by
local pppd instances.
For L2TP routes, proacd interfaces with prol2tpd to create and delete
L2TP tunnels as required. The data path for PPPoE to L2TP routes is
handled entirely within the kernel, giving the best possible perfor-
mance. The kernel module l2tp_ac_pppoe is required by proacd to com-
plete these routes.
OPTIONS
-h Display usage information.
-v Display version information.
-f Run in the foreground. By default, proacd forks itself and runs
in the background. For debugging, it is sometimes useful to run
the application in the foreground. Note that when run in the
foreground, daemon output messages are sent to the controlling
terminal rather than to syslog.
-c config
Read configuration commands from the specified file rather than
the default path.
-n Checks the config file for correctness and outputs the result-
ing configuration information. Exits after reading the configu-
ration.
-o output
Send daemon output to the specified filename, rather than sys-
log.
-D Enable daemon debugging messages.
-d debugmask
Configures the debug message mask. The mask may be specified as
a decimal or hexadecimal integer or as a comma-separated list
of debug modules. Valid debug modules are route, pppoe, l2tp,
radius, ppp, pppfsm, lcpfsm, ctrl, trace, pppd, system and
parser. The special mask all enables debugging in all modules.
-L facility
If logging to syslog, this option can be used to specify the
syslog facility to be used. Valid values are local0 .. local7,
or default. The value "local0" corresponds to LOG_LOCAL0. The
default is LOG_DAEMON.
OPERATION
proacd negotiates and accepts client connections and opens a connection
to the server based on the route definitions specified in it's configu-
ration file. The client connection is referred to as the source end-
point and the server connection is referred to destination endpoint.
The relationship between source endpoint and destination endpoint is
referred to as a route.
CONFIGURATION
The config file is read at startup and when proacd receives a SIGHUP
signal.
PROTOCOLS
proacd currently supports only PPPoE as a source endpoint and both L2TP
and PPP as destination endpoints. It also supports querying RADIUS
servers to make authentication and routing decisions about incoming
client session setup requests. It fully implements the server side of
RFC 2516 (A Method for Transmitting PPP Over Ethernet), to listen for
incoming service requests.
proacd requires an external L2TP daemon, prol2tpd, in order to estab-
lish L2TP destination endpoints. An external PPP daemon, either propppd
or the legacy pppd, is required to terminate PPP sessions locally.
LINUX KERNEL DRIVERS
In order to switch data packets from an incoming PPPoE session to an
L2TP session, proacd requires that the linux kernel driver l2tp_ac_pp-
poe is loaded. This driver should have been provided along with the
distribution of proacd you received.
proacd is able to terminate incoming sessions in a local pppd instance,
to do so it makes use of the rp-pppoe.so plugin distributed with pppd,
which requires that the linux kernel driver pppoe is loaded.
MANAGEMENT INTERFACE
A management interface is provided to allow users or applications to
query the status of the daemon. It uses the netlink protocol familiar
to kernel programmers, using an AF_UNIX socket attached to a named pipe
for transport. An example application proac_info is provided to allow
the user to dump the list of current routes and the set of statistics
kept by the daemon.
SEE ALSO
proacd.conf(5), proac_info(8), proac_trace(8), proac_manage(8),
ProL2TP 2.4.1 April 2023 proacd(8)