reportdhcp.pl

README for reportdhcp.pl version 2.1

Reportdhcp.pl is a CGI script written in perl. It displays statistics and
lease entries for ISC DHCPD by parsing the dhcpd.conf and dhcpd.leases
files. reportdhcp.pl version 2 supports version 3.0p1 and above of the ISC
DHCP distribution.

Copyright 1997-2002 John G. Drummond. this program is licensed under the 
GNU Public License.  See the text at the top of the file for additional 
licensing and usage information.

For updates and information, see http://www.omar.org/opensource/reportdhcp/ .

To install: 

1) Unzip and untar the reportdhcp.pl-2.1.tar.gz file:

	$ gunzip reportdhcp.pl-2.1.tar.gz
	$ tar -xvf reportdhcp.pl-2.1.tar

   The archive contains three files: reportdhcp.pl, CHANGELOG, and this
	README file.

2) Copy or move the reportdhcp.pl file into the cgi-bin directory for your 
	Web server (or some subdirectory thereof).  

3) Set the permissions on the file.  Most CGI scripts are set to mode 755
	(-rwxr-xr-x).  

	$cd /place/where/you/put/reportdhcp.pl
	$chmod 0755 reportdhcp.pl
	(or $chmod o=rx reportdhcp.pl)

4) Open reportdhcp.pl with your favorite text editor and change the options
	in the OPTIONS section.  The defaults assume you have a default
	installation of ISC DHCP and have your reportdhcp.pl in the root of
	your cgi-bin directory.  The $sysname field is optional, but makes 
	it nice if you have reportdhcp.pl on more than one system.

5) You should be done!  Point your browser at reportdhcp.pl and see if it
	works!  (http://your.host.name/cgi-bin/[directory]/reportdhcp.pl)

NOTE: On public systems where I have reportdhcp.pl installed, I use HTTP
	Basic Authentication to keep outsiders from using reportdhcp.pl.
	See the documentation for your Web server.  Your security is up
	to you, but I don't see any reason to give away information about
	your network. :)   

If you have problems, discover bugs, have a suggestion, or make an improvement,
	send email to omar@omar.org and I'll be glad to take a look, time
	permitting.