scds_fm_sleep(3HA) Sun Cluster HA and Data Services scds_fm_sleep(3HA)
NAME
scds_fm_sleep - wait for a message on a fault monitor control socket
SYNOPSIS
cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib -l dsdev
#include <rgm/libdsdev.h>
scha_err_t scds_fm_sleep(scds_handle_t handle, time_t timeout
DESCRIPTION
Thescds_fm_sleep() function waits for a data service application process tree that running under control of the process monitor facility to
die. If no such death occurs within the specified timeout period, the function returns SCHA_ERR_NOERR.
If a data service application process tree death occurs, scds_fm_sleep() records SCDS_COMPLETE_FAILURE in the failure history and either
restarts the process tree or fails it over according to the algorithm described in the scds_fm_action(3HA) man page. If a failover attempt
is unsuccessful, a restart of the application is attempted.
If an attempted restart fails, the function returns SCHA_ERR_INTERNAL.
Note that if the failure history causes this function to do a failover, and the failover attempt succeeds, scds_fm_sleep() never returns.
PARAMETERS
The following parameters are supported:
handle The handle returned from scds_initialize(3HA).
timeout The timeout period measured in seconds.
RETURN VALUES
The scds_fm_sleep() function returns the following:
0 The function succeeded.
nonzero The function failed.
ERRORS
SCHA_ERR_NOERR Indicates that the process tree has not died.
SCHA_ERR_INTERNAL Indicates that the data service application process tree has died and failed to restart.
Other values Indicate the function failed. See scha_calls(3HA) for the meaning of failure 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 |SUNWscdev |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO
scha_calls(3HA), scds_fm_action(3HA), scds_initialize(3HA), attributes(5)
Sun Cluster 3.2 7 Sep 2007 scds_fm_sleep(3HA)