scheduler.h

Go to the documentation of this file.

/*
 * Copyright 2004-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_COMMON_SCHEDULER__H
#define PCMK__CRM_COMMON_SCHEDULER__H

#include <sys/types.h>                  // time_t
#include <libxml/tree.h>                // xmlNode
#include <glib.h>                       // guint, GList, GHashTable

#include <crm/common/iso8601.h>         // crm_time_t

#include <crm/common/actions.h>
#include <crm/common/nodes.h>
#include <crm/common/resources.h>
#include <crm/common/roles.h>
#include <crm/common/rules.h>
#include <crm/common/scheduler_types.h>

#ifdef __cplusplus
extern "C" {
#endif

// NOTE: sbd (as of at least 1.5.2) uses this enum
enum pe_quorum_policy {
    pcmk_no_quorum_freeze,  
    pcmk_no_quorum_stop,    
    pcmk_no_quorum_ignore,  
    pcmk_no_quorum_fence,   
    pcmk_no_quorum_demote,  

#if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
    // NOTE: sbd (as of at least 1.5.2) uses this value
    no_quorum_freeze    = pcmk_no_quorum_freeze,

    // NOTE: sbd (as of at least 1.5.2) uses this value
    no_quorum_stop      = pcmk_no_quorum_stop,

    // NOTE: sbd (as of at least 1.5.2) uses this value
    no_quorum_ignore    = pcmk_no_quorum_ignore,

    no_quorum_suicide   = pcmk_no_quorum_fence,

    // NOTE: sbd (as of at least 1.5.2) uses this value
    no_quorum_demote    = pcmk_no_quorum_demote,
#endif
};

typedef struct pcmk__scheduler_private pcmk__scheduler_private_t;

/* Implementation of pcmk_scheduler_t
 *
 * @COMPAT Drop this struct once all members are moved to
 * pcmk__scheduler_private_t, and repoint pcmk_scheduler_t to that
 */
struct pcmk__scheduler {
    // Be careful about when each piece of information is available and final

    // NOTE: sbd (as of at least 1.5.2) uses this
    xmlNode *input;                 // CIB XML

    // NOTE: sbd (as of at least 1.5.2) uses this
    pcmk_node_t *dc_node;           // Node object for DC

    // NOTE: sbd (as of at least 1.5.2) uses this
    uint64_t flags;                 // Group of enum pcmk__scheduler_flags

    // NOTE: sbd (as of at least 1.5.2) uses this
    enum pe_quorum_policy no_quorum_policy; // Response to loss of quorum

    // NOTE: sbd (as of at least 1.5.2) uses this
    GList *nodes;                   // Nodes in cluster

    pcmk__scheduler_private_t *priv;    
};

pcmk_node_t *pcmk_get_dc(const pcmk_scheduler_t *scheduler);
enum pe_quorum_policy pcmk_get_no_quorum_policy(const pcmk_scheduler_t
                                                *scheduler);

int pcmk_set_scheduler_cib(pcmk_scheduler_t *scheduler, xmlNode *cib);

bool pcmk_has_quorum(const pcmk_scheduler_t *scheduler);
pcmk_node_t *pcmk_find_node(const pcmk_scheduler_t *scheduler,
                            const char *node_name);

#ifdef __cplusplus
}
#endif

#endif // PCMK__CRM_COMMON_SCHEDULER__H