Merge from Master
[l2tpns.git] / Docs / l2tpns.8
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings.  \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 .    ds -- \(*W-
28 .    ds PI pi
29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31 .    ds L" ""
32 .    ds R" ""
33 .    ds C` ""
34 .    ds C' ""
35 'br\}
36 .el\{\
37 .    ds -- \|\(em\|
38 .    ds PI \(*p
39 .    ds L" ``
40 .    ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el       .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 .    de IX
53 .    tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 .    nr % 0
56 .    rr F
57 .\}
58 .el \{\
59 .    de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
65 .    \" fudge factors for nroff and troff
66 .if n \{\
67 .    ds #H 0
68 .    ds #V .8m
69 .    ds #F .3m
70 .    ds #[ \f1
71 .    ds #] \fP
72 .\}
73 .if t \{\
74 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 .    ds #V .6m
76 .    ds #F 0
77 .    ds #[ \&
78 .    ds #] \&
79 .\}
80 .    \" simple accents for nroff and troff
81 .if n \{\
82 .    ds ' \&
83 .    ds ` \&
84 .    ds ^ \&
85 .    ds , \&
86 .    ds ~ ~
87 .    ds /
88 .\}
89 .if t \{\
90 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 .    \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 .    \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 .    \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 .    ds : e
114 .    ds 8 ss
115 .    ds o a
116 .    ds d- d\h'-1'\(ga
117 .    ds D- D\h'-1'\(hy
118 .    ds th \o'bp'
119 .    ds Th \o'LP'
120 .    ds ae ae
121 .    ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "L2TPNS.8 1"
127 .TH L2TPNS.8 1 "2014-09-11" "perl v5.14.2" "User Contributed Perl Documentation"
128 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 l2tpns \- Layer 2 tunneling protocol network server (LNS)
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 \&\fBl2tpns\fR [\-\fBd\fR] [\-\fBv\fR] [\-\fBc\fR \fIfile\fR] [\-\fBh\fR \fIhostname\fR]
137 .SH "DESCRIPTION"
138 .IX Header "DESCRIPTION"
139 \&\fBl2tpns\fR is a daemon for terminating layer 2 tunneling protocol (L2TP: \s-1RFC2661\s0) sessions.
140 .PP
141 \&\fBl2tpns\fR is a complete L2TP implementation. It supports the \s-1LAC\s0, \s-1LNS\s0, \s-1PPPOE\s0 and DHCPv6 server.
142 .PP
143 Once running, \fBl2tpns\fR may be controlled by telnetting to port 23 on the machine running the daemon and with the \fBnsctl\fR utility.
144 .SH "OPTIONS"
145 .IX Header "OPTIONS"
146 .IP "\fB\-d\fR  Detach from terminal and fork into the background. By default l2tpns will stay in the foreground." 4
147 .IX Item "-d    Detach from terminal and fork into the background. By default l2tpns will stay in the foreground."
148 \&.
149 .IP "\fB\-v\fR  Increase verbosity for debugging. Can be used multiple times." 4
150 .IX Item "-v    Increase verbosity for debugging. Can be used multiple times."
151 \&.
152 .IP "\fB\-c\fR \fIfile\fR" 4
153 .IX Item "-c file"
154 Specify configuration file.
155 .IP "\fB\-h\fR \fIhostname\fR" 4
156 .IX Item "-h hostname"
157 Force hostname to \fIhostname\fR.
158 .SH "FILES"
159 .IX Header "FILES"
160 .IP "\fI/etc/l2tpns/startup\-config\fR" 4
161 .IX Item "/etc/l2tpns/startup-config"
162 The default configuration file.
163 .IP "\fI/etc/l2tpns/ip_pool\fR" 4
164 .IX Item "/etc/l2tpns/ip_pool"
165 \&\s-1IP\s0 address pool configuration.
166 .IP "\fI/etc/l2tpns/users\fR" 4
167 .IX Item "/etc/l2tpns/users"
168 Username/password configuration for access to admin interface.
169 .SH "SIGNALS"
170 .IX Header "SIGNALS"
171 .IP "\fB\s-1SIGHUP\s0\fR Reload the config from disk and re-open log file." 4
172 .IX Item "SIGHUP Reload the config from disk and re-open log file."
173 \&.
174 .IP "\fB\s-1SIGTERM\s0\fR, \fB\s-1SIGINT\s0\fR" 4
175 .IX Item "SIGTERM, SIGINT"
176 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.
177 .IP "\fB\s-1SIGQUIT\s0\fR" 4
178 .IX Item "SIGQUIT"
179 Shut down tunnels and sessions, exit process when complete.
180 .SH "MANAGED RADIUS ATTRIBUTE"
181 .IX Header "MANAGED RADIUS ATTRIBUTE"
182 .IP "\fBAscend-Client-Primary-DNS\fR, \fBAscend-Client-Secondary-DNS\fR" 4
183 .IX Item "Ascend-Client-Primary-DNS, Ascend-Client-Secondary-DNS"
184 Specifies a primary and secondary \s-1DNS\s0 server address to send to user.
185 .IP "\fBDelegated\-IPv6\-Prefix\fR" 4
186 .IX Item "Delegated-IPv6-Prefix"
187 Assign a network address IPv6 prefix to a user by DHCPv6.
188 .IP "\fBFramed-IP-Address\fR" 4
189 .IX Item "Framed-IP-Address"
190 The address to be configured for the user (IPv4 address of the interface ppp).
191 .IP "\fBFramed-Route\fR" 4
192 .IX Item "Framed-Route"
193 provides routing information to be configured for the user.
194 .IP "\fBFramed\-IPv6\-Route\fR" 4
195 .IX Item "Framed-IPv6-Route"
196 Has the same action as \fBDelegated\-IPv6\-Prefix\fR. \fBDelegated\-IPv6\-Prefix\fR is the correct one to use.
197 .IP "\fBFramed\-IPv6\-Address\fR" 4
198 .IX Item "Framed-IPv6-Address"
199 IPv6 address to be assigned to the user by DHCPv6 (IPv6 address of the interface ppp).
200 .IP "\fBIdle-Timeout\fR" 4
201 .IX Item "Idle-Timeout"
202 disconnects the session if no data for more than \fBIdle-Timeout\fR (in seconds).
203 .IP "\fBSession-Timeout\fR" 4
204 .IX Item "Session-Timeout"
205 disconnects the user session when the time \fBSession-Timeout\fR is reached (in seconds).
206 .IP "\fBTunnel-Type\fR, \fBTunnel-Medium-Type\fR, \fBTunnel-Server-Endpoint\fR, \fBTunnel-Password\fR, \fBTunnel-Assignment-Id\fR" 4
207 .IX Item "Tunnel-Type, Tunnel-Medium-Type, Tunnel-Server-Endpoint, Tunnel-Password, Tunnel-Assignment-Id"
208 attributes returned by the Radius of the remote \s-1LNS\s0 server (\s-1LAC\s0 functionality).
209 .Sp
210 example, Radius that return the information of 2 remote \s-1LNS\s0 server with which must be open a L2TP \s-1TUNNEL:\s0
211 .RS 4
212 .IP "\fBTunnel-Type\fR: 1 = L2TP" 4
213 .IX Item "Tunnel-Type: 1 = L2TP"
214 .PD 0
215 .IP "\fBTunnel-Medium-Type\fR: 1 = IPv4" 4
216 .IX Item "Tunnel-Medium-Type: 1 = IPv4"
217 .ie n .IP "\fBTunnel-Password\fR: 1 = ""TheSecretL2TP""" 4
218 .el .IP "\fBTunnel-Password\fR: 1 = ``TheSecretL2TP''" 4
219 .IX Item "Tunnel-Password: 1 = TheSecretL2TP"
220 .ie n .IP "\fBTunnel-Server-Endpoint\fR: 1 = ""88.xx.xx.x1""" 4
221 .el .IP "\fBTunnel-Server-Endpoint\fR: 1 = ``88.xx.xx.x1''" 4
222 .IX Item "Tunnel-Server-Endpoint: 1 = 88.xx.xx.x1"
223 .ie n .IP "\fBTunnel-Assignment-Id\fR: 1 = ""friendisp_lns1""" 4
224 .el .IP "\fBTunnel-Assignment-Id\fR: 1 = ``friendisp_lns1''" 4
225 .IX Item "Tunnel-Assignment-Id: 1 = friendisp_lns1"
226 .IP "\fBTunnel-Type\fR: 2 = L2TP" 4
227 .IX Item "Tunnel-Type: 2 = L2TP"
228 .IP "\fBTunnel-Medium-Type\fR: 2 = IPv4" 4
229 .IX Item "Tunnel-Medium-Type: 2 = IPv4"
230 .ie n .IP "\fBTunnel-Password\fR: 2 = ""TheSecretL2TP""" 4
231 .el .IP "\fBTunnel-Password\fR: 2 = ``TheSecretL2TP''" 4
232 .IX Item "Tunnel-Password: 2 = TheSecretL2TP"
233 .ie n .IP "\fBTunnel-Server-Endpoint\fR: 2 = ""88.xx.xx.x2""" 4
234 .el .IP "\fBTunnel-Server-Endpoint\fR: 2 = ``88.xx.xx.x2''" 4
235 .IX Item "Tunnel-Server-Endpoint: 2 = 88.xx.xx.x2"
236 .ie n .IP "\fBTunnel-Assignment-Id\fR: 2 = ""friendisp_lns2""" 4
237 .el .IP "\fBTunnel-Assignment-Id\fR: 2 = ``friendisp_lns2''" 4
238 .IX Item "Tunnel-Assignment-Id: 2 = friendisp_lns2"
239 .RE
240 .RS 4
241 .RE
242 .PD
243 .SH "SEE ALSO"
244 .IX Header "SEE ALSO"
245 \&\fBstartup-config\fR(5), \fBnsctl\fR(8)
246 .SH "AUTHOR"
247 .IX Header "AUTHOR"
248 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).