scha_cluster_getnodename

- return name of local cluster node

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 necessarily 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:

See Also

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