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

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

## NAME

> cmm_master_getinfo, cmm_vicemaster_getinfo - retrieve information about the master node or the vice-master node

## SYNOPSIS

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

>     #include <cmm.h>

> `cmm_error_t cmm_master_getinfo(cmm_member_t * const member);`
> `cmm_error_t cmm_vicemaster_getinfo(cmm_member_t * const member);`

## DESCRIPTION

> The cmm_master_getinfo() function returns information about the current master node. The cmm_vicemaster_getinfo() function returns information about the current vice-master node. The information returned by these two functions has the same type and meaning as that returned by the cmm_member_getinfo() function.

> The member parameter is a pointer to a member structure where the function stores the member's information, such as its current state.

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

## RETURN VALUES

> The cmm_master_getinfo() and cmm_vicemaster_getinfo() functions return one of the following values:

> `CMM_EAGAIN`

>   The information might be deprecated, because a node has been out of communication with the master node for a period of time.

> `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` is currently accessible on the local node.

> `CMM_EINVAL`

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

> `CMM_ENOCLUSTER`

>   The calling node is not yet in a cluster.

> `CMM_ENOTSUP`

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

> `CMM_ESRCH`

>   No such member. This return value is only applicable for the vice-master node.

> `CMM_ETIMEDOUT`

>   The call timeout expired before the action was completed.

> `CMM_OK`

>   Operation succeeds.

## RETURN VALUES

> 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), `cmm_member_getinfo`(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.