pacemaker/html/msg__xml_8h_source.html

/*

 * 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_MSG_XML__H

#  define PCMK__CRM_MSG_XML__H


#  include <crm/common/xml.h>


#if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)

#include <crm/msg_xml_compat.h>

#endif


#ifdef __cplusplus

extern "C" {

#endif


/* This file defines constants for various XML syntax (mainly element and

 * attribute names).

 *

 * For consistency, new constants should start with "PCMK_", followed by "XE"

 * for XML element names, "XA" for XML attribute names, and "META" for meta

 * attribute names. Old names that don't follow this policy should eventually be

 * deprecated and replaced with names that do.

 */


/*

 * XML elements

 */


#define PCMK_XE_DATE_EXPRESSION             "date_expression"

#define PCMK_XE_OP_EXPRESSION               "op_expression"


/* This has been deprecated as a CIB element (an alias for <clone> with

 * "promotable" set to "true") since 2.0.0.

 */

#define PCMK_XE_PROMOTABLE_LEGACY           "master"


#define PCMK_XE_RSC_EXPRESSION              "rsc_expression"


/*

 * XML attributes

 */


/* These have been deprecated as CIB <clone> element attributes (aliases for

 * "promoted-max" and "promoted-node-max") since 2.0.0.

 */

#define PCMK_XA_PROMOTED_MAX_LEGACY         "master-max"

#define PCMK_XA_PROMOTED_NODE_MAX_LEGACY    "master-node-max"


/*

 * Meta attributes

 */


#define PCMK_META_ENABLED                   "enabled"


/*

 * Older constants that don't follow current naming

 */


#  ifndef F_ORIG

#    define F_ORIG    "src"

#  endif


#  ifndef F_SEQ

#    define F_SEQ       "seq"

#  endif


#  ifndef F_SUBTYPE

#    define F_SUBTYPE "subt"

#  endif


#  ifndef F_TYPE

#    define F_TYPE    "t"

#  endif


#  ifndef F_CLIENTNAME

#    define F_CLIENTNAME    "cn"

#  endif


#  ifndef F_XML_TAGNAME

#    define F_XML_TAGNAME   "__name__"

#  endif


#  ifndef T_CRM

#    define T_CRM     "crmd"

#  endif


#  ifndef T_ATTRD

#    define T_ATTRD     "attrd"

#  endif


#  define CIB_OPTIONS_FIRST "cib-bootstrap-options"


#  define F_CRM_DATA            "crm_xml"

#  define F_CRM_TASK            "crm_task"

#  define F_CRM_HOST_TO         "crm_host_to"

#  define F_CRM_MSG_TYPE        F_SUBTYPE

#  define F_CRM_SYS_TO          "crm_sys_to"

#  define F_CRM_SYS_FROM        "crm_sys_from"

#  define F_CRM_HOST_FROM       F_ORIG

#  define F_CRM_REFERENCE       XML_ATTR_REFERENCE

#  define F_CRM_VERSION         XML_ATTR_VERSION

#  define F_CRM_ORIGIN          "origin"

#  define F_CRM_USER            "crm_user"

#  define F_CRM_JOIN_ID         "join_id"

#  define F_CRM_DC_LEAVING      "dc-leaving"

#  define F_CRM_ELECTION_ID     "election-id"

#  define F_CRM_ELECTION_AGE_S      "election-age-sec"

#  define F_CRM_ELECTION_AGE_US     "election-age-nano-sec"

#  define F_CRM_ELECTION_OWNER      "election-owner"

#  define F_CRM_TGRAPH          "crm-tgraph-file"

#  define F_CRM_TGRAPH_INPUT        "crm-tgraph-in"


#  define F_CRM_THROTTLE_MODE       "crm-limit-mode"

#  define F_CRM_THROTTLE_MAX        "crm-limit-max"


/*---- Common tags/attrs */

#  define XML_DIFF_MARKER       "__crm_diff_marker__"

#  define XML_TAG_CIB           "cib"

#  define XML_TAG_FAILED        "failed"


#  define XML_ATTR_CRM_VERSION      "crm_feature_set"

#  define XML_ATTR_DIGEST       "digest"

#  define XML_ATTR_VALIDATION       "validate-with"


#  define XML_ATTR_QUORUM_PANIC     "no-quorum-panic"

#  define XML_ATTR_HAVE_QUORUM      "have-quorum"

#  define XML_ATTR_HAVE_WATCHDOG    "have-watchdog"

#  define XML_ATTR_GENERATION       "epoch"

#  define XML_ATTR_GENERATION_ADMIN "admin_epoch"

#  define XML_ATTR_NUMUPDATES       "num_updates"

#  define XML_ATTR_TIMEOUT      "timeout"

#  define XML_ATTR_ORIGIN       "crm-debug-origin"

#  define XML_ATTR_TSTAMP       "crm-timestamp"

#  define XML_CIB_ATTR_WRITTEN      "cib-last-written"

#  define XML_ATTR_VERSION      "version"

#  define XML_ATTR_DESC         "description"

#  define XML_ATTR_ID           "id"

#  define XML_ATTR_NAME         "name"

#  define XML_ATTR_IDREF            "id-ref"

#  define XML_ATTR_ID_LONG      "long-id"

#  define XML_ATTR_TYPE         "type"

#  define XML_ATTR_VERBOSE      "verbose"

#  define XML_ATTR_OP           "op"

#  define XML_ATTR_DC_UUID      "dc-uuid"

#  define XML_ATTR_UPDATE_ORIG      "update-origin"

#  define XML_ATTR_UPDATE_CLIENT    "update-client"

#  define XML_ATTR_UPDATE_USER      "update-user"


#  define XML_BOOLEAN_TRUE      "true"

#  define XML_BOOLEAN_FALSE     "false"

#  define XML_BOOLEAN_YES       XML_BOOLEAN_TRUE

#  define XML_BOOLEAN_NO        XML_BOOLEAN_FALSE


#  define XML_TAG_OPTIONS       "options"


/*---- top level tags/attrs */

#  define XML_ATTR_REQUEST      "request"

#  define XML_ATTR_RESPONSE     "response"


#  define XML_ATTR_UNAME        "uname"

#  define XML_ATTR_REFERENCE        "reference"


#  define XML_CRM_TAG_PING      "ping_response"

#  define XML_PING_ATTR_STATUS      "result"

#  define XML_PING_ATTR_SYSFROM     "crm_subsystem"

#  define XML_PING_ATTR_CRMDSTATE   "crmd_state"

#  define XML_PING_ATTR_PACEMAKERDSTATE "pacemakerd_state"

#  define XML_PING_ATTR_PACEMAKERDSTATE_INIT "init"

#  define XML_PING_ATTR_PACEMAKERDSTATE_STARTINGDAEMONS "starting_daemons"

#  define XML_PING_ATTR_PACEMAKERDSTATE_WAITPING "wait_for_ping"

#  define XML_PING_ATTR_PACEMAKERDSTATE_RUNNING "running"

#  define XML_PING_ATTR_PACEMAKERDSTATE_SHUTTINGDOWN "shutting_down"

#  define XML_PING_ATTR_PACEMAKERDSTATE_SHUTDOWNCOMPLETE "shutdown_complete"

#  define XML_PING_ATTR_PACEMAKERDSTATE_REMOTE "remote"


#  define XML_TAG_FRAGMENT      "cib_fragment"


#  define XML_FAIL_TAG_CIB      "failed_update"


#  define XML_FAILCIB_ATTR_ID       "id"

#  define XML_FAILCIB_ATTR_OBJTYPE  "object_type"

#  define XML_FAILCIB_ATTR_OP       "operation"

#  define XML_FAILCIB_ATTR_REASON   "reason"


/*---- CIB specific tags/attrs */

#  define XML_CIB_TAG_SECTION_ALL   "all"

#  define XML_CIB_TAG_CONFIGURATION "configuration"

#  define XML_CIB_TAG_STATUS        "status"

#  define XML_CIB_TAG_RESOURCES     "resources"

#  define XML_CIB_TAG_NODES             "nodes"

#  define XML_CIB_TAG_DOMAINS           "domains"

#  define XML_CIB_TAG_CONSTRAINTS       "constraints"

#  define XML_CIB_TAG_CRMCONFIG     "crm_config"

#  define XML_CIB_TAG_OPCONFIG      "op_defaults"

#  define XML_CIB_TAG_RSCCONFIG     "rsc_defaults"

#  define XML_CIB_TAG_ACLS          "acls"

#  define XML_CIB_TAG_ALERTS        "alerts"

#  define XML_CIB_TAG_ALERT         "alert"

#  define XML_CIB_TAG_ALERT_RECIPIENT   "recipient"

#  define XML_CIB_TAG_ALERT_SELECT      "select"

#  define XML_CIB_TAG_ALERT_ATTRIBUTES  "select_attributes"

#  define XML_CIB_TAG_ALERT_FENCING     "select_fencing"

#  define XML_CIB_TAG_ALERT_NODES       "select_nodes"

#  define XML_CIB_TAG_ALERT_RESOURCES   "select_resources"

#  define XML_CIB_TAG_ALERT_ATTR        "attribute"


#  define XML_CIB_TAG_STATE             "node_state"

#  define XML_CIB_TAG_NODE              "node"

#  define XML_CIB_TAG_NVPAIR            "nvpair"


#  define XML_CIB_TAG_PROPSET       "cluster_property_set"

#  define XML_TAG_ATTR_SETS     "instance_attributes"

#  define XML_TAG_META_SETS     "meta_attributes"

#  define XML_TAG_ATTRS         "attributes"

#  define XML_TAG_PARAMS        "parameters"

#  define XML_TAG_PARAM         "param"

#  define XML_TAG_UTILIZATION       "utilization"


#  define XML_TAG_RESOURCE_REF      "resource_ref"

#  define XML_CIB_TAG_RESOURCE      "primitive"

#  define XML_CIB_TAG_GROUP     "group"

#  define XML_CIB_TAG_INCARNATION   "clone"

#  define XML_CIB_TAG_CONTAINER     "bundle"


#  define XML_CIB_TAG_RSC_TEMPLATE  "template"


#  define XML_RSC_ATTR_TARGET           "container-attribute-target"

#  define XML_RSC_ATTR_RESTART      "restart-type"

#  define XML_RSC_ATTR_ORDERED      "ordered"

#  define XML_RSC_ATTR_INTERLEAVE   "interleave"

#  define XML_RSC_ATTR_INCARNATION  "clone"

#  define XML_RSC_ATTR_INCARNATION_MAX  "clone-max"

#  define XML_RSC_ATTR_INCARNATION_MIN  "clone-min"

#  define XML_RSC_ATTR_INCARNATION_NODEMAX  "clone-node-max"

#  define XML_RSC_ATTR_PROMOTABLE       "promotable"

#  define XML_RSC_ATTR_PROMOTED_MAX     "promoted-max"

#  define XML_RSC_ATTR_PROMOTED_NODEMAX "promoted-node-max"

#  define XML_RSC_ATTR_MANAGED      "is-managed"

#  define XML_RSC_ATTR_TARGET_ROLE  "target-role"

#  define XML_RSC_ATTR_UNIQUE       "globally-unique"

#  define XML_RSC_ATTR_NOTIFY       "notify"

#  define XML_RSC_ATTR_STICKINESS   "resource-stickiness"

#  define XML_RSC_ATTR_FAIL_STICKINESS  "migration-threshold"

#  define XML_RSC_ATTR_FAIL_TIMEOUT "failure-timeout"

#  define XML_RSC_ATTR_MULTIPLE     "multiple-active"

#  define XML_RSC_ATTR_REQUIRES     "requires"

#  define XML_RSC_ATTR_CONTAINER    "container"

#  define XML_RSC_ATTR_INTERNAL_RSC "internal_rsc"

#  define XML_RSC_ATTR_MAINTENANCE  "maintenance"

#  define XML_RSC_ATTR_REMOTE_NODE      "remote-node"

#  define XML_RSC_ATTR_CLEAR_OP         "clear_failure_op"

#  define XML_RSC_ATTR_CLEAR_INTERVAL   "clear_failure_interval"

#  define XML_RSC_ATTR_REMOTE_RA_ADDR   "addr"

#  define XML_RSC_ATTR_REMOTE_RA_SERVER "server"

#  define XML_RSC_ATTR_REMOTE_RA_PORT   "port"

#  define XML_RSC_ATTR_CRITICAL         "critical"


#  define XML_REMOTE_ATTR_RECONNECT_INTERVAL "reconnect_interval"


#  define XML_OP_ATTR_ON_FAIL       "on-fail"

#  define XML_OP_ATTR_START_DELAY   "start-delay"

#  define XML_OP_ATTR_ALLOW_MIGRATE "allow-migrate"

#  define XML_OP_ATTR_ORIGIN        "interval-origin"

#  define XML_OP_ATTR_PENDING       "record-pending"

#  define XML_OP_ATTR_DIGESTS_ALL       "digests-all"

#  define XML_OP_ATTR_DIGESTS_SECURE    "digests-secure"


#  define XML_CIB_TAG_LRM       "lrm"

#  define XML_LRM_TAG_RESOURCES         "lrm_resources"

#  define XML_LRM_TAG_RESOURCE      "lrm_resource"

#  define XML_LRM_TAG_RSC_OP        "lrm_rsc_op"

#  define XML_AGENT_ATTR_CLASS      "class"

#  define XML_AGENT_ATTR_PROVIDER   "provider"


#  define XML_CIB_ATTR_REPLACE          "replace"


#  define XML_CIB_ATTR_SOURCE           "source"


#  define XML_CIB_ATTR_PRIORITY         "priority"

#  define XML_CIB_ATTR_SOURCE           "source"


#  define XML_NODE_JOIN_STATE       "join"

#  define XML_NODE_EXPECTED         "expected"

#  define XML_NODE_IN_CLUSTER           "in_ccm"

#  define XML_NODE_IS_PEER      "crmd"

#  define XML_NODE_IS_REMOTE        "remote_node"

#  define XML_NODE_IS_FENCED        "node_fenced"

#  define XML_NODE_IS_MAINTENANCE   "node_in_maintenance"


#  define XML_CIB_ATTR_SHUTDOWN         "shutdown"


/* Aside from being an old name for the executor, LRM is a misnomer here because

 * the controller and scheduler use these to track actions, which are not always

 * executor operations.

 */


// XML attribute that takes interval specification (user-facing configuration)

#  define XML_LRM_ATTR_INTERVAL     "interval"


// XML attribute that takes interval in milliseconds (daemon APIs)

// (identical value as above, but different constant allows clearer code intent)

#  define XML_LRM_ATTR_INTERVAL_MS  XML_LRM_ATTR_INTERVAL


#  define XML_LRM_ATTR_TASK     "operation"

#  define XML_LRM_ATTR_TASK_KEY     "operation_key"

#  define XML_LRM_ATTR_TARGET       "on_node"

#  define XML_LRM_ATTR_TARGET_UUID  "on_node_uuid"

#  define XML_LRM_ATTR_ROUTER_NODE  "router_node"

#  define XML_LRM_ATTR_RSCID        "rsc-id"

#  define XML_LRM_ATTR_OPSTATUS     "op-status"

#  define XML_LRM_ATTR_RC       "rc-code"

#  define XML_LRM_ATTR_CALLID       "call-id"

#  define XML_LRM_ATTR_OP_DIGEST    "op-digest"

#  define XML_LRM_ATTR_OP_RESTART   "op-force-restart"

#  define XML_LRM_ATTR_OP_SECURE    "op-secure-params"

#  define XML_LRM_ATTR_RESTART_DIGEST   "op-restart-digest"

#  define XML_LRM_ATTR_SECURE_DIGEST    "op-secure-digest"

#  define XML_LRM_ATTR_EXIT_REASON  "exit-reason"


#  define XML_RSC_OP_LAST_CHANGE        "last-rc-change"

#  define XML_RSC_OP_LAST_RUN           "last-run"  // deprecated since 2.0.3

#  define XML_RSC_OP_T_EXEC             "exec-time"

#  define XML_RSC_OP_T_QUEUE            "queue-time"


#  define XML_LRM_ATTR_MIGRATE_SOURCE   "migrate_source"

#  define XML_LRM_ATTR_MIGRATE_TARGET   "migrate_target"


#  define XML_TAG_GRAPH         "transition_graph"

#  define XML_GRAPH_TAG_RSC_OP      "rsc_op"

#  define XML_GRAPH_TAG_PSEUDO_EVENT    "pseudo_event"

#  define XML_GRAPH_TAG_CRM_EVENT   "crm_event"

#  define XML_GRAPH_TAG_DOWNED            "downed"

#  define XML_GRAPH_TAG_MAINTENANCE       "maintenance"


#  define XML_TAG_RULE          "rule"

#  define XML_RULE_ATTR_SCORE       "score"

#  define XML_RULE_ATTR_SCORE_ATTRIBUTE "score-attribute"

#  define XML_RULE_ATTR_ROLE        "role"

#  define XML_RULE_ATTR_BOOLEAN_OP  "boolean-op"


#  define XML_TAG_EXPRESSION        "expression"

#  define XML_EXPR_ATTR_ATTRIBUTE   "attribute"

#  define XML_EXPR_ATTR_OPERATION   "operation"

#  define XML_EXPR_ATTR_VALUE       "value"

#  define XML_EXPR_ATTR_TYPE        "type"

#  define XML_EXPR_ATTR_VALUE_SOURCE    "value-source"


#  define XML_CONS_TAG_RSC_DEPEND   "rsc_colocation"

#  define XML_CONS_TAG_RSC_ORDER    "rsc_order"

#  define XML_CONS_TAG_RSC_LOCATION "rsc_location"

#  define XML_CONS_TAG_RSC_TICKET   "rsc_ticket"

#  define XML_CONS_TAG_RSC_SET      "resource_set"

#  define XML_CONS_ATTR_SYMMETRICAL "symmetrical"


#  define XML_LOCATION_ATTR_DISCOVERY   "resource-discovery"


#  define XML_COLOC_ATTR_SOURCE     "rsc"

#  define XML_COLOC_ATTR_SOURCE_ROLE    "rsc-role"

#  define XML_COLOC_ATTR_TARGET     "with-rsc"

#  define XML_COLOC_ATTR_TARGET_ROLE    "with-rsc-role"

#  define XML_COLOC_ATTR_NODE_ATTR  "node-attribute"

#  define XML_COLOC_ATTR_INFLUENCE          "influence"


#  define XML_COLOC_ATTR_SOURCE_INSTANCE    "rsc-instance"


#  define XML_COLOC_ATTR_TARGET_INSTANCE    "with-rsc-instance"


#  define XML_LOC_ATTR_SOURCE           "rsc"

#  define XML_LOC_ATTR_SOURCE_PATTERN   "rsc-pattern"


#  define XML_ORDER_ATTR_FIRST      "first"

#  define XML_ORDER_ATTR_THEN       "then"

#  define XML_ORDER_ATTR_FIRST_ACTION   "first-action"

#  define XML_ORDER_ATTR_THEN_ACTION    "then-action"

#  define XML_ORDER_ATTR_KIND       "kind"


#  define XML_ORDER_ATTR_FIRST_INSTANCE "first-instance"


#  define XML_ORDER_ATTR_THEN_INSTANCE  "then-instance"


#  define XML_TICKET_ATTR_TICKET    "ticket"

#  define XML_TICKET_ATTR_LOSS_POLICY   "loss-policy"


#  define XML_NVPAIR_ATTR_NAME          "name"

#  define XML_NVPAIR_ATTR_VALUE         "value"


#  define XML_NODE_ATTR_RSC_DISCOVERY   "resource-discovery-enabled"


#  define XML_CONFIG_ATTR_DC_DEADTIME   "dc-deadtime"

#  define XML_CONFIG_ATTR_ELECTION_FAIL "election-timeout"

#  define XML_CONFIG_ATTR_FORCE_QUIT    "shutdown-escalation"

#  define XML_CONFIG_ATTR_RECHECK   "cluster-recheck-interval"

#  define XML_CONFIG_ATTR_FENCE_REACTION    "fence-reaction"

#  define XML_CONFIG_ATTR_SHUTDOWN_LOCK         "shutdown-lock"

#  define XML_CONFIG_ATTR_SHUTDOWN_LOCK_LIMIT   "shutdown-lock-limit"

#  define XML_CONFIG_ATTR_PRIORITY_FENCING_DELAY "priority-fencing-delay"


#  define XML_ALERT_ATTR_PATH       "path"

#  define XML_ALERT_ATTR_TIMEOUT    "timeout"

#  define XML_ALERT_ATTR_TSTAMP_FORMAT  "timestamp-format"

#  define XML_ALERT_ATTR_REC_VALUE  "value"


#  define XML_CIB_TAG_GENERATION_TUPPLE "generation_tuple"


#  define XML_ATTR_TRANSITION_MAGIC "transition-magic"

#  define XML_ATTR_TRANSITION_KEY   "transition-key"


#  define XML_ATTR_TE_NOWAIT        "op_no_wait"

#  define XML_ATTR_TE_TARGET_RC     "op_target_rc"

#  define XML_TAG_TRANSIENT_NODEATTRS   "transient_attributes"


#  define XML_TAG_DIFF_ADDED        "diff-added"

#  define XML_TAG_DIFF_REMOVED      "diff-removed"


#  define XML_ACL_TAG_USER      "acl_target"

#  define XML_ACL_TAG_USERv1        "acl_user"

#  define XML_ACL_TAG_GROUP     "acl_group"

#  define XML_ACL_TAG_ROLE      "acl_role"

#  define XML_ACL_TAG_PERMISSION    "acl_permission"

#  define XML_ACL_TAG_ROLE_REF      "role"

#  define XML_ACL_TAG_ROLE_REFv1    "role_ref"

#  define XML_ACL_ATTR_KIND     "kind"

#  define XML_ACL_TAG_READ      "read"

#  define XML_ACL_TAG_WRITE     "write"

#  define XML_ACL_TAG_DENY      "deny"

#  define XML_ACL_ATTR_REF      "reference"

#  define XML_ACL_ATTR_REFv1        "ref"

#  define XML_ACL_ATTR_TAG      "object-type"

#  define XML_ACL_ATTR_TAGv1        "tag"

#  define XML_ACL_ATTR_XPATH        "xpath"

#  define XML_ACL_ATTR_ATTRIBUTE    "attribute"


#  define XML_CIB_TAG_TICKETS       "tickets"

#  define XML_CIB_TAG_TICKET_STATE  "ticket_state"


#  define XML_CIB_TAG_TAGS          "tags"

#  define XML_CIB_TAG_TAG           "tag"

#  define XML_CIB_TAG_OBJ_REF       "obj_ref"


#  define XML_TAG_FENCING_TOPOLOGY      "fencing-topology"

#  define XML_TAG_FENCING_LEVEL         "fencing-level"

#  define XML_ATTR_STONITH_INDEX        "index"

#  define XML_ATTR_STONITH_TARGET       "target"

#  define XML_ATTR_STONITH_TARGET_VALUE     "target-value"

#  define XML_ATTR_STONITH_TARGET_PATTERN   "target-pattern"

#  define XML_ATTR_STONITH_TARGET_ATTRIBUTE "target-attribute"

#  define XML_ATTR_STONITH_DEVICES      "devices"


#  define XML_TAG_DIFF                  "diff"

#  define XML_DIFF_VERSION              "version"

#  define XML_DIFF_VSOURCE              "source"

#  define XML_DIFF_VTARGET              "target"

#  define XML_DIFF_CHANGE               "change"

#  define XML_DIFF_LIST                 "change-list"

#  define XML_DIFF_ATTR                 "change-attr"

#  define XML_DIFF_RESULT               "change-result"

#  define XML_DIFF_OP                   "operation"

#  define XML_DIFF_PATH                 "path"

#  define XML_DIFF_POSITION             "position"


#  define ID(x) crm_element_value(x, XML_ATTR_ID)

#  define TYPE(x) crm_element_name(x)


#ifdef __cplusplus

}

#endif


#endif

msg_xml_compat.h
Deprecated Pacemaker XML constants API.

xml.h
Wrappers for and extensions to libxml2.