Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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()`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`(5) 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`(5)

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |