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


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 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