scds_get_rg_hostnames(3HA) Sun Cluster HA and Data Services scds_get_rg_hostnames(3HA)
NAME
scds_get_rg_hostnames - get the network resources used in a resource group
SYNOPSIS
cc [flags...] -I /usr/cluster/include file
-L /usr/cluster/lib -l dsdev
#include <rgm/libdsdev.h>
scha_err_t scds_get_rg_hostnames(char *resourcegroup_name,
scds_net_resource_list_t **netresource_list
DESCRIPTION
The scds_get_rg_hostnames() function retrieves a list of hostnames used by all the network resources in a resource group. This function
returns a pointer to the list in netresource_list. It is possible for a resource group to contain no network resources or to contain
resources that do not use network resources, so this function can return netresource_list set to NULL.
You can pass the name of any resource group name in the system to scds_get_rg_hostnames(). Use the hostnames returned by scds_get_rg_host-
names() to contact applications running in the specified resource group.
Free the memory allocated and returned by this function with scds_free_net_list().
PARAMETERS
The following parameters are supported
resourcegroup_name Name of the resource group for which data is to be retrieved
netresource_list List of network resources used by the resource group
RETURN VALUES
The scds_get_rg_hostnames() function returns the following:
0 The function succeeded.
non-zero The function failed.
ERRORS
SCHA_ERR_NOERR Function succeeded.
See scha_calls(3HA) for a description of other error 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_net_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), attributes(5)
Sun Cluster 3.2 14 Sep 2007 scds_get_rg_hostnames(3HA)