pacemaker  1.1.18-7fdfbbe
Scalable High-Availability cluster resource manager
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Macros | Typedefs | Enumerations | Functions
xml.c File Reference
#include <crm_internal.h>
#include <sys/param.h>
#include <stdio.h>
#include <sys/types.h>
#include <unistd.h>
#include <time.h>
#include <string.h>
#include <stdlib.h>
#include <ctype.h>
#include <stdarg.h>
#include <crm/crm.h>
#include <crm/msg_xml.h>
#include <crm/common/xml.h>
#include <crm/common/xml_internal.h>
Include dependency graph for xml.c:

Go to the source code of this file.

Macros

#define XML_BUFFER_SIZE   4096
 
#define XML_PARSER_DEBUG   0
 
#define CHUNK_SIZE   1024
 
#define buffer_print(buffer, max, offset, fmt, args...)
 
#define XML_PRIVATE_MAGIC   (long) 0x81726354
 
#define XPATH_MAX   512
 

Typedefs

typedef struct xml_private_s xml_private_t
 
typedef struct xml_acl_s xml_acl_t
 
typedef struct xml_deleted_obj_s xml_deleted_obj_t
 
typedef struct name_value_s name_value_t
 

Enumerations

enum  xml_private_flags {
  xpf_none = 0x0000, xpf_dirty = 0x0001, xpf_deleted = 0x0002, xpf_created = 0x0004,
  xpf_modified = 0x0008, xpf_tracking = 0x0010, xpf_processed = 0x0020, xpf_skip = 0x0040,
  xpf_moved = 0x0080, xpf_acl_enabled = 0x0100, xpf_acl_read = 0x0200, xpf_acl_write = 0x0400,
  xpf_acl_deny = 0x0800, xpf_acl_create = 0x1000, xpf_acl_denied = 0x2000
}
 

Functions

const char * __xml_acl_to_text (enum xml_private_flags flags)
 
int get_tag_name (const char *input, size_t offset, size_t max)
 
int get_attr_name (const char *input, size_t offset, size_t max)
 
int get_attr_value (const char *input, size_t offset, size_t max)
 
gboolean can_prune_leaf (xmlNode *xml_node)
 
void diff_filter_context (int context, int upper_bound, int lower_bound, xmlNode *xml_node, xmlNode *parent)
 
int in_upper_context (int depth, int context, xmlNode *xml_node)
 
int add_xml_object (xmlNode *parent, xmlNode *target, xmlNode *update, gboolean as_diff)
 
bool xml_acl_filtered_copy (const char *user, xmlNode *acl_source, xmlNode *xml, xmlNode **result)
 
bool xml_acl_denied (xmlNode *xml)
 
void xml_acl_disable (xmlNode *xml)
 
bool xml_acl_enabled (xmlNode *xml)
 
void xml_track_changes (xmlNode *xml, const char *user, xmlNode *acl_source, bool enforce_acls)
 
bool xml_tracking_changes (xmlNode *xml)
 
bool xml_document_dirty (xmlNode *xml)
 
xmlNode * xml_create_patchset (int format, xmlNode *source, xmlNode *target, bool *config_changed, bool manage_version)
 
void patchset_process_digest (xmlNode *patch, xmlNode *source, xmlNode *target, bool with_digest)
 
void xml_log_patchset (uint8_t log_level, const char *function, xmlNode *patchset)
 
void xml_log_changes (uint8_t log_level, const char *function, xmlNode *xml)
 
void xml_accept_changes (xmlNode *xml)
 
bool xml_patch_versions (xmlNode *patchset, int add[3], int del[3])
 
int xml_apply_patchset (xmlNode *xml, xmlNode *patchset, bool check_version)
 
xmlNode * find_xml_node (xmlNode *root, const char *search_path, gboolean must_find)
 
xmlNode * find_entity (xmlNode *parent, const char *node_name, const char *id)
 
void copy_in_properties (xmlNode *target, xmlNode *src)
 
void fix_plus_plus_recursive (xmlNode *target)
 
void expand_plus_plus (xmlNode *target, const char *name, const char *value)
 
xmlDoc * getDocPtr (xmlNode *node)
 
xmlNode * add_node_copy (xmlNode *parent, xmlNode *src_node)
 
int add_node_nocopy (xmlNode *parent, const char *name, xmlNode *child)
 
const char * crm_xml_add (xmlNode *node, const char *name, const char *value)
 
const char * crm_xml_replace (xmlNode *node, const char *name, const char *value)
 
const char * crm_xml_add_int (xmlNode *node, const char *name, int value)
 
xmlNode * create_xml_node (xmlNode *parent, const char *name)
 
char * xml_get_path (xmlNode *xml)
 
void free_xml (xmlNode *child)
 
xmlNode * copy_xml (xmlNode *src)
 
xmlNode * string2xml (const char *input)
 
xmlNode * stdin2xml (void)
 
void strip_text_nodes (xmlNode *xml)
 
xmlNode * filename2xml (const char *filename)
 
const char * crm_xml_add_last_written (xmlNode *xml_node)
 
void crm_xml_sanitize_id (char *id)
 Sanitize a string so it is usable as an XML ID. More...
 
void crm_xml_set_id (xmlNode *xml, const char *format,...)
 Set the ID of an XML element using a format. More...
 
int write_xml_fd (xmlNode *xml_node, const char *filename, int fd, gboolean compress)
 
int write_xml_file (xmlNode *xml_node, const char *filename, gboolean compress)
 
xmlNode * get_message_xml (xmlNode *msg, const char *field)
 
gboolean add_message_xml (xmlNode *msg, const char *field, xmlNode *xml)
 
char * crm_xml_escape (const char *text)
 
void log_data_element (int log_level, const char *file, const char *function, int line, const char *prefix, xmlNode *data, int depth, int options)
 
void crm_xml_dump (xmlNode *data, int options, char **buffer, int *offset, int *max, int depth)
 
void crm_buffer_add_char (char **buffer, int *offset, int *max, char c)
 
char * dump_xml_formatted_with_text (xmlNode *an_xml_node)
 
char * dump_xml_formatted (xmlNode *an_xml_node)
 
char * dump_xml_unformatted (xmlNode *an_xml_node)
 
gboolean xml_has_children (const xmlNode *xml_root)
 
int crm_element_value_int (xmlNode *data, const char *name, int *dest)
 
int crm_element_value_const_int (const xmlNode *data, const char *name, int *dest)
 
const char * crm_element_value_const (const xmlNode *data, const char *name)
 
char * crm_element_value_copy (xmlNode *data, const char *name)
 
void xml_remove_prop (xmlNode *obj, const char *name)
 
void purge_diff_markers (xmlNode *a_node)
 
void save_xml_to_file (xmlNode *xml, const char *desc, const char *filename)
 
gboolean apply_xml_diff (xmlNode *old, xmlNode *diff, xmlNode **new)
 
void xml_calculate_changes (xmlNode *old, xmlNode *new)
 
xmlNode * diff_xml_object (xmlNode *old, xmlNode *new, gboolean suppress)
 
xmlNode * subtract_xml_object (xmlNode *parent, xmlNode *left, xmlNode *right, gboolean full, gboolean *changed, const char *marker)
 
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)
 
gboolean replace_xml_child (xmlNode *parent, xmlNode *child, xmlNode *update, gboolean delete_only)
 
xmlNode * crm_create_nvpair_xml (xmlNode *parent, const char *id, const char *name, const char *value)
 Create an XML name/value pair. More...
 
void hash2nvpair (gpointer key, gpointer value, gpointer user_data)
 
void hash2smartfield (gpointer key, gpointer value, gpointer user_data)
 
void hash2field (gpointer key, gpointer value, gpointer user_data)
 
void hash2metafield (gpointer key, gpointer value, gpointer user_data)
 
GHashTable * xml2list (xmlNode *parent)
 
xmlNode * sorted_xml (xmlNode *input, xmlNode *parent, gboolean recursive)
 
xmlNode * first_named_child (xmlNode *parent, const char *name)
 
xmlNode * crm_next_same_xml (xmlNode *sibling)
 Get next instance of same XML tag. More...
 
void crm_xml_init (void)
 
void crm_xml_cleanup (void)
 
xmlNode * expand_idref (xmlNode *input, xmlNode *top)
 
const char * crm_element_value (xmlNode *data, const char *name)
 
void crm_destroy_xml (gpointer data)
 xmlNode destructor which can be used in glib collections More...
 

Macro Definition Documentation

#define buffer_print (   buffer,
  max,
  offset,
  fmt,
  args... 
)
Value:
do { \
int rc = (max); \
if(buffer) { \
rc = snprintf((buffer) + (offset), (max) - (offset), fmt, ##args); \
} \
if(buffer && rc < 0) { \
crm_perror(LOG_ERR, "snprintf failed at offset %d", offset); \
(buffer)[(offset)] = 0; \
break; \
} else if(rc >= ((max) - (offset))) { \
char *tmp = NULL; \
(max) = QB_MAX(CHUNK_SIZE, (max) * 2); \
tmp = realloc_safe((buffer), (max)); \
CRM_ASSERT(tmp); \
(buffer) = tmp; \
} else { \
offset += rc; \
break; \
} \
} while(1);
CHUNK_SIZE
#define CHUNK_SIZE
Definition: xml.c:113
crm_perror
#define crm_perror(level, fmt, args...)
Log a system error message.
Definition: logging.h:226
CRM_ASSERT
#define CRM_ASSERT(expr)
Definition: error.h:35

Definition at line 124 of file xml.c.

#define CHUNK_SIZE   1024

Definition at line 113 of file xml.c.

#define XML_BUFFER_SIZE   4096

Definition at line 45 of file xml.c.

#define XML_PARSER_DEBUG   0

Definition at line 46 of file xml.c.

#define XML_PRIVATE_MAGIC   (long) 0x81726354

Definition at line 272 of file xml.c.

#define XPATH_MAX   512

Definition at line 5122 of file xml.c.

Typedef Documentation

typedef struct name_value_s name_value_t
typedef struct xml_acl_s xml_acl_t
typedef struct xml_deleted_obj_s xml_deleted_obj_t
typedef struct xml_private_s xml_private_t

Enumeration Type Documentation

enum xml_private_flags
Enumerator
xpf_none 
xpf_dirty 
xpf_deleted 
xpf_created 
xpf_modified 
xpf_tracking 
xpf_processed 
xpf_skip 
xpf_moved 
xpf_acl_enabled 
xpf_acl_read 
xpf_acl_write 
xpf_acl_deny 
xpf_acl_create 
xpf_acl_denied 

Definition at line 56 of file xml.c.

Function Documentation

const char * __xml_acl_to_text ( enum xml_private_flags  flags)

Definition at line 524 of file xml.c.

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

Definition at line 3171 of file xml.c.

xmlNode* add_node_copy ( xmlNode *  parent,
xmlNode *  src_node 
)

Definition at line 2405 of file xml.c.

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

Definition at line 2419 of file xml.c.

int add_xml_object ( xmlNode *  parent,
xmlNode *  target,
xmlNode *  update,
gboolean  as_diff 
)

Definition at line 4595 of file xml.c.

gboolean apply_xml_diff ( xmlNode *  old,
xmlNode *  diff,
xmlNode **  new 
)

Definition at line 3933 of file xml.c.

gboolean can_prune_leaf ( xmlNode *  xml_node)

Definition at line 4228 of file xml.c.

void copy_in_properties ( xmlNode *  target,
xmlNode *  src 
)

Definition at line 2287 of file xml.c.

xmlNode* copy_xml ( xmlNode *  src)

Definition at line 2712 of file xml.c.

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

Definition at line 2588 of file xml.c.

void crm_buffer_add_char ( char **  buffer,
int *  offset,
int *  max,
char  c 
)

Definition at line 3799 of file xml.c.

xmlNode* crm_create_nvpair_xml ( xmlNode *  parent,
const char *  id,
const char *  name,
const char *  value 
)

Create an XML name/value pair.

Parameters
[in]parentIf not NULL, make new XML node a child of this one
[in]idIf not NULL, use this as ID (otherwise auto-generate)
[in]nameName to use
[in]valueValue to use
Returns
New XML object on success, NULL otherwise

Definition at line 4831 of file xml.c.

void crm_destroy_xml ( gpointer  data)

xmlNode destructor which can be used in glib collections

Definition at line 5187 of file xml.c.

const char* crm_element_value ( xmlNode *  data,
const char *  name 
)

Definition at line 5165 of file xml.c.

const char* crm_element_value_const ( const xmlNode *  data,
const char *  name 
)

Definition at line 3863 of file xml.c.

int crm_element_value_const_int ( const xmlNode *  data,
const char *  name,
int *  dest 
)

Definition at line 3857 of file xml.c.

char* crm_element_value_copy ( xmlNode *  data,
const char *  name 
)

Definition at line 3869 of file xml.c.

int crm_element_value_int ( xmlNode *  data,
const char *  name,
int *  dest 
)

Definition at line 3844 of file xml.c.

xmlNode* crm_next_same_xml ( xmlNode *  sibling)

Get next instance of same XML tag.

Parameters
[in]siblingXML tag to start from
Returns
Next sibling XML tag with same name

Definition at line 5078 of file xml.c.

const char* crm_xml_add ( xmlNode *  node,
const char *  name,
const char *  value 
)

Definition at line 2490 of file xml.c.

const char* crm_xml_add_int ( xmlNode *  node,
const char *  name,
int  value 
)

Definition at line 2578 of file xml.c.

const char* crm_xml_add_last_written ( xmlNode *  xml_node)

Definition at line 3006 of file xml.c.

void crm_xml_cleanup ( void  )

Definition at line 5115 of file xml.c.

void crm_xml_dump ( xmlNode *  data,
int  options,
char **  buffer,
int *  offset,
int *  max,
int  depth 
)

Definition at line 3696 of file xml.c.

char* crm_xml_escape ( const char *  text)

Definition at line 3197 of file xml.c.

void crm_xml_init ( void  )

Definition at line 5093 of file xml.c.

const char* crm_xml_replace ( xmlNode *  node,
const char *  name,
const char *  value 
)

Definition at line 2536 of file xml.c.

void crm_xml_sanitize_id ( char *  id)

Sanitize a string so it is usable as an XML ID.

Parameters
[in,out]idString to sanitize

Definition at line 3021 of file xml.c.

void crm_xml_set_id ( xmlNode *  xml,
const char *  format,
  ... 
)

Set the ID of an XML element using a format.

Parameters
[in,out]xmlXML element
[in]fmtprintf-style format
[in]...any arguments required by format

Definition at line 3043 of file xml.c.

void diff_filter_context ( int  context,
int  upper_bound,
int  lower_bound,
xmlNode *  xml_node,
xmlNode *  parent 
)

Definition at line 4266 of file xml.c.

xmlNode* diff_xml_object ( xmlNode *  old,
xmlNode *  new,
gboolean  suppress 
)

Definition at line 4200 of file xml.c.

char* dump_xml_formatted ( xmlNode *  an_xml_node)

Definition at line 3815 of file xml.c.

char* dump_xml_formatted_with_text ( xmlNode *  an_xml_node)

Definition at line 3805 of file xml.c.

char* dump_xml_unformatted ( xmlNode *  an_xml_node)

Definition at line 3825 of file xml.c.

xmlNode* expand_idref ( xmlNode *  input,
xmlNode *  top 
)

Definition at line 5125 of file xml.c.

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

Definition at line 2328 of file xml.c.

xmlNode* filename2xml ( const char *  filename)

Definition at line 2934 of file xml.c.

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

Definition at line 2268 of file xml.c.

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

Definition at line 4706 of file xml.c.

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

Definition at line 2235 of file xml.c.

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

Definition at line 5053 of file xml.c.

void fix_plus_plus_recursive ( xmlNode *  target)

Definition at line 2310 of file xml.c.

void free_xml ( xmlNode *  child)

Definition at line 2706 of file xml.c.

int get_attr_name ( const char *  input,
size_t  offset,
size_t  max 
)
int get_attr_value ( const char *  input,
size_t  offset,
size_t  max 
)
xmlNode* get_message_xml ( xmlNode *  msg,
const char *  field 
)

Definition at line 3163 of file xml.c.

int get_tag_name ( const char *  input,
size_t  offset,
size_t  max 
)
xmlDoc* getDocPtr ( xmlNode *  node)

Definition at line 2389 of file xml.c.

void hash2field ( gpointer  key,
gpointer  value,
gpointer  user_data 
)

Definition at line 4892 of file xml.c.

void hash2metafield ( gpointer  key,
gpointer  value,
gpointer  user_data 
)

Definition at line 4908 of file xml.c.

void hash2nvpair ( gpointer  key,
gpointer  value,
gpointer  user_data 
)

Definition at line 4858 of file xml.c.

void hash2smartfield ( gpointer  key,
gpointer  value,
gpointer  user_data 
)

Definition at line 4869 of file xml.c.

int in_upper_context ( int  depth,
int  context,
xmlNode *  xml_node 
)

Definition at line 4307 of file xml.c.

void log_data_element ( int  log_level,
const char *  file,
const char *  function,
int  line,
const char *  prefix,
xmlNode *  data,
int  depth,
int  options 
)

Definition at line 3496 of file xml.c.

void patchset_process_digest ( xmlNode *  patch,
xmlNode *  source,
xmlNode *  target,
bool  with_digest 
)

Definition at line 1354 of file xml.c.

void purge_diff_markers ( xmlNode *  a_node)

Definition at line 3902 of file xml.c.

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

Definition at line 4738 of file xml.c.

void save_xml_to_file ( xmlNode *  xml,
const char *  desc,
const char *  filename 
)

Definition at line 3915 of file xml.c.

xmlNode* sorted_xml ( xmlNode *  input,
xmlNode *  parent,
gboolean  recursive 
)

Definition at line 5009 of file xml.c.

xmlNode* stdin2xml ( void  )

Definition at line 2815 of file xml.c.

xmlNode* string2xml ( const char *  input)

Definition at line 2750 of file xml.c.

void strip_text_nodes ( xmlNode *  xml)

Definition at line 2905 of file xml.c.

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

Definition at line 4386 of file xml.c.

gboolean update_xml_child ( xmlNode *  child,
xmlNode *  to_update 
)

Definition at line 4672 of file xml.c.

int write_xml_fd ( xmlNode *  xml_node,
const char *  filename,
int  fd,
gboolean  compress 
)

Definition at line 3143 of file xml.c.

int write_xml_file ( xmlNode *  xml_node,
const char *  filename,
gboolean  compress 
)

Definition at line 3153 of file xml.c.

GHashTable* xml2list ( xmlNode *  parent)

Definition at line 4931 of file xml.c.

void xml_accept_changes ( xmlNode *  xml)

Definition at line 1573 of file xml.c.

bool xml_acl_denied ( xmlNode *  xml)

Definition at line 822 of file xml.c.

void xml_acl_disable ( xmlNode *  xml)

Definition at line 833 of file xml.c.

bool xml_acl_enabled ( xmlNode *  xml)

Definition at line 846 of file xml.c.

bool xml_acl_filtered_copy ( const char *  user,
xmlNode *  acl_source,
xmlNode *  xml,
xmlNode **  result 
)

Definition at line 701 of file xml.c.

int xml_apply_patchset ( xmlNode *  xml,
xmlNode *  patchset,
bool  check_version 
)

Definition at line 2158 of file xml.c.

void xml_calculate_changes ( xmlNode *  old,
xmlNode *  new 
)

Definition at line 4187 of file xml.c.

xmlNode* xml_create_patchset ( int  format,
xmlNode *  source,
xmlNode *  target,
bool *  config_changed,
bool  manage_version 
)

Definition at line 1294 of file xml.c.

bool xml_document_dirty ( xmlNode *  xml)

Definition at line 883 of file xml.c.

char* xml_get_path ( xmlNode *  xml)

Definition at line 2631 of file xml.c.

gboolean xml_has_children ( const xmlNode *  xml_root)

Definition at line 3835 of file xml.c.

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

Definition at line 1542 of file xml.c.

void xml_log_patchset ( uint8_t  log_level,
const char *  function,
xmlNode *  patchset 
)

Definition at line 1387 of file xml.c.

bool xml_patch_versions ( xmlNode *  patchset,
int  add[3],
int  del[3] 
)

Definition at line 1765 of file xml.c.

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

Definition at line 3881 of file xml.c.

void xml_track_changes ( xmlNode *  xml,
const char *  user,
xmlNode *  acl_source,
bool  enforce_acls 
)

Definition at line 857 of file xml.c.

bool xml_tracking_changes ( xmlNode *  xml)

Definition at line 872 of file xml.c.

Generated on Tue Nov 14 2017 16:40:17 for pacemaker by   doxygen 1.8.5