Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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)

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |