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_potential_getinfo(3CMM)

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

## NAME

> cmm_potential_getinfo, cmm_member_getinfo - retrieve information about a peer node

## SYNOPSIS

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

>     #include <cmm.h>

> `cmm_error_t cmm_potential_getinfo (cmm_nodeid_t const nodeid, cmm_member_t * const member);`
> `cmm_error_t cmm_member_getinfo (cmm_nodeid_t const nodeid, cmm_member_t * const member);`

## DESCRIPTION

> The cmm_potential_getinfo() function retrieves the information contained in the `cmm_member_t` structure for a node identified by its nodeid. You can use cmm_potential_getinfo() to get into any peer node, even if it has the `CMM_OUT_OF_CLUSTER` state.

> See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information about the `cmm_member_t` structure.

> The cmm_member_getinfo() function retrieves the information in the `cmm_member_t` structure for a peer node.

> If the requested membership information is temporarily unavailable the operation is retried until it succeeds or a timeout occurs.

> In the case of a timeout, the `CMM_ETIMEDOUT` error is returned. If the nodeid specified is not in the cluster node table, a `CMM_ESRCH` error is returned.

## PARAMETERS

> The cmm_potential_getinfo() and cmm_member_getinfo() functions take the following parameters:

> member

>   Points to the `cmm_member_t` structure, which contains information about the node.

> nodeid

>   Identifies the node on which information is requested.

## RETURN VALUES

> The cmm_potential_getinfo() and cmm_member_getinfo() functions return one of the following values:

> `CMM_EAGAIN`

>   The information might no longer be valid, as the node has been out of communication with the master node for a period of time.

> `CMM_EBUSY`

>   The CMM API server is temporarily unable to respond to the requested operation. 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`

>   The `nhcmmd` daemon cannot be accessed on the current node.

> `CMM_EINVAL`

>   Invalid argument such as the member is a `NULL` pointer or invalid `nodeid`.

> `CMM_ENOCLUSTER`

>   The calling node is not part of any cluster.

> `CMM_ENOTSUP`

>   Unexpected service error. The cluster might be in a critical state.

> `CMM_ESRCH`

>   Returned by the cmm_member_getinfo() function if the node is in the local cluster node table but has the `CMM_OUT_OF_CLUSTER` role. Returned by both cmm_potential_getinfo() and cmm_member_getinfo() functions if the node is not in the local cluster nodes table.

> `CMM_ETIMEDOUT`

>   The call timeout expired before the action was completed.

> `CMM_OK`

>   Operation succeeds.

## ATTRIBUTES

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

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

## SEE ALSO

> `Intro`(3CMM)

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.