election_internal.h

Go to the documentation of this file.

/*
 * Copyright 2009-2024 the Pacemaker project contributors
 *
 * The version control history for this file may have further details.
 *
 * This source code is licensed under the GNU Lesser General Public License
 * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
 */

#ifndef PCMK__CRM_CLUSTER_ELECTION_INTERNAL__H
#define PCMK__CRM_CLUSTER_ELECTION_INTERNAL__H

#include <stdbool.h>        // bool

#include <glib.h>           // guint, GSourceFunc
#include <libxml/tree.h>    // xmlNode

#include <crm/common/ipc.h> // enum pcmk_ipc_server
#include <crm/cluster.h>    // pcmk_cluster_t

#ifdef __cplusplus
extern "C" {
#endif

// Possible election results
enum election_result {
    election_start = 0,     // New election needed
    election_in_progress,   // Election started but not all peers have voted
    election_lost,          // Local node lost most recent election
    election_won,           // Local node won most recent election
    election_error,         // Election message or object invalid
};

void election_reset(pcmk_cluster_t *cluster);
void election_init(pcmk_cluster_t *cluster, void (*cb)(pcmk_cluster_t *));

void election_timeout_set_period(pcmk_cluster_t *cluster, guint period_ms);
void election_timeout_stop(pcmk_cluster_t *cluster);

void election_vote(pcmk_cluster_t *cluster);
bool election_check(pcmk_cluster_t *cluster);
void election_remove(pcmk_cluster_t *cluster, const char *uname);
enum election_result election_state(const pcmk_cluster_t *cluster);
enum election_result election_count_vote(pcmk_cluster_t *cluster,
                                         const xmlNode *message, bool can_win);
void election_clear_dampening(pcmk_cluster_t *cluster);

#ifdef __cplusplus
}
#endif

#endif // PCMK__CRM_CLUSTER_ELECTION_INTERNAL__H