phpBBHC - php Big Brother Hosts Configurator
============================================

Version 0.3: By Simon McCorkindale <wocky <<AT>> akibageeks.com>, May 2007

Introduction:
-------------

phpBBHC is a collection of PHP scripts and one C program to configure hosts
for the Big Brother network monitoring software. It doesn't cover all the
possible settings for Big Brother's hosts file but it should be enough for
most demands.

Ammendment: Big Brother has been pretty much replaced by Hobbit. I haven't
got around to using Hobbit yet but I've heard it's pretty backwards compatible
with Big Brother's configuration and scripts. I've heard of successful stories
of phpBBHC being used to configure Hobbit.

Installation:
-------------

Please check the INSTALL file in this directory for instructions on installing
and configuring phpBBHC.

Homepage:
---------

phpBBHC's official homepage can be found at

http://http://www.hart.co.jp/gnu/phpBBHC/

Hack to test database server status:
------------------------------------

Since a bug fix in version 0.3 you can now enter file names into URLs when
http/https checking is enabled. This allows you to create a simple PHP script
(or in whatever scripting language you use) to test a database connection as
Big Brother does not have this support built in. The following script below
simply prints "OK" if a connection is made to the database server successfully,
otherwise it mimicks a HTTP 404 Not Found error which causes Big Brother to go
red and report the http service as being down, which you can interpret as the
database server is down :-)

<?php
/* PHP Hack to test a database connection and mimick an HTTP 404 Not Found
 * error so Big Brother will go red (ie alert you) if the connection attempt
 * to the database server was unsuccessful.
 * 
 * Written Feb 2007
 * Simon McCorkindale <wocky <<AT>> akibageeks.com>
 */
error_reporting (0);

if(!pg_connect("host=my.databaseserver.com user=postgres dbname=foodb")){
        header("HTTP/1.0 404 Not Found");
        exit();
}else{
        pg_close();
        echo "OK";
}

?>

EOF