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


NAME

 cmm_potential_getinfo, cmm_member_getinfo - retrieve information about a peer node

SYNOPSIS

 
cc [ flag... ] file...  -lcgha_cmm  -lrt
 
#include <cmm.h>
cmm_error_t cmm_potential_getinfo (cmm_nodeid_t const nodeid, cmm_member_t * const member);
cmm_error_t cmm_member_getinfo (cmm_nodeid_t const nodeid, cmm_member_t * const member);

DESCRIPTION

The cmm_potential_getinfo() function retrieves the information contained in the cmm_member_t structure for a node identified by its nodeid. You can use cmm_potential_getinfo() to get into any peer node, even if it has the CMM_OUT_OF_CLUSTER state.

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

The cmm_member_getinfo() function retrieves the information in the cmm_member_t structure for a peer node.

If the requested membership information is temporarily unavailable the operation is retried until it succeeds or a timeout occurs.

In the case of a timeout, the CMM_ETIMEDOUT error is returned. If the nodeid specified is not in the cluster node table, a CMM_ESRCH error is returned.

PARAMETERS

The cmm_potential_getinfo() and cmm_member_getinfo() functions take the following parameters:

member

Points to the cmm_member_t structure, which contains information about the node.

nodeid

Identifies the node on which information is requested.

RETURN VALUES

The cmm_potential_getinfo() and cmm_member_getinfo() functions return one of the following values:

CMM_EAGAIN

The information might no longer be valid, as the node has been out of communication with the master node for a period of time.

CMM_EBUSY

The CMM API server is temporarily unable to respond to the requested operation. 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

The nhcmmd daemon cannot be accessed on the current node.

CMM_EINVAL

Invalid argument such as the member is a NULL pointer or invalid nodeid.

CMM_ENOCLUSTER

The calling node is not part of any cluster.

CMM_ENOTSUP

Unexpected service error. The cluster might be in a critical state.

CMM_ESRCH

Returned by the cmm_member_getinfo() function if the node is in the local cluster node table but has the CMM_OUT_OF_CLUSTER role. Returned by both cmm_potential_getinfo() and cmm_member_getinfo() functions if the node is not in the local cluster nodes table.

CMM_ETIMEDOUT

The call timeout expired before the action was completed.

CMM_OK

Operation succeeds.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhcmd
MT-LevelMT-Safe
Cancel-SafetyDeferred-Cancel-Safe Asynchronous-Cancel-Unsafe

SEE ALSO

Intro(3CMM)


Netra HAS FS 2.1Go To TopLast Changed September 2004