| 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 |
|