CI Project
  Contributed Code
  Mailing Lists
  Project List
  CLMS Features
  ICS Features
  Current Status
  Kernel Hooks
  Limitations / Enhancements
CI Documentation
  Kernel Patch
  Cluster Tools
Printer-friendly version


Section: OpenSSI Prog Manual (3ssi)
Updated: 30 October 2003



cluster_detailedtransition - returns detailed transition information  


#include <sys/cluster.h>

int cluster_detailedtransition(int which,
    transid_t *transid, int sizeof(cluster_transinfo_t),
    cluster_transinfo_t *transinfo)

cc [flag ...] file -lcluster [library ...]


This function returns details about a state transition relative to the specified transition ID. Based on the relative transition which and the transition ID transid 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 transid , the transition following the one specified by transid , 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 cluster_transition(3ssi).

For details about node states and transitions, see the cluster(8ssi) manual page.

For an application to be signaled when a cluster membership transition has occurred, the SIGCLUSTER signal must be enabled (see cluster(8ssi) and signal(4)). Note that being signaled can mean 0, 1 or more simple transitions have occurred since the last time SIGCLUSTER was processed.

The parameter which specifies a transition relative to the transid. This value can be one of :

Transition specified by transid
Transition following the one specified by transid
Transition preceding the one specified by transid.
The first transition that occurred in the cluster. With this value, transid 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, transid 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 modified.
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.


cluster_maxnodes(3ssi), cluster_membership(3ssi), cluster_name(3ssi), cluster_ssiconfig(3ssi), cluster_transition(3ssi), clusternode_avail(3ssi), clusternode_info(3ssi), clusternode_num(3ssi), cluster(8ssi), signal(4)

This document was created by man2html, using the manual pages.
Time: 21:59:39 GMT, May 19, 2004

SourceForge Logo

HP Linux solutions

The Linux Clustering Information Center

This file last updated on Tuesday, 14-May-2002 09:33:16 UTC
privacy and legal statement