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


NAME

 cmm_node_getid - retrieve ID of a node

SYNOPSIS

 
cc [ flag... ] file...  -lcgha_cmm  -lrt
 
#include <cmm.h>
cmm_error_t cmm_node_getid (cmm_nodeid_t * const me);

DESCRIPTION

The cmm_node_getid() function retrieves a nodeid. This value is accessible even if no master is currently elected. Using the nodeid, the node can retrieve information on its status in the cluster.

The me parameter is a pointer to a cmm_nodeid_t structure. If an error occurs, me contains CMM_INVALID_NODE_ID and the returned value shows the cause of the error.

Note – This function is not related to cluster information and so it can be called from any peer node, even a node with the CMM_OUT_OF_CLUSTER state.

RETURN VALUES

The cmm_node_getid() function returns one of the following values:

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(1M) is accessible on the current node.

CMM_EINVAL

Invalid parameter. me is a NULL pointer.

CMM_ENOTSUP

An unexpected service error occurred. The cluster might be in a critical state.

CMM_ETIMEDOUT

The call timeout expired before the action was completed.

CMM_OK

Operation succeeds.

This call never returns CMM_ENOCLUSTER.

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), nhcmmd(1M)


Netra HAS FS 2.1Go To TopLast Changed September 2004