scds_pmf_stop (3HA)

名称

scds_pmf_stop - 终止在 PMF 控制下运行的进程

用法概要

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>
     scha_err_t scds_pmf_stop(scds_handle_t handle, scds_pmf_type_t 
     program_type, int instance, int signal, time_t timeout);

描述

scds_pmf_stop() 函数停止在 PMF 控制下运行的程序。它等同于带有 –s 选项的 pmfadm(1M) 命令。

如果请求的实例未运行，则 scds_pmf_stop() 返回值 SCHA_ERR_NOERR。

如果请求的实例正在运行，那么指定的信号将发送到该实例。如果实例无法在 80% 的超时值的时间段内终止，将向该实例发送 SIGKILL。之后，如果实例无法在 15% 的超时值的时间段内终止，则该函数将被视为已失败并返回 SCHA_ERR_TIMEOUT。剩余 5% 的超时参数假定已由此函数的开销所用。

参数

支持以下参数：

handle

从 scds_initialize(3HA) 返回的句柄

program_type

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

SCDS_PMF_TYPE_SVC

数据服务应用程序

SCDS_PMF_TYPE_MON

故障监视器

SCDS_PMF_TYPE_OTHER

其他

instance

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

signal

要发送以终止实例的 Solaris 信号。请参见 signal(3HEAD)。如果指定的信号无法终止实例，则使用 SIGKILL。

timeout

超时时间（秒）。

返回值

scds_pmf_stop() 函数返回以下值：

0

该函数成功。

non-zero

该函数失败。

错误

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), scds_pmf_start(3HA), scha_calls(3HA), signal(3HEAD), attributes(5)