NAME

    Net::ISC::DHCPd - Interacts with ISC DHCPd

VERSION

    0.1705

SYNOPSIS

        my $dhcpd = Net::ISC::DHCPd->new(
                        config => { file => "path/to/config" },
                        leases => { file => "path/to/leases" },
                        omapi => { key => "some key" },
                    );
    
        $dhcpd->config->parse;

    See the tests bundled to this distribution for more examples.

DESCRIPTION

    This namespace contains three semi-separate projects, which this module
    binds together: dhcpd.conf, dhcpd.leases and omapi. It is written with
    Moose which provides classes and roles to represents things like a
    host, a lease or any other thing.

    The distribution as a whole is targeted an audience who configure
    and/or analyze the Internet Systems Consortium DHCP Server
    <http://www.isc.org/software/dhcp>. If you are not familiar with the
    server, check out the man pages
    <http://www.google.com/search?q=man+dhcpd>.

ATTRIBUTES

 config

    This attribute holds a read-only Net::ISC::DHCPd::Config object. It can
    be set from the constructor, using either an object or a hash-ref. The
    hash-ref will then be passed on to the constructor.

 leases

    This attribute holds a read-only Net::ISC::DHCPd::Leases object. It can
    be set from the constructor, using either an object or a hash-ref. The
    hash-ref will then be passed on to the constructor.

 omapi

    This attribute holds a read-only Net::ISC::DHCPd::OMAPI object. It can
    be set from the constructor, using either an object or a hash-ref. The
    hash-ref will then be passed on to the constructor.

 binary

    This attribute holds a Path::Class::File object to the dhcpd binary. It
    is read-only and the default is "dhcpd3".

 errstr

    Holds the last know error as a plain string. This only applies to
    OMAPI.

METHODS

 parse

     $config->parse;

    This parses the config file or the leases file.

 generate

     print $config->generate;

    This generates a copy of the config file in plaintext.

 test

     $bool = $self->test("config");
     $bool = $self->test("leases");

    Will test either the config or leases file. It returns a boolean value
    which indicates if it is valid or not: True means it is valid, while
    false means it is invalid. Check "errstr" on failure - it will contain
    a descriptive string from either this module, $! or the exit value
    (integer stored as a string).

SEE ALSO

    Net::DHCP::Info

      Net::DHCP::Info an older dhcpd.leases and dhcpd.conf parser, also
      written by Jan Henning Thorsen. It has many limitations that these
      modules address.

BUGS

    Please report any bugs or feature requests to bug-net-isc-dhcpd at
    rt.cpan.org, or through the web interface at
    https://github.com/jhthorsen/net-isc-dhcpd/issues. I will be notified,
    and then you'll automatically be notified of progress on your bug as I
    make changes.

COPYRIGHT & LICENSE

    Copyright 2007 Jan Henning Thorsen, all rights reserved.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

AUTHOR

    Jan Henning Thorsen, <jhthorsen at cpan.org>

MAINTAINER

    Robert Drake, <rdrake at cpan.org>

CONTRIBUTORS

    Nito Martinez

    Alexey Illarionov

    Patrick

    napetrov

    zoffixznet