Go to main content

Oracle Solaris Cluster 4.3 Reference Manual

Exit Print View

Updated: September 2015
 
 

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
ha-cluster/developer/api
Interface Stability
Evolving

See Also

scha_calls(3HA), scds_fm_action(3HA), scds_initialize(3HA), attributes (5)