pe_digest.c

Go to the documentation of this file.

/*
 * Copyright 2004-2025 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.
 */
 
#include <crm_internal.h>
 
#include <glib.h>
#include <stdbool.h>
 
#include <crm/crm.h>
#include <crm/common/xml.h>
#include <crm/common/xml_internal.h>
#include <crm/pengine/internal.h>
#include "pe_status_private.h"
 
extern bool pcmk__is_daemon;
 
void
pe__free_digests(gpointer ptr)
{
    pcmk__op_digest_t *data = ptr;
 
    if (data != NULL) {
        pcmk__xml_free(data->params_all);
        pcmk__xml_free(data->params_secure);
        pcmk__xml_free(data->params_restart);
 
        free(data->digest_all_calc);
        free(data->digest_restart_calc);
        free(data->digest_secure_calc);
 
        free(data);
    }
}
 
// Return true if XML attribute name is not substring of a given string
static bool
attr_not_in_string(xmlAttrPtr a, void *user_data)
{
    bool filter = false;
    char *name = crm_strdup_printf(" %s ", (const char *) a->name);
 
    if (strstr((const char *) user_data, name) == NULL) {
        crm_trace("Filtering %s (not found in '%s')",
                  (const char *) a->name, (const char *) user_data);
        filter = true;
    }
    free(name);
    return filter;
}
 
// Return true if XML attribute name is substring of a given string
static bool
attr_in_string(xmlAttrPtr a, void *user_data)
{
    bool filter = false;
    char *name = crm_strdup_printf(" %s ", (const char *) a->name);
 
    if (strstr((const char *) user_data, name) != NULL) {
        crm_trace("Filtering %s (found in '%s')",
                  (const char *) a->name, (const char *) user_data);
        filter = true;
    }
    free(name);
    return filter;
}
 
static void
calculate_main_digest(pcmk__op_digest_t *data, pcmk_resource_t *rsc,
                      const pcmk_node_t *node, GHashTable *params,
                      const char *task, guint *interval_ms,
                      const xmlNode *xml_op, const char *op_version,
                      GHashTable *overrides, pcmk_scheduler_t *scheduler)
{
    xmlNode *action_config = NULL;
 
    data->params_all = pcmk__xe_create(NULL, PCMK_XE_PARAMETERS);
 
    /* REMOTE_CONTAINER_HACK: Allow Pacemaker Remote nodes to run containers
     * that themselves are Pacemaker Remote nodes
     */
    (void) pe__add_bundle_remote_name(rsc, data->params_all,
                                      PCMK_REMOTE_RA_ADDR);
 
    if (overrides != NULL) {
        // If interval was overridden, reset it
        const char *meta_name = CRM_META "_" PCMK_META_INTERVAL;
        const char *interval_s = g_hash_table_lookup(overrides, meta_name);
 
        if (interval_s != NULL) {
            long long value_ll;
 
            if ((pcmk__scan_ll(interval_s, &value_ll, 0LL) == pcmk_rc_ok)
                && (value_ll >= 0) && (value_ll <= G_MAXUINT)) {
                *interval_ms = (guint) value_ll;
            }
        }
 
        // Add overrides to list of all parameters
        g_hash_table_foreach(overrides, hash2field, data->params_all);
    }
 
    // Add provided instance parameters
    g_hash_table_foreach(params, hash2field, data->params_all);
 
    // Find action configuration XML in CIB
    action_config = pcmk__find_action_config(rsc, task, *interval_ms, true);
 
    /* Add action-specific resource instance attributes to the digest list.
     *
     * If this is a one-time action with action-specific instance attributes,
     * enforce a restart instead of reload-agent in case the main digest doesn't
     * match, even if the restart digest does. This ensures any changes of the
     * action-specific parameters get applied for this specific action, and
     * digests calculated for the resulting history will be correct. Default the
     * result to RSC_DIGEST_RESTART for the case where the main digest doesn't
     * match.
     */
    params = pcmk__unpack_action_rsc_params(action_config, node->priv->attrs,
                                            scheduler);
    if ((*interval_ms == 0) && (g_hash_table_size(params) > 0)) {
        data->rc = pcmk__digest_restart;
    }
    g_hash_table_foreach(params, hash2field, data->params_all);
    g_hash_table_destroy(params);
 
    // Add action meta-attributes
    params = pcmk__unpack_action_meta(rsc, node, task, *interval_ms,
                                      action_config);
    g_hash_table_foreach(params, hash2metafield, data->params_all);
    g_hash_table_destroy(params);
 
    pcmk__filter_op_for_digest(data->params_all);
 
    data->digest_all_calc = pcmk__digest_operation(data->params_all);
}
 
// Return true if XML attribute name is a Pacemaker-defined fencing parameter
static bool
is_fence_param(xmlAttrPtr attr, void *user_data)
{
    return pcmk_stonith_param((const char *) attr->name);
}
 
static void
calculate_secure_digest(pcmk__op_digest_t *data, const pcmk_resource_t *rsc,
                        GHashTable *params, const xmlNode *xml_op,
                        const char *op_version, GHashTable *overrides)
{
    const char *class = crm_element_value(rsc->priv->xml, PCMK_XA_CLASS);
    const char *secure_list = NULL;
    bool old_version = (compare_version(op_version, "3.16.0") < 0);
 
    if (xml_op == NULL) {
        secure_list = " passwd password user ";
    } else {
        secure_list = crm_element_value(xml_op, PCMK__XA_OP_SECURE_PARAMS);
    }
 
    if (old_version) {
        data->params_secure = pcmk__xe_create(NULL, PCMK_XE_PARAMETERS);
        if (overrides != NULL) {
            g_hash_table_foreach(overrides, hash2field, data->params_secure);
        }
 
        g_hash_table_foreach(params, hash2field, data->params_secure);
 
    } else {
        // Start with a copy of all parameters
        data->params_secure = pcmk__xml_copy(NULL, data->params_all);
    }
 
    if (secure_list != NULL) {
        pcmk__xe_remove_matching_attrs(data->params_secure, false,
                                       attr_in_string, (void *) secure_list);
    }
    if (old_version
        && pcmk_is_set(pcmk_get_ra_caps(class),
                       pcmk_ra_cap_fence_params)) {
        /* For stonith resources, Pacemaker adds special parameters,
         * but these are not listed in fence agent meta-data, so with older
         * versions of DC, the controller will not hash them. That means we have
         * to filter them out before calculating our hash for comparison.
         */
        pcmk__xe_remove_matching_attrs(data->params_secure, false,
                                       is_fence_param, NULL);
    }
    pcmk__filter_op_for_digest(data->params_secure);
 
    /* CRM_meta_timeout *should* be part of a digest for recurring operations.
     * However, with older versions of DC, the controller does not add timeout
     * to secure digests, because it only includes parameters declared by the
     * resource agent.
     * Remove any timeout that made it this far, to match.
     */
    if (old_version) {
        pcmk__xe_remove_attr(data->params_secure,
                             CRM_META "_" PCMK_META_TIMEOUT);
    }
 
    data->digest_secure_calc = pcmk__digest_operation(data->params_secure);
}
 
static void
calculate_restart_digest(pcmk__op_digest_t *data, const xmlNode *xml_op,
                         const char *op_version)
{
    const char *value = NULL;
 
    // We must have XML of resource operation history
    if (xml_op == NULL) {
        return;
    }
 
    // And the history must have a restart digest to compare against
    if (crm_element_value(xml_op, PCMK__XA_OP_RESTART_DIGEST) == NULL) {
        return;
    }
 
    // Start with a copy of all parameters
    data->params_restart = pcmk__xml_copy(NULL, data->params_all);
 
    // Then filter out reloadable parameters, if any
    value = crm_element_value(xml_op, PCMK__XA_OP_FORCE_RESTART);
    if (value != NULL) {
        pcmk__xe_remove_matching_attrs(data->params_restart, false,
                                       attr_not_in_string, (void *) value);
    }
 
    data->digest_restart_calc = pcmk__digest_operation(data->params_restart);
}
 
pcmk__op_digest_t *
pe__calculate_digests(pcmk_resource_t *rsc, const char *task,
                      guint *interval_ms, const pcmk_node_t *node,
                      const xmlNode *xml_op, GHashTable *overrides,
                      bool calc_secure, pcmk_scheduler_t *scheduler)
{
    pcmk__op_digest_t *data = NULL;
    const char *op_version = NULL;
    GHashTable *params = NULL;
 
    CRM_CHECK(scheduler != NULL, return NULL);
 
    data = calloc(1, sizeof(pcmk__op_digest_t));
    if (data == NULL) {
        pcmk__sched_err(scheduler,
                        "Could not allocate memory for operation digest");
        return NULL;
    }
 
    data->rc = pcmk__digest_match;
 
    if (xml_op != NULL) {
        op_version = crm_element_value(xml_op, PCMK_XA_CRM_FEATURE_SET);
    }
 
    if ((op_version == NULL) && (scheduler->input != NULL)) {
        op_version = crm_element_value(scheduler->input,
                                       PCMK_XA_CRM_FEATURE_SET);
    }
 
    if (op_version == NULL) {
        op_version = CRM_FEATURE_SET;
    }
 
    params = pe_rsc_params(rsc, node, scheduler);
    calculate_main_digest(data, rsc, node, params, task, interval_ms, xml_op,
                          op_version, overrides, scheduler);
    if (calc_secure) {
        calculate_secure_digest(data, rsc, params, xml_op, op_version,
                                overrides);
    }
    calculate_restart_digest(data, xml_op, op_version);
    return data;
}
 
static pcmk__op_digest_t *
rsc_action_digest(pcmk_resource_t *rsc, const char *task, guint interval_ms,
                  pcmk_node_t *node, const xmlNode *xml_op,
                  bool calc_secure, pcmk_scheduler_t *scheduler)
{
    pcmk__op_digest_t *data = NULL;
    char *key = pcmk__op_key(rsc->id, task, interval_ms);
 
    data = g_hash_table_lookup(node->priv->digest_cache, key);
    if (data == NULL) {
        data = pe__calculate_digests(rsc, task, &interval_ms, node, xml_op,
                                     NULL, calc_secure, scheduler);
        pcmk__assert(data != NULL);
        g_hash_table_insert(node->priv->digest_cache, strdup(key), data);
    }
    free(key);
    return data;
}
 
pcmk__op_digest_t *
rsc_action_digest_cmp(pcmk_resource_t *rsc, const xmlNode *xml_op,
                      pcmk_node_t *node, pcmk_scheduler_t *scheduler)
{
    pcmk__op_digest_t *data = NULL;
    guint interval_ms = 0;
 
    const char *op_version;
    const char *task = crm_element_value(xml_op, PCMK_XA_OPERATION);
    const char *digest_all;
    const char *digest_restart;
 
    pcmk__assert(node != NULL);
 
    op_version = crm_element_value(xml_op, PCMK_XA_CRM_FEATURE_SET);
    digest_all = crm_element_value(xml_op, PCMK__XA_OP_DIGEST);
    digest_restart = crm_element_value(xml_op, PCMK__XA_OP_RESTART_DIGEST);
 
    crm_element_value_ms(xml_op, PCMK_META_INTERVAL, &interval_ms);
    data = rsc_action_digest(rsc, task, interval_ms, node, xml_op,
                             pcmk_is_set(scheduler->flags,
                                         pcmk__sched_sanitized),
                             scheduler);
 
    if (!pcmk__str_eq(data->digest_restart_calc, digest_restart,
                      pcmk__str_null_matches)) {
        pcmk__rsc_info(rsc,
                       "Parameter change for %s-interval %s of %s on %s "
                       "requires restart (hash now %s vs. %s "
                       "with op feature set %s for transition %s)",
                       pcmk__readable_interval(interval_ms), task, rsc->id,
                       pcmk__node_name(node), data->digest_restart_calc,
                       pcmk__s(digest_restart, "missing"), op_version,
                       crm_element_value(xml_op, PCMK__XA_TRANSITION_MAGIC));
        data->rc = pcmk__digest_restart;
 
    } else if (digest_all == NULL) {
        /* it is unknown what the previous op digest was */
        data->rc = pcmk__digest_unknown;
 
    } else if (strcmp(digest_all, data->digest_all_calc) != 0) {
        /* Given a non-recurring operation with extra parameters configured,
         * in case that the main digest doesn't match, even if the restart
         * digest matches, enforce a restart rather than a reload-agent anyway.
         * So that it ensures any changes of the extra parameters get applied
         * for this specific operation, and the digests calculated for the
         * resulting PCMK__XE_LRM_RSC_OP will be correct.
         * Preserve the implied rc pcmk__digest_restart for the case that the
         * main digest doesn't match.
         */
        if ((interval_ms == 0) && (data->rc == pcmk__digest_restart)) {
            pcmk__rsc_info(rsc,
                           "Parameters containing extra ones to %ums-interval"
                           " %s action for %s on %s "
                           "changed: hash was %s vs. now %s (restart:%s) %s",
                           interval_ms, task, rsc->id, pcmk__node_name(node),
                           pcmk__s(digest_all, "missing"),
                           data->digest_all_calc, op_version,
                           crm_element_value(xml_op,
                                             PCMK__XA_TRANSITION_MAGIC));
 
        } else {
            pcmk__rsc_info(rsc,
                           "Parameters to %ums-interval %s action for %s on %s "
                           "changed: hash was %s vs. now %s (%s:%s) %s",
                           interval_ms, task, rsc->id, pcmk__node_name(node),
                           pcmk__s(digest_all, "missing"),
                           data->digest_all_calc,
                           (interval_ms > 0)? "reschedule" : "reload",
                           op_version,
                           crm_element_value(xml_op,
                                             PCMK__XA_TRANSITION_MAGIC));
            data->rc = pcmk__digest_mismatch;
        }
 
    } else {
        data->rc = pcmk__digest_match;
    }
    return data;
}
 
static inline char *
create_unfencing_summary(const char *rsc_id, const char *agent_type,
                         const char *param_digest)
{
    return crm_strdup_printf("%s:%s:%s", rsc_id, agent_type, param_digest);
}
 
static bool
unfencing_digest_matches(const char *rsc_id, const char *agent,
                         const char *digest_calc, const char *node_summary)
{
    bool matches = FALSE;
 
    if (rsc_id && agent && digest_calc && node_summary) {
        char *search_secure = create_unfencing_summary(rsc_id, agent,
                                                       digest_calc);
 
        /* The digest was calculated including the device ID and agent,
         * so there is no risk of collision using strstr().
         */
        matches = (strstr(node_summary, search_secure) != NULL);
        crm_trace("Calculated unfencing digest '%s' %sfound in '%s'",
                  search_secure, matches? "" : "not ", node_summary);
        free(search_secure);
    }
    return matches;
}
 
/* Magic string to use as action name for digest cache entries used for
 * unfencing checks. This is not a real action name (i.e. "on"), so
 * pcmk__check_action_config() won't confuse these entries with real actions.
 */
#define STONITH_DIGEST_TASK "stonith-on"
 
pcmk__op_digest_t *
pe__compare_fencing_digest(pcmk_resource_t *rsc, const char *agent,
                           pcmk_node_t *node, pcmk_scheduler_t *scheduler)
{
    const char *node_summary = NULL;
 
    // Calculate device's current parameter digests
    pcmk__op_digest_t *data = rsc_action_digest(rsc, STONITH_DIGEST_TASK, 0U,
                                                node, NULL, TRUE, scheduler);
 
    // Check whether node has special unfencing summary node attribute
    node_summary = pcmk__node_attr(node, CRM_ATTR_DIGESTS_ALL, NULL,
                                   pcmk__rsc_node_current);
    if (node_summary == NULL) {
        data->rc = pcmk__digest_unknown;
        return data;
    }
 
    // Check whether full parameter digest matches
    if (unfencing_digest_matches(rsc->id, agent, data->digest_all_calc,
                                 node_summary)) {
        data->rc = pcmk__digest_match;
        return data;
    }
 
    // Check whether secure parameter digest matches
    node_summary = pcmk__node_attr(node, CRM_ATTR_DIGESTS_SECURE, NULL,
                                   pcmk__rsc_node_current);
    if (unfencing_digest_matches(rsc->id, agent, data->digest_secure_calc,
                                 node_summary)) {
        data->rc = pcmk__digest_match;
        if (!pcmk__is_daemon && (scheduler->priv->out != NULL)) {
            pcmk__output_t *out = scheduler->priv->out;
 
            out->info(out, "Only 'private' parameters to %s "
                      "for unfencing %s changed", rsc->id,
                      pcmk__node_name(node));
        }
        return data;
    }
 
    // Parameters don't match
    data->rc = pcmk__digest_mismatch;
    if (pcmk_is_set(scheduler->flags, pcmk__sched_sanitized)
        && (data->digest_secure_calc != NULL)) {
 
        if (scheduler->priv->out != NULL) {
            pcmk__output_t *out = scheduler->priv->out;
            char *digest = create_unfencing_summary(rsc->id, agent,
                                                    data->digest_secure_calc);
 
            out->info(out, "Parameters to %s for unfencing "
                      "%s changed, try '%s'", rsc->id,
                      pcmk__node_name(node), digest);
            free(digest);
        } else if (!pcmk__is_daemon) {
            char *digest = create_unfencing_summary(rsc->id, agent,
                                                    data->digest_secure_calc);
 
            printf("Parameters to %s for unfencing %s changed, try '%s'\n",
                   rsc->id, pcmk__node_name(node), digest);
            free(digest);
        }
    }
    return data;
}