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_scheduler_t *pcmk_new_scheduler(void);
void pcmk_reset_scheduler(pcmk_scheduler_t *scheduler);
void pcmk_free_scheduler(pcmk_scheduler_t *scheduler);
 
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