NAME

cnodes − get a list of active nodes in cluster

SYNOPSIS

#include <cluster.h>

int cnodes(cnode_t *buf);

DESCRIPTION

cnodes() determines the number of active cnodes in the cluster, including the cnode on which it is invoked.  If buf is not a null pointer, it must point to an array of type cnode_t with at least MAX_CNODE elements.  In this case, the values of the cnode IDs of the nodes currently in the cluster are stored in the array, terminated by the cnode ID 0. 

RETURN VALUE

Upon successful completion, cnodes() returns the current number of active cnodes.  If the value 0 is returned, the machine is not a member of a cluster.  In case of an error, a value of −1 is returned and errno is set to indicate the error. 

ERRORS

cnodes() may fail if:

[EFAULT] buf is not a null pointer and points to an illegal address.  Reliable detection of this error is not guaranteed. 

SEE ALSO

cnodes(1), cnodeid(2), getcontext(2), getccent(3C). 

AUTHOR

cnodes was developed by HP. 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992