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