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

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

## NAME

> cmm_member_isdesynchronized, cmm_member_isdisqualified, cmm_member_iseligible, cmm_member_isexcluded, cmm_member_isfrozen, cmm_member_ismaster, cmm_member_isoutofcluster, cmm_member_isqualified, cmm_member_isvicemaster - interpret the status of a member

## SYNOPSIS

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

>     #include <cmm.h>

> `int cmm_member_isdesynchronized(cmm_member_t const * member);`
> `int cmm_member_isdisqualified(cmm_member_t const * member);`
> `int cmm_member_iseligible(cmm_member_t const * member);`
> `int cmm_member_isexcluded(cmm_member_t const * member);`
> `int cmm_member_isfrozen(cmm_member_t const * member);`
> `int cmm_member_ismaster(cmm_member_t const * member);`
> `int cmm_member_isoutofcluster(cmm_member_t const * member);`
> `int cmm_member_isqualified(cmm_member_t const * member);`
> `int cmm_member_isvicemaster(cmm_member_t const * member);`

## DESCRIPTION

> These functions enable an application to obtain the status of a peer node. The status information provided includes the membership attributes and role of the cluster as defined in the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide.

## PARAMETERS

> The cmm_member_is*() function takes the following parameter:

> member

>   A pointer to a member structure that contains the member's information, such as a structure filled by `cmm_member_getinfo`(3CMM).

## EXTENDED DESCRIPTION

> The information provided by the cmm_member_is*() functions is as follows:

> cmm_member_isdesynchronized()

>   The node is desynchronized if !=0 is returned. The desynchronization flag is set for this node. For the master, !=0 means that it owns the only up-to-date disk; the disks on all other nodes are stale. Remember to check the eligibility of this node to determine if it is a potential master.

> cmm_member_isdisqualified()

>   The node is disqualified if !=0 is returned. A node can be disqualified by sending a call to cmm_member_setqualif() to set the flag `CMM_MEMBER_DISQUALIFIED`. Check the eligibility of the node to verify that it can become master.

> cmm_member_iseligible()

>   The node is a master-eligible node if !=0 is returned.

> cmm_member_isexcluded()

>   The node is excluded if !=0 is returned.

> cmm_member_isfrozen()

>   The node is frozen if !=0 is returned.

> cmm_member_ismaster()

>   The node is the master node if !=0 is returned.

> cmm_member_isoutofcluster()

>   The node is not currently participating in cluster services.

> cmm_member_isqualified()

>   The node is qualified if !=0 is returned.

> cmm_member_isvicemaster()

>   The node is the vice-master if !=0 is returned.

> Note – !=0 is returned if, and only if, the node is neither disqualified nor desynchronized. A diskless node can also have this state. Check the eligibility of the node.

## RETURN VALUES

> The cmm_member_is*() functions return one of the following values:

> `TRUE` (!=0)

>   Condition is verified.

> `FALSE` (==0)

>   Condition is not satisfied.

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