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);
The scds_get_fullname () function returns the zone nodename in fullname. The scds_get_fullname_nodeid() function returns the zone nodename with the ASCII node ID number in place of the node name. The caller is responsible for freeing the memory pointed to by fullname.
If is_zone_cluster is true, zonename provides the name of a zone cluster on the local host; the returned value is the zone-cluster nodename for the local host.
Setting is_zone_cluster to false is applicable only on Oracle Solaris Cluster 3.3 release versions. It is not currently used on Oracle Solaris Cluster 4.x releases.
The value of zonename must be non-NULL; otherwise, SCHA_ERR_INVAL is returned and the value of fullname is unchanged.
An example of a fullname value that is returned by scds_get_fullname for a zone-cluster node (with is_zone_cluster set to true) is:
If zcnode1 has a node ID number of 2, the corresponding output of scds_get_fullname_nodeid is:
The following parameters are supported:
Provides the name of a zone cluster or a global-cluster non-global zone.
Indicates whether zonename is a zone cluster name.
Out-parameter which will point to the returned nodename string.
The function succeeded.
See scha_calls(3HA) for a description of other error codes.
See attributes(7) for descriptions of the following attributes: