/* * This install file pertains to mod_httpbl.c, the source code for mod_httpbl, * an Apache web server module. * * The compilation procedure writes many linker and object files to the same * directory where the source code resides when compiled. It is reccomended * that you create a new directory, put the mod_httpbl.c source code file * in that directory, then follow the following instructions. * * To install this module first compile it into a * DSO file and install it into Apache's modules directory * by running: * * $ apxs -c -i -a mod_httpbl.c * * If your system complains that it can't find the 'apxs' command, try referencing * the command with the absolute path ('/path/to/apache/bin/apxs'). Also, make sure * that your installation came with a 'apxs' executable in the same directory as * 'httpd' (the Apache web server daemon) and 'apachectl' (The control program used * to start, stop or restart Apache). * * The last step of the previous command adds this line to your Apache server's * httpd.conf: * * LoadModule mod_httpbl.so * * If you ever need to completely disable the module, comment out the line with the * "LoadModule mod_httpbl.so" directive by adding a '#' character at the beginning * of the line then comment out every line containing a directive which begins with * "HTTPBL". * * This module is complex and has complex directives. Please refer to the documentation * that came with the source code or see the SourceForge project page. * * Specify at least the minimal directives required to get the module to allow * Apache to start. Future versions of the module may require a different set of * neccessary directives. * * ------------ in your httpd.conf below the LoadModule ------------- * <IfModule mod_httpbl.c> * HTTPBLRBLEnabled On * HTTPBLLogDir /path/to/httpbl/logs/dir * HTTPBLAccessKey *** get_this_from http://www.projecthoneypot.org *** * # any additional server-wide directives * </IfModule> * ------------ ------------- * * ------------ For any VirtualHost, Directory, Files, etc. XML block ------------- * <Directory ~ /foo> * # block-specific directives * </Directory> * ------------ ------------- * Some directive notes: * - the HTTPBLLogDir is necessary if compiled with DEBUG mode on (VERBOSITY == APLOG_DEBUG) * - the HTTPBLReposDir is necessary for developers * * Verify that your httpd.conf parses correctly with this command: * apachectl configtest * * Then to restart Apache, use: * apachectl restart * * If you get no errors from Apache during startup, the module is installed and running. * * If you are having problems installing, running, or understanding how to use the module, * head over to: * http://sourceforge.com/projects/httpbl/ * and tell those developers about your issues. Chances are that if you don't understand * something about this documentation, there is probably someone else out there with the * same troubles. We would like to hear about it and help you out. */