Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

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

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | ha-cluster/developer/api
Interface Stability | Evolving

## See Also

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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |