NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | FILES | ATTRIBUTES | SEE ALSO
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 resources used by a resource. This information is obtained from the state, online or otherwise, of all SUNW.HAStoragePlus resources that the resource depends upon using Resource_dependencies or Resource_dependencies_weak system properties defined for the resource.
Resource Type implementations can use scds_hasp_check() in VALIDATE and MONITOR_CHECK method callback implementation to ascertain whether checks specific to any filesystems that are managed by SUNW.HAStoragePlus resources, should be carried out or not.
When the function succeeds, a status code is stored in hasp_status. This code can be one of the following:
This indicates there is no SUNW.HAStoragePlus resource that this resource depends on.
Indicates that at least one of the SUNW.HAStoragePlus resource is in a different resource group then the current resource.
This indicates there is at least one SUNW.HAStoragePlus resource, that this resource depends on, which is not online on any potential primary node for this resource.
This indicates there is at least one SUNW.HAStoragePlus resource that this resource depends on, that is online on a different cluster node, that is, it. is not online on the cluster node where this function call is made.
This indicates that all SUNW.HAStoragePlus resources that this resource depends on are online on the node which called scds_hasp_check().
These status codes have precedence over each other in the order in which they have been listed above. For example, if there is an SUNW.HAStoragePlus resource not online and another SUNW.HAStoragePlus resource online on a different node, the status code will be set to SCDS_HASP_NOT_ONLINE rather than SCDS_HASP_ONLINE_NOT_LOCAL.
All SUNW.HAStoragePlus resources who have their extension property FilesystemMountPoints set to empty, are ignored by scds_hasp_check().
The following parameters are supported:
The handle returned from scds_initialize(3HA)
Status of SUNW.HAStoragePlus resources used by the resource
The scds_hasp_check() function returns the following:
The function succeeded
The function failed
Indicates the function succeeded and the status code stored in hasp_status is valid
Indicates the function failed. Value stored in hasp_status is undefined and should be ignored.
See scha_calls(3HA) for a description of other error codes.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWscdev |
Interface Stability |
Evolving |
NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | FILES | ATTRIBUTES | SEE ALSO