scds_get_netaddr_list(3HA) Sun Cluster HA and Data Services scds_get_netaddr_list(3HA)
NAME
scds_get_netaddr_list - get the network addresses used by a resource
SYNOPSIS
cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib -l dsdev
#include <rgm/libdsdev.h>
scha_err_t scds_get_netaddr_list(scds_handle_t handle,
scds_netaddr_list_t **netaddr_list
DESCRIPTION
The scds_get_netaddr_list() function returns all hostname, port, and protocol combinations that are in use by the resource. These combina-
tions are derived by combining the Port_list property settings on the resource with all the hostnames in use by the resource, as returned
by the scds_get_rs_hostnames() function.
Use scds_get_netaddr_list() in a fault monitor to monitor the resource, and to derive the list of hostnames, ports, and protocols that are
in use by the resource .
Values for the protocol type are defined in header file <rgm/libdsdev.h>.
Free the memory that is allocated and returned by this function with scds_free_netaddr_list().
PARAMETERS
The following parameters are supported:
handle The handle that is returned by scds_initialize()
netaddr_list The list of hostnames, ports, and protocols that are used by the resource group
RETURN VALUES
The scds_get_netaddr_list() function returns the following values:
0 The function succeeded.
nonzero The function failed.
ERRORS
SCHA_ERR_NOERR Indicates that the function succeeded
Other values Indicate that the function failed. See scha_calls(3HA) for the meaning of failure codes.
FILES
/usr/cluster/include/rgm/libdsdev.h
Include file
/usr/cluster/lib/libdsdev.so
Library
ATTRIBUTES
See attributes(5) for descriptions of the following attributes.
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWscdev |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO
scds_free_netaddr_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), r_properties(5), attributes(5)
Sun Cluster 3.2 7 Sep 2007 scds_get_netaddr_list(3HA)