scds_get_rg_hostnames(3HA )

名前

scds_get_rg_hostnames, scds_get_rg_hostnames_zone - リソースグループで使用されるネットワークリソースの取得

形式

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>scha_err_t 
     scds_get_rg_hostnames(char *resourcegroup_name, 
     scds_net_resource_list_t **netresource_list);

scha_err_t scds_get_rg_hostnames_zone(char *zone_name, char *
     resourcegroup_name, scds_net_resource_list_t **netresource_list);

説明

#1405

scds_get_rg_hostnames() および scds_get_rg_hostnames_zone() 関数は、リソースグループ内のすべてのネットワークリソースによって使用されているホスト名のリストを取得します。scds_get_rg_hostnames_zone() 関数を大域ゾーンから実行すると、特定のゾーンクラスタのリソースグループからリストを取得できます。この関数は、netresource_list 内のリストへのポインタを返します。リソースグループにネットワークリソースがないか、またはネットワークリソースを使用しないリリソースが含まれる場合があり、これらの関数は NULL に設定されている netresource_list パラメータを返すことがあります。

scds_get_rg_hostnames() および scds_get_rg_hostnames_zone() には、システム内の任意のリソースグループの名前を渡すことができます。指定されたリソースグループで実行されているアプリケーションに接続するには、scds_get_rg_hostnames() および scds_get_rg_hostnames_zone() によって返されたホスト名を使用します。

この関数が割り当て、返すメモリーを解放するには、scds_free_net_list() を使用します。

パラメータ

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

resourcegroup_name

リソースグループ名です。このリソースグループのデータが取得されます。

netresource_list

リソースグループによって使用されるネットワーク資源のリスト

戻り値

scds_get_rg_hostnames() および scds_get_rg_hostnames_zone() 関数は、次の値を返します。

0

関数の実行に成功。

0 以外

関数の実行に失敗。

エラー

SCHA_ERR_NOERR

関数の実行に成功。

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

ファイル

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

インクルードファイル

/usr/cluster/lib/libdsdev.so

ライブラリ

属性

次の属性の説明は、attributes(5) を参照してください:

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

関連項目

scds_free_net_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), attributes(5)