Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

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


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 TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhcmd
Interface StabilityEvolving
MT-LevelMT-Safe
Cancel-SafetyDeferred-Cancel-Safe Asynchronous-Cancel-Unsafe

SEE ALSO

Intro(3CMM), cmm_member_getinfo(3CMM)


Netra HAS FS 2.1Go To TopLast Changed September 2004