Cross Reference: /ohac/man/man3ha/scds_get_rs_hostnames.3ha

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_rs_hostnames 3HA "13 Aug 2008" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"

NAME

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 property Network_resources_used is set, then the hostnames correspond to the network resources listed in Network_resources_used. 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 group to contain no network resources or to contain resources that do not use 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

.na handle .ad The handle returned from scds_initialize(3HA)

.na netresource_list .ad List of network resources used by the resource group

RETURN VALUES

The scds_get_rs_hostnames() function returns the following:

.na 0 .ad The function succeeded

.na non-zero .ad The function failed

ERRORS

.na SCHA_ERR_NOERR .ad Function succeeded.

See scha_calls(3HA) for a description of other error 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 TYPE	ATTRIBUTE VALUE
Availability	SUNWscdev
Interface Stability	Evolving

SEE ALSO

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