scha_cluster_getzone - return name of zone
cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib –l scha#include <scha.h>scha_err_t scha_cluster_getzone( char **zonename);
The scha_cluster_getzone() function returns a string that identifies the global or non-global zone from which the function is called.
If you call this function in the global zone, the global-cluster node name is returned.
If you call this function from a zone-cluster node, the zone-cluster node name is returned.
The node name is not necessarily the same as the Oracle Solaris system name.
The function returns an error status. If successful, the function also returns a string that contains the node name and the zone name in the location that is pointed to by the zonename argument.
If the call fails, the zonename argument is set to NULL. The caller of scha_cluster_getzone() is responsible for freeing the memory that is allocated for the returned string by using the standard C library function free(3C). Freeing the memory is required only if the function succeeds.
The scha_cluster_getzone() function returns the following values:
The function succeeded.
The function failed.
The function succeeded.
See scha_calls(3HA) for a description of other error codes.
scha_err_t err_code; char *zonename; err_code = scha_cluster_getzone(&zonename); ... if (zonename != NULL) free(zonename);
Include file
Library
See attributes(7) for descriptions of the following attributes:
|
free(3C), scha_calls(3HA), scha_cluster_getnodename(3HA), scha_cluster_open(3HA), scha_strerror(3HA), attributes(7)