votequorum_trackstart - Man Page

Enable callbacks notification.

Synopsis

#include <corosync/votequorum.h>

int votequorum_trackstart(votequorum_handle_t *handle, uint64_t context, unsigned int flags);

Description

The votequorum_trackstart function is used to enable callbacks notification from the votequorum API.

Every time the voting configuration changes (eg a node joins or leave the cluster) or the quorum status change or the expected votes changes, the notification is queued.

The notification is dispatched via votequorum_dispatch() function that will execute the callback.

The context option allows one to set a tracking context.

The flags argument is defined by one or more of the following values and values can be bitwise-or'd

#define CS_TRACK_CURRENT      0x01
#define CS_TRACK_CHANGES      0x02
#define CS_TRACK_CHANGES_ONLY 0x04

Return Value

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

Errors

CS_ERR_TRY_AGAIN Resource temporarily unavailable

CS_ERR_INVALID_PARAM Invalid argument

CS_ERR_ACCESS Permission denied

CS_ERR_LIBRARY The connection failed

CS_ERR_INTERRUPT System call interrupted by a signal

CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported

CS_ERR_MESSAGE_ERROR Incorrect auth message received

CS_ERR_NO_MEMORY Not enough memory to complete the requested task

See Also

votequorum_overview(3), votequorum_initialize(3), votequorum_finalize(3), votequorum_getinfo(3), votequorum_trackstop(3), votequorum_fd_get(3), votequorum_dispatch(3), votequorum_context_set(3), votequorum_context_get(3), votequorum_setexpected(3), votequorum_setvotes(3)

Referenced By

votequorum_context_get(3), votequorum_context_set(3), votequorum_dispatch(3), votequorum_fd_get(3), votequorum_finalize(3), votequorum_getinfo(3), votequorum_initialize(3), votequorum_overview(3), votequorum_qdevice_master_wins(3), votequorum_qdevice_poll(3), votequorum_qdevice_register(3), votequorum_qdevice_unregister(3), votequorum_qdevice_update(3), votequorum_setexpected(3), votequorum_setvotes(3), votequorum_trackstop(3).

2024-07-17 corosync Man Page Corosync Cluster Engine Programmer's Manual