---
name: "votequorum_qdevice_poll"
section: "3"
platform: "linux"
package: "libvotequorum-dev"
version: "3.1.9-2+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/votequorum_qdevice_poll"
---

# votequorum\_qdevice\_poll(3)

Tells votequorum the result of the quorum device poll

## 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 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_overview/3.md), [**votequorum\_initialize**(3)](/votequorum_initialize/3.md), [**votequorum\_finalize**(3)](/votequorum_finalize/3.md), [**votequorum\_getinfo**(3)](/votequorum_getinfo/3.md), [**votequorum\_trackstart**(3)](/votequorum_trackstart/3.md), [**votequorum\_trackstop**(3)](/votequorum_trackstop/3.md), [**votequorum\_fd\_get**(3)](/votequorum_fd_get/3.md), [**votequorum\_dispatch**(3)](/votequorum_dispatch/3.md), [**votequorum\_context\_set**(3)](/votequorum_context_set/3.md), [**votequorum\_context\_get**(3)](/votequorum_context_get/3.md), [**votequorum\_setexpected**(3)](/votequorum_setexpected/3.md), [**votequorum\_setvotes**(3)](/votequorum_setvotes/3.md), [**votequorum\_qdevice\_register**(3)](/votequorum_qdevice_register/3.md), [**votequorum\_qdevice\_unregister**(3)](/votequorum_qdevice_unregister/3.md), [**votequorum\_qdevice\_update**(3)](/votequorum_qdevice_update/3.md), [**votequorum\_qdevice\_master\_wins**(3)](/votequorum_qdevice_master_wins/3.md),