MDNS plugin: Hacked away jet another uninit-warning if DEBUG=0
[olsrd.git] / README-acl
1    Using access control lists in OLSRd
2 =========================================
3
4 Several plugins in OLSRd allow you to limit the access to
5 their server functions by IP. This file will explain how to
6 use the ACL features.
7  
8 The access is controlled by two lists of ip
9 addresses and ip networks, a blacklist (reject list) and
10 a whitelist (accept list). Two binary flags control which
11 list is to be used first and what should be the default
12 reaction to an unknown IP.
13
14 The parameter "accept" contains an IP address or network
15 which is allowed to access the service, the parameter "reject"
16 contains a IP/network which is NOT allow to access it.
17
18 The parameter "checkfirst" tells the service which of the
19 two lists have to be checked first.
20 The default setting is "reject".
21
22 The last parameter "defaultpolicy" controls what the server
23 should do with IPs which are not found in BOTH lists.
24 The default setting is "reject".
25
26
27    Examples for ACL usage
28 ============================
29
30 Examples for parameters accept/reject:
31 PlParam   "accept"   "10.0.0.0/8" 
32 PlParam   "reject"   "10.0.0.1" 
33 PlParam   "accept"   "10.0.0.0 255.0.0.0" 
34
35 Examples for parameters for binary flags
36 PlParam   "checkfirst"      "reject"
37 PlParam   "defaultpolicy"   "accept"
38
39
40    Legacy parameters
41 =======================
42 The old parameters "host", "host4", "host6", "net", "net4"
43 and "net6" are just alias names for "accept".