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.

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 or zone.

SCDS_HASP_ONLINE_NOT_LOCAL

Indicates that at least one SUNW.HAStoragePlus resource on which the resource depends is online, but on another node or zone 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 or zone 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)