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

该函数成功。

非零值

该函数失败。

错误

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 接口稳定性 Evolving（发展中）

另请参见

free(3C)、scha_calls(3HA)、scha_cluster_get(3HA)、scha_cluster_getzone(3HA)、scha_strerror(3HA)、attributes(5)