|Skip Navigation Links|
|Exit Print View|
|Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster|
- get status information about SUNW.HAStoragePlus resources that are used by a resource
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);
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:
Indicates that the resource does not depend on a SUNW.HAStoragePlus resource.
Indicates that at least one of the SUNW.HAStoragePlus resources on which the resource depends is located in a different resource group.
Indicates that a SUNW.HAStoragePlus resource on which the resource depends is not online on any potential primary node or zone.
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.
Indicates that all SUNW.HAStoragePlus resources on which the resource depends are online on the node or zone 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 or zone, 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.
The following parameters are supported:
Handle that is returned from scds_initialize(3HA).
Status of SUNW.HAStoragePlus resources that are used by the resource.
The function succeeded.
This value also indicates that the status code that is stored in hasp_status is valid.
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.
See attributes(5) for descriptions of the following attributes: