GETNODES(2) LAM NETWORK LIBRARY GETNODES(2)NAMEgetnodes - Get array of LAM node identifiers.
C SYNOPSIS
#include <net.h>
int getnodes (int *nodes, int nnodes, int nodetype, int typemask);
int getall (int *nodes, int nnodes);
int getcomps (int *nodes, int nnodes);
int getjones (int *nodes, int nnodes);
int getotbs (int *nodes, int nnodes);
FORTRAN SYNOPSIS
subroutine GNODES (nodes, nnodes, nodetype, typemask, ierror)
subroutine GALL (nodes, nnodes, ierror)
subroutine GCOMPS (nodes, nnodes, ierror)
subroutine GJONES (nodes, nnodes, ierror)
subroutine GOTBS (nodes, nnodes, ierror)
integer nodes(*), nnodes, nodetype, typemask, ierror
DESCRIPTIONgetnodes() fills the array, nodes, with no more than nnodes node iden‐
tifiers whose types match nodetype at the bit positions specified by
typemask. Given sufficient space and a sufficiently large nnodes, all
node identifiers having a node type field that satisfies the relation
imposed by the nodetype and typemask arguments will be returned.
The remaining functions are wrappers for getnodes() that match commonly
used node types.
getotbs() OTB nodes
getall() all nodes
getcomps() nodes in main computing group (see getntype(2))
getjones() neighbour nodes of the caller
The node type is a combination of flags, defined in <net.h>, describing
the capabilities of the node. Usage of the nodetype and typemask argu‐
ments in getnodes() is identical to getntype(2). Indeed, getntype(2)
is usually called before getnodes() to count the matching nodes and
thus ascertain the space requirement for the node array. No indication
of the number of returned node identifiers is given by getnodes().
SEE ALSOgetntype(2)LAM 7.1.2 March, 2006 GETNODES(2)