JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Reference Manual     Oracle Solaris Cluster 3.3 3/13
search filter icon
search icon

Document Information

Preface

Introduction

OSC33 1

OSC33 1cl

OSC33 1ha

OSC33 1m

OSC33 3ha

scds_calls(3HA)

scds_close(3HA)

scds_error_string(3HA)

scds_error_string_i18n(3HA)

scds_failover_rg(3HA)

scds_fm_action(3HA)

scds_fm_net_connect(3HA)

scds_fm_net_disconnect(3HA)

scds_fm_print_probes(3HA)

scds_fm_sleep(3HA)

scds_fm_tcp_connect(3HA)

scds_fm_tcp_disconnect(3HA)

scds_fm_tcp_read(3HA)

scds_fm_tcp_write(3HA)

scds_free_ext_property(3HA)

scds_free_netaddr_list(3HA)

scds_free_net_list(3HA)

scds_free_port_list(3HA)

scds_get_current_method_name(3HA)

scds_get_ext_property(3HA)

scds_get_fullname(3HA)

scds_get_fullname_nodeid(3HA)

scds_get_netaddr_list(3HA)

scds_get_port_list(3HA)

scds_get_resource_group_name(3HA)

scds_get_resource_name(3HA)

scds_get_resource_type_name(3HA)

scds_get_rg_hostnames(3HA)

scds_get_rg_hostnames_zone(3HA)

scds_get_rs_hostnames(3HA)

scds_get_zone_name(3HA)

scds_hasp_check(3HA)

scds_initialize(3HA)

scds_is_zone_cluster(3HA)

scds_pmf_get_status(3HA)

scds_pmf_restart_fm(3HA)

scds_pmf_signal(3HA)

scds_pmf_start(3HA)

scds_pmf_start_env(3HA)

scds_pmf_stop(3HA)

scds_pmf_stop_monitoring(3HA)

scds_print_netaddr_list(3HA)

scds_print_net_list(3HA)

scds_print_port_list(3HA)

scds_property_functions(3HA)

scds_restart_resource(3HA)

scds_restart_rg(3HA)

scds_simple_net_probe(3HA)

scds_simple_probe(3HA)

scds_svc_wait(3HA)

scds_syslog(3HA)

scds_syslog_debug(3HA)

scds_timerun(3HA)

scha_calls(3HA)

scha_cluster_close(3HA)

scha_cluster_get(3HA)

scha_cluster_getlogfacility(3HA)

scha_cluster_getnodename(3HA)

scha_cluster_getnodename_zone(3HA)

scha_cluster_get_zone(3HA)

scha_cluster_getzone(3HA)

scha_cluster_open(3HA)

scha_cluster_open_zone(3HA)

scha_control(3HA)

scha_control_zone(3HA)

scha_resource_close(3HA)

scha_resource_get(3HA)

scha_resource_get_zone(3HA)

scha_resourcegroup_close(3HA)

scha_resourcegroup_get(3HA)

scha_resourcegroup_get_zone(3HA)

scha_resourcegroup_open(3HA)

scha_resourcegroup_open_zone(3HA)

scha_resource_open(3HA)

scha_resource_open_zone(3HA)

scha_resource_setstatus(3HA)

scha_resource_setstatus_zone(3HA)

scha_resourcetype_close(3HA)

scha_resourcetype_get(3HA)

scha_resourcetype_get_zone(3HA)

scha_resourcetype_open(3HA)

scha_resourcetype_open_zone(3HA)

scha_strerror(3HA)

scha_strerror_i18n(3HA)

OSC33 4

OSC33 5

OSC33 5cl

OSC33 7

OSC33 7p

Index

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 retrieve 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. These functions return 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 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(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)