NAME
votequorum_initialize - Create a new connection to the VoteQuorum
service
SYNOPSIS
#include <corosync/votequorum.h>
int votequorum_initialize(votequorum_handle_t *handle,
votequorum_callbacks_t *callbacks);
DESCRIPTION
The votequorum_initialize function is used to initialize a connection
to the vote-based quorum database API.
Each application may have several connections to the votequorum API.
Each application uses the handle argument to uniquely identify the
connection. The handle argument is then used in other function calls
to identify the connection to be used for communication with the
votequorum service.
Every time the voting configuraton changes (eg a node joins or leave
the cluster), the callback is called. The callback function is
described by the following type definitions:
typedef void (*votequorum_notification_fn_t) ( votequorum_handle_t
handle, uint64_t context, uint32_t quorate, uint32_t
node_list_entries, votequorum_node_t node_list[] );
The callbacks argument is of the type:
typedef struct {
votequorum_notification_fn_t votequorum_notify_fn;
} votequorum_callbacks_t;
votequorum_dispatch() function.
RETURN VALUE
This call returns the CS_OK value if successful, otherwise an error is
returned.
BUGS
Callbacks are not support at the moment.
ERRORS
The errors are undocumented.
SEE ALSO
votequorum_overview(8), votequorum_finalize(3), votequorum_fd_get(3),
votequorum_dispatch(3),