1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
|
.\" Automatically generated by Pandoc 3.1.8
.\"
.TH "kpppoed" "8" "May 2024" "go-l2tp v0.1.8" "go-l2tp"
.SH NAME
kpppoed - a PPPoE daemon for creating L2TPv2 Access Concentrator
sessions in response to PPPoE requests
.SH SYNOPSIS
\f[B]kpppoed\f[R] [ arguments ]
.SH DESCRIPTION
\f[B]kpppoed\f[R] is a PPPoE (RFC 2516) server daemon for creating
L2TPv2 Access Concentrator sessions.
It spawns \f[B]kl2tpd\f[R] for L2TP protocol support.
.PP
\f[B]kpppoed\f[R] and is driven by a configuration file which describes
the PPPoE service to offer.
.SH OPTIONS
.TP
-config string
specify configuration file path (default
\[lq]/etc/kpppoed/kpppoed.toml\[rq])
.TP
-verbose
toggle verbose log output
.SH CONFIGURATION
The \f[B]kpppoed\f[R] file, \f[B]kpppoed.toml\f[R] is written in the
TOML markup language (https://toml.io/en/).
.PP
It uses a small set of key:value pairs to configure the PPPoE server:
.IP
.EX
# ac_name is the name that kpppoed will use in the PPPoE AC Name tag sent
# in PADO packets. If not specified it will default to \[dq]kpppoed\[dq].
ac_name = \[dq]MyAccessConcentrator.2000\[dq]
# interface_name is the name of the network interface that kpppoed will listen
# on for PPPoE discovery packets. It must be specified.
interface_name = \[dq]eth0\[dq]
# services is a list of service names that kpppoed will advertise in PADO packets
# At least one service must be specified.
services = [ \[dq]serviceA\[dq], \[dq]serviceB\[dq], \[dq]serviceC\[dq] ]
# lns_ipaddr is the IP address and port of the L2TP server to tunnel
# pppoe sessions to. The LNS address must be specified.
lns_ipaddr = \[dq]3.22.1.9:1701\[dq]
.EE
.SH SEE ALSO
\f[B]kpppoed.toml\f[R](5), \f[B]kl2tpd\f[R](8)
.SH AUTHORS
Katalix Systems, Ltd.
|