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

関数の実行に成功。

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 インタフェースの安定性 発展中

関連項目

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