1CMAP_DISPATCH(3)  Corosync Cluster Engine Programmer's Manual CMAP_DISPATCH(3)
2
3
4

NAME

6       cmap_dispatch - Dispatches callbacks from the CMAP service
7
8

SYNOPSIS

10       #include <corosync/cmap.h>
11
12
13       cs_error_t  cmap_dispatch  (cmap_handle_t  handle,  cs_dispatch_flags_t
14       dispatch_types);
15
16

DESCRIPTION

18       The cmap_dispatch function is used to dispatch configuration changes.
19
20       Each application may have several connections to the  CMAP  API.   Each
21       application  uses  the handle argument to uniquely identify the connec‐
22       tion.
23
24       The dispatch_types argument is used to identify the type of dispatch to
25       execute.   The  possible types are CS_DISPATCH_ONE, CS_DISPATCH_ALL and
26       CS_DISPATCH_BLOCKING.
27
28       The dispatch values have the following meanings:
29
30       CS_DISPATCH_ONE
31              Dispatch at least one callback, blocking until the  callback  is
32              dispatched.
33
34       CS_DISPATCH_ALL
35              Dispatch  all waiting callbacks without blocking to wait for any
36              callbacks.
37
38       CS_DISPATCH_BLOCKING
39              Dispatch all callbacks blocking indefinitely.  This is used in a
40              threaded  program  where  a  thread is created, and then cs_dis‐
41              patch() is called immediately from the created thread to execute
42              callbacks.
43
44       CS_DISPATCH_ONE_NONBLOCKING
45              Dispatch  at most one callback. If there is no pending callback,
46              CS_ERR_TRY_AGAIN is returned.
47
48       It's needed to call cmap_track_add(3) to add tracked items and  receive
49       callbacks.
50
51

RETURN VALUE

53       This  call returns the CS_OK value if successful, otherwise an error is
54       returned.
55
56

SEE ALSO

58       cmap_track_add(3), cmap_track_delete(3), cmap_overview(8)
59
60       CS_ERR_TRY_AGAIN Resource temporarily unavailable
61
62       CS_ERR_INVALID_PARAM Invalid argument
63
64       CS_ERR_ACCESS Permission denied
65
66       CS_ERR_LIBRARY The connection failed
67
68       CS_ERR_INTERRUPT System call interrupted by a signal
69
70       CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
71
72       CS_ERR_MESSAGE_ERROR Incorrect auth message received
73
74       CS_ERR_NO_MEMORY Not enough memory to complete the requested task
75
76
77
78corosync Man Page                 23/01/2012                  CMAP_DISPATCH(3)