1NODEUPDOWN_HANDLE_DESTROY(3)     LIBNODEUPDOWN    NODEUPDOWN_HANDLE_DESTROY(3)
2
3
4

NAME

6       nodeupdown_handle_destroy - destroys a nodeupdown handle
7

SYNOPSIS

9       #include <nodeupdown.h>
10
11       int nodeupdown_handle_destroy(nodeupdown_t handle);
12

DESCRIPTION

14       nodeupdown_handle_destroy()  destroys  the nodeupdown handle pointed to
15       by handle and frees all allocated memory associated with it.
16

RETURN VALUES

18       On success, 0 is returned.  On error, -1 is returned, and an error code
19       is  returned  in  handle.   The error code can be retrieved via nodeup‐
20       down_errnum(3) , and a description of the error code can  be  retrieved
21       via nodeupdown_strerror(3).  Error codes are defined in nodeupdown.h.
22

ERRORS

24       NODEUPDOWN_ERR_NULLHANDLE
25              The  handle  parameter  is  NULL.  The nodeupdown handle must be
26              created with nodeupdown_handle_create(3).
27
28       NODEUPDOWN_ERR_MAGIC
29              handle has an incorrect magic number.  handle does not point  to
30              a nodeupdown handle or handle has already been destroyed.
31

FILES

33       /usr/include/nodeupdown.h
34

SEE ALSO

36       libnodeupdown(3), nodeupdown_handle_create(3), nodeupdown_load_data(3),
37       nodeupdown_errnum(3), nodeupdown_strerror(3)
38
39
40
41LLNL                              August 2003     NODEUPDOWN_HANDLE_DESTROY(3)