root/include/crm/crm.h

/* [previous][next][first][last][top][bottom][index][help] */

INCLUDED FROM


DEFINITIONS

This source file includes following definitions.
  1. crm_action_str

   1 /*
   2  * Copyright 2004-2022 the Pacemaker project contributors
   3  *
   4  * The version control history for this file may have further details.
   5  *
   6  * This source code is licensed under the GNU Lesser General Public License
   7  * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
   8  */
   9 
  10 #ifndef PCMK__CRM_CRM__H
  11 #  define PCMK__CRM_CRM__H
  12 
  13 #  include <crm_config.h>
  14 #  include <stdlib.h>
  15 #  include <glib.h>
  16 #  include <stdbool.h>
  17 
  18 #  include <string.h>
  19 
  20 #  include <libxml/tree.h>
  21 
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif
  25 
  26 /**
  27  * \file
  28  * \brief A dumping ground
  29  * \ingroup core
  30  */
  31 
  32 #ifndef PCMK_ALLOW_DEPRECATED
  33 /*!
  34  * \brief Allow use of deprecated Pacemaker APIs
  35  *
  36  * By default, external code using Pacemaker headers is allowed to use
  37  * deprecated Pacemaker APIs. If PCMK_ALLOW_DEPRECATED is defined to 0 before
  38  * including any Pacemaker headers, deprecated APIs will be unusable. It is
  39  * strongly recommended to leave this unchanged for production and release
  40  * builds, to avoid breakage when users upgrade to new Pacemaker releases that
  41  * deprecate more APIs. This should be defined to 0 only for development and
  42  * testing builds when desiring to check for usage of currently deprecated APIs.
  43  */
  44 #define PCMK_ALLOW_DEPRECATED 1
  45 #endif
  46 
  47 /*!
  48  * The CRM feature set assists with compatibility in mixed-version clusters.
  49  * The major version number increases when nodes with different versions
  50  * would not work (rolling upgrades are not allowed). The minor version
  51  * number increases when mixed-version clusters are allowed only during
  52  * rolling upgrades (a node with the oldest feature set will be elected DC). The
  53  * minor-minor version number is ignored, but allows resource agents to detect
  54  * cluster support for various features.
  55  *
  56  * The feature set also affects the processing of old saved CIBs (such as for
  57  * many scheduler regression tests).
  58  *
  59  * Particular feature points currently tested by Pacemaker code:
  60  *
  61  * >2.1:     Operation updates include timing data
  62  * >=3.0.5:  XML v2 digests are created
  63  * >=3.0.8:  Peers do not need acks for cancellations
  64  * >=3.0.9:  DC will send its own shutdown request to all peers
  65  *           XML v2 patchsets are created by default
  66  * >=3.0.13: Fail counts include operation name and interval
  67  * >=3.2.0:  DC supports PCMK_EXEC_INVALID and PCMK_EXEC_NOT_CONNECTED
  68  */
  69 #  define CRM_FEATURE_SET               "3.16.1"
  70 
  71 /* Pacemaker's CPG protocols use fixed-width binary fields for the sender and
  72  * recipient of a CPG message. This imposes an arbitrary limit on cluster node
  73  * names.
  74  */
  75 //! \brief Maximum length of a Corosync cluster node name (in bytes)
  76 #define MAX_NAME        256
  77 
  78 #  define CRM_META                      "CRM_meta"
  79 
  80 extern char *crm_system_name;
  81 
  82 /* *INDENT-OFF* */
  83 
  84 // How we represent "infinite" scores
  85 #  define CRM_SCORE_INFINITY    1000000
  86 #  define CRM_INFINITY_S        "INFINITY"
  87 #  define CRM_PLUS_INFINITY_S   "+" CRM_INFINITY_S
  88 #  define CRM_MINUS_INFINITY_S  "-" CRM_INFINITY_S
  89 
  90 /* @COMPAT API < 2.0.0 Deprecated "infinity" aliases
  91  *
  92  * INFINITY might be defined elsewhere (e.g. math.h), so undefine it first.
  93  * This, of course, complicates any attempt to use the other definition in any
  94  * code that includes this header.
  95  */
  96 #  undef INFINITY
  97 #  define INFINITY_S        "INFINITY"
  98 #  define MINUS_INFINITY_S "-INFINITY"
  99 #  define INFINITY        1000000
 100 
 101 /* Sub-systems */
 102 #  define CRM_SYSTEM_DC         "dc"
 103 #define CRM_SYSTEM_DCIB         "dcib" // Primary instance of CIB manager
 104 #  define CRM_SYSTEM_CIB                "cib"
 105 #  define CRM_SYSTEM_CRMD               "crmd"
 106 #  define CRM_SYSTEM_LRMD               "lrmd"
 107 #  define CRM_SYSTEM_PENGINE    "pengine"
 108 #  define CRM_SYSTEM_TENGINE    "tengine"
 109 #  define CRM_SYSTEM_STONITHD   "stonithd"
 110 #  define CRM_SYSTEM_MCP        "pacemakerd"
 111 
 112 // Names of internally generated node attributes
 113 #  define CRM_ATTR_UNAME            "#uname"
 114 #  define CRM_ATTR_ID               "#id"
 115 #  define CRM_ATTR_KIND             "#kind"
 116 #  define CRM_ATTR_ROLE             "#role"
 117 #  define CRM_ATTR_IS_DC            "#is_dc"
 118 #  define CRM_ATTR_CLUSTER_NAME     "#cluster-name"
 119 #  define CRM_ATTR_SITE_NAME        "#site-name"
 120 #  define CRM_ATTR_UNFENCED         "#node-unfenced"
 121 #  define CRM_ATTR_DIGESTS_ALL      "#digests-all"
 122 #  define CRM_ATTR_DIGESTS_SECURE   "#digests-secure"
 123 #  define CRM_ATTR_PROTOCOL         "#attrd-protocol"
 124 #  define CRM_ATTR_FEATURE_SET      "#feature-set"
 125 
 126 /* Valid operations */
 127 #  define CRM_OP_NOOP           "noop"
 128 #  define CRM_OP_JOIN_ANNOUNCE  "join_announce"
 129 #  define CRM_OP_JOIN_OFFER     "join_offer"
 130 #  define CRM_OP_JOIN_REQUEST   "join_request"
 131 #  define CRM_OP_JOIN_ACKNAK    "join_ack_nack"
 132 #  define CRM_OP_JOIN_CONFIRM   "join_confirm"
 133 #  define CRM_OP_PING           "ping"
 134 #  define CRM_OP_NODE_INFO  "node-info"
 135 #  define CRM_OP_THROTTLE       "throttle"
 136 #  define CRM_OP_VOTE           "vote"
 137 #  define CRM_OP_NOVOTE         "no-vote"
 138 #  define CRM_OP_HELLO          "hello"
 139 #  define CRM_OP_PECALC         "pe_calc"
 140 #  define CRM_OP_QUIT           "quit"
 141 #  define CRM_OP_LOCAL_SHUTDOWN         "start_shutdown"
 142 #  define CRM_OP_SHUTDOWN_REQ   "req_shutdown"
 143 #  define CRM_OP_SHUTDOWN       "do_shutdown"
 144 #  define CRM_OP_FENCE          "stonith"
 145 #  define CRM_OP_REGISTER               "register"
 146 #  define CRM_OP_IPC_FWD                "ipc_fwd"
 147 #  define CRM_OP_INVOKE_LRM     "lrm_invoke"
 148 #  define CRM_OP_LRM_REFRESH "lrm_refresh" //!< Deprecated since 1.1.10
 149 #  define CRM_OP_LRM_DELETE     "lrm_delete"
 150 #  define CRM_OP_LRM_FAIL               "lrm_fail"
 151 #  define CRM_OP_PROBED         "probe_complete"
 152 #  define CRM_OP_REPROBE                "probe_again"
 153 #  define CRM_OP_CLEAR_FAILCOUNT  "clear_failcount"
 154 #  define CRM_OP_REMOTE_STATE     "remote_state"
 155 #  define CRM_OP_RELAXED_SET  "one-or-more"
 156 #  define CRM_OP_RELAXED_CLONE  "clone-one-or-more"
 157 #  define CRM_OP_RM_NODE_CACHE "rm_node_cache"
 158 #  define CRM_OP_MAINTENANCE_NODES "maintenance_nodes"
 159 
 160 /* Possible cluster membership states */
 161 #  define CRMD_JOINSTATE_DOWN           "down"
 162 #  define CRMD_JOINSTATE_PENDING        "pending"
 163 #  define CRMD_JOINSTATE_MEMBER         "member"
 164 #  define CRMD_JOINSTATE_NACK           "banned"
 165 
 166 #  define CRMD_ACTION_DELETE            "delete"
 167 #  define CRMD_ACTION_CANCEL            "cancel"
 168 
 169 #  define CRMD_ACTION_RELOAD            "reload"
 170 #  define CRMD_ACTION_RELOAD_AGENT      "reload-agent"
 171 #  define CRMD_ACTION_MIGRATE           "migrate_to"
 172 #  define CRMD_ACTION_MIGRATED          "migrate_from"
 173 
 174 #  define CRMD_ACTION_START             "start"
 175 #  define CRMD_ACTION_STARTED           "running"
 176 
 177 #  define CRMD_ACTION_STOP              "stop"
 178 #  define CRMD_ACTION_STOPPED           "stopped"
 179 
 180 #  define CRMD_ACTION_PROMOTE           "promote"
 181 #  define CRMD_ACTION_PROMOTED          "promoted"
 182 #  define CRMD_ACTION_DEMOTE            "demote"
 183 #  define CRMD_ACTION_DEMOTED           "demoted"
 184 
 185 #  define CRMD_ACTION_NOTIFY            "notify"
 186 #  define CRMD_ACTION_NOTIFIED          "notified"
 187 
 188 #  define CRMD_ACTION_STATUS            "monitor"
 189 #  define CRMD_ACTION_METADATA          "meta-data"
 190 #  define CRMD_METADATA_CALL_TIMEOUT   30000
 191 
 192 /* short names */
 193 #  define RSC_DELETE    CRMD_ACTION_DELETE
 194 #  define RSC_CANCEL    CRMD_ACTION_CANCEL
 195 
 196 #  define RSC_MIGRATE   CRMD_ACTION_MIGRATE
 197 #  define RSC_MIGRATED  CRMD_ACTION_MIGRATED
 198 
 199 #  define RSC_START     CRMD_ACTION_START
 200 #  define RSC_STARTED   CRMD_ACTION_STARTED
 201 
 202 #  define RSC_STOP      CRMD_ACTION_STOP
 203 #  define RSC_STOPPED   CRMD_ACTION_STOPPED
 204 
 205 #  define RSC_PROMOTE   CRMD_ACTION_PROMOTE
 206 #  define RSC_PROMOTED  CRMD_ACTION_PROMOTED
 207 #  define RSC_DEMOTE    CRMD_ACTION_DEMOTE
 208 #  define RSC_DEMOTED   CRMD_ACTION_DEMOTED
 209 
 210 #  define RSC_NOTIFY    CRMD_ACTION_NOTIFY
 211 #  define RSC_NOTIFIED  CRMD_ACTION_NOTIFIED
 212 
 213 #  define RSC_STATUS    CRMD_ACTION_STATUS
 214 #  define RSC_METADATA  CRMD_ACTION_METADATA
 215 /* *INDENT-ON* */
 216 
 217 #  include <crm/common/cib.h>
 218 #  include <crm/common/logging.h>
 219 #  include <crm/common/util.h>
 220 
 221 static inline const char *
 222 crm_action_str(const char *task, guint interval_ms) {
     /* [previous][next][first][last][top][bottom][index][help] */
 223     if ((task != NULL) && (interval_ms == 0)
 224         && (strcasecmp(task, RSC_STATUS) == 0)) {
 225         return "probe";
 226     }
 227     return task;
 228 }
 229 
 230 #if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
 231 #include <crm/crm_compat.h>
 232 #endif
 233 
 234 #ifdef __cplusplus
 235 }
 236 #endif
 237 
 238 #endif

/* [previous][next][first][last][top][bottom][index][help] */