CONFDB_DISPATCH(3) Corosync Cluster Engine Programmer's Manual CONFDB_DISPATCH(3)
NAME
confdb_dispatch - Dispatches callbacks from the CONFDB service
SYNOPSIS
#include <corosync/confdb.h>
int confdb_dispatch(confdb_handle_t handle, confdb_dispatch_t *dispatch_types);
DESCRIPTION
The confdb_dispatch function is used to dispatch configuration changes.
Each application may have several connections to the CONFDB API. Each application uses the handle argument to uniquely identify the con-
nection.
The dispatch_types argument is used to identify the type of dispatch to execute. The possible types are defined by the structure:
typedef enum {
CONFDB_DISPATCH_ONE,
CONFDB_DISPATCH_ALL,
CONFDB_DISPATCH_BLOCKING
} confdb_dispatch_t;
The dispatch values have the following meanings:
CONFDB_DISPATCH_ONE
Dispatch at least one callback, blocking until the callback is dispatched.
CONFDB_DISPATCH_ALL
Dispatch all waiting callbacks without blocking to wait for any callbacks.
CONFDB_DISPATCH_BLOCKING
Dispatch all callbacks blocking indefinitely. This is used in a threaded program where a thread is created, and then confdb_dis-
patch() is called immediately from the created thread to execute callbacks.
RETURN VALUE
This call returns the CONFDB_OK value if successful, otherwise an error is returned.
ERRORS
The errors are undocumented.
SEE ALSO
confdb_overview(8), confdb_initialize(3), confdb_finalize(3), confdb_fd_get(3), confdb_object_create(3), confdb_object_destroy(3),
confdb_object_parent_get(3), confdb_key_create(3), confdb_key_delete(3), confdb_key_get(3), confdb_key_replace(3),
confdb_object_find_start(3), confdb_object_find(3), confdb_object_iter_start(3), confdb_object_iter(3), confdb_key_iter_start(3),
confdb_key_iter(3),
corosync Man Page 2004-08-31 CONFDB_DISPATCH(3)