GetDNSAllIpAddrs

Edit online

The GetDNSAllIpAddrs method returns all IP addresses corresponding to a particular node name.

Method Synopsis

GetDNSAllIpAddrs($name)

Parameters

$name
Specifies the name of the node whose corresponding IP addresses are of interest.

Description

The GetDNSAllIpAddrs method returns all IP addresses corresponding to the node name specified in the $name parameter.

Notes®

The GetDNSAllIpAddrs method issues the appropriate DNS request to the Helper Server, which performs the actual work. Thus, the Helper Server (and ncp_ctrl) must be running so that this method can make the appropriate DNS request.

Example Usage

The following example:

  • Assumes a previous call to the RIV::Agent constructor, which returns a RIV::Agent object (represented by $agent->).
  • Returns to the $refAllIpAddrs variable a reference to an array that contains all IP addresses corresponding to the node called foo.
  • Calls the print operator to send each IP address in the list to standard output.
$refAllIpAddrs = $agent->GetDNSAllIpAddrs("foo");
print @$refAllIpAddrs;

Returns

Upon completion, the GetDNSAllIpAddrs method returns a reference to an array of IP addresses corresponding to the specified node name.