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 has declared explicit dependencies on any network resources, then the hostnames correspond to those network resources. 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 to have no network resource dependencies and for its resource group to contain no 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:

See Also

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