1QUORUM_DISPATCH(3)Corosync Cluster Engine Programmer's ManualQUORUM_DISPATCH(3)
2
3
4

NAME

6       quorum_dispatch - Dispatches callbacks from the quorum service
7

SYNOPSIS

9       #include <corosync/quorum.h>
10
11       int  quorum_dispatch(quorum_handle_t  handle, cs_dispatch_flags_t *dis‐
12       patch_types);
13

DESCRIPTION

15       The quorum_dispatch function is used to dispatch configuration changes.
16
17       Each application may have several connections to the quorum API.   Each
18       application  uses  the handle argument to uniquely identify the connec‐
19       tion.
20
21       The dispatch_types argument is used to identify the type of dispatch to
22       execute.  The possible types are defined by the structure:
23
24       typedef enum {
25               CS_DISPATCH_ONE = 1,
26               CS_DISPATCH_ALL = 2,
27               CS_DISPATCH_BLOCKING = 3,
28               CS_DISPATCH_ONE_NONBLOCKING = 4
29       } cs_dispatch_flags_t;
30
31       The dispatch values have the following meanings:
32
33       CS_DISPATCH_ONE
34              Dispatch  at  least one callback, blocking until the callback is
35              dispatched.
36
37       CS_DISPATCH_ALL
38              Dispatch all waiting callbacks without blocking to wait for  any
39              callbacks.
40
41       CS_DISPATCH_BLOCKING
42              Dispatch all callbacks blocking indefinitely.  This is used in a
43              threaded program where a thread is created, and then quorum_dis‐
44              patch() is called immediately from the created thread to execute
45              callbacks.
46
47       CS_DISPATCH_ONE_NONBLOCKING
48              Dispatch at most one callback. If there is no pending  callback,
49              CS_ERR_TRY_AGAIN is returned.
50
51

RETURN VALUE

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

ERRORS

57       CS_ERR_TRY_AGAIN Resource temporarily unavailable
58
59       CS_ERR_INVALID_PARAM Invalid argument
60
61       CS_ERR_ACCESS Permission denied
62
63       CS_ERR_LIBRARY The connection failed
64
65       CS_ERR_INTERRUPT System call interrupted by a signal
66
67       CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
68
69       CS_ERR_MESSAGE_ERROR Incorrect auth message received
70
71       CS_ERR_NO_MEMORY Not enough memory to complete the requested task
72
73

SEE ALSO

75       quorum_overview(3),  quorum_initialize(3),  quorum_model_initialize(3),
76       quorum_finalize(3),  quorum_getquorate(3),  quorum_trackstart(3),  quo‐
77       rum_trackstop(3), quorum_fd_get(3), quorum_context_set(3),  quorum_con‐
78       text_get(3)
79
80corosync Man Page                 2023-11-15                QUORUM_DISPATCH(3)
Impressum