Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Sun Cluster HA and Data Servicesscds_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_hostnames() 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving

SEE ALSO

 

scds_free_net_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), attributes(5)



Sun Cluster 3.1Go To TopLast Changed 24 Jul 2002