Page MenuHomeClusterLabs Projects
Files F3154283

quorum.h
No OneTemporary
Actions

quorum.h
View Options

/*
* Copyright (c) 2008-2020 Red Hat, Inc.
*
* All rights reserved.
*
* Author: Christine Caulfield (ccaulfi@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 Red Hat, 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 CONTRIBUTORS "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.
*/
#ifndef COROSYNC_QUORUM_H_DEFINED
#define COROSYNC_QUORUM_H_DEFINED
#include <corosync/corotypes.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef enum {
QUORUM_MODEL_V0 = 0,
QUORUM_MODEL_V1 = 1,
} quorum_model_t;
/**
* @brief quorum_handle_t
*/
typedef uint64_t quorum_handle_t;
struct quorum_ring_id {
uint32_t nodeid;
uint64_t seq;
};
/**
* @brief The quorum_notification_fn_t callback
*/
typedef void (*quorum_notification_fn_t) (
quorum_handle_t handle,
uint32_t quorate,
uint64_t ring_seq,
uint32_t view_list_entries,
uint32_t *view_list
);
typedef void (*quorum_v1_quorum_notification_fn_t) (
quorum_handle_t handle,
uint32_t quorate,
struct quorum_ring_id ring_id,
uint32_t member_list_entries, const uint32_t *member_list
);
typedef void (*quorum_v1_nodelist_notification_fn_t) (
quorum_handle_t handle,
struct quorum_ring_id ring_id,
uint32_t member_list_entries, const uint32_t *member_list,
uint32_t joined_list_entries, const uint32_t *joined_list,
uint32_t left_list_entries, const uint32_t *left_list
);
/**
* @brief The quorum_callbacks_t struct
*/
typedef struct {
quorum_notification_fn_t quorum_notify_fn;
} quorum_callbacks_t;
typedef struct {
quorum_model_t model;
} quorum_model_data_t;
typedef struct {
quorum_model_t model;
quorum_notification_fn_t quorum_notify_fn;
} quorum_model_v0_data_t;
typedef struct {
quorum_model_t model;
quorum_v1_quorum_notification_fn_t quorum_notify_fn;
quorum_v1_nodelist_notification_fn_t nodelist_notify_fn;
} quorum_model_v1_data_t;
#define QUORUM_FREE 0
#define QUORUM_SET 1
/**
* @brief Create a new quorum connection
* @param handle
* @param callbacks
* @param quorum_type
* @return
*/
cs_error_t quorum_initialize (
quorum_handle_t *handle,
quorum_callbacks_t *callbacks,
uint32_t *quorum_type);
cs_error_t quorum_model_initialize (
quorum_handle_t *handle,
quorum_model_t model,
quorum_model_data_t *model_data,
uint32_t *quorum_type,
void *context);
/**
* @brief Close the quorum handle
* @param handle
* @return
*/
cs_error_t quorum_finalize (
quorum_handle_t handle);
/**
* @brief Get a file descriptor on which to poll.
*
* @note quorum_handle_t is NOT a file descriptor and may not be used directly.
*
* @param handle
* @param fd
* @return
*/
cs_error_t quorum_fd_get (
quorum_handle_t handle,
int *fd);
/**
* @brief Dispatch messages and configuration changes
* @param handle
* @param dispatch_types
* @return
*/
cs_error_t quorum_dispatch (
quorum_handle_t handle,
cs_dispatch_flags_t dispatch_types);
/**
* @brief Get quorum information.
* @param handle
* @param quorate
* @return
*/
cs_error_t quorum_getquorate (
quorum_handle_t handle,
int *quorate);
/**
* @brief Track node and quorum changes
* @param handle
* @param flags
* @return
*/
cs_error_t quorum_trackstart (
quorum_handle_t handle,
unsigned int flags );
/**
* @brief quorum_trackstop
* @param handle
* @return
*/
cs_error_t quorum_trackstop (
quorum_handle_t handle);
/**
* @brief quorum_context_set
* @param handle
* @param context
* @return
*/
cs_error_t quorum_context_set (
quorum_handle_t handle,
const void *context);
/**
* @brief quorum_context_get
* @param handle
* @param context
* @return
*/
cs_error_t quorum_context_get (
quorum_handle_t handle,
const void **context);
#ifdef __cplusplus
}
#endif
#endif /* COROSYNC_QUORUM_H_DEFINED */

File Metadata

Mime Type
text/x-c
Expires
Wed, Feb 26, 11:34 AM (23 h, 15 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1465307
Default Alt Text
quorum.h (4 KB)

Event Timeline