1CPG_ITERATION_NEXT(C3o)rosync Cluster Engine Programmer's ManCuPaGl_ITERATION_NEXT(3)
2
3
4
6 cpg_iteration_next - Return next item in iteration of CPG
7
8
10 #include <corosync/cpg.h>
11
12
13 cs_error_t cpg_iteration_next (cpg_iteration_handle_t handle, struct
14 cpg_iteration_description_t *description);
15
16
18 The cpg_iter_next function is used to get next value in iteration. The
19 handle argument is iterator handle obtained by cpg_iteration_inital‐
20 ize(3) function. description is pointer to structure with following
21 definition:
22
23 struct cpg_iteration_description_t {
24 struct cpg_name group;
25 uint32_t nodeid;
26 uint32_t pid;
27 };
28
29 where group is name of group, nodeid is ID of connected node and pid is
30 pid of connected process. If iteration was initialized with CPG_ITERA‐
31 TION_NAME_ONLY iteration type, both nodeid and pid are 0.
32
33
35 This call returns the CS_OK value if successful. If there are no more
36 items to iterate, CS_NO_SECTION error code is returned.
37
38
40 cpg_iteration_initialize(3), cpg_overview(3)
41
42 CS_ERR_TRY_AGAIN Resource temporarily unavailable
43
44 CS_ERR_INVALID_PARAM Invalid argument
45
46 CS_ERR_ACCESS Permission denied
47
48 CS_ERR_LIBRARY The connection failed
49
50 CS_ERR_INTERRUPT System call interrupted by a signal
51
52 CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
53
54 CS_ERR_MESSAGE_ERROR Incorrect auth message received
55
56 CS_ERR_NO_MEMORY Not enough memory to complete the requested task
57
58
59
60corosync Man Page 05/03/2012 CPG_ITERATION_NEXT(3)