1NODEUPDOWN_IS_NODE_UP(3)         LIBNODEUPDOWN        NODEUPDOWN_IS_NODE_UP(3)
2
3
4

NAME

6       nodeupdown_is_node_up,  nodeupdown_is_node_down  - test if a node is up
7       or down
8

SYNOPSIS

10       #include <nodeupdown.h>
11
12       int nodeupdown_is_node_up(nodeupdown_t handle, const char *node);  q.sp
13       int nodeupdown_is_node_down(nodeupdown_t handle, const char *node);
14

DESCRIPTION

16       nodeupdown_is_node_up() tests if the node pointed to by node is up.
17
18       nodeupdown_is_node_down() tests if the node pointed to by node is down.
19
20       The node name passed into these functions must be the shortened name of
21       the hostname.
22

RETURN VALUES

24       For nodeupdown_is_node_up(), 1 is returned if the  node  is  up,  0  is
25       returned  if  the  node  is  down.  For nodeupdown_is_node_down(), 1 is
26       returned if the node is down, 0 is returned if  the  node  is  up.   On
27       error,  both  return  -1, and an error code is returned in handle.  The
28       error code can be retrieved via nodeupdown_errnum(3) , and  a  descrip‐
29       tion  of  the  error  code can be retrieved via nodeupdown_strerror(3).
30       Error codes are defined in nodeupdown.h.
31

ERRORS

33       NODEUPDOWN_ERR_NULLHANDLE
34              The handle parameter is NULL.  The  nodeupdown  handle  must  be
35              created with nodeupdown_handle_create(3).
36
37       NODEUPDOWN_ERR_NOTLOADED
38              nodeupdown_load_data(3) has not been called and no data has been
39              retrieved.
40
41       NODEUPDOWN_ERR_PARAMETERS
42              An incorrect parameter has been passed in.
43
44       NODEUPDOWN_ERR_OUTMEM
45              malloc(3) has failed internally.
46
47       NODEUPDOWN_ERR_NOTFOUND
48              The node pointed to by node is not known.
49
50       NODEUPDOWN_ERR_CLUSTERLIST_MODULE
51              Internal error with the clusterlist module
52
53       NODEUPDOWN_ERR_HOSTLIST
54              Hostlist API has failed internally.
55
56       NODEUPDOWN_ERR_MAGIC
57              handle has an incorrect magic number.  handle does not point  to
58              a  nodeupdown  handle  or  handle  has been destroyed by nodeup‐
59              down_handle_destroy(3).
60

FILES

62       /usr/include/nodeupdown.h
63

SEE ALSO

65       libnodeupdown(3), nodeupdown_handle_create(3), nodeupdown_load_data(3),
66       nodeupdown_errnum(3), nodeupdown_strerror(3)
67
68
69
70LLNL                              August 2003         NODEUPDOWN_IS_NODE_UP(3)
Impressum