scds_simple_probe (3HA)

名前

scds_simple_probe - アプリケーションとの TCP 接続を確立し、終了することによる検証

形式

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>
     scha_err_t scds_simple_probe(scds_handle_t handle, const char *hostname, 
     int port, time_t timeout);

説明

scds_simple_probe() 関数は、connect(3SOCKET) および close(2) のラッパー関数で、タイムアウト時間内に実行されます。

scds_get_rg_hostnames(3HA ) と scds_get_rs_hostnames(3HA) のどちらかを使用して hostname を取得します。

この関数の代わりに scds_simple_net_probe(3HA) の使用を検討します。

パラメータ

次のパラメータがサポートされます。

handle

scds_initialize(3HA) から返されるハンドルです。

hostname

接続先のマシンのインターネットホスト名です。

port

接続を行うポート番号です。

timeout

正常に接続が完了するまで待機するタイムアウト値 (秒) です。

戻り値

scds_simple_probe() 関数の戻り値は次のとおりです。

0

関数の実行に成功。

0 以外

関数の実行に失敗。

エラー

SCHA_ERR_NOERR

関数が正常に終了。

SCHA_ERR_TIMEOUT

関数がタイムアウト。

その他のエラーコードについては、scha_calls(3HA) を参照してください。

ファイル

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

インクルードファイル

/usr/cluster/lib/libdsdev.so

ライブラリ

属性

次の属性については、attributes(5) を参照してください。

属性タイプ 属性値 使用条件 ha-cluster/developer/api インタフェースの安定性 非推奨

関連項目

close(2), connect(3SOCKET), scds_fm_net_connect(3HA), scds_fm_net_disconnect(3HA), scds_get_rg_hostnames(3HA ), scds_get_rs_hostnames(3HA), scds_initialize(3HA), scds_simple_net_probe(3HA), scha_calls(3HA), attributes(5)