Home | History | Annotate | Download | only in man3ha
 te
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License"). 
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
 Copyright 2008 Sun Microsystems, Inc. All
 rights reserved. Use is subject to license terms.
 scds_get_netaddr_list 3HA "13 Aug 2008" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"
 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:


.na
handle
.ad


The handle that is returned by scds_initialize()





.na
netaddr_list
.ad


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:


.na
0
.ad


The function succeeded.





.na
nonzero
.ad


The function failed.




 ERRORS

.na
SCHA_ERR_NOERR
.ad


Indicates that the function succeeded





.na
Other values
.ad


Indicate that the function failed. See scha_calls(3HA) for the meaning of failure
codes.




 FILES

.na
/usr/cluster/include/rgm/libdsdev.h
.ad


Include file





.na
/usr/cluster/lib/libdsdev.so
.ad


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)