Manpage of LIBCLUSTER
Section: OpenSSI Prog Manual (3ssi)
Updated: 30 October 2003
cluster_detailedtransition - returns detailed transition information
int cluster_detailedtransition(int which,
transid_t *transid, int sizeof(cluster_transinfo_t),
cc [flag ...] file -lcluster [library ...]
This function returns details about a state transition relative to the specified transition ID. Based on the relative transition
and the transition ID
supplied, this function fills a transition information structure with the transition ID, the time of the transition, the node number, the state from and to which the node transitioned, and the cause of the transition.
This information can be returned for the transition specified by
, the transition following the one specified by
, the transition previous, and the first and last transitions that have occurred in the cluster.
This function is the detailed transition call because it returns any state transition any cluster node makes (a cluster node can be in one of eight states). For a more simple transition history interface, see
For details about node states and transitions, see the
For an application to be signaled when a cluster membership transition has occurred, the
signal must be enabled (see
Note that being signaled can mean 0, 1 or more simple transitions have occurred since the last time
specifies a transition relative to the
This value can be one of :
Transition specified by
Transition following the one specified by
Transition preceding the one specified by transid.
The first transition that occurred in the cluster. With this value,
is ignored on input but is filled in on output. Using FIRST followed by a series of NEXT calls, you can obtain the complete cluster membership transition history since the last cluster-wide boot.
The most current transition the cluster went through. With this value,
is ignored as an input parameter but returns the transition ID of the last transition.
- The parameter transid is a pointer to a transition ID obtained from a previous call to cluster_membership(3ssi), cluster_transition(3ssi), or cluster_detailedtransition(3ssi).
- The parameter transinfo is a pointer to a structure of type cluster_transinfo_t.
Indicates failure, and errno is set to indicate the cause of the error.
Neither the membership transition ID nor the contents of transinfo are
Indicates no transitions have occurred since the transition specified by
transid. Neither the membership transition ID nor the contents of transinfo are modified.
Indicates success. A transition has occurred since the transition specified
by transid, and the contents of transinfo reflect that transition. The
transition ID has also been updated.
The transid or transinfo pointer was invalid or the transition ID was invalid.
This document was created by man2html,
using the manual pages.
Time: 21:59:39 GMT, May 19, 2004