On Apache
Under GNU General Public License
2024-04-19 14:50 @18.190.156.80 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
cPanel::PublicAPI::WHM::DNS(3) User Contributed Perl Documentation cPanel::PublicAPI::WHM::DNS(3)
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.
o $zone - The name of the domain to be used.
o $dnsuniqid - A Unique string used to identify uniquely (suggested: 32 character
alphanumeric)
o $zones - A pipe seperated list of domains.
o $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:
o $clustermaster - The IP of the machine being added to the cluster.
o $user - The user to authenticate DNS requests as.
o $pass - The accesshash to authenticate DNS requests with
o $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) 2011, 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.
perl v5.10.1 2011-03-03 cPanel::PublicAPI::WHM::DNS(3)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-19 14:50 @18.190.156.80 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)