Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VOTEQ...GISTER(3) Corosync Cluster Engine Programmer's ManualVOTEQ...GISTER(3)

NAME
       votequorum_qdevice_register - Registers a new quorum device

SYNOPSIS
       #include	<corosync/votequorum.h>

       int  votequorum_qdevice_register(votequorum_handle_t handle, const char
       * name);

DESCRIPTION
       The votequorum_qdevice_register is used to register a  new  quorum  de-
       vice.  A	 quorum	 device	 is an external	way of adding votes to a small
       cluster.	The quorum device is, in effect, a pseudo node in the  cluster
       that provide votes based	on some	external device, usually a shared disk
       partition or perhaps a network router.
       This  call  creates  the	 device	but does not mark it active.  votequo-
       rum_qdevice_poll	must be	called for the votes to	 be  included  in  the
       quorum calculation.
       name is string containing an informative	name for the quorum device. It
       is simply stored	by votequorum and used in the display of corosync-quo-
       rumtool,	it can be a maximum of 254 characters.
       The  number  of votes contributed by the	quorum device is already known
       to votequorum, it is set	in cmap	quorum.device.votes and	not by the de-
       vice.
       Note that it is the responsibility of the quorum	device subsystem  (not
       provided	 as part of votequorum)	to keep	all nodes informed of the quo-
       rum device status.

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_final-
       ize(3),	 votequorum_getinfo(3),	  votequorum_trackstart(3),   votequo-
       rum_trackstop(3),  votequorum_fd_get(3),	 votequorum_dispatch(3), vote-
       quorum_context_set(3),	votequorum_context_get(3),   votequorum_setex-
       pected(3),   votequorum_setvotes(3),  votequorum_qdevice_unregister(3),
       votequorum_qdevice_poll(3),   votequorum_qdevice_update(3),    votequo-
       rum_qdevice_master_wins(3)

corosync Man Page		  2025-11-01		     VOTEQ...GISTER(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=votequorum_qdevice_register&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help