$Id: README,v 1.9 2001/02/02 21:12:17 jeremy Exp $

Dhcpreg is a mechanism for adding/removing/checking host entries in 
dhcpd.conf file. This was born out of a desire to have a 'registered'
dhcp system where all cable modem mac addresses were known to the
system.

Help is available via "dhcpreg.pl -h" and yields this:

Usage: dhcpreg.pl command macaddr [username]

    Commands are:
        add macaddr username  = add a new macaddr to the config file
        rm macaddr            = remove a macaddr from the config file
        check macaddr         = check to see if macaddr is in file
        check --name username = check to see what macaddrs a name has
                                registered

Static-dhcpreg.pl is a hack to allow the additions of static CPE
IP entries for the business class customers.

Its usages is:

Usage: static-dhcpreg.pl command [username] [ipaddr]
    Commands are:
       add macaddr username ipaddr  = add a new macaddr to the config file
       rm macaddr                   = remove a macaddr from the config file
       check macaddr                = check to see if macaddr is in file
       check --name username        = check to see what macaddrs a name has
                                      registered

check-static-ips.pl is a quick util to check for all static customers
accounts, ip number, mac addr from the dhcpd.conf file

Usage: check-static-ips.pl

(No options. None. Don't even try.)

ipchange-dhcpreg.pl allows people to change the config files for the
number of ips allowed to a CM. Currently, the only options are 5
additional ips or 1 to set it back to the standard config file .

Usage: ipchange-dhcpreg.pl macaddr number-of-addrs

-=-

DHCPReg equires Interrupt.pm which is available in source or RPM form from
Systhug: http://www.systhug.com/Interrupt/

The secure version requires the dhcpd.conf and dhcpd.leases file to be 
readable by group 'dhcpd' and for the dhcpd.conf to be writeable by 
group 'dhcpd'. This is more suitable for using dhcpreg with CGIs.

The standard version installs itself suid to minimize group 
affiliations. This is only recommended for secured, limited access 
servers.

See the INSTALL file for installation instructions.

-=-

!!! NOTE FOR THE SECURITY CONSCIOUS !!!

Dhcpreg.pl and static-dhcpreg.pl install themselves suid root if you
use the standard installation method. I hate doing things like that if 
I don't have to, but the default install of the ISC dhcp server is to 
run as root with the config owned by root, so I'm working within those 
boundaries. I've created an alternate, secure method outlined in the
INSTALL file.

The one good thing is that the default group is set to "wheel" (group
10) which is good for Linux systems, the platform we're using for
DHCP, but that, too, can be easily changed.

The EXAMPLES file will also give some information on how you can set
this up to be more secure. The goal with the package was to provide a
tool set that would be universal. I could have created a group to run
as, but that seems intrusive and would still require you to have your
dhcpd.conf grouped the same way with write perms to the group. I
didn't want to make that decision for you. 

-=-