An ICAP server implementation in C++
Copyright (C) 2012 Uditha Atukorala.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
The main goal of this project is to create an ICAP server (RFC 3507) implementation in C++ to use the power of object oriented programming.
Starting from scratch, the server is developed with a modular architecture in mind. The server core (written in C++) will handle the client requests, manage workers (child processes) etc. and will provide basic handlers to serve ICAP requests.
To extend this core functionality the idea is to have pluggable modules (like apache server modules). These modules will provide features like content filtering, anti-virus scanning etc. and to make it easier to write (and faster to implement) such modules there is hope to exploit python programming language.
- libconfig++ >= 1.4
- log4cpp >= 1.0
- openssl >= 1.0.1c
- python 2.7 (for modpy module)
Please report all bugs and feature requests here under the bitz-server project. Known issues can be found here.
0.1.1 - 06th March 2013
0.1.0 - 03rd March 2013
- Daemonized version (bug #18), hence the minor version bump. Server core is re-organised with bitz::server namespace to be more cleaner and easier to read.
- Make it possible to pass in command-line options
- Closed a memory leak in modpy module
- Fixing bugs #20 and #21
0.0.1 - 24th February 2013
- Proof of concept. An ICAP server with only a REQMOD handler. Includes a template echo module to demonstrate the pluggable module architecture and the modpy module to demonstrate the python interface.
First you need to initialise the autotools
$ libtoolize (glibtoolize in OS X)
$ aclocal
$ autoheader
$ autoconf
$ automake --add-missing --foreign
After that you can use the usual ./configure && make
This is the (long awaited) python interface module. It provides a template for any other python interface module implementations either as C++ module template or as a C++ interface for python modules.
Use the following to create the binaries with debug symbols
$ ./configure CXXFLAGS="-g -O0"
If you compile OpenSSL (v1.0.1) on 64bit systems you might have to compile
with -fPIC
option. If you do that when configuring bitz-server pass in
LIBS=-ldl
to avoid linking errors.
e.g.
$ ./configure LIBS=-ldl
The default config file location is /etc/bitz/bitz-server.conf
but this can
changed using the --with-config
option when you run configure
.
e.g.
$ ./configure --with-config=/[path to source code]/conf/bitz-server.conf
$ valgrind --leak-check=full --read-var-info=yes --trace-children=yes --suppressions=test/valgrind.supp --log-file=valgrind.log ./src/bitz-server --debug