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 是否为区域群集名称。
将指向返回的节点名称字符串的输出参数。
该函数成功。
有关其他错误代码的描述,请参见 scha_calls(3HA)。
头文件
库
有关以下属性的描述,请参见 attributes(5):
|
scds_calls(3HA)、scds_is_zone_cluster(3HA)、scha_calls(3HA)、scha_strerror(3HA)、attributes(5)