Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018
 
 

scds_get_rg_hostnames(3HA )

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

#1405

The scds_get_rg_hostnames()and scds_get_rg_hostnames_zone()function 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 from a resource group in a given zone cluster, when executed from the global zone. This function returns a pointer to the list in netresource_list. A resource group can contain no network resources or can contain resources that do not use network resources, so these 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 return function returns the following values:

0

The function succeeded.

nonzero

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/developer/api
Interface Stability
Evolving

See Also

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