1VOTEQUORUM_QDEVICE_CRoErGoIsSyTnEcR(C3l)uster Engine ProgramVmOeTrE'QsUOMRaUnMu_aQlDEVICE_REGISTER(3)
2
3
4

NAME

6       votequorum_qdevice_register - Registers a new quorum device
7

SYNOPSIS

9       #include <corosync/votequorum.h>
10
11       int  votequorum_qdevice_register(votequorum_handle_t handle, const char
12       * name);
13

DESCRIPTION

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

RETURN VALUE

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

ERRORS

38       CS_ERR_TRY_AGAIN Resource temporarily unavailable
39
40       CS_ERR_INVALID_PARAM Invalid argument
41
42       CS_ERR_ACCESS Permission denied
43
44       CS_ERR_LIBRARY The connection failed
45
46       CS_ERR_INTERRUPT System call interrupted by a signal
47
48       CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
49
50       CS_ERR_MESSAGE_ERROR Incorrect auth message received
51
52       CS_ERR_NO_MEMORY Not enough memory to complete the requested task
53
54

SEE ALSO

56       votequorum_overview(8),   votequorum_initialize(3),   votequorum_final‐
57       ize(3),   votequorum_getinfo(3),   votequorum_trackstart(3),   votequo‐
58       rum_trackstop(3),  votequorum_fd_get(3),  votequorum_dispatch(3), vote‐
59       quorum_context_set(3),   votequorum_context_get(3),   votequorum_setex‐
60       pected(3),   votequorum_setvotes(3),  votequorum_qdevice_unregister(3),
61       votequorum_qdevice_poll(3),   votequorum_qdevice_update(3),    votequo‐
62       rum_qdevice_master_wins(3)
63
64corosync Man Page                 2018-10-30    VOTEQUORUM_QDEVICE_REGISTER(3)
Impressum