Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Sun Cluster HA and Data Servicesscds_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-protocol combination 3-tuples in use by the resource. This is computed by combining the Port_list property settings on the resource in conjunction with all the settings on the resource in conjunction with all the hostnames in use by the resource as returned by the scds_get_rs_hostnames() function.

If the Port_list property for the resource specifies a hostname/port/for the resource specifies a hostname/port/protocol 3-tuple, this 3-tuple is returned by scds_get_netaddr_list(). If the hostname is omitted for a port/protocol combination, a hostname-port-protocol 3-tuple is computed for each hostname returned by scds_get_rs_hostnames() and the specified port/protocol combination specified.

Use scds_get_netaddr_list() in a fault monitor to compute the list of hostname-port-protocol 3-tuples in use by the resource and to monitor the resource for all such 3-tuples.

Values for the protocol type are defined in header file <netinet/in.h>.

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


PARAMETERS

 

The following parameters are supported:

handle
The handle returned from scds_initialize()
netaddr_list
List of hostname-port-protocol 3-tuples used by the resource group


RETURN VALUES

 

The scds_get_netaddr_list() function returns the following:

0
The function succeeded.
non-zero
The function failed.

ERRORS

 
SCHA_ERR_NOERR
Indicates the function succeeded
Other values
Indicate the function failed. See scha_calls(3HA) for the meaning of failure codes.

FILES

 
/usr/cluster/include/libdsdev.h
Include file
/usr/cluster/lib/libdsdev.so
Library

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving

SEE ALSO

 

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



Sun Cluster 3.1Go To TopLast Changed 19 Jun 2002