Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

scds_fm_sleep(3ha) [opensolaris man page]

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)

Check Out this Related Man Page

scds_pmf_signal(3HA)					 Sun Cluster HA and Data Services				      scds_pmf_signal(3HA)

NAME
scds_pmf_signal - send a signal to a process tree under PMF control SYNOPSIS
cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib -l dsdev #include <rgm/libdsdev.h> scha_err_t scds_pmf_signal(scds_handle_t handle, scds_pmf_type_t program_type, int instance, int signal, time_t timeout DESCRIPTION
The scds_pmf_signal() function sends the specified signal to a process tree running under PMF control. This function is equivalent to the pmfadm(1M) command with the -k option. After sending the signal, the scds_pmf_signal() function waits for the specified timeout period for the process tree to die, before return- ing. A value of 0 for timeout tells the function to return immediately without waiting for any process to exit. A value of -1 tells the function to wait indefintely for the processes to exit. PARAMETERS
The following parameters are supported: handle The handle returned from scds_initialize() program_type Type of program to execute. Valid types are: SCDS_PMF_TYPE_SVC Data service application SCDS_PMF_TYPE_MON Fault monitor SCDS_PMF_TYPE_OTHER Other instance For resources with multiple instances, this integer, starting at 0, uniquely identifies the instance. For single instance resources, use 0. signal Solaris signal to send. See signal(3HEAD). timeout Timeout period in seconds. RETURN VALUES
The scds_pmf_signal() function returns the following: 0 The function succeeded. non-zero The function failed. ERRORS
SCHA_ERR_TIMEOUT The process tree did not exit within the specified timeout period after the signal was sent. SCHA_ERR_NOERR The function succeeded. 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
pmfadm(1M), scds_initialize(3HA), scha_calls(3HA), signal(3HEAD), attributes(5) Sun Cluster 3.2 7 Sep 2007 scds_pmf_signal(3HA)
Man Page