scds_get_netaddr_list

- get the network addresses 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_netaddr_list(scds_handle_t handle,

     scds_netaddr_list_t **netaddr_list);

Description

The scds_get_netaddr_list() function returns all hostname, port, and protocol combinations that are in use by the resource. These combinations are derived by combining the Port_list property settings on the resource with all the hostnames in use by the resource, as returned by the scds_get_rs_hostnames() function.

Use scds_get_netaddr_list() in a fault monitor to monitor the resource, and to derive the list of hostnames, ports, and protocols that are in use by the resource .

Values for the protocol type are defined in header file rgm/libdsdev.h.

Free the memory that is allocated and returned by this function with scds_free_netaddr_list().

Parameters

The following parameters are supported:

handle

The handle that is returned by scds_initialize()

netaddr_list

The list of hostnames, ports, and protocols that are used by the resource group

Return Values

The scds_get_netaddr_list() function returns the following values:

0

The function succeeded.

nonzero

The function failed.

Errors

SCHA_ERR_NOERR

Indicates that the function succeeded

Other values

Indicate that the function failed. See scha_calls(3HA) for the meaning of failure 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_netaddr_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), r_properties(5), attributes(5)