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 nodenamein 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.

If is_zone_cluster is false, zonename provides the name of a non-global native-brand zone on the local host. The returned value is of the form nodename:zonename, where nodename is the global-cluster nodename of the local host, and zonename is the passed-in zonename.

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"

An example of a fullname value that is returned by scds_get_fullname for a zone node in the global cluster (with is_zone_cluster set to false) is:

"node1:zoneA"

The corresponding output from scds_get_fullname_nodeid is:

"2:zoneA"

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:

See Also

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