 |
|
|
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);
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.
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).
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.
The cmm_member_is*() functions return one of the
following values:
-
TRUE (!=0)
-
Condition is verified.
-
FALSE (==0)
-
Condition is not satisfied.
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 |
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.
|