151 lines
3.3 KiB
Text
151 lines
3.3 KiB
Text
=pod
|
|
|
|
=head1 NAME
|
|
|
|
l2tpns - Layer 2 tunneling protocol network server (LNS)
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<l2tpns> [-B<d>] [-B<v>] [-B<c> I<file>] [-B<h> I<hostname>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
B<l2tpns> is a daemon for terminating layer 2 tunneling protocol (L2TP: RFC2661) sessions.
|
|
|
|
B<l2tpns> is a complete L2TP implementation. It supports the LAC, LNS, PPPOE and DHCPv6 server.
|
|
|
|
Once running, B<l2tpns> may be controlled by telnetting to port 23 on the machine running the daemon and with the B<nsctl> utility.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over
|
|
|
|
=item B<-d> Detach from terminal and fork into the background. By default l2tpns will stay in the foreground.
|
|
|
|
.
|
|
|
|
=item B<-v> Increase verbosity for debugging. Can be used multiple times.
|
|
|
|
.
|
|
|
|
=item B<-c> I<file>
|
|
|
|
Specify configuration file.
|
|
|
|
=item B<-h> I<hostname>
|
|
|
|
Force hostname to I<hostname>.
|
|
|
|
=back
|
|
|
|
=head1 FILES
|
|
|
|
=over
|
|
|
|
=item I</etc/l2tpns/startup-config>
|
|
|
|
The default configuration file.
|
|
|
|
=item I</etc/l2tpns/ip_pool>
|
|
|
|
IP address pool configuration.
|
|
|
|
=item I</etc/l2tpns/users>
|
|
|
|
Username/password configuration for access to admin interface.
|
|
|
|
=back
|
|
|
|
=head1 SIGNALS
|
|
|
|
=over
|
|
|
|
=item B<SIGHUP> Reload the config from disk and re-open log file.
|
|
|
|
.
|
|
|
|
=item B<SIGTERM>, B<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.
|
|
|
|
=item B<SIGQUIT>
|
|
|
|
Shut down tunnels and sessions, exit process when complete.
|
|
|
|
=back
|
|
|
|
=head1 MANAGED RADIUS ATTRIBUTE
|
|
|
|
=over
|
|
|
|
=item B<Ascend-Client-Primary-DNS>, B<Ascend-Client-Secondary-DNS>
|
|
|
|
Specifies a primary and secondary DNS server address to send to user.
|
|
|
|
=item B<Delegated-IPv6-Prefix>
|
|
|
|
Assign a network address IPv6 prefix to a user by DHCPv6.
|
|
|
|
=item B<Framed-IP-Address>
|
|
|
|
The address to be configured for the user (IPv4 address of the interface ppp).
|
|
|
|
=item B<Framed-Route>
|
|
|
|
provides routing information to be configured for the user.
|
|
|
|
=item B<Framed-IPv6-Route>
|
|
|
|
Has the same action as B<Delegated-IPv6-Prefix>. B<Delegated-IPv6-Prefix> is the correct one to use.
|
|
|
|
=item B<Framed-IPv6-Address>
|
|
|
|
IPv6 address to be assigned to the user by DHCPv6 (IPv6 address of the interface ppp).
|
|
|
|
=item B<Idle-Timeout>
|
|
|
|
disconnects the session if no data for more than B<Idle-Timeout> (in seconds).
|
|
|
|
=item B<Session-Timeout>
|
|
|
|
disconnects the user session when the time B<Session-Timeout> is reached (in seconds).
|
|
|
|
=item B<Tunnel-Type>, B<Tunnel-Medium-Type>, B<Tunnel-Server-Endpoint>, B<Tunnel-Password>, B<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:
|
|
|
|
=over
|
|
|
|
=item B<Tunnel-Type>: 1 = L2TP
|
|
|
|
=item B<Tunnel-Medium-Type>: 1 = IPv4
|
|
|
|
=item B<Tunnel-Password>: 1 = "TheSecretL2TP"
|
|
|
|
=item B<Tunnel-Server-Endpoint>: 1 = "88.xx.xx.x1"
|
|
|
|
=item B<Tunnel-Assignment-Id>: 1 = "friendisp_lns1"
|
|
|
|
=item B<Tunnel-Type>: 2 = L2TP
|
|
|
|
=item B<Tunnel-Medium-Type>: 2 = IPv4
|
|
|
|
=item B<Tunnel-Password>: 2 = "TheSecretL2TP"
|
|
|
|
=item B<Tunnel-Server-Endpoint>: 2 = "88.xx.xx.x2"
|
|
|
|
=item B<Tunnel-Assignment-Id>: 2 = "friendisp_lns2"
|
|
|
|
=back
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
B<startup-config>(5), B<nsctl>(8)
|
|
|
|
=head1 AUTHOR
|
|
|
|
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).
|