xml.c File Reference

XML abstraction layer. More...

#include "asterisk.h"
#include "asterisk/xml.h"
#include "asterisk/logger.h"
#include "asterisk/utils.h"
#include "asterisk/autoconfig.h"
#include <libxml/parser.h>
#include <libxml/tree.h>
#include <libxml/xinclude.h>
#include <libxml/xpath.h>
#include <libxml/xpathInternals.h>

Include dependency graph for xml.c:

Go to the source code of this file.

Functions
struct ast_xml_node *	ast_xml_add_child (struct ast_xml_node *parent, struct ast_xml_node *child)
	Add a child node, to a specified parent node.
struct ast_xml_node *	ast_xml_add_child_list (struct ast_xml_node *parent, struct ast_xml_node *child)
	Add a list of child nodes, to a specified parent node.
void	ast_xml_close (struct ast_xml_doc *doc)
	Close an already open document and free the used structure.
struct ast_xml_node *	ast_xml_copy_node_list (struct ast_xml_node *list)
	Create a copy of a n ode list.
int	ast_xml_doc_dump_file (FILE *output, struct ast_xml_doc *doc)
	Dump the specified document to a file.
void	ast_xml_doc_dump_memory (struct ast_xml_doc *doc, char **buffer, int *length)
	Dump the specified document to a buffer.
struct ast_xml_node *	ast_xml_find_element (struct ast_xml_node *root_node, const char *name, const char *attrname, const char *attrvalue)
	Find a node element by name.
struct ast_xml_ns *	ast_xml_find_namespace (struct ast_xml_doc *doc, struct ast_xml_node *node, const char *ns_name)
int	ast_xml_finish (void)
	Cleanup library allocated global data.
void	ast_xml_free_attr (const char *attribute)
	Free an attribute returned by ast_xml_get_attribute()
void	ast_xml_free_node (struct ast_xml_node *node)
	Free node.
void	ast_xml_free_text (const char *text)
	Free a content element that was returned by ast_xml_get_text()
const char *	ast_xml_get_attribute (struct ast_xml_node *node, const char *attrname)
	Get a node attribute by name.
struct ast_xml_doc *	ast_xml_get_doc (struct ast_xml_node *node)
	Get the document based on a node.
const char *	ast_xml_get_ns_href (struct ast_xml_ns *ns)
	Get the href of a namespace.
const char *	ast_xml_get_ns_prefix (struct ast_xml_ns *ns)
	Get the prefix of a namespace.
struct ast_xml_node *	ast_xml_get_root (struct ast_xml_doc *doc)
	Get the document root node.
const char *	ast_xml_get_text (struct ast_xml_node *node)
	Get an element content string.
int	ast_xml_init (void)
	Initialize the XML library implementation. This function is used to setup everything needed to start working with the xml implementation.
struct ast_xml_doc *	ast_xml_new (void)
	Create a XML document.
struct ast_xml_node *	ast_xml_new_child (struct ast_xml_node *parent, const char *child_name)
	Add a child node inside a passed parent node.
struct ast_xml_node *	ast_xml_new_node (const char *name)
	Create a XML node.
struct ast_xml_node *	ast_xml_node_get_children (struct ast_xml_node *node)
	Get the node's children.
const char *	ast_xml_node_get_name (struct ast_xml_node *node)
	Get the name of a node.
struct ast_xml_node *	ast_xml_node_get_next (struct ast_xml_node *node)
	Get the next node in the same level.
struct ast_xml_node *	ast_xml_node_get_parent (struct ast_xml_node *node)
	Get the parent of a specified node.
struct ast_xml_node *	ast_xml_node_get_prev (struct ast_xml_node *node)
	Get the previous node in the same leve.
struct ast_xml_doc *	ast_xml_open (char *filename)
	Open an XML document.
struct ast_xml_xpath_results *	ast_xml_query (struct ast_xml_doc *doc, const char *xpath_str)
	Execute an XPath query on an XML document.
struct ast_xml_xpath_results *	ast_xml_query_with_namespaces (struct ast_xml_doc *doc, const char *xpath_str, struct ast_xml_namespace_def_vector *namespaces)
	Execute an XPath query on an XML document with namespaces.
struct ast_xml_doc *	ast_xml_read_memory (char *buffer, size_t size)
	Open an XML document that resides in memory.
int	ast_xml_set_attribute (struct ast_xml_node *node, const char *name, const char *value)
	Set an attribute to a node.
void	ast_xml_set_name (struct ast_xml_node *node, const char *name)
	Set or reset an element's name.
void	ast_xml_set_root (struct ast_xml_doc *doc, struct ast_xml_node *node)
	Specify the root node of a XML document.
void	ast_xml_set_text (struct ast_xml_node *node, const char *content)
	Set an element content string.
struct ast_xml_node *	ast_xml_xpath_get_first_result (struct ast_xml_xpath_results *results)
	Return the first result node of an XPath query.
struct ast_xml_node *	ast_xml_xpath_get_result (struct ast_xml_xpath_results *results, int i)
	Return a specific result node of an XPath query.
int	ast_xml_xpath_num_results (struct ast_xml_xpath_results *results)
	Return the number of results from an XPath query.
void	ast_xml_xpath_results_free (struct ast_xml_xpath_results *results)
	Free the XPath results.
static int	process_xincludes (xmlDoc *doc)

Detailed Description

XML abstraction layer.

Author

Eliel C. Sardanons (LU1ALY) eliel.nosp@m.s@gm.nosp@m.ail.c.nosp@m.om

Definition in file xml.c.

Function Documentation

ast_xml_add_child()

struct ast_xml_node * ast_xml_add_child	(	struct ast_xml_node *	parent,
		struct ast_xml_node *	child
	)

Add a child node, to a specified parent node.

Parameters

parent	Where to add the child node.
child	The child node to add.

Return values

NULL	on error.
non-NULL	The add child node on success.

Definition at line 168 of file xml.c.

{
    if (!parent || !child) {
        return NULL;
    }
    return (struct ast_xml_node *) xmlAddChild((xmlNode *) parent, (xmlNode *) child);
}

References NULL.

Referenced by ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), and geoloc_eprofile_to_intermediate().

ast_xml_add_child_list()

struct ast_xml_node * ast_xml_add_child_list	(	struct ast_xml_node *	parent,
		struct ast_xml_node *	child
	)

Add a list of child nodes, to a specified parent node.

Parameters

parent	Where to add the child node.
child	The child list to add.

Return values

NULL	on error.
non-NULL	The added child list on success.

Definition at line 176 of file xml.c.

{
    if (!parent || !child) {
        return NULL;
    }
    return (struct ast_xml_node *) xmlAddChildList((xmlNode *) parent, (xmlNode *) child);
}

References NULL.

Referenced by ast_geoloc_eprofiles_to_pidf(), and handle_dump_docs().

ast_xml_close()

void ast_xml_close

(

struct ast_xml_doc *

doc

)

Close an already open document and free the used structure.

Parameters

doc	XML Document to close

Definition at line 211 of file xml.c.

{
    if (!doc) {
        return;
    }
 
    xmlFreeDoc((xmlDoc *) doc);
    doc = NULL;
}

References NULL.

Referenced by ast_geoloc_eprofile_create_from_pidf(), ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), handle_dump_docs(), handle_incoming_request(), xmldoc_load_documentation(), and xmldoc_purge_documentation().

ast_xml_copy_node_list()

struct ast_xml_node * ast_xml_copy_node_list

(

struct ast_xml_node *

list

)

Create a copy of a n ode list.

Parameters

list	The list to copy.

Return values

NULL	on error.
non-NULL	The copied list.

Definition at line 184 of file xml.c.

{
    if (!list) {
        return NULL;
    }
    return (struct ast_xml_node *) xmlCopyNodeList((xmlNode *) list);
}

References NULL.

Referenced by ast_geoloc_eprofiles_to_pidf(), and handle_dump_docs().

ast_xml_doc_dump_file()

int ast_xml_doc_dump_file	(	FILE *	output,
		struct ast_xml_doc *	doc
	)

Dump the specified document to a file.

Definition at line 380 of file xml.c.

{
    return xmlDocDump(output, (xmlDocPtr)doc);
}

Referenced by handle_dump_docs().

ast_xml_doc_dump_memory()

void ast_xml_doc_dump_memory	(	struct ast_xml_doc *	doc,
		char **	buffer,
		int *	length
	)

Dump the specified document to a buffer.

Parameters

doc	The XML doc to dump
buffer	A pointer to a char * to receive the address of the results
length	A pointer to an int to receive the length of the results

Note

The result buffer must be freed with ast_xml_free_text().

Definition at line 385 of file xml.c.

{
    xmlDocDumpFormatMemory((xmlDocPtr)doc, (xmlChar **)buffer, length, 1);
}

Referenced by ast_geoloc_eprofile_create_from_pidf(), ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), and geoloc_eprofile_create_from_xslt_result().

ast_xml_find_element()

struct ast_xml_node * ast_xml_find_element	(	struct ast_xml_node *	root_node,
		const char *	name,
		const char *	attrname,
		const char *	attrvalue
	)

Find a node element by name.

Parameters

root_node	This is the node starting point.
name	Node name to find.
attrname	attribute name to match (if NULL it won't be matched).
attrvalue	attribute value to match (if NULL it won't be matched).

Return values

NULL	if not found.

Returns

The node on success.

Definition at line 297 of file xml.c.

{
    struct ast_xml_node *cur;
    const char *attr;
 
    if (!root_node) {
        return NULL;
    }
 
    for (cur = root_node; cur; cur = ast_xml_node_get_next(cur)) {
        /* Check if the name matches */
        if (strcmp(ast_xml_node_get_name(cur), name)) {
            continue;
        }
        /* We need to check for a specific attribute name? */
        if (!attrname || !attrvalue) {
            return cur;
        }
        /* Get the attribute, we need to compare it. */
        if ((attr = ast_xml_get_attribute(cur, attrname))) {
            /* does attribute name/value matches? */
            if (!strcmp(attr, attrvalue)) {
                ast_xml_free_attr(attr);
                return cur;
            }
            ast_xml_free_attr(attr);
        }
    }
 
    return NULL;
}

References ast_xml_free_attr(), ast_xml_get_attribute(), ast_xml_node_get_name(), ast_xml_node_get_next(), name, and NULL.

Referenced by _xmldoc_build_field(), load_modules(), xmldoc_build_final_response(), xmldoc_build_list_responses(), xmldoc_get_node(), and xmldoc_get_syntax_config_object().

ast_xml_find_namespace()

struct ast_xml_ns * ast_xml_find_namespace	(	struct ast_xml_doc *	doc,
		struct ast_xml_node *	node,
		const char *	ns_name
	)

Definition at line 338 of file xml.c.

                                                                                                                   {
    xmlNsPtr ns = xmlSearchNs((xmlDocPtr) doc, (xmlNodePtr) node, (xmlChar *) ns_name);
    return (struct ast_xml_ns *) ns;
}

ast_xml_finish()

int ast_xml_finish

(

void

)

Cleanup library allocated global data.

Return values

0	On success.
1	On error.

Definition at line 57 of file xml.c.

{
    xmlCleanupParser();
#ifdef HAVE_LIBXSLT
#ifdef HAVE_LIBXSLT_CLEANUP
    xsltCleanupGlobals();
#else
    xsltUninit();
#endif
#endif
 
    return 0;
}

Referenced by xmldoc_unload_documentation().

ast_xml_free_attr()

void ast_xml_free_attr

(

const char *

attribute

)

Free an attribute returned by ast_xml_get_attribute()

Parameters

attribute

pointer to be freed.

Definition at line 253 of file xml.c.

{
    if (attribute) {
        xmlFree((char *) attribute);
    }
}

Referenced by _ast_xmldoc_build_seealso(), ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), ast_xml_find_element(), ast_xmldoc_build_documentation(), ast_xmldoc_regenerate_doc_item(), build_config_docs(), geoloc_eprofile_create_from_xslt_result(), var_list_from_confidence(), var_list_from_loc_info(), var_list_from_node(), xmldoc_attribute_match(), xmldoc_build_final_response(), xmldoc_build_list_responses(), xmldoc_get_syntax_cmd(), xmldoc_get_syntax_config_object(), xmldoc_get_syntax_config_option(), xmldoc_get_syntax_fun(), xmldoc_get_syntax_manager(), xmldoc_parse_argument(), xmldoc_parse_enumlist(), xmldoc_parse_example(), xmldoc_parse_info(), xmldoc_parse_optionlist(), xmldoc_parse_parameter(), xmldoc_parse_variable(), and xmldoc_parse_variablelist().

ast_xml_free_node()

void ast_xml_free_node

(

struct ast_xml_node *

node

)

Free node.

Parameters

node	Node to be released.

Definition at line 243 of file xml.c.

{
    if (!node) {
        return;
    }
 
    xmlFreeNode((xmlNode *) node);
    node = NULL;
}

References NULL.

Referenced by ast_geoloc_eprofiles_to_pidf(), geoloc_civicaddr_list_to_xml(), geoloc_eprofile_to_intermediate(), and geoloc_gml_list_to_xml().

ast_xml_free_text()

void ast_xml_free_text

(

const char *

text

)

Free a content element that was returned by ast_xml_get_text()

Parameters

text	text to be freed.

Definition at line 260 of file xml.c.

{
    if (text) {
        xmlFree((char *) text);
    }
}

References text.

Referenced by _ast_xmldoc_build_seealso(), _ast_xmldoc_build_since(), ast_geoloc_eprofile_create_from_pidf(), ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), geoloc_eprofile_create_from_xslt_result(), var_list_from_confidence(), var_list_from_node(), xmldoc_get_formatted(), xmldoc_get_syntax_config_object(), xmldoc_parse_example(), xmldoc_parse_para(), and xmldoc_parse_variable().

ast_xml_get_attribute()

const char * ast_xml_get_attribute	(	struct ast_xml_node *	node,
		const char *	attrname
	)

Get a node attribute by name.

Parameters

node	Node where to search the attribute.
attrname	Attribute name.

Return values

NULL

on error

Returns

The attribute value on success.

Note

The result must be freed with ast_xml_free_attr().

Definition at line 267 of file xml.c.

{
    xmlChar *attrvalue;
 
    if (!node) {
        return NULL;
    }
 
    if (!attrname) {
        return NULL;
    }
 
    attrvalue = xmlGetProp((xmlNode *) node, (xmlChar *) attrname);
 
    return (const char *) attrvalue;
}

References NULL.

Referenced by _ast_xmldoc_build_seealso(), ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), ast_xml_find_element(), ast_xmldoc_build_documentation(), ast_xmldoc_regenerate_doc_item(), build_config_docs(), geoloc_eprofile_create_from_xslt_result(), var_list_from_confidence(), var_list_from_loc_info(), var_list_from_node(), xmldoc_attribute_match(), xmldoc_build_final_response(), xmldoc_build_list_responses(), xmldoc_get_syntax_cmd(), xmldoc_get_syntax_config_object(), xmldoc_get_syntax_config_option(), xmldoc_get_syntax_fun(), xmldoc_get_syntax_manager(), xmldoc_parse_argument(), xmldoc_parse_enumlist(), xmldoc_parse_example(), xmldoc_parse_info(), xmldoc_parse_optionlist(), xmldoc_parse_parameter(), xmldoc_parse_variable(), and xmldoc_parse_variablelist().

ast_xml_get_doc()

struct ast_xml_doc * ast_xml_get_doc

(

struct ast_xml_node *

node

)

Get the document based on a node.

Parameters

node	A node that is part of the dom.

Returns

The dom pointer where this node resides.

Definition at line 329 of file xml.c.

{
    if (!node) {
        return NULL;
    }
 
    return (struct ast_xml_doc *) ((xmlNode *)node)->doc;
}

References NULL.

ast_xml_get_ns_href()

const char * ast_xml_get_ns_href

(

struct ast_xml_ns *

ns

)

Get the href of a namespace.

Parameters

ns	The namespace

Returns

The href of the namespace.

Definition at line 348 of file xml.c.

{
    return (const char *) ((xmlNsPtr) ns)->href;
}

ast_xml_get_ns_prefix()

const char * ast_xml_get_ns_prefix

(

struct ast_xml_ns *

ns

)

Get the prefix of a namespace.

Parameters

ns	The namespace

Returns

The prefix of the namespace.

Definition at line 343 of file xml.c.

{
    return (const char *) ((xmlNsPtr) ns)->prefix;
}

ast_xml_get_root()

struct ast_xml_node * ast_xml_get_root

(

struct ast_xml_doc *

doc

)

Get the document root node.

Parameters

doc	XML Document reference

Return values

NULL

on error

Returns

The root node on success.

Definition at line 230 of file xml.c.

{
    xmlNode *root_node;
 
    if (!doc) {
        return NULL;
    }
 
    root_node = xmlDocGetRootElement((xmlDoc *) doc);
 
    return (struct ast_xml_node *) root_node;
}

References NULL.

Referenced by ast_xmldoc_build_documentation(), geoloc_eprofile_create_from_xslt_result(), handle_dump_docs(), is_pidf_lo(), xmldoc_get_node(), and xmldoc_load_documentation().

ast_xml_get_text()

const char * ast_xml_get_text

(

struct ast_xml_node *

node

)

Get an element content string.

Parameters

node	Node from where to get the string.

Return values

NULL

on error.

Returns

The text content of node.

Definition at line 353 of file xml.c.

{
    if (!node) {
        return NULL;
    }
 
    return (const char *) xmlNodeGetContent((xmlNode *) node);
}

References NULL.

Referenced by _ast_xmldoc_build_seealso(), _ast_xmldoc_build_since(), geoloc_eprofile_create_from_xslt_result(), load_modules(), var_list_from_confidence(), var_list_from_node(), xmldoc_get_formatted(), xmldoc_get_syntax_config_object(), xmldoc_parse_example(), xmldoc_parse_para(), and xmldoc_parse_variable().

ast_xml_init()

int ast_xml_init

(

void

)

Initialize the XML library implementation. This function is used to setup everything needed to start working with the xml implementation.

Return values

0	On success.
1	On error.

Definition at line 48 of file xml.c.

{
    LIBXML_TEST_VERSION
#ifdef HAVE_LIBXSLT
    xsltInit();
#endif
    return 0;
}

Referenced by xmldoc_load_documentation().

ast_xml_new()

struct ast_xml_doc * ast_xml_new

(

void

)

Create a XML document.

Return values

NULL	on error.
non-NULL	The allocated document structure.

Definition at line 136 of file xml.c.

{
    xmlDoc *doc;
 
    doc = xmlNewDoc((const xmlChar *) "1.0");
    return (struct ast_xml_doc *) doc;
}

Referenced by ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), and handle_dump_docs().

ast_xml_new_child()

struct ast_xml_node * ast_xml_new_child	(	struct ast_xml_node *	parent,
		const char *	child_name
	)

Add a child node inside a passed parent node.

Parameters

parent	The pointer of the parent node.
child_name	The name of the child node to add.

Return values

NULL	on error.
non-NULL	The created child node pointer.

Definition at line 156 of file xml.c.

{
    xmlNode *child;
 
    if (!parent || !child_name) {
        return NULL;
    }
 
    child = xmlNewChild((xmlNode *) parent, NULL, (const xmlChar *) child_name, NULL);
    return (struct ast_xml_node *) child;
}

References NULL.

Referenced by geoloc_civicaddr_list_to_xml(), geoloc_eprofile_to_intermediate(), geoloc_gml_list_to_xml(), and xmldoc_update_config_type().

ast_xml_new_node()

struct ast_xml_node * ast_xml_new_node

(

const char *

name

)

Create a XML node.

Parameters

name	The name of the node to be created.

Return values

NULL	on error.
non-NULL	The allocated node structe.

Definition at line 144 of file xml.c.

{
    xmlNode *node;
    if (!name) {
        return NULL;
    }
 
    node = xmlNewNode(NULL, (const xmlChar *) name);
 
    return (struct ast_xml_node *) node;
}

References name, and NULL.

Referenced by ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), geoloc_civicaddr_list_to_xml(), geoloc_eprofile_to_intermediate(), geoloc_gml_list_to_xml(), and handle_dump_docs().

ast_xml_node_get_children()

struct ast_xml_node * ast_xml_node_get_children

(

struct ast_xml_node *

node

)

Get the node's children.

Definition at line 395 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlNode *) node)->children;
}

Referenced by _ast_xmldoc_build_arguments(), _ast_xmldoc_build_seealso(), _ast_xmldoc_build_since(), _ast_xmldoc_build_syntax(), _xmldoc_build_field(), ast_geoloc_eprofiles_to_pidf(), ast_xmldoc_build_arguments(), ast_xmldoc_build_documentation(), ast_xmldoc_build_final_response(), ast_xmldoc_build_list_responses(), ast_xmldoc_build_seealso(), ast_xmldoc_build_since(), build_config_docs(), geoloc_eprofile_create_from_xslt_result(), handle_dump_docs(), is_pidf_lo(), load_modules(), var_list_from_loc_info(), var_list_from_node(), xmldoc_build_final_response(), xmldoc_build_list_responses(), xmldoc_get_formatted(), xmldoc_get_node(), xmldoc_get_syntax_cmd(), xmldoc_get_syntax_config_object(), xmldoc_get_syntax_fun(), xmldoc_get_syntax_manager(), xmldoc_has_inside(), xmldoc_has_nodes(), xmldoc_has_specialtags(), xmldoc_parse_argument(), xmldoc_parse_cmd_enumlist(), xmldoc_parse_enum(), xmldoc_parse_enumlist(), xmldoc_parse_example(), xmldoc_parse_info(), xmldoc_parse_option(), xmldoc_parse_optionlist(), xmldoc_parse_para(), xmldoc_parse_parameter(), xmldoc_parse_specialtags(), xmldoc_parse_variable(), and xmldoc_parse_variablelist().

ast_xml_node_get_name()

const char * ast_xml_node_get_name

(

struct ast_xml_node *

node

)

Get the name of a node.

Definition at line 390 of file xml.c.

{
    return (const char *) ((xmlNode *) node)->name;
}

Referenced by _ast_xmldoc_build_arguments(), _ast_xmldoc_build_seealso(), _ast_xmldoc_build_since(), _ast_xmldoc_build_syntax(), ast_xml_find_element(), ast_xmldoc_build_documentation(), build_config_docs(), geoloc_eprofile_create_from_xslt_result(), is_pidf_lo(), var_list_from_loc_info(), var_list_from_node(), xmldoc_build_list_responses(), xmldoc_get_syntax_cmd(), xmldoc_get_syntax_fun(), xmldoc_get_syntax_manager(), xmldoc_has_inside(), xmldoc_has_nodes(), xmldoc_has_specialtags(), xmldoc_load_documentation(), xmldoc_parse_cmd_enumlist(), xmldoc_parse_enumlist(), xmldoc_parse_example(), xmldoc_parse_info(), xmldoc_parse_option(), xmldoc_parse_optionlist(), xmldoc_parse_para(), xmldoc_parse_parameter(), xmldoc_parse_specialtags(), xmldoc_parse_variable(), and xmldoc_parse_variablelist().

ast_xml_node_get_next()

struct ast_xml_node * ast_xml_node_get_next

(

struct ast_xml_node *

node

)

Get the next node in the same level.

Definition at line 400 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlNode *) node)->next;
}

Referenced by _ast_xmldoc_build_arguments(), _ast_xmldoc_build_seealso(), _ast_xmldoc_build_since(), _ast_xmldoc_build_syntax(), ast_xml_find_element(), ast_xmldoc_build_documentation(), build_config_docs(), var_list_from_node(), xmldoc_build_list_responses(), xmldoc_get_formatted(), xmldoc_get_node(), xmldoc_get_syntax_cmd(), xmldoc_get_syntax_fun(), xmldoc_get_syntax_manager(), xmldoc_has_inside(), xmldoc_has_nodes(), xmldoc_has_specialtags(), xmldoc_parse_argument(), xmldoc_parse_cmd_enumlist(), xmldoc_parse_enum(), xmldoc_parse_enumlist(), xmldoc_parse_example(), xmldoc_parse_info(), xmldoc_parse_option(), xmldoc_parse_optionlist(), xmldoc_parse_para(), xmldoc_parse_parameter(), xmldoc_parse_specialtags(), xmldoc_parse_variable(), and xmldoc_parse_variablelist().

ast_xml_node_get_parent()

struct ast_xml_node * ast_xml_node_get_parent

(

struct ast_xml_node *

node

)

Get the parent of a specified node.

Definition at line 410 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlNode *) node)->parent;
}

ast_xml_node_get_prev()

struct ast_xml_node * ast_xml_node_get_prev

(

struct ast_xml_node *

node

)

Get the previous node in the same leve.

Definition at line 405 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlNode *) node)->prev;
}

ast_xml_open()

struct ast_xml_doc * ast_xml_open

(

char *

filename

)

Open an XML document.

Parameters

filename

Document path.

Return values

NULL

on error.

Returns

The ast_xml_doc reference to the open document.

Definition at line 94 of file xml.c.

{
    xmlDoc *doc;
 
    if (!filename) {
        return NULL;
    }
 
    doc = xmlReadFile(filename, NULL, XML_PARSE_RECOVER | XML_PARSE_NOENT);
    if (!doc) {
        return NULL;
    }
 
    /* process xinclude elements. */
    if (process_xincludes(doc) < 0) {
        xmlFreeDoc(doc);
        return NULL;
    }
 
#ifdef HAVE_LIBXSLT
    {
        xsltStylesheetPtr xslt = xsltLoadStylesheetPI(doc);
        if (xslt) {
            xmlDocPtr tmpdoc = xsltApplyStylesheet(xslt, doc, NULL);
            xsltFreeStylesheet(xslt);
            xmlFreeDoc(doc);
            if (!tmpdoc) {
                return NULL;
            }
            doc = tmpdoc;
        }
    }
#else /* no HAVE_LIBXSLT */
    ast_log(LOG_NOTICE, "XSLT support not found. XML documentation may be incomplete.\n");
#endif /* HAVE_LIBXSLT */
 
    /* Optimize for XPath */
    xmlXPathOrderDocElems(doc);
 
    return (struct ast_xml_doc *) doc;
}

References ast_log, LOG_NOTICE, NULL, and process_xincludes().

Referenced by xmldoc_load_documentation().

ast_xml_query()

struct ast_xml_xpath_results * ast_xml_query	(	struct ast_xml_doc *	doc,
		const char *	xpath_str
	)

Execute an XPath query on an XML document.

Parameters

doc	XML document to query
xpath_str	The XPath query string to execute on the document

Returns

An object containing the results of the XPath query on success

Return values

NULL	on failure

Since

12

Definition at line 441 of file xml.c.

{
    xmlXPathContextPtr context;
    xmlXPathObjectPtr result;
    if (!(context = xmlXPathNewContext((xmlDoc *) doc))) {
        ast_log(LOG_ERROR, "Could not create XPath context!\n");
        return NULL;
    }
    result = xmlXPathEvalExpression((xmlChar *) xpath_str, context);
    xmlXPathFreeContext(context);
    if (!result) {
        ast_log(LOG_WARNING, "Error for query: %s\n", xpath_str);
        return NULL;
    }
    if (xmlXPathNodeSetIsEmpty(result->nodesetval)) {
        xmlXPathFreeObject(result);
        ast_debug(5, "No results for query: %s\n", xpath_str);
        return NULL;
    }
    return (struct ast_xml_xpath_results *) result;
}

References ast_debug, ast_log, LOG_ERROR, LOG_WARNING, NULL, and result.

Referenced by ast_xmldoc_query().

ast_xml_query_with_namespaces()

struct ast_xml_xpath_results * ast_xml_query_with_namespaces	(	struct ast_xml_doc *	doc,
		const char *	xpath_str,
		struct ast_xml_namespace_def_vector *	namespaces
	)

Execute an XPath query on an XML document with namespaces.

Parameters

doc	XML document to query
xpath_str	The XPath query string to execute on the document
namespaces	A vector of ast_xml_namespace structures (not pointers)

Returns

An object containing the results of the XPath query on success

Return values

NULL	on failure

Definition at line 463 of file xml.c.

{
    xmlXPathContextPtr context;
    xmlXPathObjectPtr result;
    int i;
 
    if (!(context = xmlXPathNewContext((xmlDoc *) doc))) {
        ast_log(LOG_ERROR, "Could not create XPath context!\n");
        return NULL;
    }
 
    for (i = 0; i < AST_VECTOR_SIZE(namespaces); i++) {
        struct ast_xml_namespace_def ns = AST_VECTOR_GET(namespaces, i);
        if (xmlXPathRegisterNs(context, (xmlChar *)ns.prefix,
            (xmlChar *)ns.href) != 0) {
            xmlXPathFreeContext(context);
            ast_log(LOG_ERROR, "Could not register namespace %s:%s\n",
                ns.prefix, ns.href);
            return NULL;
        }
    }
 
    result = xmlXPathEvalExpression((xmlChar *) xpath_str, context);
    xmlXPathFreeContext(context);
    if (!result) {
        ast_log(LOG_WARNING, "Error for query: %s\n", xpath_str);
        return NULL;
    }
    if (xmlXPathNodeSetIsEmpty(result->nodesetval)) {
        xmlXPathFreeObject(result);
        ast_debug(5, "No results for query: %s\n", xpath_str);
        return NULL;
    }
    return (struct ast_xml_xpath_results *) result;
}

References ast_debug, ast_log, AST_VECTOR_GET, AST_VECTOR_SIZE, ast_xml_namespace_def::href, LOG_ERROR, LOG_WARNING, NULL, ast_xml_namespace_def::prefix, and result.

ast_xml_read_memory()

struct ast_xml_doc * ast_xml_read_memory	(	char *	buffer,
		size_t	size
	)

Open an XML document that resides in memory.

Parameters

buffer	The address where the document is stored
size	The number of bytes in the document

Return values

NULL

on error.

Returns

The ast_xml_doc reference to the open document.

Definition at line 192 of file xml.c.

{
    xmlDoc *doc;
 
    if (!buffer) {
        return NULL;
    }
 
    if (!(doc = xmlParseMemory(buffer, (int) size))) {
        /* process xinclude elements. */
        if (process_xincludes(doc) < 0) {
            xmlFreeDoc(doc);
            return NULL;
        }
    }
 
    return (struct ast_xml_doc *) doc;
}

References NULL, and process_xincludes().

Referenced by handle_incoming_request().

ast_xml_set_attribute()

int ast_xml_set_attribute	(	struct ast_xml_node *	node,
		const char *	name,
		const char *	value
	)

Set an attribute to a node.

Parameters

node	In which node we want to insert the attribute.
name	The attribute name.
value	The attribute value.

Return values

0	on success.
-1	on error.

Definition at line 284 of file xml.c.

{
    if (!name || !value) {
        return -1;
    }
 
    if (!xmlSetProp((xmlNode *) node, (xmlChar *) name, (xmlChar *) value)) {
        return -1;
    }
 
    return 0;
}

References name, and value.

Referenced by ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), geoloc_civicaddr_list_to_xml(), geoloc_eprofile_to_intermediate(), geoloc_gml_list_to_xml(), xmldoc_update_config_option(), and xmldoc_update_config_type().

ast_xml_set_name()

void ast_xml_set_name	(	struct ast_xml_node *	node,
		const char *	name
	)

Set or reset an element's name.

Parameters

node	Node whose name is to be set.
name	New name.

Definition at line 371 of file xml.c.

{
    if (!node || !name) {
        return;
    }
 
    xmlNodeSetName((xmlNode *) node, (const xmlChar *) name);
}

References name.

ast_xml_set_root()

void ast_xml_set_root	(	struct ast_xml_doc *	doc,
		struct ast_xml_node *	node
	)

Specify the root node of a XML document.

Parameters

doc	XML Document reference
node	A pointer to the node we want to set as root node.

Definition at line 221 of file xml.c.

{
    if (!doc || !node) {
        return;
    }
 
    xmlDocSetRootElement((xmlDoc *) doc, (xmlNode *) node);
}

Referenced by ast_geoloc_eprofile_to_pidf(), ast_geoloc_eprofiles_to_pidf(), and handle_dump_docs().

ast_xml_set_text()

void ast_xml_set_text	(	struct ast_xml_node *	node,
		const char *	content
	)

Set an element content string.

Parameters

node	Node from where to set the content string.
content	The text to insert in the node.

Definition at line 362 of file xml.c.

{
    if (!node || !content) {
        return;
    }
 
    xmlNodeSetContent((xmlNode *) node, (const xmlChar *) content);
}

Referenced by geoloc_civicaddr_list_to_xml(), geoloc_eprofile_to_intermediate(), geoloc_gml_list_to_xml(), and xmldoc_update_config_type().

ast_xml_xpath_get_first_result()

struct ast_xml_node * ast_xml_xpath_get_first_result

(

struct ast_xml_xpath_results *

results

)

Return the first result node of an XPath query.

Parameters

results

The XPath results object to get the first result from

Returns

The first result in the XPath object on success

Return values

NULL

on error

Since

12

Definition at line 415 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlXPathObjectPtr) results)->nodesetval->nodeTab[0];
}

Referenced by load_modules(), xmldoc_update_config_option(), and xmldoc_update_config_type().

ast_xml_xpath_get_result()

struct ast_xml_node * ast_xml_xpath_get_result	(	struct ast_xml_xpath_results *	results,
		int	n
	)

Return a specific result node of an XPath query.

Parameters

results	The XPath results object to get the result from
n	The index of the result to get

Returns

The nth result in the XPath object on success

Return values

NULL

on error

Definition at line 420 of file xml.c.

{
    return (struct ast_xml_node *) ((xmlXPathObjectPtr) results)->nodesetval->nodeTab[i];
}

ast_xml_xpath_num_results()

int ast_xml_xpath_num_results

(

struct ast_xml_xpath_results *

results

)

Return the number of results from an XPath query.

Parameters

results

The XPath results object to count

Returns

The number of results in the XPath object

Since

12

Definition at line 433 of file xml.c.

{
    if (!results) {
        return 0;
    }
    return ((xmlXPathObjectPtr) results)->nodesetval->nodeNr;
}

ast_xml_xpath_results_free()

void ast_xml_xpath_results_free

(

struct ast_xml_xpath_results *

results

)

Free the XPath results.

Parameters

results

The XPath results object to dispose of

Since

12

Definition at line 425 of file xml.c.

{
    if (!results) {
        return;
    }
    xmlXPathFreeObject((xmlXPathObjectPtr) results);
}

Referenced by load_modules(), xmldoc_update_config_option(), and xmldoc_update_config_type().

process_xincludes()

static int process_xincludes ( xmlDoc *  doc )

static

Definition at line 83 of file xml.c.

{
    int res;
 
    do {
        res = xmlXIncludeProcess(doc);
    } while (res > 0);
 
    return res;
}

Referenced by ast_xml_open(), and ast_xml_read_memory().