scds_pmf_signal (3HA)

名称

scds_pmf_signal - 将信号发送到由 PMF 控制的进程树

用法概要

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

描述

scds_pmf_signal() 函数将指定信号发送到在 PMF 控制下运行的进程树。此函数等同于带有 –k 选项的 pmfadm(1M) 命令。

发送信号后，scds_pmf_signal() 函数在返回之前将等候指定的超时时间，以待进程树终止。timeout 的值 0 指示函数立即返回，不等待任何进程退出。值 -1 指示函数无限期地等待进程退出。

参数

支持以下参数：

handle

从 scds_initialize() 返回的句柄

program_type

要执行的程序类型。有效类型为：

SCDS_PMF_TYPE_SVC

数据服务应用程序

SCDS_PMF_TYPE_MON

故障监视器

SCDS_PMF_TYPE_OTHER

其他

instance

对于具有多个实例的资源，该从 0 开始的整数可以唯一标识实例。对于单实例资源，请使用 0。

signal

要发送的 Solaris 信号。请参见 signal(3HEAD)。

timeout

超时时间（秒）。

返回值

scds_pmf_signal() 函数返回以下值：

0

该函数成功。

非零值

该函数失败。

错误

SCHA_ERR_TIMEOUT

发送信号后，进程树未在指定超时时间内退出。

SCHA_ERR_NOERR

该函数成功。

其他值

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

文件

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

头文件

/usr/cluster/lib/libdsdev.so

库

属性

有关下列属性的说明，请参见 attributes(5)：

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

另请参见

pmfadm(1M), scds_initialize(3HA), scha_calls(3HA), signal(3HEAD), attributes(5)