votequorum_trackstart (3) - Linux Manuals

votequorum_trackstart: Enable callbacks notification.

NAME

votequorum_trackstart - 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 configuraton 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 inturrupted by a signal

CS_ERR_NOT_SUPPORTED The requested protocol/functuality not supported

CS_ERR_MESSAGE_ERROR Incorrect auth message received

CS_ERR_NO_MEMORY Not enough memory to completed the requested task