scds_get_rs_hostnames (3HA)

Name

scds_get_rs_hostnames - get the network resources used by a resource

Synopsis

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>
     scha_err_t scds_get_rs_hostnames(scds_handle_t 
     handle,scds_net_resource_list_t **netresource_list);

Description

The scds_get_rs_hostnames() function retrieves a list of hostnames used by the resource. If the resource property Network_resources_used is set, then the hostnames correspond to the network resources listed in Network_resources_used. Otherwise, they correspond to all the network resources in the resource group containing the resource.

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.

Free the memory allocated and returned by this function with scds_free_net_list(3HA).

Parameters

The following parameters are supported

handle

The handle returned from scds_initialize(3HA)

netresource_list

List of network resources used by the resource group

Return Values

The scds_get_rs_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 TYPE ATTRIBUTE VALUE Availability ha-cluster/developer/api Interface Stability Evolving

See also

scds_free_net_list(3HA), scds_get_rg_hostnames(3HA), scds_initialize(3HA), scha_calls(3HA), attributes (5) , r_properties(5)