lib/votequorum.c

Go to the documentation of this file.

/*
 * Copyright (c) 2009-2012 Red Hat, Inc.
 *
 * All rights reserved.
 *
 * Author: Christine Caulfield (ccaulfie@redhat.com)
 *
 * This software licensed under BSD license, the text of which follows:
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * - Redistributions of source code must retain the above copyright notice,
 *   this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 * - Neither the name of the MontaVista Software, Inc. nor the names of its
 *   contributors may be used to endorse or promote products derived from this
 *   software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 * THE POSSIBILITY OF SUCH DAMAGE.
 */
 
/*
 * Provides a quorum API using the corosync executive
 */
 
#include <config.h>
 
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <sys/uio.h>
#include <errno.h>
 
#include <qb/qbdefs.h>
#include <qb/qbipcc.h>
 
#include <corosync/corotypes.h>
#include <corosync/corodefs.h>
#include <corosync/hdb.h>
 
#include <corosync/votequorum.h>
#include <corosync/ipc_votequorum.h>
 
#include "util.h"
 
struct votequorum_inst {
        qb_ipcc_connection_t *c;
        int finalize;
        void *context;
        votequorum_model_v1_data_t callbacks;
};
 
static void votequorum_inst_free (void *inst);
 
DECLARE_HDB_DATABASE(votequorum_handle_t_db, votequorum_inst_free);
 
cs_error_t votequorum_initialize (
        votequorum_handle_t *handle,
        votequorum_callbacks_t *callbacks)
{
        votequorum_model_v1_data_t model = { 0 };
 
        model.model = VOTEQUORUM_MODEL_V1;
 
        if (callbacks) {
                model.votequorum_quorum_notify_fn = callbacks->votequorum_quorum_notify_fn;
                model.votequorum_expectedvotes_notify_fn = callbacks->votequorum_expectedvotes_notify_fn;
                model.votequorum_nodelist_notify_fn = callbacks->votequorum_nodelist_notify_fn;
        };
 
        return votequorum_model_initialize(handle, &model);
}
 
cs_error_t votequorum_model_initialize (
        votequorum_handle_t *handle,
        const votequorum_model_v1_data_t *model)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
 
        error = hdb_error_to_cs(hdb_handle_create (&votequorum_handle_t_db, sizeof (struct votequorum_inst), handle));
        if (error != CS_OK) {
                goto error_no_destroy;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, *handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                goto error_destroy;
        }
 
        votequorum_inst->finalize = 0;
        votequorum_inst->c = qb_ipcc_connect ("votequorum", IPC_REQUEST_SIZE);
        if (votequorum_inst->c == NULL) {
                error = qb_to_cs_error(-errno);
                goto error_put_destroy;
        }
 
        if (model)
                memcpy(&votequorum_inst->callbacks, model, sizeof (*model));
        else
                memset(&votequorum_inst->callbacks, 0, sizeof (*model));
 
        hdb_handle_put (&votequorum_handle_t_db, *handle);
 
        return (CS_OK);
 
error_put_destroy:
        hdb_handle_put (&votequorum_handle_t_db, *handle);
error_destroy:
        hdb_handle_destroy (&votequorum_handle_t_db, *handle);
error_no_destroy:
        return (error);
}
 
static void votequorum_inst_free (void *inst)
{
        struct votequorum_inst *vq_inst = (struct votequorum_inst *)inst;
        qb_ipcc_disconnect(vq_inst->c);
}
 
cs_error_t votequorum_finalize (
        votequorum_handle_t handle)
{
        struct votequorum_inst *votequorum_inst;
        cs_error_t error;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        /*
         * Another thread has already started finalizing
         */
        if (votequorum_inst->finalize) {
                hdb_handle_put (&votequorum_handle_t_db, handle);
                return (CS_ERR_BAD_HANDLE);
        }
 
        votequorum_inst->finalize = 1;
 
        hdb_handle_destroy (&votequorum_handle_t_db, handle);
 
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (CS_OK);
}
 
 
cs_error_t votequorum_getinfo (
        votequorum_handle_t handle,
        unsigned int nodeid,
        struct votequorum_info *info)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_getinfo req_lib_votequorum_getinfo;
        struct res_lib_votequorum_getinfo res_lib_votequorum_getinfo;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_getinfo.header.size = sizeof (struct req_lib_votequorum_getinfo);
        req_lib_votequorum_getinfo.header.id = MESSAGE_REQ_VOTEQUORUM_GETINFO;
        req_lib_votequorum_getinfo.nodeid = nodeid;
 
        iov.iov_base = (char *)&req_lib_votequorum_getinfo;
        iov.iov_len = sizeof (struct req_lib_votequorum_getinfo);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_getinfo,
                sizeof (struct res_lib_votequorum_getinfo), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_getinfo.header.error;
 
        info->node_id = res_lib_votequorum_getinfo.nodeid;
        info->node_state = res_lib_votequorum_getinfo.state;
        info->node_votes = res_lib_votequorum_getinfo.votes;
        info->node_expected_votes = res_lib_votequorum_getinfo.expected_votes;
        info->highest_expected = res_lib_votequorum_getinfo.highest_expected;
        info->total_votes = res_lib_votequorum_getinfo.total_votes;
        info->quorum = res_lib_votequorum_getinfo.quorum;
        info->flags = res_lib_votequorum_getinfo.flags;
        info->qdevice_votes = res_lib_votequorum_getinfo.qdevice_votes;
        memset(info->qdevice_name, 0, VOTEQUORUM_QDEVICE_MAX_NAME_LEN);
        strcpy(info->qdevice_name, res_lib_votequorum_getinfo.qdevice_name);
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_setexpected (
        votequorum_handle_t handle,
        unsigned int expected_votes)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_setexpected req_lib_votequorum_setexpected;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
 
        req_lib_votequorum_setexpected.header.size = sizeof (struct req_lib_votequorum_setexpected);
        req_lib_votequorum_setexpected.header.id = MESSAGE_REQ_VOTEQUORUM_SETEXPECTED;
        req_lib_votequorum_setexpected.expected_votes = expected_votes;
 
        iov.iov_base = (char *)&req_lib_votequorum_setexpected;
        iov.iov_len = sizeof (struct req_lib_votequorum_setexpected);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_setvotes (
        votequorum_handle_t handle,
        unsigned int nodeid,
        unsigned int votes)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_setvotes req_lib_votequorum_setvotes;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_setvotes.header.size = sizeof (struct req_lib_votequorum_setvotes);
        req_lib_votequorum_setvotes.header.id = MESSAGE_REQ_VOTEQUORUM_SETVOTES;
        req_lib_votequorum_setvotes.nodeid = nodeid;
        req_lib_votequorum_setvotes.votes = votes;
 
        iov.iov_base = (char *)&req_lib_votequorum_setvotes;
        iov.iov_len = sizeof (struct req_lib_votequorum_setvotes);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_trackstart (
        votequorum_handle_t handle,
        uint64_t context,
        unsigned int flags)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_trackstart req_lib_votequorum_trackstart;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_trackstart.header.size = sizeof (struct req_lib_votequorum_trackstart);
        req_lib_votequorum_trackstart.header.id = MESSAGE_REQ_VOTEQUORUM_TRACKSTART;
        req_lib_votequorum_trackstart.track_flags = flags;
        req_lib_votequorum_trackstart.context = context;
 
        iov.iov_base = (char *)&req_lib_votequorum_trackstart;
        iov.iov_len = sizeof (struct req_lib_votequorum_trackstart);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_trackstop (
        votequorum_handle_t handle)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_general req_lib_votequorum_general;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_general.header.size = sizeof (struct req_lib_votequorum_general);
        req_lib_votequorum_general.header.id = MESSAGE_REQ_VOTEQUORUM_TRACKSTOP;
 
        iov.iov_base = (char *)&req_lib_votequorum_general;
        iov.iov_len = sizeof (struct req_lib_votequorum_general);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
 
cs_error_t votequorum_context_get (
        votequorum_handle_t handle,
        void **context)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        *context = votequorum_inst->context;
 
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (CS_OK);
}
 
cs_error_t votequorum_context_set (
        votequorum_handle_t handle,
        void *context)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        votequorum_inst->context = context;
 
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (CS_OK);
}
 
 
cs_error_t votequorum_fd_get (
        votequorum_handle_t handle,
        int *fd)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        error = qb_to_cs_error(qb_ipcc_fd_get (votequorum_inst->c, fd));
 
        (void)hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_dispatch (
        votequorum_handle_t handle,
        cs_dispatch_flags_t dispatch_types)
{
        int timeout = -1;
        cs_error_t error;
        int cont = 1; /* always continue do loop except when set to 0 */
        struct votequorum_inst *votequorum_inst;
        votequorum_model_v1_data_t callbacks;
        struct qb_ipc_response_header *dispatch_data;
        struct res_lib_votequorum_quorum_notification *res_lib_votequorum_quorum_notification;
        struct res_lib_votequorum_nodelist_notification *res_lib_votequorum_nodelist_notification;
        struct res_lib_votequorum_expectedvotes_notification *res_lib_votequorum_expectedvotes_notification;
        struct res_lib_votequorum_qdevice_extra_info_notification *res_lib_votequorum_qdevice_extra_info_notification;
        char dispatch_buf[IPC_DISPATCH_SIZE];
        votequorum_ring_id_t ring_id;
 
        if (dispatch_types != CS_DISPATCH_ONE &&
                dispatch_types != CS_DISPATCH_ALL &&
                dispatch_types != CS_DISPATCH_BLOCKING &&
                dispatch_types != CS_DISPATCH_ONE_NONBLOCKING) {
 
                return (CS_ERR_INVALID_PARAM);
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle,
                (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        /*
         * Timeout instantly for CS_DISPATCH_ONE_NONBLOCKING or CS_DISPATCH_ALL and
         * wait indefinately for CS_DISPATCH_ONE or CS_DISPATCH_BLOCKING
         */
        if (dispatch_types == CS_DISPATCH_ALL || dispatch_types == CS_DISPATCH_ONE_NONBLOCKING) {
                timeout = 0;
        }
 
        dispatch_data = (struct qb_ipc_response_header *)dispatch_buf;
        do {
                error = qb_to_cs_error (qb_ipcc_event_recv (
                        votequorum_inst->c,
                        dispatch_buf,
                        IPC_DISPATCH_SIZE,
                        timeout));
                if (error == CS_ERR_BAD_HANDLE) {
                        error = CS_OK;
                        goto error_put;
                }
                if (error == CS_ERR_TRY_AGAIN) {
                        if (dispatch_types == CS_DISPATCH_ONE_NONBLOCKING) {
                                /*
                                 * Don't mask error
                                 */
                                goto error_put;
                        }
                        error = CS_OK;
                        if (dispatch_types == CS_DISPATCH_ALL) {
                                break; /* exit do while cont is 1 loop */
                        } else {
                                continue; /* next poll */
                        }
                }
                if (error != CS_OK) {
                        goto error_put;
                }
 
                /*
                 * Make copy of callbacks, message data, unlock instance, and call callback
                 * A risk of this dispatch method is that the callback routines may
                 * operate at the same time that votequorum_finalize has been called in another thread.
                 */
                memcpy (&callbacks, &votequorum_inst->callbacks, sizeof (votequorum_model_v1_data_t));
 
                /*
                 * Dispatch incoming message
                 */
                switch (dispatch_data->id) {
 
                case MESSAGE_RES_VOTEQUORUM_QUORUM_NOTIFICATION:
                        if (callbacks.votequorum_quorum_notify_fn == NULL) {
                                break;
                        }
                        res_lib_votequorum_quorum_notification = (struct res_lib_votequorum_quorum_notification *)dispatch_data;
 
                        callbacks.votequorum_quorum_notify_fn ( handle,
                                                                res_lib_votequorum_quorum_notification->context,
                                                                res_lib_votequorum_quorum_notification->quorate,
                                                                res_lib_votequorum_quorum_notification->node_list_entries,
                                                                (votequorum_node_t *)res_lib_votequorum_quorum_notification->node_list );
                        break;
 
                case MESSAGE_RES_VOTEQUORUM_NODELIST_NOTIFICATION:
                        if (callbacks.votequorum_nodelist_notify_fn == NULL) {
                                break;
                        }
                        res_lib_votequorum_nodelist_notification = (struct res_lib_votequorum_nodelist_notification *)dispatch_data;
                        marshall_from_mar_votequorum_ring_id (&ring_id, &res_lib_votequorum_nodelist_notification->ring_id);
 
                        callbacks.votequorum_nodelist_notify_fn ( handle,
                                                                  res_lib_votequorum_nodelist_notification->context,
                                                                  ring_id,
                                                                  res_lib_votequorum_nodelist_notification->node_list_entries,
                                                                  res_lib_votequorum_nodelist_notification->node_list );
                        break;
 
                case MESSAGE_RES_VOTEQUORUM_EXPECTEDVOTES_NOTIFICATION:
                        if (callbacks.votequorum_expectedvotes_notify_fn == NULL) {
                                break;
                        }
                        res_lib_votequorum_expectedvotes_notification = (struct res_lib_votequorum_expectedvotes_notification *)dispatch_data;
 
                        callbacks.votequorum_expectedvotes_notify_fn ( handle,
                                                                       res_lib_votequorum_expectedvotes_notification->context,
                                                                       res_lib_votequorum_expectedvotes_notification->expected_votes);
                        break;
 
                case MESSAGE_RES_VOTEQUORUM_QDEVICE_EXTRA_INFO_NOTIFICATION:
                        if (callbacks.votequorum_qdevice_extra_info_fn == NULL) {
                                break;
                        }
                        res_lib_votequorum_qdevice_extra_info_notification = (struct res_lib_votequorum_qdevice_extra_info_notification *)dispatch_data;
 
                        callbacks.votequorum_qdevice_extra_info_fn(handle,
                                                                   res_lib_votequorum_qdevice_extra_info_notification->context,
                                                                   res_lib_votequorum_qdevice_extra_info_notification->nodeid,
                                                                   res_lib_votequorum_qdevice_extra_info_notification->ei_size,
                                                                   res_lib_votequorum_qdevice_extra_info_notification->extra_info);
                        break;
 
                default:
                        error = CS_ERR_LIBRARY;
                        goto error_put;
                        break;
                }
                if (votequorum_inst->finalize) {
                        /*
                         * If the finalize has been called then get out of the dispatch.
                         */
                        error = CS_ERR_BAD_HANDLE;
                        goto error_put;
                }
 
                /*
                 * Determine if more messages should be processed
                 */
                if (dispatch_types == CS_DISPATCH_ONE || dispatch_types == CS_DISPATCH_ONE_NONBLOCKING) {
                        cont = 0;
                }
        } while (cont);
 
 
error_put:
        hdb_handle_put (&votequorum_handle_t_db, handle);
        return (error);
}
 
cs_error_t votequorum_qdevice_register (
        votequorum_handle_t handle,
        const char *name)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_qdevice_register req_lib_votequorum_qdevice_register;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        if ((strlen(name) == 0) ||
            (strlen(name) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN)) {
                return CS_ERR_INVALID_PARAM;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
 
        req_lib_votequorum_qdevice_register.header.size = sizeof (struct req_lib_votequorum_qdevice_register);
        req_lib_votequorum_qdevice_register.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_REGISTER;
        strcpy(req_lib_votequorum_qdevice_register.name, name);
 
        iov.iov_base = (char *)&req_lib_votequorum_qdevice_register;
        iov.iov_len = sizeof (struct req_lib_votequorum_qdevice_register);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_qdevice_poll (
        votequorum_handle_t handle,
        const char *name,
        unsigned int cast_vote,
        votequorum_ring_id_t ring_id)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_qdevice_poll req_lib_votequorum_qdevice_poll;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        if ((strlen(name) == 0) ||
            (strlen(name) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN)) {
                return CS_ERR_INVALID_PARAM;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_qdevice_poll.header.size = sizeof (struct req_lib_votequorum_qdevice_poll);
        req_lib_votequorum_qdevice_poll.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_POLL;
        strcpy(req_lib_votequorum_qdevice_poll.name, name);
        req_lib_votequorum_qdevice_poll.cast_vote = cast_vote;
        marshall_to_mar_votequorum_ring_id(&req_lib_votequorum_qdevice_poll.ring_id, &ring_id);
 
        iov.iov_base = (char *)&req_lib_votequorum_qdevice_poll;
        iov.iov_len = sizeof (struct req_lib_votequorum_qdevice_poll);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_qdevice_master_wins (
        votequorum_handle_t handle,
        const char *name,
        unsigned int allow)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_qdevice_master_wins req_lib_votequorum_qdevice_master_wins;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        if ((strlen(name) == 0) ||
            (strlen(name) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN)) {
                return CS_ERR_INVALID_PARAM;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_qdevice_master_wins.header.size = sizeof (struct req_lib_votequorum_qdevice_master_wins);
        req_lib_votequorum_qdevice_master_wins.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_MASTER_WINS;
        strcpy(req_lib_votequorum_qdevice_master_wins.name, name);
        req_lib_votequorum_qdevice_master_wins.allow = allow;
 
        iov.iov_base = (char *)&req_lib_votequorum_qdevice_master_wins;
        iov.iov_len = sizeof (struct req_lib_votequorum_qdevice_master_wins);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_qdevice_update (
        votequorum_handle_t handle,
        const char *oldname,
        const char *newname)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_qdevice_update req_lib_votequorum_qdevice_update;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        if ((strlen(oldname) == 0) ||
            (strlen(oldname) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN) ||
            (strlen(newname) == 0) ||
            (strlen(newname) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN)) {
                return CS_ERR_INVALID_PARAM;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_qdevice_update.header.size = sizeof (struct req_lib_votequorum_qdevice_update);
        req_lib_votequorum_qdevice_update.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_UPDATE;
        strcpy(req_lib_votequorum_qdevice_update.oldname, oldname);
        strcpy(req_lib_votequorum_qdevice_update.newname, newname);
 
        iov.iov_base = (char *)&req_lib_votequorum_qdevice_update;
        iov.iov_len = sizeof (struct req_lib_votequorum_qdevice_update);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_qdevice_unregister (
        votequorum_handle_t handle,
        const char *name)
{
        cs_error_t error;
        struct votequorum_inst *votequorum_inst;
        struct iovec iov;
        struct req_lib_votequorum_qdevice_unregister req_lib_votequorum_qdevice_unregister;
        struct res_lib_votequorum_status res_lib_votequorum_status;
 
        if ((strlen(name) == 0) ||
            (strlen(name) >= VOTEQUORUM_QDEVICE_MAX_NAME_LEN)) {
                return CS_ERR_INVALID_PARAM;
        }
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&votequorum_inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_qdevice_unregister.header.size = sizeof (struct req_lib_votequorum_qdevice_unregister);
        req_lib_votequorum_qdevice_unregister.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_UNREGISTER;
        strcpy(req_lib_votequorum_qdevice_unregister.name, name);
 
        iov.iov_base = (char *)&req_lib_votequorum_qdevice_unregister;
        iov.iov_len = sizeof (struct req_lib_votequorum_qdevice_unregister);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                votequorum_inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
 
        return (error);
}
 
cs_error_t votequorum_get_qdevice_extra_info (
        votequorum_handle_t handle,
        unsigned int nodeid,
        uint32_t *ei_size,
        void *extra_info)
{
        if (!ei_size || !extra_info) {
                return CS_ERR_INVALID_PARAM;
        }
        cs_error_t error;
        struct votequorum_inst *inst;
        struct iovec iov;
        struct req_lib_votequorum_get_qdevice_extra_info req_lib_votequorum_get_qdevice_extra_info;
 
        char buf[sizeof(struct res_lib_votequorum_get_qdevice_extra_info) + VOTEQUORUM_QDEVICE_EXTRA_NODEINFO_MAXSIZE];
        struct res_lib_votequorum_get_qdevice_extra_info *res_lib_votequorum_get_qdevice_extra_info
                = (struct res_lib_votequorum_get_qdevice_extra_info *)buf;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&inst));
        if (error != CS_OK) {
                return (error);
        }
 
        req_lib_votequorum_get_qdevice_extra_info.header.size = sizeof(req_lib_votequorum_get_qdevice_extra_info);
        req_lib_votequorum_get_qdevice_extra_info.header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_GET_EXTRA_INFO;
        req_lib_votequorum_get_qdevice_extra_info.nodeid = nodeid;
 
        iov.iov_base = (char *)&req_lib_votequorum_get_qdevice_extra_info;
        iov.iov_len = sizeof (struct req_lib_votequorum_get_qdevice_extra_info);
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                                inst->c,
                                &iov,
                                1,
                                buf,
                                sizeof (buf), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_get_qdevice_extra_info->header.error;
        *ei_size = res_lib_votequorum_get_qdevice_extra_info->ei_size;
        memcpy(extra_info,
               res_lib_votequorum_get_qdevice_extra_info->extra_info,
               res_lib_votequorum_get_qdevice_extra_info->ei_size);
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
        return (error);
}
 
 
cs_error_t votequorum_set_qdevice_extra_info (
        votequorum_handle_t handle,
        uint32_t ei_size,
        const void *extra_info)
{
        cs_error_t error;
        struct votequorum_inst *inst;
        struct iovec iov;
        struct res_lib_votequorum_status res_lib_votequorum_status;
        char buf[sizeof(struct req_lib_votequorum_set_qdevice_extra_info) + VOTEQUORUM_QDEVICE_EXTRA_NODEINFO_MAXSIZE];
        struct req_lib_votequorum_set_qdevice_extra_info *req_lib_votequorum_set_qdevice_extra_info
                = (struct req_lib_votequorum_set_qdevice_extra_info *)buf;
 
        error = hdb_error_to_cs(hdb_handle_get (&votequorum_handle_t_db, handle, (void *)&inst));
        if (error != CS_OK) {
                return (error);
        }
 
        if(!extra_info) { // Force NULL to mean zero size
                ei_size = 0;
        }
 
        if(ei_size > VOTEQUORUM_QDEVICE_EXTRA_NODEINFO_MAXSIZE) {
                return CS_ERR_INVALID_PARAM;
        }
 
        req_lib_votequorum_set_qdevice_extra_info->header.size = sizeof(*req_lib_votequorum_set_qdevice_extra_info) + ei_size;
        req_lib_votequorum_set_qdevice_extra_info->header.id = MESSAGE_REQ_VOTEQUORUM_QDEVICE_SET_EXTRA_INFO;
        req_lib_votequorum_set_qdevice_extra_info->ei_size = ei_size;
        if(extra_info) {
                memcpy(req_lib_votequorum_set_qdevice_extra_info->extra_info, extra_info, ei_size);
        }
 
        iov.iov_base = buf;
        iov.iov_len = req_lib_votequorum_set_qdevice_extra_info->header.size;
 
        error = qb_to_cs_error(qb_ipcc_sendv_recv (
                inst->c,
                &iov,
                1,
                &res_lib_votequorum_status,
                sizeof (struct res_lib_votequorum_status), CS_IPC_TIMEOUT_MS));
 
        if (error != CS_OK) {
                goto error_exit;
        }
 
        error = res_lib_votequorum_status.header.error;
 
error_exit:
        hdb_handle_put (&votequorum_handle_t_db, handle);
        return (error);
}