opensolaris man page for scha_cluster_getnodename

scha_cluster_getnodename(3HA)				 Sun Cluster HA and Data Services			     scha_cluster_getnodename(3HA)

NAME
       scha_cluster_getnodename - local cluster node name access function

SYNOPSIS
       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  scha
       #include <scha.h>

	scha_err_t scha_cluster_getnodename(char **nodename);

DESCRIPTION
       The  scha_cluster_getnodename()	function returns the name of the cluster node on which the function is called. The node name is not neces-
       sarily the same as the Solaris system name. The function returns an error status, and if successful, a string that contains the	node  name
       in the location that is pointed to by the nodename argument.

       If  the	call  fails,  the  nodename is set to NULL. The caller of scha_cluster_getnodename() 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.

RETURN VALUES
       The scha_cluster_getnodename() function returns the following values:

       0		   The function succeeded.

       nonzero		   The function failed.

ERRORS
       SCHA_ERR_NOERR			   Function succeeded.

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

EXAMPLES
       Example 1 Using the scha_cluster_getnodename() Function

	       scha_err_t  err_code;
	      char *nodename;
	      err_code = scha_cluster_getnodename(&nodename);
	      ...
	      if (nodename != NULL) free(nodename);

FILES
       /usr/cluster/include/scha.h	   Include file

       /usr/cluster/lib/libscha.so	   Library

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       free(3C), scha_calls(3HA), scha_cluster_get(3HA), scha_cluster_getzone(3HA), scha_strerror(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007					     scha_cluster_getnodename(3HA)