scds_fm_sleep(3HA)

名称

scds_fm_sleep - 等待故障监视器控制套接字上发送的消息

用法概要

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

描述

scds_fm_sleep() 函数等待在进程监视器工具控制下运行的数据服务应用程序进程树停止。如果在指定的超时时间段内未发生此类停止，该函数将返回 SCHA_ERR_NOERR。

如果发生数据服务应用程序进程树停止，则 scds_fm_sleep() 会在失败历史记录中记录 SCDS_COMPLETE_FAILURE，并重新启动进程树或根据 scds_fm_action(3HA) 手册页中所述的算法对其进行故障转移。如果故障转移尝试不成功，则会尝试重新启动应用程序。

如果尝试重新启动失败，该函数将返回 SCHA_ERR_INTERNAL 。

请注意，如果失败历史记录引发此函数执行故障转移，且故障转移尝试成功，则 scds_fm_sleep() 永不会返回。

参数

支持以下参数：

handle

从 scds_initialize(3HA) 返回的句柄。

timeout

以秒为单位度量的超时时间段。

返回值

scds_fm_sleep() 函数返回以下值：

0

该函数成功。

非零值

该函数失败。

错误

SCHA_ERR_NOERR

表明进程树尚未停止。

SCHA_ERR_INTERNAL

表明数据服务应用程序进程树已停止，且无法重新启动。

其他值

表明函数执行失败。有关失败代码的含义，请参见 scha_calls(3HA)。

文件

/usr/cluster/include/rgm/libdsdev.h

头文件

/usr/cluster/lib/libdsdev.so

库

属性

有关以下属性的描述，请参见 attributes(5)：

属性类型 属性值 可用性 ha-cluster/developer/api 接口稳定性 Evolving（发展中）

另请参见

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