1GETNODES(2)                   LAM NETWORK LIBRARY                  GETNODES(2)
2
3
4

NAME

6       getnodes - Get array of LAM node identifiers.
7

C SYNOPSIS

9       #include <net.h>
10
11       int getnodes (int *nodes, int nnodes, int nodetype, int typemask);
12       int getall (int *nodes, int nnodes);
13       int getcomps (int *nodes, int nnodes);
14       int getjones (int *nodes, int nnodes);
15       int getotbs (int *nodes, int nnodes);
16

FORTRAN SYNOPSIS

18       subroutine GNODES (nodes, nnodes, nodetype, typemask, ierror)
19       subroutine GALL (nodes, nnodes, ierror)
20       subroutine GCOMPS (nodes, nnodes, ierror)
21       subroutine GJONES (nodes, nnodes, ierror)
22       subroutine GOTBS (nodes, nnodes, ierror)
23
24       integer nodes(*), nnodes, nodetype, typemask, ierror
25

DESCRIPTION

27       getnodes()  fills the array, nodes, with no more than nnodes node iden‐
28       tifiers whose types match nodetype at the bit  positions  specified  by
29       typemask.   Given sufficient space and a sufficiently large nnodes, all
30       node identifiers having a node type field that satisfies  the  relation
31       imposed by the nodetype and typemask arguments will be returned.
32
33       The remaining functions are wrappers for getnodes() that match commonly
34       used node types.
35
36       getotbs()   OTB nodes
37
38       getall()    all nodes
39
40       getcomps()  nodes in main computing group (see getntype(2))
41
42       getjones()  neighbour nodes of the caller
43
44       The node type is a combination of flags, defined in <net.h>, describing
45       the capabilities of the node.  Usage of the nodetype and typemask argu‐
46       ments in getnodes() is identical to getntype(2).   Indeed,  getntype(2)
47       is  usually  called  before  getnodes() to count the matching nodes and
48       thus ascertain the space requirement for the node array.  No indication
49       of the number of returned node identifiers is given by getnodes().
50

SEE ALSO

52       getntype(2)
53
54
55
56LAM 7.1.2                         March, 2006                      GETNODES(2)
Impressum