Debian Codegraph @

notes/extended_rooms

raw
1 Extended Room functions in e2guardian
2
3 Hosts in a room can have a override list of urls with or without a blanket block function.
4
5 File format:-
6
7 1st line must contain a '#' followed by the room name
8
9 The following lines define the IP ranges, one IP or range per lines e.g.
10 172.167.58.3
11 172.167.59.1-172.167.59.65
12 177.167.60.0/255.255.255.0
13 177.167.61.0/24
14
15 End the list with:
16 #ENDLIST
17
18 Then optional whitelists can be added by using #SITELIST or #URLLIST
19 Each list must be ended with #ENDLIST
20
21 To block all access (other than listed in one of the above lists) use #BLOCK.
22
23 If #BLOCK is absent than the trusted sites listed will overide any block in the users filter group.
24
25 So there are 4 cases:-
26
27 1. #BLOCK and no (#SITELIST or #URLLIST) - block all access
28 2. #SITELIST and/or #URLLIST and no #BLOCK - trust these urls and allow normal access.
29 3. #SITELIST and/or #URLLIST and #BLOCK - only allow these urls.
30 4. #SITELIST, #URLLIST, #BLOCK all missing - Legacy format file - block all access.
31
32 e.g.
33
34 #MyRoom
35 172.167.58.3
36 172.167.59.1-172.167.59.65
37 177.167.60.0/255.255.255.0
38 #ENDLIST
39
40 #SITELIST
41 site1.com
42 site2.net
43 #ENDLIST
44
45 #URLLIST
46 site3.com/url
47 site4.net/url
48 #ENDLIST
49
50 #BLOCK
51
52 end_of_example
53