The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

cPanel::PublicAPI::WHM::DNS - A module for interacting with WHM's DNS clustering system.

DESCRIPTION

This module is intended as a client for querying WHM's DNS clustering system. Unless you are specifically looking to write your own interaction with cPanel's DNS system, you should never need to use this module, rather the DNS functions within cPanel's XML-API should do what you are looking for: http://docs.cpanel.net/twiki/bin/vief/AllDocumentation/AutomationIntegration/XmlApi#DNS%20functions

functions

The functions contained within this module share a similiar naming scheme for the variables used within, please consult the list below when figuring out what each function does.

  • $zone - The name of the domain to be used.

  • $dnsuniqid - A Unique string used to identify uniquely (suggested: 32 character alphanumeric)

  • $zones - A pipe seperated list of domains.

  • $zonedata - The contents of a zone file, usually used for sending changes of a zone to another system.

addtocluster()

Add a machine to a DNS cluster.

Call specific parameters:

  • $clustermaster - The IP of the machine being added to the cluster.

  • $user - The user to authenticate DNS requests as.

  • $pass - The accesshash or API token to authenticate DNS requests with

  • $version - The version of cPanel/WHM of the machine being added to the cluster

Syntax:

  $pubapi->addtocluster(  $user, $clustermaster, $accesshash, $version )

getzone_local()

Get the contents of a zone file.

Syntax:

  $pubapi->getzone_local( $zone, $dnsuniqid )

getzones_local()

Get the contents of multiple zone files, this will be split up as:

  cpdnszone-%URI ENCODED ZONENAME%=%URI encoded version of zone file%&cpdnszone...

for each zone in the response

Syntax:

  $pubapi->getzones_local( $zones, $dnsuniqid )

getallzones_local()

Like getzones_local, but will return all zones in a cluster.

Syntax:

  $pubapi->getallzones_local( $dnsuniqid )

cleandns_local()

Clean up any old or unused DNS zones from named.conf.

Syntax:

  $pubapi->cleandns_local( $dnsuniqid )

getips_local()

Get a list of extra IPs available on a system, response will be formated as:

$ip:$netmask:$broadcast

Syntax:

  $pubapi->getips_local( $dnsuniqid )

getpath_local()

Returns a newline separated list containing all the machines that this machine is clustered with in the following format:

$hostname $remote_host

Syntax:

  $pubapi->getpath_local( $dnsuniqid )

removezone_local()

Remove a DNS zone.

Syntax:

  $pubapi->removezone_local( $zone, $dnsuniqid )

removezones_local()

Remove multiple DNS zones.

Syntax:

  $pubapi->removezones_local( $zones, $dnsuniqid )

reloadzones_local()

Force bind to re-read zones files via the "rndc reload" command.

Syntax:

  $pubapi->reloadzones_local( $dnsuniqid, $zones )

reloadbind_local()

Run the 'rndc reload' command. If no zones are specified, bind will reload everything.

Syntax:

  $pubapi->reloadbind_local( $dnsuniqid, $zone )

reconfigbind_local()

Run the 'rndc reconfig' command.

Syntax:

  $pubapi->reconfigbind_local( $dnsuniqid, $zone )

quickzoneadd_local()

Add a new zone to a system.

Syntax:

  $pubapi->quickzoneadd_local( $zone, $zonedata, $dnsuniqid )

savezone_local()

Update a zone file with the data specified in $zonedata.

Syntax:

  $pubapi->savezone_local( $zone, $zonedata, $dnsuniqid )

synczones_local()

Send a dump of all zones and update zones when required. The zones are sent within the $formdata in the following format:

  cpdnszone-%URI ENCODED ZONENAME%=%URI encoded version of zone file%&cpdnszone...

Syntax:

  $pubapi->synczones_local( $formdata, $dnsuniqid )

addzoneconf_local()

Add a zone to the named.conf file.

Syntax:

  $pubapi->addzoneconf_local( $zone, $dnsuniqid )

getzonelist_local()

Get a newline seperated list of the zones on a system.

Syntax:

  $pubapi->getzonelist_local( $dnsuniqid )

zoneexists_local()

Return boolean value indicating whether a zone exists on a remote system or not.

Syntax:

  $pubapi->zoneexists_local( $zone, $dnsuniqid )

Bugs

see http://rt.cpan.org to report and view bugs

License

Copyright (c) 2015, cPanel, Inc. All rights reserved. http://cpanel.net

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of cPanel, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.