Net::ISC::DHCPd - Interacts with ISC DHCPd
0.1709
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.
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.
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.
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.
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.
This attribute holds a Path::Class::File object to the dhcpd binary. It is read-only and the default is "dhcpd3".
Holds the last know error as a plain string. This only applies to OMAPI.
$config->parse;
This parses the config file or the leases file.
print $config->generate;
This generates a copy of the config file in plaintext.
$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).
$!
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.
Net::DHCP::Info
kea.isc.org a replacement DHCP server from ISC that is high-performance and supports an API and on-line configuration directly.
kea.isc.org
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.
bug-net-isc-dhcpd at rt.cpan.org
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.
Jan Henning Thorsen, <jhthorsen at cpan.org>
<jhthorsen at cpan.org>
Robert Drake, <rdrake at cpan.org>
<rdrake at cpan.org>
Nito Martinez
Alexey Illarionov
Patrick
napetrov
zoffixznet
Bossi
To install Net::ISC::DHCPd, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::ISC::DHCPd
CPAN shell
perl -MCPAN -e shell install Net::ISC::DHCPd
For more information on module installation, please visit the detailed CPAN module installation guide.