crm.h

Go to the documentation of this file.

/*
 * Copyright 2004-2023 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_CRM__H
#  define PCMK__CRM_CRM__H

#  include <crm_config.h>
#  include <stdlib.h>
#  include <glib.h>
#  include <stdbool.h>

#  include <string.h>

#  include <libxml/tree.h>

#ifdef __cplusplus
extern "C" {
#endif

#ifndef PCMK_ALLOW_DEPRECATED

#define PCMK_ALLOW_DEPRECATED 1
#endif

#  define CRM_FEATURE_SET       "3.19.0"

/* Pacemaker's CPG protocols use fixed-width binary fields for the sender and
 * recipient of a CPG message. This imposes an arbitrary limit on cluster node
 * names.
 */
#define MAX_NAME    256

#  define CRM_META          "CRM_meta"

extern char *crm_system_name;

// How we represent "infinite" scores
#  define CRM_SCORE_INFINITY    1000000
#  define CRM_INFINITY_S        "INFINITY"
#  define CRM_PLUS_INFINITY_S   "+" CRM_INFINITY_S
#  define CRM_MINUS_INFINITY_S  "-" CRM_INFINITY_S

/* @COMPAT API < 2.0.0 Deprecated "infinity" aliases
 *
 * INFINITY might be defined elsewhere (e.g. math.h), so undefine it first.
 * This, of course, complicates any attempt to use the other definition in any
 * code that includes this header.
 */
#  undef INFINITY
#  define INFINITY_S        "INFINITY"
#  define MINUS_INFINITY_S "-INFINITY"
#  define INFINITY        1000000

/* Sub-systems */
#  define CRM_SYSTEM_DC     "dc"
#define CRM_SYSTEM_DCIB         "dcib" // Primary instance of CIB manager
#  define CRM_SYSTEM_CIB        "cib"
#  define CRM_SYSTEM_CRMD       "crmd"
#  define CRM_SYSTEM_LRMD       "lrmd"
#  define CRM_SYSTEM_PENGINE    "pengine"
#  define CRM_SYSTEM_TENGINE    "tengine"
#  define CRM_SYSTEM_STONITHD   "stonithd"
#  define CRM_SYSTEM_MCP    "pacemakerd"

// Names of internally generated node attributes
// @TODO Replace these with PCMK_NODE_ATTR_*
#  define CRM_ATTR_UNAME            "#uname"
#  define CRM_ATTR_ID               "#id"
#  define CRM_ATTR_KIND             "#kind"
#  define CRM_ATTR_ROLE             "#role"
#  define CRM_ATTR_IS_DC            "#is_dc"
#  define CRM_ATTR_CLUSTER_NAME     "#cluster-name"
#  define CRM_ATTR_SITE_NAME        "#site-name"
#  define CRM_ATTR_UNFENCED         "#node-unfenced"
#  define CRM_ATTR_DIGESTS_ALL      "#digests-all"
#  define CRM_ATTR_DIGESTS_SECURE   "#digests-secure"
#  define CRM_ATTR_PROTOCOL         "#attrd-protocol"
#  define CRM_ATTR_FEATURE_SET      "#feature-set"

/* Valid operations */
#  define CRM_OP_NOOP       "noop"
#  define CRM_OP_JOIN_ANNOUNCE  "join_announce"
#  define CRM_OP_JOIN_OFFER "join_offer"
#  define CRM_OP_JOIN_REQUEST   "join_request"
#  define CRM_OP_JOIN_ACKNAK    "join_ack_nack"
#  define CRM_OP_JOIN_CONFIRM   "join_confirm"
#  define CRM_OP_PING       "ping"
#  define CRM_OP_NODE_INFO  "node-info"
#  define CRM_OP_THROTTLE   "throttle"
#  define CRM_OP_VOTE       "vote"
#  define CRM_OP_NOVOTE     "no-vote"
#  define CRM_OP_HELLO      "hello"
#  define CRM_OP_PECALC     "pe_calc"
#  define CRM_OP_QUIT       "quit"
#  define CRM_OP_LOCAL_SHUTDOWN     "start_shutdown"
#  define CRM_OP_SHUTDOWN_REQ   "req_shutdown"
#  define CRM_OP_SHUTDOWN   PCMK_ACTION_DO_SHUTDOWN
#  define CRM_OP_REGISTER       "register"
#  define CRM_OP_IPC_FWD        "ipc_fwd"
#  define CRM_OP_INVOKE_LRM "lrm_invoke"
#  define CRM_OP_LRM_REFRESH "lrm_refresh" 
#  define CRM_OP_LRM_DELETE         PCMK_ACTION_LRM_DELETE
#  define CRM_OP_LRM_FAIL       "lrm_fail"
#  define CRM_OP_PROBED     "probe_complete"
#  define CRM_OP_REPROBE        "probe_again"
#  define CRM_OP_CLEAR_FAILCOUNT    PCMK_ACTION_CLEAR_FAILCOUNT
#  define CRM_OP_REMOTE_STATE     "remote_state"
#  define CRM_OP_RM_NODE_CACHE "rm_node_cache"
#  define CRM_OP_MAINTENANCE_NODES  PCMK_ACTION_MAINTENANCE_NODES

/* Possible cluster membership states */
#  define CRMD_JOINSTATE_DOWN           "down"
#  define CRMD_JOINSTATE_PENDING        "pending"
#  define CRMD_JOINSTATE_MEMBER         "member"
#  define CRMD_JOINSTATE_NACK           "banned"

#  include <crm/common/actions.h>
#  include <crm/common/cib.h>
#  include <crm/common/logging.h>
#  include <crm/common/util.h>

#if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
#include <crm/crm_compat.h>
#endif

#ifdef __cplusplus
}
#endif

#endif