DHCPD-POOLS(1)

NAME
dhcpd-pools - ISC dhcpd pools usage analysis

SYNOPSIS
dhcpd-pools [OPTIONS]

DESCRIPTION
The program analyses ISC dhcpd shared network and pool usage and outputs the results in a user selectable format.

FIELDS

shared net name
    Name of the shared-network for the range.

first ip
    First IP in lease pool range.

last ip
    Last IP in lease pool range.

max Number of IPs which exist in a pool, shared network or all together.

cur Number of leases currently in use.

percent
    Percent of IPs currently in use compared to max.

touch
    Number of IP's which appear in the lease file, but who's leases have expired. A touched IP is either expired or abandoned. The touched IP count is somewhat misleading when you try to determine if an IP pool is big enough; it is a better indicator of whether a pool is too large.

t+c The sum of Touched and Currently in-use leases.

t+c perc
    Percent of IPs either touched or currently in use, compared to max.

bu  Failover pair can allocate these addresses. The count appears only if there is failover configuration.

bu perc
    Percent of addresses that failover pair can allocate. The percent appears only if there is failover configuration.

ARGUMENTS

-c, --config=FILE
    Path to the dhcpd.conf file.

-l, --leases=FILE
    Path to the dhcpd.leases file.

-s, --sort=[nimcptTe]
    Sort ranges by chosen fields as a sorting keys. Maximum of five sort keys can be defined. Keys weight from left to right IE if more weighting keys are equal next one is used. The IP field is default sort key.

-r, --reverse
    Sort results in reverse order.

-f, --format=[thHcxX]
    Output format. Currently there is text, html, full-html and csv (comma-separated values). Default is text. Standard html (h) outputs only the HTML tables, and is useful for embeding more complex web pages. Full-html (H) provides complete HTML headers, etc., including in-line CSS. Output format xml (x) is similar to the dhcpstatus Perl module output. The extended xml (X) format will print ethernet address details.

-o, --output=FILE
    File where output is written. Default is stdout.

-L, --limit=NR
    Limit what will be printed. Syntax is similar to chmod permission string. The limit string uses two digits which vary between 0 to 7. The first digit determines which headers to display, and the second digit determines which numeric analysis tables to include in the output. The following values are "OR'd" together to create the desired output. The default is 77.
    01  Print x
    02  Print y
    04  Print z
    10  Print headers for x
    20  Print headers for y
    40  Print headers for z

-v, --version
    Print version information to standard output and exit successfully.

-h, --help
    Print help to standard output and exit successfully.

FILES
/etc/dhcpd.conf
    ISC dhcpd configuration file.
/var/lib/dhcp/dhcpd.leases
    ISC dhcpd lease file.

AUTHOR
Written by Sami Kerola.
XML support by Dominic Germain, Sogetel inc.

The software has FreeBSD License.

REPORTING BUGS
Report bugs to <kerolasa@iki.fi>
Homepage: http://dhcpd-pools.sourceforge.net/

SEE ALSO
dhcpd.leases(5), dhcpd.conf(5), chmod(1)