scds_get_fullname(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 的值不变。

下例显示了 scds_get_fullname 为区域群集节点（is_zone_cluster 设置为 true）返回的 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 接口稳定性 Evolving（发展中）

另请参见

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