"Fossies" - the Fresh Open Source Software Archive

Member "httpbl/mod_httpbl_for_apache_1.3/mod_httpbl_source/install.txt" (15 May 2007, 3352 Bytes) of package /linux/www/apache_httpd_modules/old/mod_httpbl.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 /*
    2  *	This install file pertains to mod_httpbl.c, the source code for mod_httpbl,
    3  *	an Apache web server module.
    4  *
    5  *	The compilation procedure writes many linker and object files to the same
    6  *	directory where the source code resides when compiled.  It is reccomended
    7  *	that you create a new directory, put the mod_httpbl.c source code file
    8  *	in that directory, then follow the following instructions.
    9  *
   10  *      To install this module first compile it into a
   11  *      DSO file and install it into Apache's modules directory 
   12  *      by running:
   13  *       
   14  *         $ apxs -c -i -a mod_httpbl.c
   15  *
   16  *	If your system complains that it can't find the 'apxs' command, try referencing
   17  *	the command with the absolute path ('/path/to/apache/bin/apxs').  Also, make sure
   18  *	that your installation came with a 'apxs' executable in the same directory as
   19  *	'httpd' (the Apache web server daemon) and 'apachectl' (The control program used
   20  *	to start, stop or restart Apache).
   21  *
   22  *	The last step of the previous command adds this line to your Apache server's
   23  *	httpd.conf:
   24  *
   25  *	   LoadModule mod_httpbl.so
   26  *
   27  *	If you ever need to completely disable the module, comment out the line with the
   28  *	"LoadModule mod_httpbl.so" directive by adding a '#' character at the beginning
   29  *	of the line then comment out every line containing a directive which begins with
   30  *	"HTTPBL".
   31  *	
   32  *	This module is complex and has complex directives.  Please refer to the documentation
   33  *	that came with the source code or see the SourceForge project page.
   34  *       
   35  *     	Specify at least the minimal directives required to get the module to allow
   36  *	Apache to start.  Future versions of the module may require a different set of
   37  *	neccessary directives.
   38  *     
   39  *       ------------         in your httpd.conf below the LoadModule       -------------
   40  *       <IfModule mod_httpbl.c>
   41  *           HTTPRBLEnable        On
   42  *           HTTPBLLogDir         /path/to/httpbl/logs/dir
   43  *           HTTPBLAccessKey      *** get_this_from http://www.projecthoneypot.org ***
   44  *           # any additional server-wide directives
   45  *       </IfModule>
   46  *       ------------                                                       -------------
   47  *
   48  *       ------------ For any VirtualHost, Directory, Files, etc. XML block -------------
   49  *       <Directory ~ /foo>
   50  *           # block-specific directives
   51  *       </Directory>
   52  *       ------------                                                       -------------
   53  *       Some directive notes:
   54  *       - the HTTPBLLogDir is necessary if compiled with DEBUG mode on (VERBOSITY == APLOG_DEBUG)
   55  *       - the HTTPBLReposDir is necessary for developers
   56  *
   57  *     	Verify that your httpd.conf parses correctly with this command:
   58  *     	apachectl configtest
   59  *
   60  *     	Then to restart Apache, use: 
   61  *     	apachectl restart
   62  *
   63  *     	If you get no errors from Apache during startup, the module is installed and running.
   64  *
   65  *	If you are having problems installing, running, or understanding how to use the module,
   66  *	head over to:
   67  *	http://sourceforge.com/projects/httpbl/
   68  *	and tell those developers about your issues.  Chances are that if you don't understand
   69  *	something about this documentation, there is probably someone else out there with the
   70  *	same troubles.  We would like to hear about it and help you out.
   71  */