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)