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

Search Scope:

- This Document
- Entire Library

### scds_hasp_check

- get status information about `SUNW.HAStoragePlus` resources that are 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_hasp_check(scds_handle_t handle, scds_hasp_status_t *hasp_status);

## Description

The `scds_hasp_check()` function retrieves status information about `SUNW.HAStoragePlus`(5) resources that are used by a resource. This information is obtained from the state, online or otherwise, of all `SUNW.HAStoragePlus` resources on which the resource depends. This state is obtained by using the `Resource_dependencies` or `Resource_dependencies_weak` system properties that are defined for the resource.

Resource type implementations can use `scds_hasp_check()` in `VALIDATE` and `MONITOR_CHECK` method callback implementations to determine whether checks that are specific to any file systems that are managed by `SUNW.HAStoragePlus` resources should be carried out.

Resource dependencies are only checked within the same cluster context in which the function is executed, either global cluster or zone cluster. Dependencies of the form `clustername:resourcename` (inter-cluster dependencies) are ignored. For example, if the only HAStoragePlus dependency is an inter-cluster dependency, the function returns the status code `SCDS_HASP_NO_RESOURCE`.

When the function succeeds, a status code is stored in hasp_status. This code can be one of the following values:

`SCDS_HASP_NO_RESOURCE`

  Indicates that the resource does not depend on a `SUNW.HAStoragePlus` resource.

`SCDS_HASP_ERR_CONFIG`

  Indicates that at least one of the `SUNW.HAStoragePlus` resources on which the resource depends is located in a different resource group.

`SCDS_HASP_NOT_ONLINE`

  Indicates that a `SUNW.HAStoragePlus` resource on which the resource depends is not online on any potential primary node.

`SCDS_HASP_ONLINE_NOT_LOCAL`

  Indicates that at least one `SUNW.HAStoragePlus` resource on which the resource depends is online, but on another node from which this function is called.

`SCDS_HASP_ONLINE_LOCAL`

  Indicates that all `SUNW.HAStoragePlus` resources on which the resource depends are online on the node from which this function is called.

Note - The preceding status codes have precedence over each other in the order in which they appear. For example, if a `SUNW.HAStoragePlus` resource is not online and another `SUNW.HAStoragePlus` resource is online on a different node, the status code is set to `SCDS_HASP_NOT_ONLINE` rather than `SCDS_HASP_ONLINE_NOT_LOCAL`.

The `scds_hasp_check()` function ignores all `SUNW.HAStoragePlus` resources for which the `FilesystemMountPoints` or `Zpools` property is set to an empty list, the default.

## Parameters

The following parameters are supported:

handle

  Handle that is returned from `scds_initialize`(3HA).

hasp_status

  Status of `SUNW.HAStoragePlus` resources that are used by the resource.

## Return Values

`SCHA_ERR_NOERR`

  The function succeeded.

  This value also indicates that the status code that is stored in `hasp_status` is valid.

`SCHA_ERR_INTERNAL`

  The function failed.

  The value that is stored in `hasp_status` is undefined. Ignore this undefined value.

See the `scha_calls`(3HA) man page for a description of other error 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_initialize`(3HA), `scha_calls`(3HA), `attributes`(5), `SUNW.HAStoragePlus`(5)

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