scds_get_netaddr_list (3HA)

Name

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.

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability ha-cluster/developer/api Interface Stability Evolving

See also

scds_free_netaddr_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), r_properties(5), attributes (5)