scds_get_fullname_nodeid(3HA)

名前

scds_get_fullname, scds_get_fullname_nodeid - ゾーンのノード名へのポインタの取得。

形式

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>scha_err_t scds_get_fullname(
     const char *zonename, char **fullname,boolean_t is_zone_cluster);

scha_err_t scds_get_fullname_nodeid(const char *zonename, 
     char **fullname,boolean_t is_zone_cluster);

説明

scds_get_fullname() 関数はゾーンのノード名を fullname で返します。scds_get_fullname_nodeid() 関数は、ノード名の代わりに ASCII ノード ID 番号を付けてゾーンのノード名を返します。呼び出し元は、fullname で指定されたメモリーを解放する責任があります。

is_zone_cluster が true の場合、zonename はローカルホストのゾーンクラスタの名前を提供します。返される値はローカルホストのゾーンクラスタノード名です。

is_zone_cluster を false に設定することは、Oracle Solaris Cluster 3.3 リリースバージョンにのみ適用できます。現時点では、それは Oracle Solaris Cluster 4.x リリースでは使用されません。

zonename の値は NULL 以外である必要があり、そうでない場合は SCHA_ERR_INVAL が返されて、fullname の値は変更されません。

ゾーンクラスタノードに対して (is_zone_cluster を true に設定した場合)、scds_get_fullname によって返される fullname 値の例を次に示します。

"zcnode1"

zcnode1 のノード ID 番号が 2 の場合、対応する scds_get_fullname_nodeid の出力は、次のようになります。

"2"

パラメータ

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

zonename

ゾーンクラスタまたはグローバルクラスタの非大域ゾーンの名前を提供します。

is_zone_cluster

zonename がゾーンクラスタ名かどうかを示します。

fullname

返されるノード名文字列を指定する出力パラメータ。

エラー

SCHA_ERR_NOERR

関数の実行に成功。

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

ファイル

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

インクルードファイル

/usr/cluster/lib/libdsdev.so

ライブラリ

属性

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

属性タイプ 属性値 使用条件 SUNWscdev インタフェースの安定性 発展中

関連項目

scds_calls(3HA), scds_is_zone_cluster(3HA), scha_calls(3HA), scha_strerror(3HA), attributes(5)