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
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/ .
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
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
$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
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 email@example.com and I'll be glad to take a look, time