Page MenuHomeClusterLabs Projects
IndexNew Document
Phriction Welcome to the ClusterLabs Wiki Projects Pacemaker Pacemaker 3.0 Changes Pacemaker 3.0 Api Changes History Version 13 vs 41

Version 13 vs 41

Edits

  • Edit by kgaillot, Version 41
    • Sep 23 2024 11:34 AM
  • Edit by kgaillot, Version 13
    • May 30 2024 10:57 AM
Edit Older Version 13...Edit Current Version 41...

Content Changes

This document only indicates APIs that were dropped or changed incompatibly. Additions and new deprecations can be seen in the ChangeLog. == libcib == The following symbols were dropped from the library === Types, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | cib_api_operations_t (cib_t cmds member) delete_absolute() member | remove() | | cib_api_operations_t (cib_t cmds member) inputfd(), is_master(), quit(), and set_slave_all() members | | | cib_api_operations_t (cib_t cmds member) set_master() member | set_primary() | | cib_api_operations_t (cib_t cmds member) set_slave() member | set_secondary() | | cib_api_operations_t (cib_t cmds member) set_op_callback() member | register_callback() or register_callback_full() for individual calls | | cib_api_operations_t (cib_t cmds member) signon_raw() member | signon() | | cib_api_operations_t (cib_t cmds member) update() member | modify() | | cib_database (in enum cib_variant) | | | cib_inhibit_bcast (in enum cib_call_options) | | | cib_mixed_update (in enum cib_call_options) | | | cib_quorum_override (in enum cib_call_options) | | | cib_t op_callback() member | | | cib_zero_copy (in enum cib_call_options) | | === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | cib_get_generation() | | | cib_metadata() | | | cib_pref() | | | get_object_parent() | pcmk_cib_parent_name_for() | | get_object_path() | pcmk_cib_xpath_for() | | get_object_root() | pcmk_cib_xpath_for() | | query_node_uname() | | | set_standby() | | --- == libcrmcluster == The following symbols were dropped from the library. === Headers === The `crm/cluster.h` header no longer includes `stdint.h`, `libxml/tree.h`, `crm/common/util.h`, or `crm/common/xml.h`. If you were previously relying on any of those being included transitively, you will need to include them explicitly. === Constants === | Dropped | Suggested replacement (if any) | | -- | -- | | CRM_NODE_LOST | | | CRM_NODE_MEMBER | PCMK_VALUE_MEMBER | === Types, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | crm_node_t | | | enum crm_ais_msg_class | | | enum crm_ais_msg_types | | | enum crm_get_peer_flags | | | enum crm_join_phase | | | enum crm_node_flags | | | enum crm_status_type | | | struct crm_peer_node_s | | In addition, `struct crm_cluster_s` (`pcmk_cluster_t`) has been renamed to the internal name `struct pcmk__cluster`, which should not be used directly. Direct access to all members except for `cpg` and `destroy` has been dropped. Direct access to the remaining members is still deprecated. === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | cluster_connect_cpg() | | | cluster_disconnect_cpg() | | | crm_active_peers() | | | crm_cluster_disconnect() | pcmk_cluster_disconnect() | | crm_get_peer() | | | crm_get_peer_full() | | | crm_is_corosync_peer_active() | | | crm_is_peer_active() | | | crm_join_phase_str() | | | crm_peer_destroy() | | | crm_peer_uname() | | | crm_peer_uuid() | | | crm_remote_peer_cache_refresh() | | | crm_remote_peer_cache_remove() | | | crm_remote_peer_cache_size() | | | crm_remote_peer_get() | | | crm_set_autoreap() | | | crm_set_status_callback() | | | crm_terminate_member() | stonith_api_kick() | | crm_terminate_member_no_mainloop() | stonith_api_kick() | | get_local_nodeid() | | | get_local_node_name() | | | get_node_name() | | | is_corosync_cluster() | pcmk_get_cluster_layer() | | pcmk_cpg_membership() | | | pcmk_message_common_cs() | | | reap_crm_member() | | | send_cluster_message() | | | send_cluster_text() | | | set_uuid() | | | text2msg_type() | | === Global variables === | Dropped | Suggested replacement (if any) | | -- | -- | | crm_have_quorum | | | crm_peer_cache | | | crm_peer_seq | | | crm_remote_peer_cache | | --- == libcrmcommon == The following symbols were dropped from the library === Headers === | Dropped | Suggested replacement (if any) | | -- | -- | | compatibility.h | | | tags.h | | | tickets.h | | === Constants === | Dropped | Suggested replacement (if any) | | -- | -- | | CIB_OPTIONS_FIRST | PCMK_VALUE_CIB_BOOTSTRAP_OPTIONS | | CRM_ATTR_RA_VERSION | | | CRM_INFINITYDEFAULT_OP_TIMEOUT_S | | | CRM_MINUSINFINITY_S | PCMK_VALUE_INFINITY_S | | | | CRM_MINUS_INFINITY_S | PCMK_VALUE_MINUS_INFINITY | | CRM_OP_FENCE | |PCMK_ACTION_STONITH | | CRM_OP_LOCAL_SHUTDOWN | | | CRM_OP_LRM_QUERY | | | CRM_OP_LRM_REFRESH | | | CRM_OP_RELAXED_CLONE | |PCMK_ACTION_CLONE_ONE_OR_MORE | | CRM_OP_RELAXED_SET | PCMK_ACTION_ONE_OR_MORE | | CRM_PLUS_INFINITY_S | PCMK_VALUE_PLUS_INFINITY | | CRMD_ACTION_CANCEL | PCMK_ACTION_CANCEL | | CRMD_ACTION_DELETE | PCMK_ACTION_DELETE | | CRMD_ACTION_DEMOTE | PCMK_ACTION_DEMOTE | | CRMD_ACTION_DEMOTED | PCMK_ACTION_DEMOTED | | CRMD_ACTION_METADATA | PCMK_ACTION_META_DATA | | CRMD_ACTION_MIGRATE | PCMK_ACTION_MIGRATE_TO | | CRMD_ACTION_MIGRATED | PCMK_ACTION_MIGRATE_FROM | | CRMD_ACTION_NOTIFIED | PCMK_ACTION_NOTIFIED | | CRMD_ACTION_NOTIFY | PCMK_ACTION_NOTIFY | | CRMD_ACTION_PROMOTE | PCMK_ACTION_PROMOTE | | CRMD_ACTION_PROMOTED | PCMK_ACTION_PROMOTED | | CRMD_ACTION_RELOAD | PCMK_ACTION_RELOAD | | CRMD_ACTION_RELOAD_AGENT | PCMK_ACTION_RELOAD_AGENT | | CRMD_ACTION_START | PCMK_ACTION_START | | CRMD_ACTION_STARTED | PCMK_ACTION_RUNNING | | CRMD_ACTION_STATUS | PCMK_ACTION_MONITOR | | CRMD_ACTION_STOP | PCMK_ACTION_STOP | | CRMD_ACTION_STOPPED | PCMK_ACTION_STOPPED | | CRMD_METADATA | | | EOS | '\0' | | F_CLIENTNAME | | | F_CRM_DATA | | | F_CRM_DC_LEAVING | | | F_CRM_ELECTION_AGE_S | | | F_CRM_ELECTION_AGE_US | | | F_CRM_ELECTION_ID | | | F_CRM_ELECTION_OWNER | | | F_CRM_HOST_FROM | | | F_CRM_HOST_TO | | | F_CRM_JOIN_ID | | | F_CRM_MSG_TYPE | | | F_CRM_ORIGIN | PCMK_XA_ORIGIN | | F_CRM_REFERENCE | | | F_CRM_SYS_FROM | | | F_CRM_SYS_TO | | | F_CRM_TASK | | | F_CRM_TGRAPH | | | F_CRM_TGRAPH_INPUT | | | F_CRM_THROTTLE_MAX | | | F_CRM_THROTTLE_MODE | | | F_CRM_USER | | | F_CRM_VERSION | PCMK_XA_VERSION | | F_ORIG | | | F_SEQ | | | F_SUBTYPE | | | F_TYPE | | | F_XML_TAGNAME | | | INFINITY | PCMK_SCORE_INFINITY | | INFINITY_S | PCMK_VALUE_INFINITY | | MAX_IPC_DELAY | | | MINUS_INFINITY_S | PCMK_VALUE_MINUS_INFINITY | | OFFLINESTATUS | PCMK_VALUE_OFFLINE | | ONLINESTATUS | PCMK_VALUE_ONLINE | | PCMK_DEFAULT_METADATA_TIMEOUT_MS | | | PCMK_XA_PROMOTED_MAX_LEGACY | | | PCMK_XA_PROMOTED_NODE_MAX_LEGACY | | | PCMK_XE_PROMOTABLE_LEGACY | | | PCMK_XE_PROMOTED_MAX_LEGACY | | | PCMK_XE_PROMOTED_NODE_MAX_LEGACY | | | RSC_CANCEL | PCMK_ACTION_CANCEL | | RSC_DELETE | PCMK_ACTION_DELETE | | RSC_DEMOTE | PCMK_ACTION_DEMOTE | | RSC_DEMOTED | PCMK_ACTION_DEMOTED | | RSC_METADATA | PCMK_ACTION_META_DATA | | RSC_MIGRATE | PCMK_ACTION_MIGRATE_TO | | RSC_MIGRATED | PCMK_ACTION_MIGRATE_FROM | | RSC_DELETE | |NOTIFIED | PCMK_ACTION_NOTIFIED | | RSC_DEMOTE | |NOTIFY | PCMK_ACTION_NOTIFY | | RSC_DEPROMOTED | | | PCMK_ACTION_PROMOTE | | RSC_METADATA | |PROMOTED | PCMK_ACTION_PROMOTED | | RSC_MIGRATE | |ROLE_MASTER | pcmk_role_promoted | | RSC_MIGRAROLE_PROMOTED | |pcmk_role_promoted | | RSC_NOTIFIED | |ROLE_SLAVE | pcmk_role_unpromoted | | RSC_NOTIFY | |ROLE_STARTED | pcmk_role_started | | RSC_PROMOTE | |ROLE_STOPPED | pcmk_role_stopped | | RSC_PROMOTED | |ROLE_UNKNOWN | pcmk_role_unknown | | RSC_START | |ROLE_UNPROMOTED | pcmk_role_unpromoted | | RSC_STARTED | | | PCMK_ACTION_START | | RSC_STATUS | |RTED | PCMK_ACTION_RUNNING | | RSC_STOP | |ATUS | PCMK_ACTION_MONITOR | | RSC_STOP | PCMK_ACTION_STOP | | RSC_STOPPED | |PCMK_ACTION_STOPPED | | T_ATTRD | | | T_CRM | | | T_STONITH_NOTIFY_DISCONNECT | | | T_STONITH_NOTIFY_FENCE | | | T_STONITH_NOTIFY_HISTORY | | | T_STONITH_NOTIFY_HISTORY_SYNCED | | | XML_ACL_ATTR_ATTRIBUTE | PCMK_XA_ATTRIBUTE | | XML_ACL_ATTR_KIND | PCMK_XA_KIND | | XML_ACL_ATTR_REF | PCMK_XA_REFERENCE | | XML_ACL_ATTR_REFv1 | | | XML_ACL_ATTR_TAG | PCMK_XA_OBJECT_TYPE | | XML_ACL_ATTR_TAGv1 | | | XML_ACL_ATTR_XPATH | PCMK_XA_XPATH | | XML_ACL_TAG_DENY | | | XML_ACL_TAG_GROUP | PCMK_XE_ACL_GROUP | | XML_ACL_TAG_PERMISSION | PCMK_XE_ACL_PERMISSION | | XML_ACL_TAG_READ | | | XML_ACL_TAG_ROLE | PCMK_XE_ACL_ROLE | | XML_ACL_TAG_ROLE_REF | PCMK_XE_ROLE | | XML_ACL_TAG_ROLE_REFv1 | | | XML_ACL_TAG_USER | | | XML_ACL_TAG_USERv1 | | | XML_ACL_TAG_WRITE | | | XML_AGENT_ATTR_CLASS | PCMK_XA_CLASS | | XML_AGENT_ATTR_PROVIDER | PCMK_XA_PROVIDER | | XML_ALERT_ATTR_PATH | PCMK_XA_PATH | | XML_ALERT_ATTR_REC_VALUE | PCMK_XA_VALUE | | XML_ALERT_ATTR_TIMEOUT | PCMK_META_TIMEOUT | | XML_ALERT_ATTR_TSTAMP_FORMAT | PCMK_META_TIMESTAMP_FORMAT | | XML_ATTR_CRM_VERSION | PCMK_XA_CRM_FEATURE_SET | | XML_ATTR_DC_UUID | PCMK_XA_DC_UUID | | XML_ATTR_DESC | PCMK_XA_DESCRIPTION | | XML_ATTR_DIGEST | | | XML_ATTR_GENERATION | PCMK_XA_EPOCH | | XML_ATTR_GENERATION_ADMIN | | | XML_ATTR_HAVE_QUORUM | PCMK_XA_HAVE_QUORUM | | XML_ATTR_HAVE_WATCHDOG | PCMK_OPT_HAVE_WATCHDOG | | XML_ATTR_ID | PCMK_XA_ID | | XML_ATTR_ID_LONG | | | XML_ATTR_IDREF | PCMK_XA_ID_REF | | XML_ATTR_NAME | PCMK_XA_NAME | | XML_ATTR_NUMUPDATES | PCMK_XA_NUM_UPDATES | | XML_ATTR_OP | PCMK_XE_OP | | XML_ATTR_ORIGIN | PCMK_XA_CRM_DEBUG_ORIGIN | | XML_ATTR_QUORUM_PANIC | PCMK_XA_NO_QUORUM_PANIC | | XML_ATTR_RA_VERSION | | | XML_ATTR_REFERENCE | PCMK_XA_REFERENCE | | XML_ATTR_REQUEST | PCMK_XA_REQUEST | | XML_ATTR_RESPONSE | | | XML_ATTR_STONITH_DEVICES | PCMK_XA_DEVICES | | XML_ATTR_STONITH_INDEX | PCMK_XA_INDEX | | XML_ATTR_STONITH_TARGET | PCMK_XA_TARGET | | XML_ATTR_STONITH_TARGET_ATTRIBUTE | PCMK_XA_TARGET_ATTRIBUTE | | XML_ATTR_STONITH_TARGET_PATTERN | PCMK_XA_TARGET_PATTERN | | XML_ATTR_STONITH_TARGET_VALUE | PCMK_XA_TARGET_VALUE | | XML_ATTR_TE_NOWAIT | | | XML_ATTR_TE_TARGET_RC | | | XML_ATTR_TIMEOUT | PCMK_META_TIMEOUT | | XML_ATTR_TRANSITION_KEY | | | XML_ATTR_TRANSITION_MAGIC | | | XML_ATTR_TSTAMP | PCMK_XA_CRM_TIMESTAMP | | XML_ATTR_TYPE | PCMK_XA_TYPE | | XML_ATTR_UNAME | PCMK_XA_UNAME | | XML_ATTR_UPDATE_CLIENT | PCMK_XA_UPDATE_CLIENT | | XML_ATTR_UPDATE_ORIG | PCMK_XA_UPDATE_ORIGIN | | XML_ATTR_UPDATE_USER | PCMK_XA_UPDATE_USER | | XML_ATTR_UUID | XML_ATTR_UUPCMK_XA_ID | | XML_ATTR_VALIDATION | PCMK_XA_VALIDATE_WITH | | XML_ATTR_VERBOSE | | | XML_ATTR_VERSION | PCMK_XA_VERSION | | XML_BOOLEAN_FALSE | PCMK_VALUE_FALSE | | XML_BOOLEAN_NO | PCMK_VALUE_FALSE | | XML_BOOLEAN_TRUE | PCMK_VALUE_TRUE | | XML_BOOLEAN_YES | PCMK_VALUE_TRUE | | XML_CIB_ATTR_PRIORITY | | | XML_CIB_ATTR_REPLACE | | | XML_CIB_ATTR_SHUTDOWN | | | XML_CIB_ATTR_SOURCE | | | XML_CIB_ATTR_WRITTEN | PCMK_XA_CIB_LAST_WRITTEN | | XML_CIB_TAG_ACLS | PCMK_XE_ACLS | | XML_CIB_TAG_ALERT | PCMK_XE_ALERT | | XML_CIB_TAG_ALERT_ATTR | PCMK_XE_ATTRIBUTE | | XML_CIB_TAG_ALERT_ATTRIBUTES | PCMK_XE_SELECT_ATTRIBUTES | | XML_CIB_TAG_ALERT_FENCING | PCMK_XE_SELECT_FENCING | | XML_CIB_TAG_ALERT_NODES | PCMK_XE_SELECT_NODES | | XML_CIB_TAG_ALERT_RECIPIENT | PCMK_XE_RECIPIENT | | XML_CIB_TAG_ALERT_RESOURCES | PCMK_XE_SELECT_RESOURCES | | XML_CIB_TAG_ALERTS | PCMK_XE_ALERTS | | XML_CIB_TAG_ALERT_SELECT | PCMK_XE_SELECT | | XML_CIB_TAG_CONFIGURATION | PCMK_XE_CONFIGURATION | | XML_CIB_TAG_CONSTRAINTS | PCMK_XE_CONSTRAINTS | | XML_CIB_TAG_CONTAINER | PCMK_XE_BUNDLE | | XML_CIB_TAG_CRMCONFIG | PCMK_XE_CRM_CONFIG | | XML_CIB_TAG_DOMAINS | | | XML_CIB_TAG_GENERATION_TUPPLE | | | XML_CIB_TAG_GROUP | PCMK_XE_GROUP | | XML_CIB_TAG_INCARNATION | PCMK_XE_CLONE | | XML_CIB_TAG_LRM | | | XML_CIB_TAG_MASTER | | | XML_CIB_TAG_NODE | PCMK_XE_NODE | | XML_CIB_TAG_NODES | PCMK_XE_NODES | | XML_CIB_TAG_NVPAIR | PCMK_XE_NVPAIR | | XML_CIB_TAG_OBJ_REF | PCMK_XE_OBJ_REF | | XML_CIB_TAG_OPCONFIG | PCMK_XE_OP_DEFAULTS | | XML_CIB_TAG_PROPSET | PCMK_XE_CLUSTER_PROPERTY_SET | | XML_CIB_TAG_RESOURCE | PCMK_XE_PRIMITIVE | | XML_CIB_TAG_RESOURCES | PCMK_XE_RESOURCES | | XML_CIB_TAG_RSCCONFIG | PCMK_XE_RSC_DEFAULTS | | XML_CIB_TAG_RSC_TEMPLATE | PCMK_XE_TEMPLATE | | XML_CIB_TAG_SECTION_ALL | | | XML_CIB_TAG_STATE | | | XML_CIB_TAG_STATUS | PCMK_XE_STATUS | | XML_CIB_TAG_TAG | PCMK_XE_TAG | | XML_CIB_TAG_TAGS | PCMK_XE_TAGS | | XML_CIB_TAG_TICKETS | PCMK_XE_TICKETS | | XML_CIB_TAG_TICKET_STATE | | | XML_COLOC_ATTR_INFLUENCE | PCMK_XA_INFLUENCE | | XML_COLOC_ATTR_NODE_ATTR | PCMK_XA_NODE_ATTRIBUTE | | XML_COLOC_ATTR_SOURCE | PCMK_XA_RSC | | XML_COLOC_ATTR_SOURCE_INSTANCE | | | XML_COLOC_ATTR_SOURCE_ROLE | PCMK_XA_RSC_ROLE | | XML_COLOC_ATTR_TARGET | PCMK_XA_WITH_RSC | | XML_COLOC_ATTR_TARGET_INSTANCE | | | XML_COLOC_ATTR_TARGET_ROLE | PCMK_XA_WITH_RSC_ROLE | | XML_CONFIG_ATTR_DC_DEADTIME | PCMK_OPT_DC_DEADTIME | | XML_CONFIG_ATTR_ELECTION_FAIL | PCMK_OPT_ELECTION_TIMEOUT | | XML_CONFIG_ATTR_FENCE_REACTION | PCMK_OPT_FENCE_REACTION | | XML_CONFIG_ATTR_FORCE_QUIT | PCMK_OPT_SHUTDOWN_ESCALATION | | XML_CONFIG_ATTR_NODE_PENDING_TIMEOUT | PCMK_OPT_NODE_PENDING_TIMEOUT | | XML_CONFIG_ATTR_PRIORITY_FENCING_DELAY | PCMK_OPT_PRIORITY_FENCING_DELAY | | XML_CONFIG_ATTR_RECHECK | PCMK_OPT_CLUSTER_RECHECK_INTERVAL | | XML_CONFIG_ATTR_SHUTDOWN_LOCK | PCMK_OPT_SHUTDOWN_LOCK | | XML_CONFIG_ATTR_SHUTDOWN_LOCK_LIMIT | PCMK_OPT_SHUTDOWN_LOCK_LIMIT | | XML_CONS_ATTR_SYMMETRICAL | PCMK_XA_SYMMETRICAL | | XML_CONS_TAG_RSC_DEPEND | PCMK_XE_RSC_COLOCATION | | XML_CONS_TAG_RSC_LOCATION | PCMK_XE_RSC_LOCATION | | XML_CONS_TAG_RSC_ORDER | PCMK_XE_RSC_ORDER | | XML_CONS_TAG_RSC_SET | PCMK_XE_RESOURCE_SET | | XML_CONS_TAG_RSC_TICKET | PCMK_XE_RSC_TICKET | | XML_CRM_TAG_PING | | | XML_DIFF_ATTR | PCMK_XE_CHANGE_ATTR | | XML_DIFF_CHANGE | PCMK_XE_CHANGE | | XML_DIFF_LIST | PCMK_XE_CHANGE_LIST | | XML_DIFF_MARKER | | | XML_DIFF_OP | PCMK_XA_OPERATION | | XML_DIFF_PATH | PCMK_XA_PATH | | XML_DIFF_POSITION | PCMK_XE_POSITION | | XML_DIFF_RESULT | PCMK_XE_CHANGE_RESULT | | XML_DIFF_VERSION | PCMK_XE_VERSION | | XML_DIFF_VSOURCE | PCMK_XE_SOURCE | | XML_DIFF_VTARGET | PCMK_XE_TARGET | | XML_EXPR_ATTR_ATTRIBUTE | PCMK_XA_ATTRIBUTE | | XML_EXPR_ATTR_OPERATION | PCMK_XA_OPERATION | | XML_EXPR_ATTR_TYPE | PCMK_XA_TYPE | | XML_EXPR_ATTR_VALUE | PCMK_XA_VALUE | | XML_EXPR_ATTR_VALUE_SOURCE | PCMK_XA_VALUE_SOURCE | | XML_FAILCIB_ATTR_ID | PCMK_XA_ID | | XML_FAILCIB_ATTR_OBJTYPE | | | XML_FAILCIB_ATTR_OP | PCMK_XA_OPERATION | | XML_FAILCIB_ATTR_REASON | PCMK_XA_REASON | | XML_FAIL_TAG_CIB | | | XML_GRAPH_TAG_CRM_EVENT | | | XML_GRAPH_TAG_DOWNED | | | XML_GRAPH_TAG_MAINTENANCE | | | XML_GRAPH_TAG_PSEUDO_EVENT | | | XML_GRAPH_TAG_RSC_OP | | | XML_LOCATION_ATTR_DISCOVERY | PCMK_XA_RESOURCE_DISCOVERY | | XML_LOC_ATTR_SOURCE | PCMK_XA_RSC | | XML_LOC_ATTR_SOURCE_PATTERN | PCMK_XA_RSC_PATTERN | | XML_LRM_ATTR_CALLID | | | XML_LRM_ATTR_EXIT_REASON | PCMK_XA_EXIT_REASON | | XML_LRM_ATTR_INTERVAL | PCMK_META_INTERVAL | | XML_LRM_ATTR_INTERVAL_MS | PCMK_META_INTERVAL | | XML_LRM_ATTR_MIGRATE_SOURCE | | | XML_LRM_ATTR_MIGRATE_TARGET | | | XML_LRM_ATTR_OP_DIGEST | | | XML_LRM_ATTR_OP_RESTART | | | XML_LRM_ATTR_OP_SECURE | | | XML_LRM_ATTR_OPSTATUS | | | XML_LRM_ATTR_RC | | | XML_LRM_ATTR_RESTART_DIGEST | | | XML_LRM_ATTR_ROUTER_NODE | | | XML_LRM_ATTR_RSCID | | | XML_LRM_ATTR_SECURE_DIGEST | | | XML_LRM_ATTR_TARGET | | | XML_LRM_ATTR_TARGET_UUID | | | XML_LRM_ATTR_TASK | PCMK_XA_OPERATION | | XML_LRM_ATTR_TASK_KEY | | | XML_LRM_TAG_RESOURCE | | | XML_LRM_TAG_RESOURCES | | | XML_LRM_TAG_RSC_OP | | | XML_NODE_ATTR_RSC_DISCOVERY | | | XML_NODE_EXPECTED | | | XML_NODE_IN_CLUSTER | | | XML_NODE_IS_FENCED | | | XML_NODE_IS_MAINTENANCE | | | XML_NODE_IS_PEER | | | XML_NODE_IS_REMOTE | | | XML_NODE_JOIN_STATE | | | XML_NVPAIR_ATTR_NAME | PCMK_XA_NAME | | XML_NVPAIR_ATTR_VALUE | PCMK_XA_VALUE | | XML_OP_ATTR_ALLOW_MIGRATE | PCMK_META_ALLOW_MIGRATE | | XML_OP_ATTR_DIGESTS_ALL | | | XML_OP_ATTR_DIGESTS_SECURE | | | XML_OP_ATTR_ON_FAIL | PCMK_META_ON_FAIL | | XML_OP_ATTR_ORIGIN | PCMK_META_INTERVAL_ORIGIN | | XML_OP_ATTR_PENDING | PCMK_META_RECORD_PENDING | | XML_OP_ATTR_START_DELAY | PCMK_META_START_DELAY | | XML_ORDER_ATTR_FIRST | PCMK_XA_FIRST | | XML_ORDER_ATTR_FIRST_ACTION | PCMK_XA_FIRST_ACTION | | XML_ORDER_ATTR_FIRST_INSTANCE | | | XML_ORDER_ATTR_KIND | PCMK_XA_KIND | | XML_ORDER_ATTR_THEN | PCMK_XA_THEN | | XML_ORDER_ATTR_THEN_ACTION | PCMK_XA_THEN_ACTION | | XML_ORDER_ATTR_THEN_INSTANCE | | | XML_PARANOIA_CHECKS | | | XML_PING_ATTR_CRMDSTATE | | | XML_PING_ATTR_PACEMAKERDSTATE | | | XML_PING_ATTR_PACEMAKERDSTATE_INIT | | | XML_PING_ATTR_PACEMAKERDSTATE_REMOTE | | | XML_PING_ATTR_PACEMAKERDSTATE_RUNNING | | | XML_PING_ATTR_PACEMAKERDSTATE_SHUTDOWNCOMPLETE | | | XML_PING_ATTR_PACEMAKERDSTATE_SHUTTINGDOWN | | | XML_PING_ATTR_PACEMAKERDSTATE_STARTINGDAEMONS | | | XML_PING_ATTR_PACEMAKERDSTATE_WAITPING | | | XML_PING_ATTR_STATUS | PCMK_XA_RESULT | | XML_PING_ATTR_SYSFROM | | | XML_REMOTE_ATTR_RECONNECT_INTERVAL | PCMK_REMOTE_RA_RECONNECT_INTERVAL | | XML_RSC_ATTR_CLEAR_INTERVAL | | | XML_RSC_ATTR_CLEAR_OP | | | XML_RSC_ATTR_CONTAINER | | | XML_RSC_ATTR_CRITICAL | PCMK_META_CRITICAL | | XML_RSC_ATTR_FAIL_STICKINESS | PCMK_META_MIGRATION_THRESHOLD | | XML_RSC_ATTR_FAIL_TIMEOUT | PCMK_META_FAILURE_TIMEOUT | | XML_RSC_ATTR_INCARNATION | | | XML_RSC_ATTR_INCARNATION_MAX | PCMK_META_CLONE_MAX | | XML_RSC_ATTR_INCARNATION_MIN | PCMK_META_CLONE_MIN | | XML_RSC_ATTR_INCARNATION_NODEMAX | PCMK_META_CLONE_NODE_MAX | | XML_RSC_ATTR_INTERLEAVE | PCMK_META_INTERLEAVE | | XML_RSC_ATTR_INTERNAL_RSC | | | XML_RSC_ATTR_MAINTENANCE | PCMK_META_MAINTENANCE | | XML_RSC_ATTR_MANAGED | PCMK_META_IS_MANAGED | | XML_RSC_ATTR_MASTER_MAX | | | XML_RSC_ATTR_MASTER_NODEMAX | | | XML_RSC_ATTR_MULTIPLE | PCMK_META_MULTIPLE_ACTIVE | | XML_RSC_ATTR_NOTIFY | PCMK_META_NOTIFY | | XML_RSC_ATTR_ORDERED | PCMK_META_ORDERED | | XML_RSC_ATTR_PROMOTABLE | PCMK_META_PROMOTABLE | | XML_RSC_ATTR_PROMOTED_MAX | PCMK_META_PROMOTED_MAX | | XML_RSC_ATTR_PROMOTED_NODEMAX | PCMK_META_PROMOTED_NODE_MAX | | XML_RSC_ATTR_PROVIDES | PCMK_STONITH_PROVIDES | | XML_RSC_ATTR_REMOTE_NODE | PCMK_META_REMOTE_NODE | | XML_RSC_ATTR_REMOTE_RA_ADDR | PCMK_REMOTE_RA_ADDR | | XML_RSC_ATTR_REMOTE_RA_PORT | PCMK_REMOTE_RA_PORT | | XML_RSC_ATTR_REMOTE_RA_SERVER | PCMK_REMOTE_RA_SERVER | | XML_RSC_ATTR_REQUIRES | PCMK_META_REQUIRES | | XML_RSC_ATTR_RESTART | | | XML_RSC_ATTR_STICKINESS | PCMK_META_RESOURCE_STICKINESS | | XML_RSC_ATTR_TARGET | PCMK_META_CONTAINER_ATTRIBUTE_TARGET | | XML_RSC_ATTR_TARGET_ROLE | PCMK_META_TARGET_ROLE | | XML_RSC_ATTR_UNIQUE | PCMK_META_GLOBALLY_UNIQUE | | XML_RSC_OP_LAST_CHANGE | PCMK_XA_LAST_RC_CHANGE | | XML_RSC_OP_LAST_RUN | | | XML_RSC_OP_T_EXEC | PCMK_XA_EXEC_TIME | | XML_RSC_OP_T_QUEUE | PCMK_XA_QUEUE_TIME | | XML_RULE_ATTR_BOOLEAN_OP | PCMK_XA_BOOLEAN_OP | | XML_RULE_ATTR_ROLE | PCMK_XE_ROLE | | XML_RULE_ATTR_SCORE | PCMK_XA_SCORE | | XML_RULE_ATTR_SCORE_ATTRIBUTE | PCMK_XA_SCORE_ATTRIBUTE | | XML_TAG_ATTRS | | | XML_TAG_ATTR_SETS | PCMK_XE_INSTANCE_ATTRIBUTES | | XML_TAG_DIFF | PCMK_XE_DIFF | | XML_TAG_DIFF_ADDED | | | XML_TAG_DIFF_REMOVED | | | XML_TAG_EXPRESSION | PCMK_XE_EXPRESSION | | XML_TAG_FAILED | | | XML_TAG_FENCING_LEVEL | PCMK_XE_FENCING_LEVEL | | XML_TAG_FENCING_TOPOLOGY | PCMK_XE_FENCING_TOPOLOGY | | XML_TAG_FRAGMENT | | | XML_TAG_GRAPH | | | XML_TAG_META_SETS | PCMK_XE_META_ATTRIBUTES | | XML_TAG_OPTIONS | | | XML_TAG_OP_VER_ATTRS | | | XML_TAG_OP_VER_META | | | XML_TAG_PARAM | | | XML_TAG_PARAMS | PCMK_XE_PARAMETERS | | XML_TAG_RESOURCE_REF | PCMK_XE_RESOURCE_REF | | XML_TAG_RSC_VER_ATTRS | | | XML_TAG_RULE | PCMK_XE_RULE | | XML_TAG_TRANSIENT_NODEATTRS | | | XML_TAG_UTILIZATION | PCMK_XE_UTILIZATION | | XML_TICKET_ATTR_LOSS_POLICY | PCMK_XA_LOSS_POLICY | | XML_TICKET_ATTR_TICKET | PCMK_XA_TICKET | === MacroTypes, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | __likely(x) | __builtin_expect(x, 1) || PCMK_OCF_CANCELLED (in enum ocf_exitcode) | | | __unlikely(x| PCMK_OCF_DEGRADED_MASTER (in enum ocf_exitcode) | __builtin_expect(x, 0) |PCMK_OCF_DEGRADED_PROMOTED | | ID(x) | crm_element_value(x, PCMK_XA_ID) || PCMK_OCF_EXEC_ERROR (in enum ocf_exitcode) | | | TYPE(x) | x->name | === Types, structs, and| PCMK_OCF_FAILED_MASTER (in enums === | Dropped | Suggested replacement (if any) | ocf_exitcode) | PCMK_OCF_FAILED_PROMOTED | | -- | --PCMK_OCF_NOT_SUPPORTED (in enum ocf_exitcode) | | | PCMK_OCF_OTHER_ERROR (in enum ocf_exitcode) | | | PCMK_OCF_PENDING (in enum ocf_exitcode) | | | PCMK_OCF_RUNNING_MASTER (in enum ocf_exitcode) | PCMK_OCF_RUNNING_PROMOTED | | PCMK_OCF_SIGNAL (in enum ocf_exitcode) | | | PCMK_OCF_TIMEOUT (in enum ocf_exitcode) | | | crm_ipc_server_error (in enum crm_ipc_flags) | | | crm_ipc_server_info (in enum crm_ipc_flags) | | | enum action_fail_response | | | enum action_tasks | | | enum node_type | | | enum pcmk_rsc_flags | | | enum pcmk_sched_flags | | | enum pe_action_flags | | | enum pe_discover_e | | | enum pe_ordering | | | enum pe_print_options | | | enum rsc_start_requirement | | | enum xml_log_options | | | pcmk_assignment_methods_t | | | pcmk_rsc_methods_t | | | pcmk_tag_t | | | pcmk_ticket_t | | | pe_find_any (in enum pe_find) | pcmk_rsc_match_basename | | pe_find_anon (in enum pe_find) | pcmk_rsc_match_anon_basename | | pe_find_clone (in enum pe_find) | pcmk_rsc_match_clone_only | | pe_find_current (in enum pe_find) | pcmk_rsc_match_current_node | | pe_find_inactive (in enum pe_find) | | | pe_find_renamed (in enum pe_find) | pcmk_rsc_match_history | | enum pe_link_state | | | resource_alloc_functions_t | | | resource_object_functions_t | | | struct pe_action_wrapper_s | | | struct pe_tag_s | | | struct pe_ticket_s | | | struct resource_alloc_functions_s | | | struct resource_object_functions_s | | In addition, direct access to all members of `struct pe_resource_s` (`pcmk_resource_t`) except for `id` and `flags` has been dropped. `id` and `flags` remain deprecated.the implementation of certain structs has been made internal: === Functions* `struct pe_action_s` (`pcmk_action_t`) has been renamed to the internal name `struct pcmk__action`, which should not be used directly. Direct access to all members has been dropped. * `struct pe_node_s` (`pcmk_node_t`) has been renamed to the internal name `struct pcmk__scored_node`, which should not be used directly. Direct access to all members except for `details` has been dropped. Direct access to `details` is still deprecated. * `struct pe_node_shared_s` (used for the `details` member of `pcmk_node_t`) has been renamed to the internal name `struct pcmk__node_details`, which should not be used directly. Direct access to all members except for `online`, `pending`, `unclean`, `shutdown`, `maintenance`, and `running_rsc` has been dropped. Direct access to the remaining members is still deprecated. * `struct pe_resource_s` (`pcmk_resource_t`) has been renamed to the internal name `struct pcmk__resource`, which should not be used directly. Direct access to all members except for `id` and `flags` has been dropped. Direct access to the remaining members is still deprecated. * `struct pe_working_set_s` (`pcmk_scheduler_t`) has been renamed to the internal name `struct pcmk__scheduler`, which should not be used directly. Direct access to all members except for `input`, `dc_node`, `flags`, `no_quorum_policy`, and `nodes` has been dropped. Direct access to the remaining members is still deprecated. === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | __likely(x) | __builtin_expect(x, 1) | | __unlikely(x) | __builtin_expect(x, 0) | | ID(x) | crm_element_value(x, PCMK_XA_ID) | | TYPE(x) | x->name | | add_message_xml() | | | add_node_copy() | | | add_node_nocopy() | | | apply_xml_diff() | xml_apply_patchset() | | bz2_strerror() | | | can_prune_leaf() | | | copy_in_properties() | | | create_hello_message() | | | create_reply() | | | create_reply_adv() | | | create_request() | | | create_request_adv() | | | create_xml_node() | | | crm_action_str() | | | crm_add_logfile() | | | crm_atoi() | strtoll() | | crm_build_path() | | | crm_destroy_xml() | | | crm_errno2exit(x) | pcmk_rc2exitc(pcmk_legacy2rc(x)) | | crm_ftoa() | | | crm_get_interval() | | | crm_hash_table_size() | g_hash_table_size() | | crm_itoa() | | | crm_itoa_stack() | snprintf() | | crm_log_cli_init() | | | crm_map_element_name() | | | crm_next_same_xml() | | | crm_parse_int() | strtoll() | | crm_parse_interval_spec() | pcmk_parse_interval_spec() | | crm_parse_ll() | strtoll() | | crm_provider_required() | pcmk_get_ra_caps() | | crm_signal() | crm_signal_handler() | | crm_str() | | | crm_strcase_equal() | | | crm_strcase_hash() | | | crm_strcase_table_new() | g_hash_table_new_full() | | crm_str_eq() | strcmp() or strcasecmp() | | crm_str_hash() | g_str_hash() | | crm_strip_trailing_newline() | | | crm_str_table_dup() | | | crm_str_table_new() | g_hash_table_new_full() | | crm_ttoa() | | | crm_xml_add_boolean() | crm_xml_add() | | crm_xml_escape() | | | crm_xml_replace() | crm_xml_add() or xml_remove_prop() | | diff_xml_object() | | | do_crm_log_always() | | | dump_xml_formatted() | | | dump_xml_formatted_with_text() | | | dump_xml_unformatted() | | | expand_plus_plus() | | | filename2xml() | | | find_entity() | | | find_xml_children() | | | find_xml_node() | | | first_named_child() | | | fix_plus_plus_recursive() | | | g_str_hash_traditional() | g_str_hash() | | getDocPtr() | | | get_message_xml() | | | get_schema_name() | | | get_schema_version() | | | get_xpath_object_relative() | | | is_not_set() | !pcmk_all_flags_set() | | is_set_any() | pcmk_any_flags_set() | | log_data_element() | | | pcmk_action_text() | | | pcmk_create_html_node() | | | pcmk_create_xml_text_node() | | | pcmk_format_named_time() | printf()-style function | | pcmk_format_nvpair() | printf()-style function | | pcmk_hostname() | uname() | | pcmk_log_xml_impl() | | | pcmk_on_fail_text() | | | pcmk_numeric_strcasecmp() | | | pcmk_parse_action() | | | pcmk_scan_nvpair() | sscanf() | | purge_diff_markers() | | | replace_xml_child() | | | safe_str_eq() | strcasecmp() == 0 | | safe_str_neq() | strcasecmp() != 0 | | score2char() | pcmk_readable_score() | | score2char_stack() | pcmk_readable_score() | | stdin2xml() | | | string2xml() | | | subtract_xml_object() | | | update_validation() | | | update_xml_child() | | | validate_xml() | | | validate_xml_verbose() | | | write_xml_fd() | | | write_xml_file() | | | xml_get_path() | | | xml_has_children() | | | xml_latest_schema() | | | xml_log_changes() | | | xml_log_patchset() | | | xml_remove_prop() | | Additionally, support for "version 1" patchsets has been dropped, so patchset-related functions such as `xml_create_patchset()` will no longer be able to create, apply, or display them. === Global variables === | Dropped | Suggested replacement (if any) | | -- | -- | | crm_config_error | | | crm_config_warning | | | resource_class_functions | | | was_processing_error | | | was_processing_warning | | --- == libcrmservice == === Constants === | Dropped | Suggested replacement (if any) | | -- | -- | | LSB_ROOT_DIR | "/etc/init.d" | === Types, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | enum op_status | enum pcmk_exec_status | === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | services_action_create() | resources_action_create() | | services_list() | resources_list_agents() | | services_lrm_status_str() | pcmk_exec_status_str() | | services_get_ocf_exitcode() | services_result2ocf() | --- == liblrmd == The following symbols were dropped from the library === Constants === | Dropped | Suggested replacement (if any) | | -- | -- | | ALT_REMOTE_KEY_LOCATION | | | F_LRMD_ALERT | | | F_LRMD_ALERT_ID | | | F_LRMD_ALERT_PATH | | | F_LRMD_CALLBACK_TOKEN | | | F_LRMD_CALLDATA | | | F_LRMD_CALLID | | | F_LRMD_CALLOPTS | | | F_LRMD_CLASS | | | F_LRMD_CLIENTID | | | F_LRMD_CLIENTNAME | | | F_LRMD_EXEC_RC | | | F_LRMD_IPC_CLIENT | | | F_LRMD_IPC_IPC_SERVER | | | F_LRMD_IPC_MSG | | | F_LRMD_IPC_MSG_FLAGS | | | F_LRMD_IPC_MSG_ID | | | F_LRMD_IPC_OP | | | F_LRMD_IPC_SESSION | | | F_LRMD_IPC_USER | | | F_LRMD_IS_IPC_PROVIDER | | | F_LRMD_OPERATION | | | F_LRMD_OP_STATUS | | | F_LRMD_ORIGIN | | | F_LRMD_PROTOCOL_VERSION | | | F_LRMD_PROVIDER | | | F_LRMD_RC | | | F_LRMD_REMOTE_MSG_ID | | | F_LRMD_REMOTE_MSG_TYPE | | | F_LRMD_RSC | | | F_LRMD_RSC_ACTION | | | F_LRMD_RSC_DELETED | | | F_LRMD_RSC_EXEC_TIME | | | F_LRMD_RSC_EXIT_REASON | | | F_LRMD_RSC_ID | | | F_LRMD_RSC_INTERVAL | | | F_LRMD_RSC_OUTPUT | | | F_LRMD_RSC_QUEUE_TIME | | | F_LRMD_RSC_RCCHANGE_TIME | | | F_LRMD_RSC_RUN_TIME | | | F_LRMD_RSC_START_DELAY | | | F_LRMD_RSC_USERDATA_STR | | | F_LRMD_TIMEOUT | | | F_LRMD_TYPE | | | F_LRMD_WATCHDOG | | | LRMD_MIN_PROTOCOL_VERSION | | | T_LRMD | | | T_LRMD_IPC_PROXY | | | T_LRMD_NOTIFY | | | T_LRMD_REPLY | | | T_LRMD_RSC_OP | | === Types, structs, and enums === The `t_run` and `t_rcchange` members of `lrmd_event_data_t` are now of type `time_t` instead of `unsigned int`. (This is the final change needed to make Pacemaker completely Y2038-ready.) --- == libpe_rules and libpe_status (common code) == The following symbols were dropped from the library === Constants === | Dropped | Suggested replacement (if any) | | -- | -- | | pe_flag_check_config | | | pe_flag_concurrent_fencing | | | pe_flag_enable_unfencing | | | pe_flag_have_remote_nodes | | | pe_flag_have_status | | | pe_flag_maintenance_mode | | | pe_flag_no_compat | | | pe_flag_no_counts | | | pe_flag_quick_location | | | pe_flag_remove_after_stop | | | pe_flag_sanitized | | | pe_flag_show_scores | | | pe_flag_show_utilization | | | pe_flag_shutdown_lock | | | pe_flag_start_failure_fatal | | | pe_flag_startup_fencing | | | pe_flag_startup_probes | | | pe_flag_stdout | | | pe_flag_stonith_enabled | | | pe_flag_stop_action_orphans | | | pe_flag_stop_everything | | | pe_flag_stop_rsc_orphans | | | pe_flag_symmetric_cluster | | | pe_rsc_allocating | | | pe_rsc_allow_migrate | | | pe_rsc_allow_remote_remotes | | | pe_rsc_block | | | pe_rsc_critical | | | pe_rsc_detect_loop | | | pe_rsc_failed | | | pe_rsc_failure_ignored | | | pe_rsc_fence_device | | | pe_rsc_is_container | | | pe_rsc_maintenance | | | pe_rsc_merging | | | pe_rsc_needs_fencing | | | pe_rsc_needs_quorum | | | pe_rsc_needs_unfencing | | | pe_rsc_notify | | | pe_rsc_orphan | | | pe_rsc_orphan_container_filler | | | pe_rsc_promotable | | | pe_rsc_provisional | | | pe_rsc_reload | | | pe_rsc_replica_container | | | pe_rsc_restarting | | | pe_rsc_runnable | | | pe_rsc_starting | | | pe_rsc_start_pending | | | pe_rsc_stop | | | pe_rsc_stopping | | | pe_rsc_stop_unexpected | | | pe_rsc_unique | | | RSC_ROLE_MASTER_S | | | RSC_ROLE_MAX | | | RSC_ROLE_PROMOTED_LEGACY_S | | | RSC_ROLE_PROMOTED_S | pcmk_role_text(pcmk_role_promoted) | | RSC_ROLE_SLAVE_S | | | RSC_ROLE_STARTED_S | pcmk_role_text(pcmk_role_started) | | RSC_ROLE_STOPPED_S | pcmk_role_text(pcmk_role_stopped) | | RSC_ROLE_UNKNOWN_S | pcmk_role_text(pcmk_role_unknown) | | RSC_ROLE_UNPROMOTED_LEGACY_S | | | RSC_ROLE_UNPROMOTED_S | pcmk_role_text(pcmk_role_unpromoted) | === Types, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | action_t | pcmk_action_t | | action_wrapper_t | | | enum node_type | | | enum pe_graph_flags | | | enum pe_check_parameters | | | no_quorum_policy_t | enum pe_quorum_policy | | pe_action_t | pcmk_action_t | | pe_action_wrapper_t | | | pe_node_t | pcmk_node_t | | pe_resource_t | pcmk_resource_t | | pe_tag_t | | | pe_ticket_t | | | tag_t | | | ticket_t | | === FunctionAdditionally, direct access to all members of `struct pe_node_shared_s` (the `details` member of `pcmk_node_t`) has been dropped, except for `online`, `pending`, `unclean`, `shutdown`, `maintenance`, and `running_rsc`. Access to those remaining members is still deprecated. === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | fail2text() | | | pe_pref() | | | recovery2text() | | | role2text() | pcmk_role_text() | | task2text() | | | text2role() | pcmk_parse_role() | | text2task() | | --- == libpe_rules == The following symbols were dropped from the library === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | find_expression_type() | | | pe_eval_expr() | pcmk_evaluate_rule() on parent rule | | pe_eval_rules() | pcmk_evaluate_rule() on each rule | | pe_eval_subexpr() | pcmk_evaluate_rule() on parent rule | | pe_evaluate_rules() | pcmk_evaluate_rule() on each rule | | pe_expand_re_matches() | | | pe_test_expression() | pcmk_evaluate_rule() on parent rule | | pe_test_expression_full() | pcmk_evaluate_rule() on parent rule | | pe_test_expression_re | pcmk_evaluate_rule() on parent rule | | pe_test_rule() | pcmk_evaluate_rule() | | pe_test_rule_full | pcmk_evaluate_rule() | | pe_test_rule_re() | pcmk_evaluate_rule() | | test_expression() | pcmk_evaluate_rule() on parent rule | | test_ruleset | pcmk_evaluate_rule() on each rule | | unpack_instance_attributes() | pe_unpack_nvpairs() | --- == libpe_status == The following symbols were dropped from the library === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | pe_rsc_is_anon_clone() | | | pe_rsc_is_bundled() | | | pe_rsc_is_clone() | | | pe_rsc_is_unique_clone() | | --- == libstonithd == The following symbols were dropped from the library === Types, structs, and enums === | Dropped | Suggested replacement (if any) | | -- | -- | | stonith_event_t type and message members | | | stonith_t call member | | === Functions and macros === | Dropped | Suggested replacement (if any) | | -- | -- | | get_stonith_provider() | stonith_get_namespace() |