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.

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:

See Also

scds_initialize(3HA), scha_calls(3HA), attributes(5), SUNW.HAStoragePlus(5)