scds_get_fullname_nodeid(3HA)

Name

scds_get_fullname, scds_get_fullname_nodeid - retrieve a pointer to the zone nodename.

Synopsis

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);

Description

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:

"zcnode1"

If zcnode1 has a node ID number of 2, the corresponding output of scds_get_fullname_nodeid is:

"2"

Parameters

The following parameters are supported:

zonename

Provides the name of a zone cluster or a global-cluster non-global zone.

is_zone_cluster

Indicates whether zonename is a zone cluster name.

fullname

Out-parameter which will point to the returned nodename string.

Errors

SCHA_ERR_NOERR

The function succeeded.

See scha_calls(3HA) for a description of other error codes.

Files

/usr/cluster/include/rgm/libdsdev.h

Include file

/usr/cluster/lib/libdsdev.so

Library

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability SUNWscdev Interface Stability Evolving

See also

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