sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Program Interface | cmm_node_getid(3CMM)

- NAME
- SYNOPSIS
- DESCRIPTION
- RETURN VALUES
- ATTRIBUTES
- SEE ALSO

## NAME

> cmm_node_getid - retrieve ID of a node

## SYNOPSIS

>     cc [ flag... ] file...  -lcgha_cmm  -lrt

>     #include <cmm.h>

> `cmm_error_t cmm_node_getid (cmm_nodeid_t * const me);`

## DESCRIPTION

> The cmm_node_getid() function retrieves a nodeid. This value is accessible even if no master is currently elected. Using the nodeid, the node can retrieve information on its status in the cluster.

> The me parameter is a pointer to a `cmm_nodeid_t` structure. If an error occurs, me contains `CMM_INVALID_NODE_ID` and the returned value shows the cause of the error.

> Note – This function is not related to cluster information and so it can be called from any peer node, even a node with the `CMM_OUT_OF_CLUSTER` state.

## RETURN VALUES

> The cmm_node_getid() function returns one of the following values:

> `CMM_EBUSY`

>   The CMM API server is temporarily out of resources to respond to the requested operation. The recommended action is to wait a short time and retry the operation. The length of the waiting must be decided by the user, depending on the application's characteristics.

> `CMM_ECONN`

>   No `nhcmmd`(1M) is accessible on the current node.

> `CMM_EINVAL`

>   Invalid parameter. me is a `NULL` pointer.

> `CMM_ENOTSUP`

>   An unexpected service error occurred. The cluster might be in a critical state.

> `CMM_ETIMEDOUT`

>   The call timeout expired before the action was completed.

> `CMM_OK`

>   Operation succeeds.

> This call never returns `CMM_ENOCLUSTER`.

## ATTRIBUTES

> See `attributes`(5) for descriptions of the following attributes:

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhcmd
> Interface Stability | Evolving
> MT-Level | MT-Safe
> Cancel-Safety | Deferred-Cancel-Safe Asynchronous-Cancel-Unsafe

## SEE ALSO

> `Intro`(3CMM), `nhcmmd`(1M)

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.