Docs/startup-config.5

   1 .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
   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 .    ds C`
  42 .    ds C'
  43 'br\}
  44 .\"
  45 .\" Escape single quotes in literal strings from groff's Unicode transform.
  46 .ie \n(.g .ds Aq \(aq
  47 .el       .ds Aq '
  48 .\"
  49 .\" If the F register is turned on, we'll generate index entries on stderr for
  50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  52 .\" output yourself in some meaningful fashion.
  53 .\"
  54 .\" Avoid warning from groff about undefined register 'F'.
  55 .de IX
  56 ..
  57 .nr rF 0
  58 .if \n(.g .if rF .nr rF 1
  59 .if (\n(rF:(\n(.g==0)) \{
  60 .    if \nF \{
  61 .        de IX
  62 .        tm Index:\\$1\t\\n%\t"\\$2"
  63 ..
  64 .        if !\nF==2 \{
  65 .            nr % 0
  66 .            nr F 2
  67 .        \}
  68 .    \}
  69 .\}
  70 .rr rF
  71 .\"
  72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  74 .    \" fudge factors for nroff and troff
  75 .if n \{\
  76 .    ds #H 0
  77 .    ds #V .8m
  78 .    ds #F .3m
  79 .    ds #[ \f1
  80 .    ds #] \fP
  81 .\}
  82 .if t \{\
  83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84 .    ds #V .6m
  85 .    ds #F 0
  86 .    ds #[ \&
  87 .    ds #] \&
  88 .\}
  89 .    \" simple accents for nroff and troff
  90 .if n \{\
  91 .    ds ' \&
  92 .    ds ` \&
  93 .    ds ^ \&
  94 .    ds , \&
  95 .    ds ~ ~
  96 .    ds /
  97 .\}
  98 .if t \{\
  99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 105 .\}
 106 .    \" troff and (daisy-wheel) nroff accents
 107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 114 .ds ae a\h'-(\w'a'u*4/10)'e
 115 .ds Ae A\h'-(\w'A'u*4/10)'E
 116 .    \" corrections for vroff
 117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 119 .    \" for low resolution devices (crt and lpr)
 120 .if \n(.H>23 .if \n(.V>19 \
 121 \{\
 122 .    ds : e
 123 .    ds 8 ss
 124 .    ds o a
 125 .    ds d- d\h'-1'\(ga
 126 .    ds D- D\h'-1'\(hy
 127 .    ds th \o'bp'
 128 .    ds Th \o'LP'
 129 .    ds ae ae
 130 .    ds Ae AE
 131 .\}
 132 .rm #[ #] #H #V #F C
 133 .\" ========================================================================
 134 .\"
 135 .IX Title "STARTUP-CONFIG.5 1"
 136 .TH STARTUP-CONFIG.5 1 "2017-05-26" "perl v5.20.2" "User Contributed Perl Documentation"
 137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 138 .\" way too many mistakes in technical documents.
 139 .if n .ad l
 140 .nh
 141 .SH "NAME"
 142 startup\-config \- configuration file for l2tpns
 143 .SH "SYNOPSIS"
 144 .IX Header "SYNOPSIS"
 145 /etc/l2tpns/startup\-config
 146 .SH "DESCRIPTION"
 147 .IX Header "DESCRIPTION"
 148 \&\fBstartup-config\fR is the configuration file for \fBl2tpns\fR
 149 .PP
 150 The format is plain text, in the same format as accepted by
 151 the configuration mode of l2tpns's telnet administrative
 152 interface. Comments are indicated by either the character # or !.
 153 .SS "\s-1SETTINGS\s0"
 154 .IX Subsection "SETTINGS"
 155 Settings are specified with
 156 .IP "\fBset\fR \fIvariable\fR \fIvalue\fR" 4
 157 .IX Item "set variable value"
 158 .PP
 159 A list of the possible configuration directives follows. Each of these should be set by a line like:
 160 .ie n .IP "\fBset\fR \fIconfigstring\fR \fI""value""\fR" 4
 161 .el .IP "\fBset\fR \fIconfigstring\fR \fI``value''\fR" 4
 162 .IX Item "set configstring value"
 163 .PD 0
 164 .IP "\fBset\fR \fIipaddress\fR \fI192.168.1.1\fR" 4
 165 .IX Item "set ipaddress 192.168.1.1"
 166 .IP "\fBset\fR \fIboolean\fR \fItrue\fR" 4
 167 .IX Item "set boolean true"
 168 .PD
 169 .PP
 170 The following \fIvariables\fR may be set:
 171 .IP "\fBaccounting_dir\fR (string)" 4
 172 .IX Item "accounting_dir (string)"
 173 If set to a directory, then every 5 minutes the current usage for every connected use will be dumped to a file in this directory. Each file dumped begins with a header, where each line is prefixed by #. Following the header is a single line for every connected user, fields separated by a space.
 174 .Sp
 175 The fields are username, ip, qos, uptxoctets, downrxoctets, origin (optional). The qos field is 1 if a standard user, and 2 if the user is throttled. The origin field is dump if \fBaccount_all_origin\fR is set to true (origin value: L=LAC data, R=Remote \s-1LNS\s0 data, P=PPPOE data).
 176 .IP "\fBaccount_all_origin\fR (boolean)" 4
 177 .IX Item "account_all_origin (boolean)"
 178 If set to true, all origin of the usage is dumped to the accounting file (LAC+Remote \s-1LNS+PPPOE\s0)(default false).
 179 .IP "\fBallow_duplicate_users\fR (boolean)" 4
 180 .IX Item "allow_duplicate_users (boolean)"
 181 Allow multiple logins with the same username. If false (the default), any prior session with the same username will be dropped when a new session is established.
 182 .IP "\fBauth_tunnel_change_addr_src\fR (boolean)" 4
 183 .IX Item "auth_tunnel_change_addr_src (boolean)"
 184 This parameter authorize to change the source \s-1IP\s0 of the tunnels l2tp. This parameter can be used when the remotes \s-1BAS/LAC\s0 are l2tpns server configured in cluster mode, but that the interface to remote \s-1LNS\s0 are not clustered (the tunnel can be coming from different source \s-1IP\s0) (default: no).
 185 .IP "\fBbind_address\fR (ip address)" 4
 186 .IX Item "bind_address (ip address)"
 187 It's the listen address of the l2tp udp protocol sent and received to \s-1LAC.\s0 This address is also assigned to the tun interface if no iftun_address is specified. Packets containing user traffic should be routed via this address if given, otherwise the primary address of the machine.
 188 .IP "\fBbind_multi_address\fR (ip address)" 4
 189 .IX Item "bind_multi_address (ip address)"
 190 This parameter permit to listen several addresss of the l2tp udp protocol (and set several address to the tun interface).
 191 .Sp
 192 \&\s-1WHEN\s0 this parameter is set, It \s-1OVERWRITE\s0 the parameters \*(L"bind_address\*(R" and \*(L"iftun_address\*(R".
 193 .Sp
 194 these can be interesting when you want do load-balancing in cluster mode of the uploaded from the \s-1LAC.\s0 For example you can set a bgp.prepend(\s-1MY_AS\s0) for Address1 on \s-1LNS1\s0 and a bgp.prepend(\s-1MY_AS\s0) for Address2 on \s-1LNS2 \s0(see \s-1BGP\s0 AS-path prepending).
 195 .Sp
 196 example of use with 2 address:
 197 .Sp
 198 \&\fBset\fR \fIbind_multi_address\fR \*(L"64.14.13.41, 64.14.13.42\*(R"
 199 .IP "\fBcluster_address\fR (ip address)" 4
 200 .IX Item "cluster_address (ip address)"
 201 Multicast cluster address (default: 239.192.13.13). See the section on Clustering for more information.
 202 .IP "\fBBcluster_port\fR (int)" 4
 203 .IX Item "Bcluster_port (int)"
 204 \&\s-1UDP\s0 cluster port (default: 32792). See the section on Clustering for more information.
 205 .IP "\fBcluster_interface\fR (string)" 4
 206 .IX Item "cluster_interface (string)"
 207 Interface for cluster packets (default: eth0).
 208 .IP "\fBcluster_mcast_ttl\fR (int)" 4
 209 .IX Item "cluster_mcast_ttl (int)"
 210 \&\s-1TTL\s0 for multicast packets (default: 1).
 211 .IP "\fBcluster_hb_interval\fR (int)" 4
 212 .IX Item "cluster_hb_interval (int)"
 213 Interval in tenths of a second between cluster heartbeat/pings.
 214 .IP "\fBcluster_hb_timeout\fR (int)" 4
 215 .IX Item "cluster_hb_timeout (int)"
 216 Cluster heartbeat timeout in tenths of a second. A new master will be elected when this interval has been passed without seeing a heartbeat from the master.
 217 .IP "\fBcluster_master_min_adv\fR (int)" 4
 218 .IX Item "cluster_master_min_adv (int)"
 219 Determines the minumum number of up to date slaves required before the master will drop routes (default: 1).
 220 .IP "\fBdebug\fR (int)" 4
 221 .IX Item "debug (int)"
 222 Set the level of debugging messages written to the log file. The value should
 223 be between 0 and 5, with 0 being no debugging, and 5 being the highest.
 224 A rough description of the levels is:
 225 .RS 4
 226 .IP "0. Critical Errors \- Things are probably broken" 4
 227 .IX Item "0. Critical Errors - Things are probably broken"
 228 .PD 0
 229 .IP "1. Errors \- Things might have gone wrong, but probably will recover" 4
 230 .IX Item "1. Errors - Things might have gone wrong, but probably will recover"
 231 .IP "2. Warnings \- Just in case you care what is not quite perfect" 4
 232 .IX Item "2. Warnings - Just in case you care what is not quite perfect"
 233 .IP "3. Information \- Parameters of control packets" 4
 234 .IX Item "3. Information - Parameters of control packets"
 235 .IP "4. Calls \- For tracing the execution of the code" 4
 236 .IX Item "4. Calls - For tracing the execution of the code"
 237 .IP "5. Packets \- Everything, including a hex dump of all packets processed... probably twice" 4
 238 .IX Item "5. Packets - Everything, including a hex dump of all packets processed... probably twice"
 239 .RE
 240 .RS 4
 241 .PD
 242 .Sp
 243 Note that the higher you set the debugging level, the slower the program will run. Also, at level 5 a \s-1LOT\s0 of information will be logged. This should only ever be used for working out why it doesn't work at all.
 244 .RE
 245 .IP "\fBdump_speed\fR (boolean)" 4
 246 .IX Item "dump_speed (boolean)"
 247 If set to true, then the current bandwidth utilization will be logged every second. Even if this is disabled, you can see this information by running the uptime command on the \s-1CLI.\s0
 248 .IP "\fBdisable_sending_hello\fR (boolean)" 4
 249 .IX Item "disable_sending_hello (boolean)"
 250 Disable l2tp sending \s-1HELLO\s0 message for Apple compatibility. Some \s-1OS X\s0 implementation of l2tp no manage the L2TP \*(L"\s-1HELLO\s0 message\*(R". (default: no).
 251 .IP "\fBecho_timeout\fR (int)" 4
 252 .IX Item "echo_timeout (int)"
 253 Time between last packet sent and \s-1LCP ECHO\s0 generation (default: 10 (seconds)).
 254 .IP "\fBguest_account\fR" 4
 255 .IX Item "guest_account"
 256 Allow multiple logins matching this specific username.
 257 .IP "\fBicmp_rate\fR (int)" 4
 258 .IX Item "icmp_rate (int)"
 259 Maximum number of host unreachable \s-1ICMP\s0 packets to send per second.
 260 .IP "\fBidle_echo_timeout\fR (int)" 4
 261 .IX Item "idle_echo_timeout (int)"
 262 Drop sessions who have not responded within idle_echo_timeout seconds (default: 240 (seconds))
 263 .IP "\fBiftun_address\fR (ip address)" 4
 264 .IX Item "iftun_address (ip address)"
 265 This parameter is used when you want a tun interface address different from the address of \*(L"bind_address\*(R" (For use in cases of specific configuration). If no address is given to iftun_address and bind_address, 1.1.1.1 is used.
 266 .IP "\fBl2tp_mtu\fR (int)" 4
 267 .IX Item "l2tp_mtu (int)"
 268 \&\s-1MTU\s0 of interface for L2TP traffic (default: 1500). Used to set link \s-1MRU\s0 and adjust \s-1TCP MSS.\s0
 269 .IP "\fBl2tp_secret\fR (string)" 4
 270 .IX Item "l2tp_secret (string)"
 271 The secret used by l2tpns for authenticating tunnel request. Must be the same as the \s-1LAC,\s0 or authentication will fail. Only actually be used if the \s-1LAC\s0 requests authentication.
 272 .IP "\fBlock_pages\fR (boolean)" 4
 273 .IX Item "lock_pages (boolean)"
 274 Keep all pages mapped by the l2tpns process in memory.
 275 .IP "\fBlog_file\fR (string)" 4
 276 .IX Item "log_file (string)"
 277 This will be where all logging and debugging information is written to.This may be either a filename, such as /var/log/l2tpns, or the string syslog:facility, where facility is any one of the syslog logging facilities, such as local5.
 278 .IP "\fBmulti_read_count\fR (int)" 4
 279 .IX Item "multi_read_count (int)"
 280 Number of packets to read off each of the \s-1UDP\s0 and \s-1TUN\s0 fds when returned as readable by select (default: 10). Avoids incurring the unnecessary system call overhead of select on busy servers.
 281 .IP "\fBpacket_limit\fR (int>" 4
 282 .IX Item "packet_limit (int>"
 283 Maximum number of packets of downstream traffic to be handled each tenth of a second per session. If zero, no limit is applied (default: 0). Intended as a DoS prevention mechanism and not a general throttling control (packets are dropped, not queued).
 284 .IP "\fBpeer_address\fR (ip address)" 4
 285 .IX Item "peer_address (ip address)"
 286 Address to send to clients as the default gateway.
 287 .IP "\fBpid_file\fR (string)" 4
 288 .IX Item "pid_file (string)"
 289 If set, the process id will be written to the specified file. The value must be an absolute path.
 290 .IP "\fBppp_keepalive\fR (boolean)" 4
 291 .IX Item "ppp_keepalive (boolean)"
 292 Change this value to no to force generation of \s-1LCP ECHO\s0 every echo_timeout seconds, even there are activity on the link (default: yes)
 293 .IP "\fBppp_restart_time\fR (int)" 4
 294 .IX Item "ppp_restart_time (int)"
 295 .PD 0
 296 .IP "\fBppp_max_configure\fR (int)" 4
 297 .IX Item "ppp_max_configure (int)"
 298 .IP "\fBppp_max_failure\fR (int)" 4
 299 .IX Item "ppp_max_failure (int)"
 300 .PD
 301 \&\s-1PPP\s0 counter and timer values, as described in Section 4.1 of \s-1RFC1661.\s0
 302 .Sp
 303 \&\fIppp_restart_time\fR, Restart timer for \s-1PPP\s0 protocol negotiation in seconds (default: 3).
 304 .Sp
 305 \&\fIppp_max_configure\fR, Number of configure requests to send before giving up (default: 10).
 306 .Sp
 307 \&\fIppp_max_failure\fR, Number of Configure-Nak requests to send before sending a Configure-Reject (default: 5).
 308 .IP "\fBprimary_dns\fR (ip address), \fBsecondary_dns\fR (ip address)" 4
 309 .IX Item "primary_dns (ip address), secondary_dns (ip address)"
 310 Whenever a \s-1PPP\s0 connection is established, \s-1DNS\s0 servers will be sent to the user, both a primary and a secondary. If either is set to 0.0.0.0, then that one will not be sent.
 311 .IP "\fBprimary_radius\fR (ip address), \fBsecondary_radius\fR (ip address)" 4
 312 .IX Item "primary_radius (ip address), secondary_radius (ip address)"
 313 Sets the \s-1RADIUS\s0 servers used for both authentication and accounting. If the primary server does not respond, then the secondary \s-1RADIUS\s0 server will be tried.
 314 .Sp
 315 Note: in addition to the source \s-1IP\s0 address and identifier, the \s-1RADIUS\s0 server must include the source port when detecting duplicates to supress (in order to cope with a large number of sessions comming on-line simultaneously l2tpns uses a set of udp sockets, each with a seperate identifier).
 316 .IP "\fBprimary_radius_port\fR (short), \fBsecondary_radius_port\fR (short)" 4
 317 .IX Item "primary_radius_port (short), secondary_radius_port (short)"
 318 Sets the authentication ports for the primary and secondary \s-1RADIUS\s0 servers. The accounting port is one more than the authentication port. If no \s-1RADIUS\s0 ports are given, the authentication port defaults to 1645, and the accounting port to 1646.
 319 .IP "\fBradius_accounting\fR (boolean)" 4
 320 .IX Item "radius_accounting (boolean)"
 321 If set to true, then \s-1RADIUS\s0 accounting packets will be sent. This means that a \fBStart\fR record will be sent when the session is successfully authenticated, and a \fBStop\fR record will be sent when the session is closed.
 322 .IP "\fBradius_interim\fR (int)" 4
 323 .IX Item "radius_interim (int)"
 324 If radius_accounting is on, defines the interval between sending of \s-1RADIUS\s0 interim accounting records (in seconds).
 325 .IP "\fBradius_secret\fR (string)" 4
 326 .IX Item "radius_secret (string)"
 327 This secret will be used in all \s-1RADIUS\s0 queries. If this is not set then \s-1RADIUS\s0 queries will fail.
 328 .IP "\fBradius_authtypes\fR (string)" 4
 329 .IX Item "radius_authtypes (string)"
 330 A comma separated list of supported \s-1RADIUS\s0 authentication methods (\*(L"pap\*(R" or \*(L"chap\*(R"), in order of preference (default \*(L"pap\*(R").
 331 .IP "\fBradius_dae_port\fR (short)" 4
 332 .IX Item "radius_dae_port (short)"
 333 Port for \s-1DAE RADIUS \s0(Packet of Death/Disconnect, Change of Authorization) requests (default: 3799).
 334 .IP "\fBradius_bind_min\fR, \fBradius_bind_max\fR (int)" 4
 335 .IX Item "radius_bind_min, radius_bind_max (int)"
 336 Define a port range in which to bind sockets used to send and receive \s-1RADIUS\s0 packets. Must be at least \s-1RADIUS_FDS \s0(64) wide. Simplifies firewalling of \s-1RADIUS\s0 ports (default: dynamically assigned).
 337 .IP "\fBrandom_device\fR (string)" 4
 338 .IX Item "random_device (string)"
 339 Path to random data source (default /dev/urandom). Use "" to use the \fIrand()\fR library function.
 340 .IP "\fBscheduler_fifo\fR (boolean)" 4
 341 .IX Item "scheduler_fifo (boolean)"
 342 Sets the scheduling policy for the l2tpns process to \s-1SCHED_FIFO.\s0 This causes the kernel to immediately preempt any currently running \s-1SCHED_OTHER \s0(normal) process in favour of l2tpns when it becomes runnable. Ignored on uniprocessor systems.
 343 .IP "\fBsend_garp\fR (boolean)" 4
 344 .IX Item "send_garp (boolean)"
 345 Determines whether or not to send a gratuitous \s-1ARP\s0 for the bind_address when the server is ready to handle traffic (default: true). This value is ignored if \s-1BGP\s0 is configured.
 346 .IP "\fBtundevicename\fR (string)" 4
 347 .IX Item "tundevicename (string)"
 348 Name of the tun interface (default: \*(L"tun0\*(R").
 349 .IP "\fBthrottle_speed\fR (int)" 4
 350 .IX Item "throttle_speed (int)"
 351 Sets the default speed (in kbits/s) which sessions will be limited to. If this is set to 0, then throttling will not be used at all. Note: You can set this by the \s-1CLI,\s0 but changes will not affect currently connected users.
 352 .IP "\fBthrottle_buckets\fR (int)" 4
 353 .IX Item "throttle_buckets (int)"
 354 Number of token buckets to allocate for throttling. Each throttled session requires two buckets (in and out).
 355 .SS "DHCPv6 And IPv6 \s-1SETTINGS\s0"
 356 .IX Subsection "DHCPv6 And IPv6 SETTINGS"
 357 .IP "\fBdhcp6_preferred_lifetime\fR (int)" 4
 358 .IX Item "dhcp6_preferred_lifetime (int)"
 359 The preferred lifetime for the IPv6 address and the IPv6 prefix address, expressed in units of seconds (see rfc3315).
 360 .IP "\fBdhcp6_valid_lifetime\fR (int)" 4
 361 .IX Item "dhcp6_valid_lifetime (int)"
 362 The valid lifetime for the IPv6 address and the IPv6 prefix address, expressed in units of seconds (see rfc3315).
 363 .IP "\fBdhcp6_server_duid\fR (int)" 4
 364 .IX Item "dhcp6_server_duid (int)"
 365 \&\s-1DUID\s0 Based on Link-layer Address (DUID-LL) (see rfc3315).
 366 .IP "\fBprimary_ipv6_dns\fR, \fBsecondary_ipv6_dns\fR (Ipv6 address)" 4
 367 .IX Item "primary_ipv6_dns, secondary_ipv6_dns (Ipv6 address)"
 368 IPv6 \s-1DNS\s0 servers will be sent to the user (see rfc3646).
 369 .IP "\fBdefault_ipv6_domain_list\fR (string)" 4
 370 .IX Item "default_ipv6_domain_list (string)"
 371 The Domain Search List (ex: \*(L"fdn.fr\*(R") (see rfc3646).
 372 .IP "\fBipv6_prefix\fR (Ipv6 address)" 4
 373 .IX Item "ipv6_prefix (Ipv6 address)"
 374 Enable negotiation of IPv6. This forms the the first 64 bits of the client allocated address. The remaining 64 come from the allocated IPv4 address and 4 bytes of 0.
 375 .SS "\s-1LAC SETTINGS\s0"
 376 .IX Subsection "LAC SETTINGS"
 377 .IP "\fBbind_address_remotelns\fR (ip address)" 4
 378 .IX Item "bind_address_remotelns (ip address)"
 379 Address of the interface to listen the remote \s-1LNS\s0 tunnels. If no address is given, all interfaces are listened (Any Address).
 380 .IP "\fBbind_portremotelns\fR (short)" 4
 381 .IX Item "bind_portremotelns (short)"
 382 Port to bind for the Remote \s-1LNS \s0(default: 65432).
 383 .PP
 384 A static \s-1REMOTES LNS\s0 configuration can be entered by the command:
 385 .IP "\fBsetforward\fR \fI\s-1MASK\s0\fR \fI\s-1IP\s0\fR \fI\s-1PORT\s0\fR \fI\s-1SECRET\s0\fR" 4
 386 .IX Item "setforward MASK IP PORT SECRET"
 387 where \s-1MASK\s0 specifies the mask of users who have forwarded to remote \s-1LNS \s0(ex: \*(L"/friendISP@company.com\*(R").
 388 .Sp
 389 where \s-1IP\s0 specifies the \s-1IP\s0 of the remote \s-1LNS \s0(ex: \*(L"66.66.66.55\*(R").
 390 .Sp
 391 where \s-1PORT\s0 specifies the L2TP Port of the remote \s-1LNS \s0(Normally should be 1701) (ex: 1701).
 392 .Sp
 393 where \s-1SECRET\s0 specifies the secret password the remote \s-1LNS \s0(ex: mysecret).
 394 .PP
 395 The static \s-1REMOTE LNS\s0 configuration can be used when the friend \s-1ISP\s0 not have a proxied Radius.
 396 .PP
 397 If a proxied Radius is used, It will return the \s-1RADIUS\s0 attributes:
 398 .IP "Tunnel\-Type:1 = L2TP" 4
 399 .IX Item "Tunnel-Type:1 = L2TP"
 400 .PD 0
 401 .IP "Tunnel\-Medium\-Type:1 = IPv4" 4
 402 .IX Item "Tunnel-Medium-Type:1 = IPv4"
 403 .ie n .IP "Tunnel\-Password:1 = ""\s-1LESECRETL2TP""\s0" 4
 404 .el .IP "Tunnel\-Password:1 = ``\s-1LESECRETL2TP''\s0" 4
 405 .IX Item "Tunnel-Password:1 = LESECRETL2TP"
 406 .ie n .IP "Tunnel\-Server\-Endpoint:1 = ""88.xx.xx.x1""" 4
 407 .el .IP "Tunnel\-Server\-Endpoint:1 = ``88.xx.xx.x1''" 4
 408 .IX Item "Tunnel-Server-Endpoint:1 = 88.xx.xx.x1"
 409 .ie n .IP "Tunnel\-Assignment\-Id:1 = ""friendisp_lns1""" 4
 410 .el .IP "Tunnel\-Assignment\-Id:1 = ``friendisp_lns1''" 4
 411 .IX Item "Tunnel-Assignment-Id:1 = friendisp_lns1"
 412 .IP "Tunnel\-Type:2 += L2TP" 4
 413 .IX Item "Tunnel-Type:2 += L2TP"
 414 .IP "Tunnel\-Medium\-Type:2 += IPv4" 4
 415 .IX Item "Tunnel-Medium-Type:2 += IPv4"
 416 .ie n .IP "Tunnel\-Password:2 += ""\s-1LESECRETL2TP""\s0" 4
 417 .el .IP "Tunnel\-Password:2 += ``\s-1LESECRETL2TP''\s0" 4
 418 .IX Item "Tunnel-Password:2 += LESECRETL2TP"
 419 .ie n .IP "Tunnel\-Server\-Endpoint:2 += ""88.xx.xx.x2""" 4
 420 .el .IP "Tunnel\-Server\-Endpoint:2 += ``88.xx.xx.x2''" 4
 421 .IX Item "Tunnel-Server-Endpoint:2 += 88.xx.xx.x2"
 422 .ie n .IP "Tunnel\-Assignment\-Id:2 += ""friendisp_lns2""" 4
 423 .el .IP "Tunnel\-Assignment\-Id:2 += ``friendisp_lns2''" 4
 424 .IX Item "Tunnel-Assignment-Id:2 += friendisp_lns2"
 425 .PD
 426 .SS "\s-1PPPOE SETTINGS\s0"
 427 .IX Subsection "PPPOE SETTINGS"
 428 .IP "\fBpppoe_if_to_bind\fR (string)" 4
 429 .IX Item "pppoe_if_to_bind (string)"
 430 \&\s-1PPPOE\s0 server interface to bind (ex: \*(L"eth0.12\*(R"), If not specified the server \s-1PPPOE\s0 is not enabled. For the pppoe clustering, all the interfaces \s-1PPPOE\s0 of the clusters must use the same \s-1HW\s0 address (\s-1MAC\s0 address).
 431 .IP "\fBpppoe_service_name\fR (string)" 4
 432 .IX Item "pppoe_service_name (string)"
 433 \&\s-1PPPOE\s0 service name (default: \s-1NULL\s0).
 434 .IP "\fBpppoe_ac_name\fR (string)" 4
 435 .IX Item "pppoe_ac_name (string)"
 436 \&\s-1PPPOE\s0 access concentrator name (default: \*(L"l2tpns\-pppoe\*(R").
 437 .IP "\fBpppoe_only_equal_svc_name\fR (boolean)" 4
 438 .IX Item "pppoe_only_equal_svc_name (boolean)"
 439 If set to yes, the \s-1PPPOE\s0 server only accepts clients with a \*(L"service-name\*(R" different from \s-1NULL\s0 and a \*(L"service-name\*(R" equal to server \*(L"service-name\*(R" (default: no).
 440 .SS "\s-1BGP ROUTING\s0"
 441 .IX Subsection "BGP ROUTING"
 442 The routing configuration section is entered by the command
 443 .PP
 444 \&\fBrouter\fR \fBbgp\fR \fIas\fR
 445 .PP
 446 where \fIas\fR specifies the local \s-1AS\s0 number.
 447 .PP
 448 Subsequent lines prefixed with \fBneighbour\fR \fIpeer\fR define the attributes of \s-1BGP\s0 neighhbours. Valid commands are:
 449 .PP
 450 \&\fBneighbour\fR \fIpeer\fR \fBremote-as\fR \fIas\fR
 451 .PP
 452 \&\fBneighbour\fR \fIpeer\fR \fBtimers\fR \fIkeepalive\fR \fIhold\fR
 453 .PP
 454 Where \fIpeer\fR specifies the \s-1BGP\s0 neighbour as either a hostname or \s-1IP\s0 address, \fIas\fR is the remote \s-1AS\s0 number and \fIkeepalive\fR, \fIhold\fR are the timer values in seconds.
 455 .SS "\s-1NAMED ACCESS LISTS\s0"
 456 .IX Subsection "NAMED ACCESS LISTS"
 457 Named access lists may be defined with either of
 458 .IP "\(bu" 4
 459 \&\fBip\fR \fBaccess-list\fR \fBstandard\fR \fIname\fR
 460 .IP "\(bu" 4
 461 \&\fBip\fR \fBaccess-list\fR \fBextended\fR \fIname\fR
 462 .PP
 463 Subsequent lines starting with permit or deny define the body of the access-list.
 464 .PP
 465 \fIStandard Access Lists\fR
 466 .IX Subsection "Standard Access Lists"
 467 .PP
 468 Standard access lists are defined with:
 469 .IP "\(bu" 4
 470 {\fBpermit\fR|\fBdeny\fR} \fIsource\fR [\fIdest\fR]
 471 .PP
 472 Where \fIsource\fR and \fIdest\fR specify \s-1IP\s0 matches using one of:
 473 .IP "\(bu" 4
 474 \&\fIaddress\fR \fIwildard\fR
 475 .IP "\(bu" 4
 476 \&\fBhost\fR \fIaddress\fR
 477 .IP "\(bu" 4
 478 \&\fBany\fR
 479 .PP
 480 \&\fIaddress\fR and \fIwildard\fR are in dotted-quad notation, bits in the \fIwildard\fR indicate which address bits in \fIaddress\fR are relevant to the match (0 = exact match; 1 = don't care).
 481 .PP
 482 The shorthand 'host address' is equivalent to '\fIaddress\fR \fB0.0.0.0\fR'; '\fBany\fR' to '\fB0.0.0.0\fR \fB255.255.255.255\fR'.
 483 .PP
 484 \fIExtended Access Lists\fR
 485 .IX Subsection "Extended Access Lists"
 486 .PP
 487 Extended access lists are defined with:
 488 .IP "\(bu" 4
 489 {\fBpermit\fR|\fBdeny\fR} \fIproto\fR \fIsource\fR [\fIports\fR] \fIdest\fR [\fIports\fR] [\fIflags\fR]
 490 .PP
 491 Where \fIproto\fR is one of \fBip\fR, \fBtcp\fR or \fBudp\fR, and \fIsource\fR and \fIdest\fR are as described above for standard lists.
 492 .PP
 493 For \s-1TCP\s0 and \s-1UDP\s0 matches, source and destination may be optionally followed by a ports specification:
 494 .IP "\(bu" 4
 495 {\fBeq|neq|gt|lt\fR} \fIport\fR
 496 .IP "\(bu" 4
 497 \&\fBrange\fR \fIfrom\fR \fIto\fR
 498 .PP
 499 \&\fIflags\fR may be one of:
 500 .IP "{\fBmatch\-any|match\-all\fR} {\fB+|\-\fR}{\fBfin|syn|rst|psh|ack|urg\fR} ..." 4
 501 .IX Item "{match-any|match-all} {+|-}{fin|syn|rst|psh|ack|urg} ..."
 502 Match packets with any or all of the tcp flags set (+) or clear (\-).
 503 .IP "\fBestablished\fR" 4
 504 .IX Item "established"
 505 Match \*(L"established\*(R" \s-1TCP\s0 connections: packets with \s-1RST\s0 or \s-1ACK\s0 set, and \s-1SYN\s0 clear.
 506 .IP "\fBfragments\fR" 4
 507 .IX Item "fragments"
 508 Match \s-1IP\s0 fragments. May not be specified on rules with layer 4 matches.
 509 .SH "SEE ALSO"
 510 .IX Header "SEE ALSO"
 511 \&\fIl2tpns\fR\|(8)