NAME

       votequorum_qdevice_poll - Tells votequorum the result of the quorum device poll

SYNOPSIS

       #include <corosync/votequorum.h>

       int  votequorum_qdevice_poll(votequorum_handle_t  handle,  const  char  *  name,  unsigned int cast_vote,
       votequorum_ring_id_t ring_id);

DESCRIPTION

       The votequorum_qdevice_poll is called by the quorum device subsystem (not provided as part of votequorum)
       to tell the voting system if the quorum device is present/active or not. If cast_vote is 1 then the votes
       for the device are included in the quorum calculation, otherwise not.  Current ring_id must be  set  (one
       get  in votequorum_notification_fn callback) otherwise poll is ignored.  This routine should be called at
       regular  intervals  to  ensure  that  the   device   status   is   always   known   to   votequorum.   If
       votequorum_qdevice_poll  is  not  called for (default) 10 seconds (or 30 seconds for sync phase) then the
       device will be deemed to be dead and its votes removed from the cluster. This  does  not  unregister  the
       device.   The  default  poll  time  can be changed by setting the cmap variable quorum.device.timeout for
       normal operation or quorum.device.sync_timeout for synchronization phase.

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

SEE ALSO

       votequorum_overview(8),    votequorum_initialize(3),    votequorum_finalize(3),    votequorum_getinfo(3),
       votequorum_trackstart(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),
       votequorum_qdevice_register(3),      votequorum_qdevice_unregister(3),      votequorum_qdevice_update(3),
       votequorum_qdevice_master_wins(3),