xml_compat.h

Go to the documentation of this file.

/*
 * Copyright 2004-2024 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_COMMON_XML_COMPAT__H
#define PCMK__CRM_COMMON_XML_COMPAT__H

#include <glib.h>               // gboolean
#include <libxml/tree.h>        // xmlNode

#include <crm/common/nvpair.h>  // crm_xml_add()
#include <crm/common/xml_names.h>   // PCMK_XE_CLONE

#ifdef __cplusplus
extern "C" {
#endif

#define XML_PARANOIA_CHECKS 0

xmlDoc *getDocPtr(xmlNode *node);

int add_node_nocopy(xmlNode * parent, const char *name, xmlNode * child);

xmlNode *find_entity(xmlNode *parent, const char *node_name, const char *id);

char *xml_get_path(const xmlNode *xml);

void xml_log_changes(uint8_t level, const char *function, const xmlNode *xml);

void xml_log_patchset(uint8_t level, const char *function, const xmlNode *xml);

gboolean apply_xml_diff(xmlNode *old_xml, xmlNode *diff, xmlNode **new_xml);

void crm_destroy_xml(gpointer data);

gboolean xml_has_children(const xmlNode *root);

static inline const char *
crm_xml_add_boolean(xmlNode *node, const char *name, gboolean value)
{
    return crm_xml_add(node, name, (value? "true" : "false"));
}

// NOTE: sbd (as of at least 1.5.2) uses this
static inline const char *
crm_element_name(const xmlNode *xml)
{
    return (xml == NULL)? NULL : (const char *) xml->name;
}

char *crm_xml_escape(const char *text);

// NOTE: sbd (as of at least 1.5.2) uses this
xmlNode *copy_xml(xmlNode *src_node);

xmlNode *add_node_copy(xmlNode *new_parent, xmlNode *xml_node);

void purge_diff_markers(xmlNode *a_node);

xmlNode *diff_xml_object(xmlNode *left, xmlNode *right, gboolean suppress);

xmlNode *subtract_xml_object(xmlNode *parent, xmlNode *left, xmlNode *right,
                             gboolean full, gboolean *changed,
                             const char *marker);

gboolean can_prune_leaf(xmlNode *xml_node);

xmlNode *create_xml_node(xmlNode *parent, const char *name);

xmlNode *pcmk_create_xml_text_node(xmlNode *parent, const char *name,
                                   const char *content);

xmlNode *pcmk_create_html_node(xmlNode *parent, const char *element_name,
                               const char *id, const char *class_name,
                               const char *text);

xmlNode *first_named_child(const xmlNode *parent, const char *name);

xmlNode *find_xml_node(const xmlNode *root, const char *search_path,
                       gboolean must_find);

xmlNode *crm_next_same_xml(const xmlNode *sibling);

void xml_remove_prop(xmlNode *obj, const char *name);

gboolean replace_xml_child(xmlNode *parent, xmlNode *child, xmlNode *update,
                           gboolean delete_only);

gboolean update_xml_child(xmlNode *child, xmlNode *to_update);

int find_xml_children(xmlNode **children, xmlNode *root, const char *tag,
                      const char *field, const char *value,
                      gboolean search_matches);

xmlNode *get_xpath_object_relative(const char *xpath, xmlNode *xml_obj,
                                   int error_level);

void fix_plus_plus_recursive(xmlNode *target);

gboolean add_message_xml(xmlNode *msg, const char *field, xmlNode *xml);

xmlNode *get_message_xml(const xmlNode *msg, const char *field);

const char *xml_latest_schema(void);

const char *get_schema_name(int version);

int get_schema_version(const char *name);

int update_validation(xmlNode **xml_blob, int *best, int max,
                      gboolean transform, gboolean to_logs);

gboolean validate_xml(xmlNode *xml_blob, const char *validation,
                      gboolean to_logs);

gboolean validate_xml_verbose(const xmlNode *xml_blob);

// NOTE: sbd (as of at least 1.5.2) uses this
gboolean cli_config_update(xmlNode **xml, int *best_version, gboolean to_logs);

static inline const char *
crm_map_element_name(const xmlNode *xml)
{
    if (xml == NULL) {
        return NULL;
    } else if (strcmp((const char *) xml->name, "master") == 0) {
        // Can't use PCMK__XE_PROMOTABLE_LEGACY because it's internal
        return PCMK_XE_CLONE;
    } else {
        return (const char *) xml->name;
    }
}

void copy_in_properties(xmlNode *target, const xmlNode *src);

void expand_plus_plus(xmlNode * target, const char *name, const char *value);

#ifdef __cplusplus
}
#endif

#endif // PCMK__CRM_COMMON_XML_COMPAT__H