---
name: "confdb_dispatch"
section: "3"
platform: "linux"
package: "corosync-dev"
version: "1.4.6-1.1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/confdb_dispatch"
---

# confdb\_dispatch(3)

Dispatches callbacks from the CONFDB service

## 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 connection.

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\_dispatch() 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_overview/8.md), [**confdb\_initialize**(3)](/confdb_initialize/3.md), [**confdb\_finalize**(3)](/confdb_finalize/3.md), [**confdb\_fd\_get**(3)](/confdb_fd_get/3.md), [**confdb\_object\_create**(3)](/confdb_object_create/3.md), [**confdb\_object\_destroy**(3)](/confdb_object_destroy/3.md), [**confdb\_object\_parent\_get**(3)](/confdb_object_parent_get/3.md), [**confdb\_key\_create**(3)](/confdb_key_create/3.md), [**confdb\_key\_delete**(3)](/confdb_key_delete/3.md), [**confdb\_key\_get**(3)](/confdb_key_get/3.md), [**confdb\_key\_replace**(3)](/confdb_key_replace/3.md), [**confdb\_object\_find\_start**(3)](/confdb_object_find_start/3.md), [**confdb\_object\_find**(3)](/confdb_object_find/3.md), [**confdb\_object\_iter\_start**(3)](/confdb_object_iter_start/3.md), [**confdb\_object\_iter**(3)](/confdb_object_iter/3.md), [**confdb\_key\_iter\_start**(3)](/confdb_key_iter_start/3.md), [**confdb\_key\_iter**(3)](/confdb_key_iter/3.md),