scha_cluster_getnodename (3HA)

名前

scha_cluster_getnodename - ローカルクラスタノード名を返す

形式

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l scha#include <scha.h>scha_err_t scha_cluster_getnodename(
     char **nodename);

説明

scha_cluster_getnodename() 関数を実行すると、この関数を呼び出したクラスタノードの名前が返されます。ノード名は、必ずしも Solaris システム名と一致しているとは限りません。この関数は戻り値にエラーステータスを返すと同時に、実行に成功した場合は、ノード名の文字列を nodename 引数の指定位置に収めます。

呼び出しに失敗した場合、nodename に NULL が設定されます。scha_cluster_getnodename() 関数の呼び出し元には、標準 C ライブラリ関数の free(3C) を使用して、返される文字列に割り当てられたメモリーを解放する責任があります。メモリーの解放が必要になるのは、この関数が成功した場合だけです。

戻り値

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

0

関数の実行に成功。

0 以外

関数の実行に失敗。

エラー

SCHA_ERR_NOERR

関数の実行に成功。

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

例

使用例 1 scha_cluster_getnodename() 関数の使用例

      scha_err_t  err_code;
      char *nodename;
      err_code = scha_cluster_getnodename(&nodename);
      ...
      if (nodename != NULL) free(nodename);

ファイル

/usr/cluster/include/scha.h

インクルードファイル

/usr/cluster/lib/libscha.so

ライブラリ

属性

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

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

関連項目

free(3C), scha_calls(3HA), scha_cluster_open(3HA), scha_cluster_getzone(3HA), scha_strerror(3HA), attributes(5)