1CMAP_ITER_NEXT(3) Corosync Cluster Engine Programmer's ManualCMAP_ITER_NEXT(3)
2
3
4

NAME

6       cmap_iter_next - Return next item in iteration in CMAP
7
8

SYNOPSIS

10       #include <corosync/cmap.h>
11
12
13       cs_error_t   cmap_iter_next(cmap_handle_t   handle,  cmap_iter_handle_t
14       iter_handle, char  key_name[],  size_t  *value_len,  cmap_value_types_t
15       *type);
16
17

DESCRIPTION

19       The cmap_iter_next function is used to get next value in iteration. The
20       handle argument is connection to  CMAP  database  obtained  by  calling
21       cmap_initialize(3)  function.   iter_handle argument is iterator handle
22       obtained by cmap_iter_init(3) function. Following key  name  is  stored
23       inside  key_name argument, which must be preallocated by caller and its
24       guaranteed  maximum  size  is  CMAP_KEYNAME_MAXLEN   (currently   255).
25       value_len  is pointer where length of value is stored, but can be NULL.
26       type is also optional argument (can be NULL) and here type of value  is
27       stored (type is one of types described in cmap_get(3) function).
28
29

RETURN VALUE

31       This  call  returns the CS_OK value if successful. If there are no more
32       items to iterate, CS_NO_SECTION error code is returned.
33
34

SEE ALSO

36       cmap_iter_init(3),      cmap_iter_finalize(3),      cmap_initialize(3),
37       cmap_get(3), cmap_overview(3)
38
39       CS_ERR_TRY_AGAIN Resource temporarily unavailable
40
41       CS_ERR_INVALID_PARAM Invalid argument
42
43       CS_ERR_ACCESS Permission denied
44
45       CS_ERR_LIBRARY The connection failed
46
47       CS_ERR_INTERRUPT System call interrupted by a signal
48
49       CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
50
51       CS_ERR_MESSAGE_ERROR Incorrect auth message received
52
53       CS_ERR_NO_MEMORY Not enough memory to complete the requested task
54
55
56
57corosync Man Page                 06/02/2012                 CMAP_ITER_NEXT(3)