opensolaris man page for scds_get_rs_hostnames

scds_get_rs_hostnames(3HA)				 Sun Cluster HA and Data Services				scds_get_rs_hostnames(3HA)

NAME
       scds_get_rs_hostnames - get the network resources 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_rs_hostnames(scds_handle_t handle,
       scds_net_resource_list_t **netresource_list

DESCRIPTION
       The scds_get_rs_hostnames() function retrieves a list of hostnames used by the resource. If the resource property Network_resources_used is
       set, then the hostnames correspond to the network resources listed in Network_resources_used. Otherwise, they correspond to all the network
       resources in the resource group containing the resource.

       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.

       Free the memory allocated and returned by this function with scds_free_net_list(3HA).

PARAMETERS
       The following parameters are supported

       handle		   The handle returned from scds_initialize(3HA)

       netresource_list    List of network resources used by the resource group

RETURN VALUES
       The scds_get_rs_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_rg_hostnames(3HA), scds_initialize(3HA), scha_calls(3HA), attributes(5), r_properties(5)

Sun Cluster 3.2 						    14 Sep 2007 					scds_get_rs_hostnames(3HA)