scds_get_rg_hostnames(3HA)

NAME | Synopsis | Description | Parameters | Return Values | Errors | Files | Attributes | See Also

NAME

scds_get_rg_hostnames, scds_get_rg_hostnames_zone – 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
);

scha_err_t scds_get_rg_hostnames_zone(char *zone_name, char *resourcegroup_name, scds_net_resource_list_t **netresource_list);

Description

The scds_get_rg_hostnames() and scds_get_rg_hostnames_zone() functions retrieves a list of host names that are used by all the network resources in a resource group. The scds_get_rg_hostnames_zone() function enables you to retrieve a list within a particular zone. Theseis functions returns a pointer to the list in netresource_list. It is possible for aA resource group tocan contain no network resources or to can contain resources that do not use network resources, so theseis functions can return a netresource_list parameter that is set to NULL.

You can pass the name of any resource group name in the system to scds_get_rg_hostnames() and scds_get_rg_hostnames_zone(). Use the host names that are returned by scds_get_rg_hostnames() and scds_get_rg_hostnames_zone() to contact applications that are running in the specified resource group.

Free the memory that is 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 that are used by the resource group

Return Values

The scds_get_rg_hostnames() and scds_get_rg_hostnames_zone() functions returns the following values:

0

The function succeeded.

nonzeronon-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  Last Revised 1 Aug 2008 14 Sep 2007

NAME | Synopsis | Description | Parameters | Return Values | Errors | Files | Attributes | See Also