include/corosync/quorum.h
Go to the documentation of this file.
/*
* 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;
typedef uint64_t quorum_handle_t;
struct quorum_ring_id {
uint32_t nodeid;
uint64_t seq;
};
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
);
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
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);
cs_error_t quorum_finalize (
quorum_handle_t handle);
cs_error_t quorum_fd_get (
quorum_handle_t handle,
int *fd);
cs_error_t quorum_dispatch (
quorum_handle_t handle,
cs_dispatch_flags_t dispatch_types);
cs_error_t quorum_getquorate (
quorum_handle_t handle,
int *quorate);
cs_error_t quorum_trackstart (
quorum_handle_t handle,
unsigned int flags );
cs_error_t quorum_trackstop (
quorum_handle_t handle);
cs_error_t quorum_context_set (
quorum_handle_t handle,
const void *context);
cs_error_t quorum_context_get (
quorum_handle_t handle,
const void **context);
#ifdef __cplusplus
}
#endif
#endif /* COROSYNC_QUORUM_H_DEFINED */
nodeid
unsigned int nodeid
Definition coroapi.h:0
corotypes.h
cs_dispatch_flags_t
cs_dispatch_flags_t
The cs_dispatch_flags_t enum.
Definition corotypes.h:84
cs_error_t
cs_error_t
The cs_error_t enum.
Definition corotypes.h:98
flags
uint32_t flags
Definition exec/votequorum.c:4
quorum_context_get
cs_error_t quorum_context_get(quorum_handle_t handle, const void **context)
quorum_context_get
Definition lib/quorum.c:299
quorum_handle_t
uint64_t quorum_handle_t
quorum_handle_t
Definition include/corosync/quorum.h:51
quorum_model_t
quorum_model_t
Definition include/corosync/quorum.h:43
QUORUM_MODEL_V1
@ QUORUM_MODEL_V1
Definition include/corosync/quorum.h:45
QUORUM_MODEL_V0
@ QUORUM_MODEL_V0
Definition include/corosync/quorum.h:44
quorum_trackstop
cs_error_t quorum_trackstop(quorum_handle_t handle)
quorum_trackstop
Definition lib/quorum.c:379
quorum_initialize
cs_error_t quorum_initialize(quorum_handle_t *handle, quorum_callbacks_t *callbacks, uint32_t *quorum_type)
Create a new quorum connection.
Definition lib/quorum.c:73
quorum_fd_get
cs_error_t quorum_fd_get(quorum_handle_t handle, int *fd)
Get a file descriptor on which to poll.
Definition lib/quorum.c:279
quorum_notification_fn_t
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)
The quorum_notification_fn_t callback.
Definition include/corosync/quorum.h:61
quorum_trackstart
cs_error_t quorum_trackstart(quorum_handle_t handle, unsigned int flags)
Track node and quorum changes.
Definition lib/quorum.c:338
quorum_model_initialize
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)
Definition lib/quorum.c:90
quorum_finalize
cs_error_t quorum_finalize(quorum_handle_t handle)
Close the quorum handle.
Definition lib/quorum.c:209
quorum_getquorate
cs_error_t quorum_getquorate(quorum_handle_t handle, int *quorate)
Get quorum information.
Definition lib/quorum.c:237
quorum_v1_nodelist_notification_fn_t
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)
Definition include/corosync/quorum.h:76
quorum_context_set
cs_error_t quorum_context_set(quorum_handle_t handle, const void *context)
quorum_context_set
Definition lib/quorum.c:318
quorum_dispatch
cs_error_t quorum_dispatch(quorum_handle_t handle, cs_dispatch_flags_t dispatch_types)
Dispatch messages and configuration changes.
Definition lib/quorum.c:418
quorum_v1_quorum_notification_fn_t
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)
Definition include/corosync/quorum.h:69
quorate
uint32_t quorate
Definition sam.c:134
quorum_callbacks_t
The quorum_callbacks_t struct.
Definition include/corosync/quorum.h:87
quorum_callbacks_t::quorum_notify_fn
quorum_notification_fn_t quorum_notify_fn
Definition include/corosync/quorum.h:88
quorum_model_data_t
Definition include/corosync/quorum.h:91
quorum_model_data_t::model
quorum_model_t model
Definition include/corosync/quorum.h:92
quorum_model_v0_data_t
Definition include/corosync/quorum.h:95
quorum_model_v0_data_t::quorum_notify_fn
quorum_notification_fn_t quorum_notify_fn
Definition include/corosync/quorum.h:97
quorum_model_v0_data_t::model
quorum_model_t model
Definition include/corosync/quorum.h:96
quorum_model_v1_data_t
Definition include/corosync/quorum.h:100
quorum_model_v1_data_t::quorum_notify_fn
quorum_v1_quorum_notification_fn_t quorum_notify_fn
Definition include/corosync/quorum.h:102
quorum_model_v1_data_t::nodelist_notify_fn
quorum_v1_nodelist_notification_fn_t nodelist_notify_fn
Definition include/corosync/quorum.h:103
quorum_model_v1_data_t::model
quorum_model_t model
Definition include/corosync/quorum.h:101
quorum_ring_id
Definition include/corosync/quorum.h:53
quorum_ring_id::seq
uint64_t seq
Definition include/corosync/quorum.h:55
quorum_ring_id::nodeid
uint32_t nodeid
Definition include/corosync/quorum.h:54
ring_seq
unsigned long long ring_seq
Definition totemsrp.c:4
ring_id
struct memb_ring_id ring_id
Definition totemsrp.c:4