|
|
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)