mirror of
git://git.code.sf.net/p/dhcpd-pools/code
synced 2025-12-17 00:06:59 +00:00
improve README file instructions
Proposed-by: Derrick Lin <d.lin@garvan.org.au> Signed-off-by: Sami Kerola <kerolasa@iki.fi>
This commit is contained in:
parent
5cede1ff31
commit
c7917152d3
2 changed files with 35 additions and 31 deletions
65
README
65
README
|
|
@ -1,53 +1,56 @@
|
||||||
This is dhcpd-pools which is made for ISC dhcpd pool range analysis.
|
This is dhcpd-pools - ISC dhcpd lease status utility.
|
||||||
|
|
||||||
== Quick start
|
Quick start.
|
||||||
|
|
||||||
|
Get the uthash, assuming you do not have it already.
|
||||||
|
|
||||||
|
cd /tmp
|
||||||
|
wget https://github.com/troydhanson/uthash/archive/master.zip
|
||||||
|
unzip master.zip
|
||||||
|
|
||||||
|
Build the dhcpd-pools project.
|
||||||
|
|
||||||
|
cd /tmp/dhcpd-pools
|
||||||
./bootstrap
|
./bootstrap
|
||||||
./configure --prefix=/usr/local
|
./configure --with-uthash=/tmp/uthash-master/include
|
||||||
make
|
make
|
||||||
|
make check
|
||||||
make install
|
make install
|
||||||
|
|
||||||
# Notice that there are configuration options for dhcpd.conf,
|
Notice that there are configuration options for default dhcpd.conf,
|
||||||
# dhcpd.leases, and uthash include paths, among other things.
|
dhcpd.leases paths, among other things.
|
||||||
|
|
||||||
./configure --help
|
./configure --help
|
||||||
|
|
||||||
== General information
|
Read the manual to see what options are available, and what they to.
|
||||||
|
|
||||||
With this command you can check usage of pool addresses
|
man ./man/dhcpd-pools.1
|
||||||
when address space is great. Command is designed so that
|
|
||||||
it will not get slow even there is thousands of IPs in
|
|
||||||
lease file. This kind of huge dhcpd installation can be
|
|
||||||
near by DSL DSLAMs or some other public access connection
|
|
||||||
points.
|
|
||||||
|
|
||||||
This command will not print nice to know information like
|
Dependencies to other projects.
|
||||||
DHCPStatus does. Output is limited only to list only
|
|
||||||
usage for ranges, shared network and total address space.
|
|
||||||
Limiting what is printed is the right thing to do when
|
|
||||||
there is thousands of addresses. If your address space is
|
|
||||||
small some other dhcp analyzer might be more suitable for
|
|
||||||
you.
|
|
||||||
|
|
||||||
== Dependencies to other projects
|
|
||||||
|
|
||||||
http://www.gnu.org/software/gnulib/
|
http://www.gnu.org/software/gnulib/
|
||||||
|
|
||||||
If you have gnulib checked out somewhere at file
|
You can avoid repeated gnulib downloads by setting
|
||||||
system you can avoid download by setting
|
GNULIB_SRCDIR environment variable. For example:
|
||||||
GNULIB_SRCDIR environment variable.
|
|
||||||
|
git clone git://git.savannah.gnu.org/gnulib.git ~/src/gnulib
|
||||||
|
export GNULIB_SRCDIR="$HOME/src/gnulib"
|
||||||
|
|
||||||
|
Assumign detached gnulib please remember to git pull the
|
||||||
|
latest updates before building dhcpd-pools.
|
||||||
|
|
||||||
http://uthash.sourceforge.net/
|
http://uthash.sourceforge.net/
|
||||||
|
|
||||||
== Test data wanted
|
See quick start.
|
||||||
|
|
||||||
|
Test data wanted.
|
||||||
|
|
||||||
Maintainer is interested to get copy of your dhcpd.conf
|
Maintainer is interested to get copy of your dhcpd.conf
|
||||||
and dhcpd.leases file, with includes if you use them.
|
and dhcpd.leases files, and include files if you use them.
|
||||||
Intention is to collect large set of data to build
|
Intention is to collect large set of data to build
|
||||||
realistic regression test environment. By giving your
|
realistic regression test environment.
|
||||||
data to maintainer you can be sure that updates will work
|
|
||||||
for you.
|
|
||||||
|
|
||||||
If you are interested to help this way put all files into
|
If you are interested to help this way put all files into
|
||||||
tar.gz, and send them to kerolasa@iki.fi. It would be nice
|
tar.gz, and send them to:
|
||||||
that email subject line would have 'dhcpd-pools test data'.
|
|
||||||
|
Sami Kerola <kerolasa@iki.fi>
|
||||||
|
|
|
||||||
1
THANKS
1
THANKS
|
|
@ -36,3 +36,4 @@ Aaron Paetznick
|
||||||
Tim Cantin
|
Tim Cantin
|
||||||
Martijn van Brummelen
|
Martijn van Brummelen
|
||||||
Anton Tkachev
|
Anton Tkachev
|
||||||
|
Derrick Lin
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue