Debian Codegraph @

notes/NEWIN_v4

raw
1 New in v4 (v4.1).
2
3 The v4 is written in c++11 and so to compile it you will need gcc v5.4
4 or later. (or another complier that supports the c++11 std::thread library).
5 Note that the target systems may also need an c++11 library update.
6
7 REVISED PROCESS MODEL
8
9 The parent children process model (which does not scale for very large numbers
10 of connections) is replaced with a queue/threads based model.
11
12 The main thread now only deals with set-up of the logging, listener, and worker
13 threads, the input (and reinput) of the lists, signals and statistics.
14
15 The treads communicate via fi-fo queues within memory and so there is no need
16 for ipc pipes.
17
18 A listener thread is set up for each ip/port combination. They listen for a
19 connection, accept it and then push the new connection socket on the
20 appropriate worker queue.
21
22 The worker threads pop connections from the worker queue and deal with the
23 connection.
24
25 When a worker wants to log a request it pushes the logging data onto the log
26 queue. The logging thread will pop the data from the queue, format it and
27 write it to the log.
28
29 Most of the above logic is in FatControler.cpp. The logic is now much simpler
30 and has reduced the amount of code in FatControler by over 50%.
31
32 Socket classes have been extensively modified to remove interrupt handling (for
33 list reload etc) and all select calls are removed. So there is no longer a
34 need to modify FD_SETSIZE.
35
36 New LOptionContainer class has been written to hold list and filter group
37 setings. On gentle restart a new LOptionContainer object is created and
38 loaded with filter group and list settings. Once fully read in a global
39 shared pointer is switched from the old list to the new, making actioning
40 list changes immediate an with no interruption to service.
41
42 TODO - for next release (v5).
43
44 Make lists parameter based rather than hard coded.
45
46 Create 'story-board' parameterised logic for handling filtering logic.
47
48 Transparent https option.
49
50
51 WISHLIST
52
53 ICAP server mode.
54
55 Re-implement mailing option.
56
57 Per-user exceptions/blocks.
58
59 NOTES FOR PREVIOUS VERSION - v4.0.1
60
61 All pics support has been removed
62
63 Mail option not yet implemented.
64
65 Url cache not implemented
66
67 IP cache not implemented
68
69 Auth plugins - tested and working
70
71 Scan plugins - some tested
72
73 New e2guardian.conf options
74
75 httpworkers
76 enablessl
77
78 Please note the new format for the dstats log. See notes/dstat_format
79
80 Philip Pearce 12 July 2017
81
82