Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jhthorsen/net-isc-dhcpd

Perl module that interacts with ISC DHCPd
https://github.com/jhthorsen/net-isc-dhcpd

Last synced: 3 months ago
JSON representation

Perl module that interacts with ISC DHCPd

Awesome Lists containing this project

README 

        
NAME

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



VERSION

    0.1709



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

    . If you are not familiar with the

    server, check out the man pages

    .



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.



    kea.isc.org

            "kea.isc.org" a replacement DHCP server from ISC that is

            high-performance and supports an API and on-line configuration

            directly.



BUGS

    Please report any bugs or feature requests to "bug-net-isc-dhcpd at

    rt.cpan.org", or through the web interface at

    . 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, ""



MAINTAINER

    Robert Drake, ""



CONTRIBUTORS

    Nito Martinez



    Alexey Illarionov



    Patrick



    napetrov



    zoffixznet



    Bossi