dbghelp: Properly fail on PDB files generated by MSVC compiler version 14.31.
[wine.git] / libs / xml2 / xinclude.c
blob2a0614d737af3f94f7d50aaf90c8716b29b5e501
1 /*
2 * xinclude.c : Code to implement XInclude processing
4 * World Wide Web Consortium W3C Last Call Working Draft 10 November 2003
5 * http://www.w3.org/TR/2003/WD-xinclude-20031110
7 * See Copyright for the status of this software.
9 * daniel@veillard.com
12 #define IN_LIBXML
13 #include "libxml.h"
15 #include <string.h>
16 #include <libxml/xmlmemory.h>
17 #include <libxml/tree.h>
18 #include <libxml/parser.h>
19 #include <libxml/uri.h>
20 #include <libxml/xpath.h>
21 #include <libxml/xpointer.h>
22 #include <libxml/parserInternals.h>
23 #include <libxml/xmlerror.h>
24 #include <libxml/encoding.h>
25 #include <libxml/globals.h>
27 #ifdef LIBXML_XINCLUDE_ENABLED
28 #include <libxml/xinclude.h>
30 #include "buf.h"
32 #define XINCLUDE_MAX_DEPTH 40
34 /* #define DEBUG_XINCLUDE */
35 #ifdef DEBUG_XINCLUDE
36 #ifdef LIBXML_DEBUG_ENABLED
37 #include <libxml/debugXML.h>
38 #endif
39 #endif
41 /************************************************************************
42 * *
43 * XInclude context handling *
44 * *
45 ************************************************************************/
48 * An XInclude context
50 typedef xmlChar *xmlURL;
52 typedef struct _xmlXIncludeRef xmlXIncludeRef;
53 typedef xmlXIncludeRef *xmlXIncludeRefPtr;
54 struct _xmlXIncludeRef {
55 xmlChar *URI; /* the fully resolved resource URL */
56 xmlChar *fragment; /* the fragment in the URI */
57 xmlDocPtr doc; /* the parsed document */
58 xmlNodePtr ref; /* the node making the reference in the source */
59 xmlNodePtr inc; /* the included copy */
60 int xml; /* xml or txt */
61 int count; /* how many refs use that specific doc */
62 int fallback; /* fallback was loaded */
63 int emptyFb; /* flag to show fallback empty */
66 struct _xmlXIncludeCtxt {
67 xmlDocPtr doc; /* the source document */
68 int incBase; /* the first include for this document */
69 int incNr; /* number of includes */
70 int incMax; /* size of includes tab */
71 xmlXIncludeRefPtr *incTab; /* array of included references */
73 int txtNr; /* number of unparsed documents */
74 int txtMax; /* size of unparsed documents tab */
75 xmlChar * *txtTab; /* array of unparsed text strings */
76 xmlURL *txturlTab; /* array of unparsed text URLs */
78 xmlChar * url; /* the current URL processed */
79 int urlNr; /* number of URLs stacked */
80 int urlMax; /* size of URL stack */
81 xmlChar * *urlTab; /* URL stack */
83 int nbErrors; /* the number of errors detected */
84 int legacy; /* using XINCLUDE_OLD_NS */
85 int parseFlags; /* the flags used for parsing XML documents */
86 xmlChar * base; /* the current xml:base */
88 void *_private; /* application data */
90 unsigned long incTotal; /* total number of processed inclusions */
93 static int
94 xmlXIncludeDoProcess(xmlXIncludeCtxtPtr ctxt, xmlDocPtr doc, xmlNodePtr tree,
95 int skipRoot);
98 /************************************************************************
99 * *
100 * XInclude error handler *
102 ************************************************************************/
105 * xmlXIncludeErrMemory:
106 * @extra: extra information
108 * Handle an out of memory condition
110 static void
111 xmlXIncludeErrMemory(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node,
112 const char *extra)
114 if (ctxt != NULL)
115 ctxt->nbErrors++;
116 __xmlRaiseError(NULL, NULL, NULL, ctxt, node, XML_FROM_XINCLUDE,
117 XML_ERR_NO_MEMORY, XML_ERR_ERROR, NULL, 0,
118 extra, NULL, NULL, 0, 0,
119 "Memory allocation failed : %s\n", extra);
123 * xmlXIncludeErr:
124 * @ctxt: the XInclude context
125 * @node: the context node
126 * @msg: the error message
127 * @extra: extra information
129 * Handle an XInclude error
131 static void LIBXML_ATTR_FORMAT(4,0)
132 xmlXIncludeErr(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node, int error,
133 const char *msg, const xmlChar *extra)
135 if (ctxt != NULL)
136 ctxt->nbErrors++;
137 __xmlRaiseError(NULL, NULL, NULL, ctxt, node, XML_FROM_XINCLUDE,
138 error, XML_ERR_ERROR, NULL, 0,
139 (const char *) extra, NULL, NULL, 0, 0,
140 msg, (const char *) extra);
143 #if 0
145 * xmlXIncludeWarn:
146 * @ctxt: the XInclude context
147 * @node: the context node
148 * @msg: the error message
149 * @extra: extra information
151 * Emit an XInclude warning.
153 static void LIBXML_ATTR_FORMAT(4,0)
154 xmlXIncludeWarn(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node, int error,
155 const char *msg, const xmlChar *extra)
157 __xmlRaiseError(NULL, NULL, NULL, ctxt, node, XML_FROM_XINCLUDE,
158 error, XML_ERR_WARNING, NULL, 0,
159 (const char *) extra, NULL, NULL, 0, 0,
160 msg, (const char *) extra);
162 #endif
165 * xmlXIncludeGetProp:
166 * @ctxt: the XInclude context
167 * @cur: the node
168 * @name: the attribute name
170 * Get an XInclude attribute
172 * Returns the value (to be freed) or NULL if not found
174 static xmlChar *
175 xmlXIncludeGetProp(xmlXIncludeCtxtPtr ctxt, xmlNodePtr cur,
176 const xmlChar *name) {
177 xmlChar *ret;
179 ret = xmlGetNsProp(cur, XINCLUDE_NS, name);
180 if (ret != NULL)
181 return(ret);
182 if (ctxt->legacy != 0) {
183 ret = xmlGetNsProp(cur, XINCLUDE_OLD_NS, name);
184 if (ret != NULL)
185 return(ret);
187 ret = xmlGetProp(cur, name);
188 return(ret);
191 * xmlXIncludeFreeRef:
192 * @ref: the XInclude reference
194 * Free an XInclude reference
196 static void
197 xmlXIncludeFreeRef(xmlXIncludeRefPtr ref) {
198 if (ref == NULL)
199 return;
200 #ifdef DEBUG_XINCLUDE
201 xmlGenericError(xmlGenericErrorContext, "Freeing ref\n");
202 #endif
203 if (ref->doc != NULL) {
204 #ifdef DEBUG_XINCLUDE
205 xmlGenericError(xmlGenericErrorContext, "Freeing doc %s\n", ref->URI);
206 #endif
207 xmlFreeDoc(ref->doc);
209 if (ref->URI != NULL)
210 xmlFree(ref->URI);
211 if (ref->fragment != NULL)
212 xmlFree(ref->fragment);
213 xmlFree(ref);
217 * xmlXIncludeNewRef:
218 * @ctxt: the XInclude context
219 * @URI: the resource URI
221 * Creates a new reference within an XInclude context
223 * Returns the new set
225 static xmlXIncludeRefPtr
226 xmlXIncludeNewRef(xmlXIncludeCtxtPtr ctxt, const xmlChar *URI,
227 xmlNodePtr ref) {
228 xmlXIncludeRefPtr ret;
230 #ifdef DEBUG_XINCLUDE
231 xmlGenericError(xmlGenericErrorContext, "New ref %s\n", URI);
232 #endif
233 ret = (xmlXIncludeRefPtr) xmlMalloc(sizeof(xmlXIncludeRef));
234 if (ret == NULL) {
235 xmlXIncludeErrMemory(ctxt, ref, "growing XInclude context");
236 return(NULL);
238 memset(ret, 0, sizeof(xmlXIncludeRef));
239 if (URI == NULL)
240 ret->URI = NULL;
241 else
242 ret->URI = xmlStrdup(URI);
243 ret->fragment = NULL;
244 ret->ref = ref;
245 ret->doc = NULL;
246 ret->count = 0;
247 ret->xml = 0;
248 ret->inc = NULL;
249 if (ctxt->incMax == 0) {
250 ctxt->incMax = 4;
251 ctxt->incTab = (xmlXIncludeRefPtr *) xmlMalloc(ctxt->incMax *
252 sizeof(ctxt->incTab[0]));
253 if (ctxt->incTab == NULL) {
254 xmlXIncludeErrMemory(ctxt, ref, "growing XInclude context");
255 xmlXIncludeFreeRef(ret);
256 return(NULL);
259 if (ctxt->incNr >= ctxt->incMax) {
260 ctxt->incMax *= 2;
261 ctxt->incTab = (xmlXIncludeRefPtr *) xmlRealloc(ctxt->incTab,
262 ctxt->incMax * sizeof(ctxt->incTab[0]));
263 if (ctxt->incTab == NULL) {
264 xmlXIncludeErrMemory(ctxt, ref, "growing XInclude context");
265 xmlXIncludeFreeRef(ret);
266 return(NULL);
269 ctxt->incTab[ctxt->incNr++] = ret;
270 return(ret);
274 * xmlXIncludeNewContext:
275 * @doc: an XML Document
277 * Creates a new XInclude context
279 * Returns the new set
281 xmlXIncludeCtxtPtr
282 xmlXIncludeNewContext(xmlDocPtr doc) {
283 xmlXIncludeCtxtPtr ret;
285 #ifdef DEBUG_XINCLUDE
286 xmlGenericError(xmlGenericErrorContext, "New context\n");
287 #endif
288 if (doc == NULL)
289 return(NULL);
290 ret = (xmlXIncludeCtxtPtr) xmlMalloc(sizeof(xmlXIncludeCtxt));
291 if (ret == NULL) {
292 xmlXIncludeErrMemory(NULL, (xmlNodePtr) doc,
293 "creating XInclude context");
294 return(NULL);
296 memset(ret, 0, sizeof(xmlXIncludeCtxt));
297 ret->doc = doc;
298 ret->incNr = 0;
299 ret->incBase = 0;
300 ret->incMax = 0;
301 ret->incTab = NULL;
302 ret->nbErrors = 0;
303 return(ret);
307 * xmlXIncludeURLPush:
308 * @ctxt: the parser context
309 * @value: the url
311 * Pushes a new url on top of the url stack
313 * Returns -1 in case of error, the index in the stack otherwise
315 static int
316 xmlXIncludeURLPush(xmlXIncludeCtxtPtr ctxt,
317 const xmlChar *value)
319 if (ctxt->urlNr > XINCLUDE_MAX_DEPTH) {
320 xmlXIncludeErr(ctxt, NULL, XML_XINCLUDE_RECURSION,
321 "detected a recursion in %s\n", value);
322 return(-1);
324 if (ctxt->urlTab == NULL) {
325 ctxt->urlMax = 4;
326 ctxt->urlNr = 0;
327 ctxt->urlTab = (xmlChar * *) xmlMalloc(
328 ctxt->urlMax * sizeof(ctxt->urlTab[0]));
329 if (ctxt->urlTab == NULL) {
330 xmlXIncludeErrMemory(ctxt, NULL, "adding URL");
331 return (-1);
334 if (ctxt->urlNr >= ctxt->urlMax) {
335 ctxt->urlMax *= 2;
336 ctxt->urlTab =
337 (xmlChar * *) xmlRealloc(ctxt->urlTab,
338 ctxt->urlMax *
339 sizeof(ctxt->urlTab[0]));
340 if (ctxt->urlTab == NULL) {
341 xmlXIncludeErrMemory(ctxt, NULL, "adding URL");
342 return (-1);
345 ctxt->url = ctxt->urlTab[ctxt->urlNr] = xmlStrdup(value);
346 return (ctxt->urlNr++);
350 * xmlXIncludeURLPop:
351 * @ctxt: the parser context
353 * Pops the top URL from the URL stack
355 static void
356 xmlXIncludeURLPop(xmlXIncludeCtxtPtr ctxt)
358 xmlChar * ret;
360 if (ctxt->urlNr <= 0)
361 return;
362 ctxt->urlNr--;
363 if (ctxt->urlNr > 0)
364 ctxt->url = ctxt->urlTab[ctxt->urlNr - 1];
365 else
366 ctxt->url = NULL;
367 ret = ctxt->urlTab[ctxt->urlNr];
368 ctxt->urlTab[ctxt->urlNr] = NULL;
369 if (ret != NULL)
370 xmlFree(ret);
374 * xmlXIncludeFreeContext:
375 * @ctxt: the XInclude context
377 * Free an XInclude context
379 void
380 xmlXIncludeFreeContext(xmlXIncludeCtxtPtr ctxt) {
381 int i;
383 #ifdef DEBUG_XINCLUDE
384 xmlGenericError(xmlGenericErrorContext, "Freeing context\n");
385 #endif
386 if (ctxt == NULL)
387 return;
388 while (ctxt->urlNr > 0)
389 xmlXIncludeURLPop(ctxt);
390 if (ctxt->urlTab != NULL)
391 xmlFree(ctxt->urlTab);
392 for (i = 0;i < ctxt->incNr;i++) {
393 if (ctxt->incTab[i] != NULL)
394 xmlXIncludeFreeRef(ctxt->incTab[i]);
396 if (ctxt->incTab != NULL)
397 xmlFree(ctxt->incTab);
398 if (ctxt->txtTab != NULL) {
399 for (i = 0;i < ctxt->txtNr;i++) {
400 if (ctxt->txtTab[i] != NULL)
401 xmlFree(ctxt->txtTab[i]);
403 xmlFree(ctxt->txtTab);
405 if (ctxt->txturlTab != NULL) {
406 for (i = 0;i < ctxt->txtNr;i++) {
407 if (ctxt->txturlTab[i] != NULL)
408 xmlFree(ctxt->txturlTab[i]);
410 xmlFree(ctxt->txturlTab);
412 if (ctxt->base != NULL) {
413 xmlFree(ctxt->base);
415 xmlFree(ctxt);
419 * xmlXIncludeParseFile:
420 * @ctxt: the XInclude context
421 * @URL: the URL or file path
423 * parse a document for XInclude
425 static xmlDocPtr
426 xmlXIncludeParseFile(xmlXIncludeCtxtPtr ctxt, const char *URL) {
427 xmlDocPtr ret;
428 xmlParserCtxtPtr pctxt;
429 xmlParserInputPtr inputStream;
431 xmlInitParser();
433 pctxt = xmlNewParserCtxt();
434 if (pctxt == NULL) {
435 xmlXIncludeErrMemory(ctxt, NULL, "cannot allocate parser context");
436 return(NULL);
440 * pass in the application data to the parser context.
442 pctxt->_private = ctxt->_private;
445 * try to ensure that new documents included are actually
446 * built with the same dictionary as the including document.
448 if ((ctxt->doc != NULL) && (ctxt->doc->dict != NULL)) {
449 if (pctxt->dict != NULL)
450 xmlDictFree(pctxt->dict);
451 pctxt->dict = ctxt->doc->dict;
452 xmlDictReference(pctxt->dict);
455 xmlCtxtUseOptions(pctxt, ctxt->parseFlags | XML_PARSE_DTDLOAD);
457 /* Don't read from stdin. */
458 if ((URL != NULL) && (strcmp(URL, "-") == 0))
459 URL = "./-";
461 inputStream = xmlLoadExternalEntity(URL, NULL, pctxt);
462 if (inputStream == NULL) {
463 xmlFreeParserCtxt(pctxt);
464 return(NULL);
467 inputPush(pctxt, inputStream);
469 if (pctxt->directory == NULL)
470 pctxt->directory = xmlParserGetDirectory(URL);
472 pctxt->loadsubset |= XML_DETECT_IDS;
474 xmlParseDocument(pctxt);
476 if (pctxt->wellFormed) {
477 ret = pctxt->myDoc;
479 else {
480 ret = NULL;
481 if (pctxt->myDoc != NULL)
482 xmlFreeDoc(pctxt->myDoc);
483 pctxt->myDoc = NULL;
485 xmlFreeParserCtxt(pctxt);
487 return(ret);
491 * xmlXIncludeAddNode:
492 * @ctxt: the XInclude context
493 * @cur: the new node
495 * Add a new node to process to an XInclude context
497 static int
498 xmlXIncludeAddNode(xmlXIncludeCtxtPtr ctxt, xmlNodePtr cur) {
499 xmlXIncludeRefPtr ref;
500 xmlURIPtr uri;
501 xmlChar *URL;
502 xmlChar *fragment = NULL;
503 xmlChar *href;
504 xmlChar *parse;
505 xmlChar *base;
506 xmlChar *URI;
507 int xml = 1, i; /* default Issue 64 */
508 int local = 0;
511 if (ctxt == NULL)
512 return(-1);
513 if (cur == NULL)
514 return(-1);
516 #ifdef DEBUG_XINCLUDE
517 xmlGenericError(xmlGenericErrorContext, "Add node\n");
518 #endif
520 * read the attributes
522 href = xmlXIncludeGetProp(ctxt, cur, XINCLUDE_HREF);
523 if (href == NULL) {
524 href = xmlStrdup(BAD_CAST ""); /* @@@@ href is now optional */
525 if (href == NULL)
526 return(-1);
528 if ((href[0] == '#') || (href[0] == 0))
529 local = 1;
530 parse = xmlXIncludeGetProp(ctxt, cur, XINCLUDE_PARSE);
531 if (parse != NULL) {
532 if (xmlStrEqual(parse, XINCLUDE_PARSE_XML))
533 xml = 1;
534 else if (xmlStrEqual(parse, XINCLUDE_PARSE_TEXT))
535 xml = 0;
536 else {
537 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_PARSE_VALUE,
538 "invalid value %s for 'parse'\n", parse);
539 if (href != NULL)
540 xmlFree(href);
541 if (parse != NULL)
542 xmlFree(parse);
543 return(-1);
548 * compute the URI
550 base = xmlNodeGetBase(ctxt->doc, cur);
551 if (base == NULL) {
552 URI = xmlBuildURI(href, ctxt->doc->URL);
553 } else {
554 URI = xmlBuildURI(href, base);
556 if (URI == NULL) {
557 xmlChar *escbase;
558 xmlChar *eschref;
560 * Some escaping may be needed
562 escbase = xmlURIEscape(base);
563 eschref = xmlURIEscape(href);
564 URI = xmlBuildURI(eschref, escbase);
565 if (escbase != NULL)
566 xmlFree(escbase);
567 if (eschref != NULL)
568 xmlFree(eschref);
570 if (parse != NULL)
571 xmlFree(parse);
572 if (href != NULL)
573 xmlFree(href);
574 if (base != NULL)
575 xmlFree(base);
576 if (URI == NULL) {
577 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_HREF_URI,
578 "failed build URL\n", NULL);
579 return(-1);
581 fragment = xmlXIncludeGetProp(ctxt, cur, XINCLUDE_PARSE_XPOINTER);
584 * Check the URL and remove any fragment identifier
586 uri = xmlParseURI((const char *)URI);
587 if (uri == NULL) {
588 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_HREF_URI,
589 "invalid value URI %s\n", URI);
590 if (fragment != NULL)
591 xmlFree(fragment);
592 xmlFree(URI);
593 return(-1);
596 if (uri->fragment != NULL) {
597 if (ctxt->legacy != 0) {
598 if (fragment == NULL) {
599 fragment = (xmlChar *) uri->fragment;
600 } else {
601 xmlFree(uri->fragment);
603 } else {
604 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_FRAGMENT_ID,
605 "Invalid fragment identifier in URI %s use the xpointer attribute\n",
606 URI);
607 if (fragment != NULL)
608 xmlFree(fragment);
609 xmlFreeURI(uri);
610 xmlFree(URI);
611 return(-1);
613 uri->fragment = NULL;
615 URL = xmlSaveUri(uri);
616 xmlFreeURI(uri);
617 xmlFree(URI);
618 if (URL == NULL) {
619 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_HREF_URI,
620 "invalid value URI %s\n", URI);
621 if (fragment != NULL)
622 xmlFree(fragment);
623 return(-1);
627 * If local and xml then we need a fragment
629 if ((local == 1) && (xml == 1) &&
630 ((fragment == NULL) || (fragment[0] == 0))) {
631 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_RECURSION,
632 "detected a local recursion with no xpointer in %s\n",
633 URL);
634 xmlFree(URL);
635 xmlFree(fragment);
636 return(-1);
640 * Check the URL against the stack for recursions
642 if ((!local) && (xml == 1)) {
643 for (i = 0;i < ctxt->urlNr;i++) {
644 if (xmlStrEqual(URL, ctxt->urlTab[i])) {
645 xmlXIncludeErr(ctxt, cur, XML_XINCLUDE_RECURSION,
646 "detected a recursion in %s\n", URL);
647 xmlFree(URL);
648 xmlFree(fragment);
649 return(-1);
654 ref = xmlXIncludeNewRef(ctxt, URL, cur);
655 xmlFree(URL);
656 if (ref == NULL) {
657 return(-1);
659 ref->fragment = fragment;
660 ref->doc = NULL;
661 ref->xml = xml;
662 ref->count = 1;
663 return(0);
667 * xmlXIncludeRecurseDoc:
668 * @ctxt: the XInclude context
669 * @doc: the new document
670 * @url: the associated URL
672 * The XInclude recursive nature is handled at this point.
674 static void
675 xmlXIncludeRecurseDoc(xmlXIncludeCtxtPtr ctxt, xmlDocPtr doc,
676 const xmlURL url ATTRIBUTE_UNUSED) {
677 xmlXIncludeCtxtPtr newctxt;
678 int i;
681 * Avoid recursion in already substituted resources
682 for (i = 0;i < ctxt->urlNr;i++) {
683 if (xmlStrEqual(doc->URL, ctxt->urlTab[i]))
684 return;
688 #ifdef DEBUG_XINCLUDE
689 xmlGenericError(xmlGenericErrorContext, "Recursing in doc %s\n", doc->URL);
690 #endif
692 * Handle recursion here.
695 newctxt = xmlXIncludeNewContext(doc);
696 if (newctxt != NULL) {
698 * Copy the private user data
700 newctxt->_private = ctxt->_private;
702 * Copy the existing document set
704 newctxt->incMax = ctxt->incMax;
705 newctxt->incNr = ctxt->incNr;
706 newctxt->incTab = (xmlXIncludeRefPtr *) xmlMalloc(newctxt->incMax *
707 sizeof(newctxt->incTab[0]));
708 if (newctxt->incTab == NULL) {
709 xmlXIncludeErrMemory(ctxt, (xmlNodePtr) doc, "processing doc");
710 xmlFree(newctxt);
711 return;
714 * copy the urlTab
716 newctxt->urlMax = ctxt->urlMax;
717 newctxt->urlNr = ctxt->urlNr;
718 newctxt->urlTab = ctxt->urlTab;
721 * Inherit the existing base
723 newctxt->base = xmlStrdup(ctxt->base);
726 * Inherit the documents already in use by other includes
728 newctxt->incBase = ctxt->incNr;
729 for (i = 0;i < ctxt->incNr;i++) {
730 newctxt->incTab[i] = ctxt->incTab[i];
731 newctxt->incTab[i]->count++; /* prevent the recursion from
732 freeing it */
735 * The new context should also inherit the Parse Flags
736 * (bug 132597)
738 newctxt->parseFlags = ctxt->parseFlags;
739 newctxt->incTotal = ctxt->incTotal;
740 xmlXIncludeDoProcess(newctxt, doc, xmlDocGetRootElement(doc), 0);
741 ctxt->incTotal = newctxt->incTotal;
742 for (i = 0;i < ctxt->incNr;i++) {
743 newctxt->incTab[i]->count--;
744 newctxt->incTab[i] = NULL;
747 /* urlTab may have been reallocated */
748 ctxt->urlTab = newctxt->urlTab;
749 ctxt->urlMax = newctxt->urlMax;
751 newctxt->urlMax = 0;
752 newctxt->urlNr = 0;
753 newctxt->urlTab = NULL;
755 xmlXIncludeFreeContext(newctxt);
757 #ifdef DEBUG_XINCLUDE
758 xmlGenericError(xmlGenericErrorContext, "Done recursing in doc %s\n", url);
759 #endif
763 * xmlXIncludeAddTxt:
764 * @ctxt: the XInclude context
765 * @txt: the new text node
766 * @url: the associated URL
768 * Add a new text node to the list
770 static void
771 xmlXIncludeAddTxt(xmlXIncludeCtxtPtr ctxt, const xmlChar *txt,
772 const xmlURL url) {
773 #ifdef DEBUG_XINCLUDE
774 xmlGenericError(xmlGenericErrorContext, "Adding text %s\n", url);
775 #endif
776 if (ctxt->txtMax == 0) {
777 ctxt->txtMax = 4;
778 ctxt->txtTab = (xmlChar **) xmlMalloc(ctxt->txtMax *
779 sizeof(ctxt->txtTab[0]));
780 if (ctxt->txtTab == NULL) {
781 xmlXIncludeErrMemory(ctxt, NULL, "processing text");
782 return;
784 ctxt->txturlTab = (xmlURL *) xmlMalloc(ctxt->txtMax *
785 sizeof(ctxt->txturlTab[0]));
786 if (ctxt->txturlTab == NULL) {
787 xmlXIncludeErrMemory(ctxt, NULL, "processing text");
788 return;
791 if (ctxt->txtNr >= ctxt->txtMax) {
792 ctxt->txtMax *= 2;
793 ctxt->txtTab = (xmlChar **) xmlRealloc(ctxt->txtTab,
794 ctxt->txtMax * sizeof(ctxt->txtTab[0]));
795 if (ctxt->txtTab == NULL) {
796 xmlXIncludeErrMemory(ctxt, NULL, "processing text");
797 return;
799 ctxt->txturlTab = (xmlURL *) xmlRealloc(ctxt->txturlTab,
800 ctxt->txtMax * sizeof(ctxt->txturlTab[0]));
801 if (ctxt->txturlTab == NULL) {
802 xmlXIncludeErrMemory(ctxt, NULL, "processing text");
803 return;
806 ctxt->txtTab[ctxt->txtNr] = xmlStrdup(txt);
807 ctxt->txturlTab[ctxt->txtNr] = xmlStrdup(url);
808 ctxt->txtNr++;
811 /************************************************************************
813 * Node copy with specific semantic *
815 ************************************************************************/
817 static xmlNodePtr
818 xmlXIncludeCopyNodeList(xmlXIncludeCtxtPtr ctxt, xmlDocPtr target,
819 xmlDocPtr source, xmlNodePtr elem);
822 * xmlXIncludeCopyNode:
823 * @ctxt: the XInclude context
824 * @target: the document target
825 * @source: the document source
826 * @elem: the element
828 * Make a copy of the node while preserving the XInclude semantic
829 * of the Infoset copy
831 static xmlNodePtr
832 xmlXIncludeCopyNode(xmlXIncludeCtxtPtr ctxt, xmlDocPtr target,
833 xmlDocPtr source, xmlNodePtr elem) {
834 xmlNodePtr result = NULL;
836 if ((ctxt == NULL) || (target == NULL) || (source == NULL) ||
837 (elem == NULL))
838 return(NULL);
839 if (elem->type == XML_DTD_NODE)
840 return(NULL);
841 if (elem->type == XML_DOCUMENT_NODE)
842 result = xmlXIncludeCopyNodeList(ctxt, target, source, elem->children);
843 else
844 result = xmlDocCopyNode(elem, target, 1);
845 return(result);
849 * xmlXIncludeCopyNodeList:
850 * @ctxt: the XInclude context
851 * @target: the document target
852 * @source: the document source
853 * @elem: the element list
855 * Make a copy of the node list while preserving the XInclude semantic
856 * of the Infoset copy
858 static xmlNodePtr
859 xmlXIncludeCopyNodeList(xmlXIncludeCtxtPtr ctxt, xmlDocPtr target,
860 xmlDocPtr source, xmlNodePtr elem) {
861 xmlNodePtr cur, res, result = NULL, last = NULL;
863 if ((ctxt == NULL) || (target == NULL) || (source == NULL) ||
864 (elem == NULL))
865 return(NULL);
866 cur = elem;
867 while (cur != NULL) {
868 res = xmlXIncludeCopyNode(ctxt, target, source, cur);
869 if (res != NULL) {
870 if (result == NULL) {
871 result = last = res;
872 } else {
873 last->next = res;
874 res->prev = last;
875 last = res;
878 cur = cur->next;
880 return(result);
884 * xmlXIncludeGetNthChild:
885 * @cur: the node
886 * @no: the child number
888 * Returns the @n'th element child of @cur or NULL
890 static xmlNodePtr
891 xmlXIncludeGetNthChild(xmlNodePtr cur, int no) {
892 int i;
893 if ((cur == NULL) || (cur->type == XML_NAMESPACE_DECL))
894 return(NULL);
895 cur = cur->children;
896 for (i = 0;i <= no;cur = cur->next) {
897 if (cur == NULL)
898 return(cur);
899 if ((cur->type == XML_ELEMENT_NODE) ||
900 (cur->type == XML_DOCUMENT_NODE) ||
901 (cur->type == XML_HTML_DOCUMENT_NODE)) {
902 i++;
903 if (i == no)
904 break;
907 return(cur);
910 xmlNodePtr xmlXPtrAdvanceNode(xmlNodePtr cur, int *level); /* in xpointer.c */
912 * xmlXIncludeCopyRange:
913 * @ctxt: the XInclude context
914 * @target: the document target
915 * @source: the document source
916 * @obj: the XPointer result from the evaluation.
918 * Build a node list tree copy of the XPointer result.
920 * Returns an xmlNodePtr list or NULL.
921 * The caller has to free the node tree.
923 static xmlNodePtr
924 xmlXIncludeCopyRange(xmlXIncludeCtxtPtr ctxt, xmlDocPtr target,
925 xmlDocPtr source, xmlXPathObjectPtr range) {
926 /* pointers to generated nodes */
927 xmlNodePtr list = NULL, last = NULL, listParent = NULL;
928 xmlNodePtr tmp, tmp2;
929 /* pointers to traversal nodes */
930 xmlNodePtr start, cur, end;
931 int index1, index2;
932 int level = 0, lastLevel = 0, endLevel = 0, endFlag = 0;
934 if ((ctxt == NULL) || (target == NULL) || (source == NULL) ||
935 (range == NULL))
936 return(NULL);
937 if (range->type != XPATH_RANGE)
938 return(NULL);
939 start = (xmlNodePtr) range->user;
941 if ((start == NULL) || (start->type == XML_NAMESPACE_DECL))
942 return(NULL);
943 end = range->user2;
944 if (end == NULL)
945 return(xmlDocCopyNode(start, target, 1));
946 if (end->type == XML_NAMESPACE_DECL)
947 return(NULL);
949 cur = start;
950 index1 = range->index;
951 index2 = range->index2;
953 * level is depth of the current node under consideration
954 * list is the pointer to the root of the output tree
955 * listParent is a pointer to the parent of output tree (within
956 the included file) in case we need to add another level
957 * last is a pointer to the last node added to the output tree
958 * lastLevel is the depth of last (relative to the root)
960 while (cur != NULL) {
962 * Check if our output tree needs a parent
964 if (level < 0) {
965 while (level < 0) {
966 /* copy must include namespaces and properties */
967 tmp2 = xmlDocCopyNode(listParent, target, 2);
968 xmlAddChild(tmp2, list);
969 list = tmp2;
970 listParent = listParent->parent;
971 level++;
973 last = list;
974 lastLevel = 0;
977 * Check whether we need to change our insertion point
979 while (level < lastLevel) {
980 last = last->parent;
981 lastLevel --;
983 if (cur == end) { /* Are we at the end of the range? */
984 if (cur->type == XML_TEXT_NODE) {
985 const xmlChar *content = cur->content;
986 int len;
988 if (content == NULL) {
989 tmp = xmlNewTextLen(NULL, 0);
990 } else {
991 len = index2;
992 if ((cur == start) && (index1 > 1)) {
993 content += (index1 - 1);
994 len -= (index1 - 1);
995 } else {
996 len = index2;
998 tmp = xmlNewTextLen(content, len);
1000 /* single sub text node selection */
1001 if (list == NULL)
1002 return(tmp);
1003 /* prune and return full set */
1004 if (level == lastLevel)
1005 xmlAddNextSibling(last, tmp);
1006 else
1007 xmlAddChild(last, tmp);
1008 return(list);
1009 } else { /* ending node not a text node */
1010 endLevel = level; /* remember the level of the end node */
1011 endFlag = 1;
1012 /* last node - need to take care of properties + namespaces */
1013 tmp = xmlDocCopyNode(cur, target, 2);
1014 if (list == NULL) {
1015 list = tmp;
1016 listParent = cur->parent;
1017 last = tmp;
1018 } else {
1019 if (level == lastLevel)
1020 last = xmlAddNextSibling(last, tmp);
1021 else {
1022 last = xmlAddChild(last, tmp);
1023 lastLevel = level;
1027 if (index2 > 1) {
1028 end = xmlXIncludeGetNthChild(cur, index2 - 1);
1029 index2 = 0;
1031 if ((cur == start) && (index1 > 1)) {
1032 cur = xmlXIncludeGetNthChild(cur, index1 - 1);
1033 index1 = 0;
1034 } else {
1035 cur = cur->children;
1037 level++; /* increment level to show change */
1039 * Now gather the remaining nodes from cur to end
1041 continue; /* while */
1043 } else if (cur == start) { /* Not at the end, are we at start? */
1044 if ((cur->type == XML_TEXT_NODE) ||
1045 (cur->type == XML_CDATA_SECTION_NODE)) {
1046 const xmlChar *content = cur->content;
1048 if (content == NULL) {
1049 tmp = xmlNewTextLen(NULL, 0);
1050 } else {
1051 if (index1 > 1) {
1052 content += (index1 - 1);
1053 index1 = 0;
1055 tmp = xmlNewText(content);
1057 last = list = tmp;
1058 listParent = cur->parent;
1059 } else { /* Not text node */
1061 * start of the range - need to take care of
1062 * properties and namespaces
1064 tmp = xmlDocCopyNode(cur, target, 2);
1065 list = last = tmp;
1066 listParent = cur->parent;
1067 if (index1 > 1) { /* Do we need to position? */
1068 cur = xmlXIncludeGetNthChild(cur, index1 - 1);
1069 level = lastLevel = 1;
1070 index1 = 0;
1072 * Now gather the remaining nodes from cur to end
1074 continue; /* while */
1077 } else {
1078 tmp = NULL;
1079 switch (cur->type) {
1080 case XML_DTD_NODE:
1081 case XML_ELEMENT_DECL:
1082 case XML_ATTRIBUTE_DECL:
1083 case XML_ENTITY_NODE:
1084 /* Do not copy DTD information */
1085 break;
1086 case XML_ENTITY_DECL:
1087 /* handle crossing entities -> stack needed */
1088 break;
1089 case XML_XINCLUDE_START:
1090 case XML_XINCLUDE_END:
1091 /* don't consider it part of the tree content */
1092 break;
1093 case XML_ATTRIBUTE_NODE:
1094 /* Humm, should not happen ! */
1095 break;
1096 default:
1098 * Middle of the range - need to take care of
1099 * properties and namespaces
1101 tmp = xmlDocCopyNode(cur, target, 2);
1102 break;
1104 if (tmp != NULL) {
1105 if (level == lastLevel)
1106 last = xmlAddNextSibling(last, tmp);
1107 else {
1108 last = xmlAddChild(last, tmp);
1109 lastLevel = level;
1114 * Skip to next node in document order
1116 cur = xmlXPtrAdvanceNode(cur, &level);
1117 if (endFlag && (level >= endLevel))
1118 break;
1120 return(list);
1124 * xmlXIncludeBuildNodeList:
1125 * @ctxt: the XInclude context
1126 * @target: the document target
1127 * @source: the document source
1128 * @obj: the XPointer result from the evaluation.
1130 * Build a node list tree copy of the XPointer result.
1131 * This will drop Attributes and Namespace declarations.
1133 * Returns an xmlNodePtr list or NULL.
1134 * the caller has to free the node tree.
1136 static xmlNodePtr
1137 xmlXIncludeCopyXPointer(xmlXIncludeCtxtPtr ctxt, xmlDocPtr target,
1138 xmlDocPtr source, xmlXPathObjectPtr obj) {
1139 xmlNodePtr list = NULL, last = NULL;
1140 int i;
1142 if (source == NULL)
1143 source = ctxt->doc;
1144 if ((ctxt == NULL) || (target == NULL) || (source == NULL) ||
1145 (obj == NULL))
1146 return(NULL);
1147 switch (obj->type) {
1148 case XPATH_NODESET: {
1149 xmlNodeSetPtr set = obj->nodesetval;
1150 if (set == NULL)
1151 return(NULL);
1152 for (i = 0;i < set->nodeNr;i++) {
1153 if (set->nodeTab[i] == NULL)
1154 continue;
1155 switch (set->nodeTab[i]->type) {
1156 case XML_TEXT_NODE:
1157 case XML_CDATA_SECTION_NODE:
1158 case XML_ELEMENT_NODE:
1159 case XML_ENTITY_REF_NODE:
1160 case XML_ENTITY_NODE:
1161 case XML_PI_NODE:
1162 case XML_COMMENT_NODE:
1163 case XML_DOCUMENT_NODE:
1164 case XML_HTML_DOCUMENT_NODE:
1165 #ifdef LIBXML_DOCB_ENABLED
1166 case XML_DOCB_DOCUMENT_NODE:
1167 #endif
1168 case XML_XINCLUDE_END:
1169 break;
1170 case XML_XINCLUDE_START: {
1171 xmlNodePtr tmp, cur = set->nodeTab[i];
1173 cur = cur->next;
1174 while (cur != NULL) {
1175 switch(cur->type) {
1176 case XML_TEXT_NODE:
1177 case XML_CDATA_SECTION_NODE:
1178 case XML_ELEMENT_NODE:
1179 case XML_ENTITY_REF_NODE:
1180 case XML_ENTITY_NODE:
1181 case XML_PI_NODE:
1182 case XML_COMMENT_NODE:
1183 tmp = xmlXIncludeCopyNode(ctxt, target,
1184 source, cur);
1185 if (last == NULL) {
1186 list = last = tmp;
1187 } else {
1188 last = xmlAddNextSibling(last, tmp);
1190 cur = cur->next;
1191 continue;
1192 default:
1193 break;
1195 break;
1197 continue;
1199 case XML_ATTRIBUTE_NODE:
1200 case XML_NAMESPACE_DECL:
1201 case XML_DOCUMENT_TYPE_NODE:
1202 case XML_DOCUMENT_FRAG_NODE:
1203 case XML_NOTATION_NODE:
1204 case XML_DTD_NODE:
1205 case XML_ELEMENT_DECL:
1206 case XML_ATTRIBUTE_DECL:
1207 case XML_ENTITY_DECL:
1208 continue; /* for */
1210 if (last == NULL)
1211 list = last = xmlXIncludeCopyNode(ctxt, target, source,
1212 set->nodeTab[i]);
1213 else {
1214 xmlAddNextSibling(last,
1215 xmlXIncludeCopyNode(ctxt, target, source,
1216 set->nodeTab[i]));
1217 if (last->next != NULL)
1218 last = last->next;
1221 break;
1223 #ifdef LIBXML_XPTR_ENABLED
1224 case XPATH_LOCATIONSET: {
1225 xmlLocationSetPtr set = (xmlLocationSetPtr) obj->user;
1226 if (set == NULL)
1227 return(NULL);
1228 for (i = 0;i < set->locNr;i++) {
1229 if (last == NULL)
1230 list = last = xmlXIncludeCopyXPointer(ctxt, target, source,
1231 set->locTab[i]);
1232 else
1233 xmlAddNextSibling(last,
1234 xmlXIncludeCopyXPointer(ctxt, target, source,
1235 set->locTab[i]));
1236 if (last != NULL) {
1237 while (last->next != NULL)
1238 last = last->next;
1241 break;
1243 case XPATH_RANGE:
1244 return(xmlXIncludeCopyRange(ctxt, target, source, obj));
1245 #endif
1246 case XPATH_POINT:
1247 /* points are ignored in XInclude */
1248 break;
1249 default:
1250 break;
1252 return(list);
1254 /************************************************************************
1256 * XInclude I/O handling *
1258 ************************************************************************/
1260 typedef struct _xmlXIncludeMergeData xmlXIncludeMergeData;
1261 typedef xmlXIncludeMergeData *xmlXIncludeMergeDataPtr;
1262 struct _xmlXIncludeMergeData {
1263 xmlDocPtr doc;
1264 xmlXIncludeCtxtPtr ctxt;
1268 * xmlXIncludeMergeOneEntity:
1269 * @ent: the entity
1270 * @doc: the including doc
1271 * @nr: the entity name
1273 * Implements the merge of one entity
1275 static void
1276 xmlXIncludeMergeEntity(void *payload, void *vdata,
1277 const xmlChar *name ATTRIBUTE_UNUSED) {
1278 xmlEntityPtr ent = (xmlEntityPtr) payload;
1279 xmlXIncludeMergeDataPtr data = (xmlXIncludeMergeDataPtr) vdata;
1280 xmlEntityPtr ret, prev;
1281 xmlDocPtr doc;
1282 xmlXIncludeCtxtPtr ctxt;
1284 if ((ent == NULL) || (data == NULL))
1285 return;
1286 ctxt = data->ctxt;
1287 doc = data->doc;
1288 if ((ctxt == NULL) || (doc == NULL))
1289 return;
1290 switch (ent->etype) {
1291 case XML_INTERNAL_PARAMETER_ENTITY:
1292 case XML_EXTERNAL_PARAMETER_ENTITY:
1293 case XML_INTERNAL_PREDEFINED_ENTITY:
1294 return;
1295 case XML_INTERNAL_GENERAL_ENTITY:
1296 case XML_EXTERNAL_GENERAL_PARSED_ENTITY:
1297 case XML_EXTERNAL_GENERAL_UNPARSED_ENTITY:
1298 break;
1300 ret = xmlAddDocEntity(doc, ent->name, ent->etype, ent->ExternalID,
1301 ent->SystemID, ent->content);
1302 if (ret != NULL) {
1303 if (ent->URI != NULL)
1304 ret->URI = xmlStrdup(ent->URI);
1305 } else {
1306 prev = xmlGetDocEntity(doc, ent->name);
1307 if (prev != NULL) {
1308 if (ent->etype != prev->etype)
1309 goto error;
1311 if ((ent->SystemID != NULL) && (prev->SystemID != NULL)) {
1312 if (!xmlStrEqual(ent->SystemID, prev->SystemID))
1313 goto error;
1314 } else if ((ent->ExternalID != NULL) &&
1315 (prev->ExternalID != NULL)) {
1316 if (!xmlStrEqual(ent->ExternalID, prev->ExternalID))
1317 goto error;
1318 } else if ((ent->content != NULL) && (prev->content != NULL)) {
1319 if (!xmlStrEqual(ent->content, prev->content))
1320 goto error;
1321 } else {
1322 goto error;
1327 return;
1328 error:
1329 switch (ent->etype) {
1330 case XML_INTERNAL_PARAMETER_ENTITY:
1331 case XML_EXTERNAL_PARAMETER_ENTITY:
1332 case XML_INTERNAL_PREDEFINED_ENTITY:
1333 case XML_INTERNAL_GENERAL_ENTITY:
1334 case XML_EXTERNAL_GENERAL_PARSED_ENTITY:
1335 return;
1336 case XML_EXTERNAL_GENERAL_UNPARSED_ENTITY:
1337 break;
1339 xmlXIncludeErr(ctxt, (xmlNodePtr) ent, XML_XINCLUDE_ENTITY_DEF_MISMATCH,
1340 "mismatch in redefinition of entity %s\n",
1341 ent->name);
1345 * xmlXIncludeMergeEntities:
1346 * @ctxt: an XInclude context
1347 * @doc: the including doc
1348 * @from: the included doc
1350 * Implements the entity merge
1352 * Returns 0 if merge succeeded, -1 if some processing failed
1354 static int
1355 xmlXIncludeMergeEntities(xmlXIncludeCtxtPtr ctxt, xmlDocPtr doc,
1356 xmlDocPtr from) {
1357 xmlNodePtr cur;
1358 xmlDtdPtr target, source;
1360 if (ctxt == NULL)
1361 return(-1);
1363 if ((from == NULL) || (from->intSubset == NULL))
1364 return(0);
1366 target = doc->intSubset;
1367 if (target == NULL) {
1368 cur = xmlDocGetRootElement(doc);
1369 if (cur == NULL)
1370 return(-1);
1371 target = xmlCreateIntSubset(doc, cur->name, NULL, NULL);
1372 if (target == NULL)
1373 return(-1);
1376 source = from->intSubset;
1377 if ((source != NULL) && (source->entities != NULL)) {
1378 xmlXIncludeMergeData data;
1380 data.ctxt = ctxt;
1381 data.doc = doc;
1383 xmlHashScan((xmlHashTablePtr) source->entities,
1384 xmlXIncludeMergeEntity, &data);
1386 source = from->extSubset;
1387 if ((source != NULL) && (source->entities != NULL)) {
1388 xmlXIncludeMergeData data;
1390 data.ctxt = ctxt;
1391 data.doc = doc;
1394 * don't duplicate existing stuff when external subsets are the same
1396 if ((!xmlStrEqual(target->ExternalID, source->ExternalID)) &&
1397 (!xmlStrEqual(target->SystemID, source->SystemID))) {
1398 xmlHashScan((xmlHashTablePtr) source->entities,
1399 xmlXIncludeMergeEntity, &data);
1402 return(0);
1406 * xmlXIncludeLoadDoc:
1407 * @ctxt: the XInclude context
1408 * @url: the associated URL
1409 * @nr: the xinclude node number
1411 * Load the document, and store the result in the XInclude context
1413 * Returns 0 in case of success, -1 in case of failure
1415 static int
1416 xmlXIncludeLoadDoc(xmlXIncludeCtxtPtr ctxt, const xmlChar *url, int nr) {
1417 xmlDocPtr doc;
1418 xmlURIPtr uri;
1419 xmlChar *URL;
1420 xmlChar *fragment = NULL;
1421 int i = 0;
1422 #ifdef LIBXML_XPTR_ENABLED
1423 int saveFlags;
1424 #endif
1426 #ifdef DEBUG_XINCLUDE
1427 xmlGenericError(xmlGenericErrorContext, "Loading doc %s:%d\n", url, nr);
1428 #endif
1430 * Check the URL and remove any fragment identifier
1432 uri = xmlParseURI((const char *)url);
1433 if (uri == NULL) {
1434 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1435 XML_XINCLUDE_HREF_URI,
1436 "invalid value URI %s\n", url);
1437 return(-1);
1439 if (uri->fragment != NULL) {
1440 fragment = (xmlChar *) uri->fragment;
1441 uri->fragment = NULL;
1443 if ((ctxt->incTab != NULL) && (ctxt->incTab[nr] != NULL) &&
1444 (ctxt->incTab[nr]->fragment != NULL)) {
1445 if (fragment != NULL) xmlFree(fragment);
1446 fragment = xmlStrdup(ctxt->incTab[nr]->fragment);
1448 URL = xmlSaveUri(uri);
1449 xmlFreeURI(uri);
1450 if (URL == NULL) {
1451 if (ctxt->incTab != NULL)
1452 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1453 XML_XINCLUDE_HREF_URI,
1454 "invalid value URI %s\n", url);
1455 else
1456 xmlXIncludeErr(ctxt, NULL,
1457 XML_XINCLUDE_HREF_URI,
1458 "invalid value URI %s\n", url);
1459 if (fragment != NULL)
1460 xmlFree(fragment);
1461 return(-1);
1465 * Handling of references to the local document are done
1466 * directly through ctxt->doc.
1468 if ((URL[0] == 0) || (URL[0] == '#') ||
1469 ((ctxt->doc != NULL) && (xmlStrEqual(URL, ctxt->doc->URL)))) {
1470 doc = ctxt->doc;
1471 goto loaded;
1475 * Prevent reloading twice the document.
1477 for (i = 0; i < ctxt->incNr; i++) {
1478 if ((xmlStrEqual(URL, ctxt->incTab[i]->URI)) &&
1479 (ctxt->incTab[i]->doc != NULL)) {
1480 doc = ctxt->incTab[i]->doc;
1481 #ifdef DEBUG_XINCLUDE
1482 printf("Already loaded %s\n", URL);
1483 #endif
1484 goto loaded;
1489 * Load it.
1491 #ifdef DEBUG_XINCLUDE
1492 printf("loading %s\n", URL);
1493 #endif
1494 #ifdef LIBXML_XPTR_ENABLED
1496 * If this is an XPointer evaluation, we want to assure that
1497 * all entities have been resolved prior to processing the
1498 * referenced document
1500 saveFlags = ctxt->parseFlags;
1501 if (fragment != NULL) { /* if this is an XPointer eval */
1502 ctxt->parseFlags |= XML_PARSE_NOENT;
1504 #endif
1506 doc = xmlXIncludeParseFile(ctxt, (const char *)URL);
1507 #ifdef LIBXML_XPTR_ENABLED
1508 ctxt->parseFlags = saveFlags;
1509 #endif
1510 if (doc == NULL) {
1511 xmlFree(URL);
1512 if (fragment != NULL)
1513 xmlFree(fragment);
1514 return(-1);
1516 ctxt->incTab[nr]->doc = doc;
1518 * It's possible that the requested URL has been mapped to a
1519 * completely different location (e.g. through a catalog entry).
1520 * To check for this, we compare the URL with that of the doc
1521 * and change it if they disagree (bug 146988).
1523 if (!xmlStrEqual(URL, doc->URL)) {
1524 xmlFree(URL);
1525 URL = xmlStrdup(doc->URL);
1527 for (i = nr + 1; i < ctxt->incNr; i++) {
1528 if (xmlStrEqual(URL, ctxt->incTab[i]->URI)) {
1529 ctxt->incTab[nr]->count++;
1530 #ifdef DEBUG_XINCLUDE
1531 printf("Increasing %s count since reused\n", URL);
1532 #endif
1533 break;
1538 * Make sure we have all entities fixed up
1540 xmlXIncludeMergeEntities(ctxt, ctxt->doc, doc);
1543 * We don't need the DTD anymore, free up space
1544 if (doc->intSubset != NULL) {
1545 xmlUnlinkNode((xmlNodePtr) doc->intSubset);
1546 xmlFreeNode((xmlNodePtr) doc->intSubset);
1547 doc->intSubset = NULL;
1549 if (doc->extSubset != NULL) {
1550 xmlUnlinkNode((xmlNodePtr) doc->extSubset);
1551 xmlFreeNode((xmlNodePtr) doc->extSubset);
1552 doc->extSubset = NULL;
1555 xmlXIncludeRecurseDoc(ctxt, doc, URL);
1557 loaded:
1558 if (fragment == NULL) {
1560 * Add the top children list as the replacement copy.
1562 ctxt->incTab[nr]->inc = xmlXIncludeCopyNodeList(ctxt, ctxt->doc,
1563 doc, doc->children);
1565 #ifdef LIBXML_XPTR_ENABLED
1566 else {
1568 * Computes the XPointer expression and make a copy used
1569 * as the replacement copy.
1571 xmlXPathObjectPtr xptr;
1572 xmlXPathContextPtr xptrctxt;
1573 xmlNodeSetPtr set;
1575 xptrctxt = xmlXPtrNewContext(doc, NULL, NULL);
1576 if (xptrctxt == NULL) {
1577 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1578 XML_XINCLUDE_XPTR_FAILED,
1579 "could not create XPointer context\n", NULL);
1580 xmlFree(URL);
1581 xmlFree(fragment);
1582 return(-1);
1584 xptr = xmlXPtrEval(fragment, xptrctxt);
1585 if (xptr == NULL) {
1586 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1587 XML_XINCLUDE_XPTR_FAILED,
1588 "XPointer evaluation failed: #%s\n",
1589 fragment);
1590 xmlXPathFreeContext(xptrctxt);
1591 xmlFree(URL);
1592 xmlFree(fragment);
1593 return(-1);
1595 switch (xptr->type) {
1596 case XPATH_UNDEFINED:
1597 case XPATH_BOOLEAN:
1598 case XPATH_NUMBER:
1599 case XPATH_STRING:
1600 case XPATH_POINT:
1601 case XPATH_USERS:
1602 case XPATH_XSLT_TREE:
1603 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1604 XML_XINCLUDE_XPTR_RESULT,
1605 "XPointer is not a range: #%s\n",
1606 fragment);
1607 xmlXPathFreeObject(xptr);
1608 xmlXPathFreeContext(xptrctxt);
1609 xmlFree(URL);
1610 xmlFree(fragment);
1611 return(-1);
1612 case XPATH_NODESET:
1613 if ((xptr->nodesetval == NULL) ||
1614 (xptr->nodesetval->nodeNr <= 0)) {
1615 xmlXPathFreeObject(xptr);
1616 xmlXPathFreeContext(xptrctxt);
1617 xmlFree(URL);
1618 xmlFree(fragment);
1619 return(-1);
1622 case XPATH_RANGE:
1623 case XPATH_LOCATIONSET:
1624 break;
1626 set = xptr->nodesetval;
1627 if (set != NULL) {
1628 for (i = 0;i < set->nodeNr;i++) {
1629 if (set->nodeTab[i] == NULL)
1630 continue;
1631 switch (set->nodeTab[i]->type) {
1632 case XML_ELEMENT_NODE:
1633 case XML_TEXT_NODE:
1634 case XML_CDATA_SECTION_NODE:
1635 case XML_ENTITY_REF_NODE:
1636 case XML_ENTITY_NODE:
1637 case XML_PI_NODE:
1638 case XML_COMMENT_NODE:
1639 case XML_DOCUMENT_NODE:
1640 case XML_HTML_DOCUMENT_NODE:
1641 #ifdef LIBXML_DOCB_ENABLED
1642 case XML_DOCB_DOCUMENT_NODE:
1643 #endif
1644 continue;
1646 case XML_ATTRIBUTE_NODE:
1647 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1648 XML_XINCLUDE_XPTR_RESULT,
1649 "XPointer selects an attribute: #%s\n",
1650 fragment);
1651 set->nodeTab[i] = NULL;
1652 continue;
1653 case XML_NAMESPACE_DECL:
1654 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1655 XML_XINCLUDE_XPTR_RESULT,
1656 "XPointer selects a namespace: #%s\n",
1657 fragment);
1658 set->nodeTab[i] = NULL;
1659 continue;
1660 case XML_DOCUMENT_TYPE_NODE:
1661 case XML_DOCUMENT_FRAG_NODE:
1662 case XML_NOTATION_NODE:
1663 case XML_DTD_NODE:
1664 case XML_ELEMENT_DECL:
1665 case XML_ATTRIBUTE_DECL:
1666 case XML_ENTITY_DECL:
1667 case XML_XINCLUDE_START:
1668 case XML_XINCLUDE_END:
1669 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1670 XML_XINCLUDE_XPTR_RESULT,
1671 "XPointer selects unexpected nodes: #%s\n",
1672 fragment);
1673 set->nodeTab[i] = NULL;
1674 set->nodeTab[i] = NULL;
1675 continue; /* for */
1679 ctxt->incTab[nr]->inc =
1680 xmlXIncludeCopyXPointer(ctxt, ctxt->doc, doc, xptr);
1681 xmlXPathFreeObject(xptr);
1682 xmlXPathFreeContext(xptrctxt);
1683 xmlFree(fragment);
1685 #endif
1688 * Do the xml:base fixup if needed
1690 if ((doc != NULL) && (URL != NULL) &&
1691 (!(ctxt->parseFlags & XML_PARSE_NOBASEFIX)) &&
1692 (!(doc->parseFlags & XML_PARSE_NOBASEFIX))) {
1693 xmlNodePtr node;
1694 xmlChar *base;
1695 xmlChar *curBase;
1698 * The base is only adjusted if "necessary", i.e. if the xinclude node
1699 * has a base specified, or the URL is relative
1701 base = xmlGetNsProp(ctxt->incTab[nr]->ref, BAD_CAST "base",
1702 XML_XML_NAMESPACE);
1703 if (base == NULL) {
1705 * No xml:base on the xinclude node, so we check whether the
1706 * URI base is different than (relative to) the context base
1708 curBase = xmlBuildRelativeURI(URL, ctxt->base);
1709 if (curBase == NULL) { /* Error return */
1710 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1711 XML_XINCLUDE_HREF_URI,
1712 "trying to build relative URI from %s\n", URL);
1713 } else {
1714 /* If the URI doesn't contain a slash, it's not relative */
1715 if (!xmlStrchr(curBase, (xmlChar) '/'))
1716 xmlFree(curBase);
1717 else
1718 base = curBase;
1721 if (base != NULL) { /* Adjustment may be needed */
1722 node = ctxt->incTab[nr]->inc;
1723 while (node != NULL) {
1724 /* Only work on element nodes */
1725 if (node->type == XML_ELEMENT_NODE) {
1726 curBase = xmlNodeGetBase(node->doc, node);
1727 /* If no current base, set it */
1728 if (curBase == NULL) {
1729 xmlNodeSetBase(node, base);
1730 } else {
1732 * If the current base is the same as the
1733 * URL of the document, then reset it to be
1734 * the specified xml:base or the relative URI
1736 if (xmlStrEqual(curBase, node->doc->URL)) {
1737 xmlNodeSetBase(node, base);
1738 } else {
1740 * If the element already has an xml:base
1741 * set, then relativise it if necessary
1743 xmlChar *xmlBase;
1744 xmlBase = xmlGetNsProp(node,
1745 BAD_CAST "base",
1746 XML_XML_NAMESPACE);
1747 if (xmlBase != NULL) {
1748 xmlChar *relBase;
1749 relBase = xmlBuildURI(xmlBase, base);
1750 if (relBase == NULL) { /* error */
1751 xmlXIncludeErr(ctxt,
1752 ctxt->incTab[nr]->ref,
1753 XML_XINCLUDE_HREF_URI,
1754 "trying to rebuild base from %s\n",
1755 xmlBase);
1756 } else {
1757 xmlNodeSetBase(node, relBase);
1758 xmlFree(relBase);
1760 xmlFree(xmlBase);
1763 xmlFree(curBase);
1766 node = node->next;
1768 xmlFree(base);
1771 if ((nr < ctxt->incNr) && (ctxt->incTab[nr]->doc != NULL) &&
1772 (ctxt->incTab[nr]->count <= 1)) {
1773 #ifdef DEBUG_XINCLUDE
1774 printf("freeing %s\n", ctxt->incTab[nr]->doc->URL);
1775 #endif
1776 xmlFreeDoc(ctxt->incTab[nr]->doc);
1777 ctxt->incTab[nr]->doc = NULL;
1779 xmlFree(URL);
1780 return(0);
1784 * xmlXIncludeLoadTxt:
1785 * @ctxt: the XInclude context
1786 * @url: the associated URL
1787 * @nr: the xinclude node number
1789 * Load the content, and store the result in the XInclude context
1791 * Returns 0 in case of success, -1 in case of failure
1793 static int
1794 xmlXIncludeLoadTxt(xmlXIncludeCtxtPtr ctxt, const xmlChar *url, int nr) {
1795 xmlParserInputBufferPtr buf;
1796 xmlNodePtr node;
1797 xmlURIPtr uri;
1798 xmlChar *URL;
1799 int i;
1800 xmlChar *encoding = NULL;
1801 xmlCharEncoding enc = (xmlCharEncoding) 0;
1802 xmlParserCtxtPtr pctxt;
1803 xmlParserInputPtr inputStream;
1804 int xinclude_multibyte_fallback_used = 0;
1806 /* Don't read from stdin. */
1807 if (xmlStrcmp(url, BAD_CAST "-") == 0)
1808 url = BAD_CAST "./-";
1811 * Check the URL and remove any fragment identifier
1813 uri = xmlParseURI((const char *)url);
1814 if (uri == NULL) {
1815 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref, XML_XINCLUDE_HREF_URI,
1816 "invalid value URI %s\n", url);
1817 return(-1);
1819 if (uri->fragment != NULL) {
1820 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref, XML_XINCLUDE_TEXT_FRAGMENT,
1821 "fragment identifier forbidden for text: %s\n",
1822 (const xmlChar *) uri->fragment);
1823 xmlFreeURI(uri);
1824 return(-1);
1826 URL = xmlSaveUri(uri);
1827 xmlFreeURI(uri);
1828 if (URL == NULL) {
1829 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref, XML_XINCLUDE_HREF_URI,
1830 "invalid value URI %s\n", url);
1831 return(-1);
1835 * Handling of references to the local document are done
1836 * directly through ctxt->doc.
1838 if (URL[0] == 0) {
1839 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1840 XML_XINCLUDE_TEXT_DOCUMENT,
1841 "text serialization of document not available\n", NULL);
1842 xmlFree(URL);
1843 return(-1);
1847 * Prevent reloading twice the document.
1849 for (i = 0; i < ctxt->txtNr; i++) {
1850 if (xmlStrEqual(URL, ctxt->txturlTab[i])) {
1851 node = xmlNewText(ctxt->txtTab[i]);
1852 goto loaded;
1856 * Try to get the encoding if available
1858 if ((ctxt->incTab[nr] != NULL) && (ctxt->incTab[nr]->ref != NULL)) {
1859 encoding = xmlGetProp(ctxt->incTab[nr]->ref, XINCLUDE_PARSE_ENCODING);
1861 if (encoding != NULL) {
1863 * TODO: we should not have to remap to the xmlCharEncoding
1864 * predefined set, a better interface than
1865 * xmlParserInputBufferCreateFilename should allow any
1866 * encoding supported by iconv
1868 enc = xmlParseCharEncoding((const char *) encoding);
1869 if (enc == XML_CHAR_ENCODING_ERROR) {
1870 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1871 XML_XINCLUDE_UNKNOWN_ENCODING,
1872 "encoding %s not supported\n", encoding);
1873 xmlFree(encoding);
1874 xmlFree(URL);
1875 return(-1);
1877 xmlFree(encoding);
1881 * Load it.
1883 pctxt = xmlNewParserCtxt();
1884 inputStream = xmlLoadExternalEntity((const char*)URL, NULL, pctxt);
1885 if(inputStream == NULL) {
1886 xmlFreeParserCtxt(pctxt);
1887 xmlFree(URL);
1888 return(-1);
1890 buf = inputStream->buf;
1891 if (buf == NULL) {
1892 xmlFreeInputStream (inputStream);
1893 xmlFreeParserCtxt(pctxt);
1894 xmlFree(URL);
1895 return(-1);
1897 if (buf->encoder)
1898 xmlCharEncCloseFunc(buf->encoder);
1899 buf->encoder = xmlGetCharEncodingHandler(enc);
1900 node = xmlNewText(NULL);
1903 * Scan all chars from the resource and add the to the node
1905 xinclude_multibyte_fallback:
1906 while (xmlParserInputBufferRead(buf, 128) > 0) {
1907 int len;
1908 const xmlChar *content;
1910 content = xmlBufContent(buf->buffer);
1911 len = xmlBufLength(buf->buffer);
1912 for (i = 0;i < len;) {
1913 int cur;
1914 int l;
1916 cur = xmlStringCurrentChar(NULL, &content[i], &l);
1917 if (!IS_CHAR(cur)) {
1918 /* Handle split multibyte char at buffer boundary */
1919 if (((len - i) < 4) && (!xinclude_multibyte_fallback_used)) {
1920 xinclude_multibyte_fallback_used = 1;
1921 xmlBufShrink(buf->buffer, i);
1922 goto xinclude_multibyte_fallback;
1923 } else {
1924 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
1925 XML_XINCLUDE_INVALID_CHAR,
1926 "%s contains invalid char\n", URL);
1927 xmlFreeParserCtxt(pctxt);
1928 xmlFreeParserInputBuffer(buf);
1929 xmlFree(URL);
1930 return(-1);
1932 } else {
1933 xinclude_multibyte_fallback_used = 0;
1934 xmlNodeAddContentLen(node, &content[i], l);
1936 i += l;
1938 xmlBufShrink(buf->buffer, len);
1940 xmlFreeParserCtxt(pctxt);
1941 xmlXIncludeAddTxt(ctxt, node->content, URL);
1942 xmlFreeInputStream(inputStream);
1944 loaded:
1946 * Add the element as the replacement copy.
1948 ctxt->incTab[nr]->inc = node;
1949 xmlFree(URL);
1950 return(0);
1954 * xmlXIncludeLoadFallback:
1955 * @ctxt: the XInclude context
1956 * @fallback: the fallback node
1957 * @nr: the xinclude node number
1959 * Load the content of the fallback node, and store the result
1960 * in the XInclude context
1962 * Returns 0 in case of success, -1 in case of failure
1964 static int
1965 xmlXIncludeLoadFallback(xmlXIncludeCtxtPtr ctxt, xmlNodePtr fallback, int nr) {
1966 xmlXIncludeCtxtPtr newctxt;
1967 int ret = 0;
1968 int oldNbErrors = ctxt->nbErrors;
1970 if ((fallback == NULL) || (fallback->type == XML_NAMESPACE_DECL) ||
1971 (ctxt == NULL))
1972 return(-1);
1973 if (fallback->children != NULL) {
1975 * It's possible that the fallback also has 'includes'
1976 * (Bug 129969), so we re-process the fallback just in case
1978 newctxt = xmlXIncludeNewContext(ctxt->doc);
1979 if (newctxt == NULL)
1980 return (-1);
1981 newctxt->_private = ctxt->_private;
1982 newctxt->base = xmlStrdup(ctxt->base); /* Inherit the base from the existing context */
1983 xmlXIncludeSetFlags(newctxt, ctxt->parseFlags);
1984 newctxt->incTotal = ctxt->incTotal;
1985 if (xmlXIncludeDoProcess(newctxt, ctxt->doc, fallback, 1) < 0)
1986 ret = -1;
1987 ctxt->incTotal = newctxt->incTotal;
1988 if (ctxt->nbErrors > oldNbErrors)
1989 ret = -1;
1990 xmlXIncludeFreeContext(newctxt);
1992 ctxt->incTab[nr]->inc = xmlDocCopyNodeList(ctxt->doc,
1993 fallback->children);
1994 if (ctxt->incTab[nr]->inc == NULL)
1995 ctxt->incTab[nr]->emptyFb = 1;
1996 } else {
1997 ctxt->incTab[nr]->inc = NULL;
1998 ctxt->incTab[nr]->emptyFb = 1; /* flag empty callback */
2000 ctxt->incTab[nr]->fallback = 1;
2001 return(ret);
2004 /************************************************************************
2006 * XInclude Processing *
2008 ************************************************************************/
2011 * xmlXIncludePreProcessNode:
2012 * @ctxt: an XInclude context
2013 * @node: an XInclude node
2015 * Implement the XInclude preprocessing, currently just adding the element
2016 * for further processing.
2018 * Returns the result list or NULL in case of error
2020 static xmlNodePtr
2021 xmlXIncludePreProcessNode(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node) {
2022 xmlXIncludeAddNode(ctxt, node);
2023 return(NULL);
2027 * xmlXIncludeLoadNode:
2028 * @ctxt: an XInclude context
2029 * @nr: the node number
2031 * Find and load the infoset replacement for the given node.
2033 * Returns 0 if substitution succeeded, -1 if some processing failed
2035 static int
2036 xmlXIncludeLoadNode(xmlXIncludeCtxtPtr ctxt, int nr) {
2037 xmlNodePtr cur;
2038 xmlChar *href;
2039 xmlChar *parse;
2040 xmlChar *base;
2041 xmlChar *oldBase;
2042 xmlChar *URI;
2043 int xml = 1; /* default Issue 64 */
2044 int ret;
2046 if (ctxt == NULL)
2047 return(-1);
2048 if ((nr < 0) || (nr >= ctxt->incNr))
2049 return(-1);
2050 cur = ctxt->incTab[nr]->ref;
2051 if (cur == NULL)
2052 return(-1);
2055 * read the attributes
2057 href = xmlXIncludeGetProp(ctxt, cur, XINCLUDE_HREF);
2058 if (href == NULL) {
2059 href = xmlStrdup(BAD_CAST ""); /* @@@@ href is now optional */
2060 if (href == NULL)
2061 return(-1);
2063 parse = xmlXIncludeGetProp(ctxt, cur, XINCLUDE_PARSE);
2064 if (parse != NULL) {
2065 if (xmlStrEqual(parse, XINCLUDE_PARSE_XML))
2066 xml = 1;
2067 else if (xmlStrEqual(parse, XINCLUDE_PARSE_TEXT))
2068 xml = 0;
2069 else {
2070 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
2071 XML_XINCLUDE_PARSE_VALUE,
2072 "invalid value %s for 'parse'\n", parse);
2073 if (href != NULL)
2074 xmlFree(href);
2075 if (parse != NULL)
2076 xmlFree(parse);
2077 return(-1);
2082 * compute the URI
2084 base = xmlNodeGetBase(ctxt->doc, cur);
2085 if (base == NULL) {
2086 URI = xmlBuildURI(href, ctxt->doc->URL);
2087 } else {
2088 URI = xmlBuildURI(href, base);
2090 if (URI == NULL) {
2091 xmlChar *escbase;
2092 xmlChar *eschref;
2094 * Some escaping may be needed
2096 escbase = xmlURIEscape(base);
2097 eschref = xmlURIEscape(href);
2098 URI = xmlBuildURI(eschref, escbase);
2099 if (escbase != NULL)
2100 xmlFree(escbase);
2101 if (eschref != NULL)
2102 xmlFree(eschref);
2104 if (URI == NULL) {
2105 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
2106 XML_XINCLUDE_HREF_URI, "failed build URL\n", NULL);
2107 if (parse != NULL)
2108 xmlFree(parse);
2109 if (href != NULL)
2110 xmlFree(href);
2111 if (base != NULL)
2112 xmlFree(base);
2113 return(-1);
2115 #ifdef DEBUG_XINCLUDE
2116 xmlGenericError(xmlGenericErrorContext, "parse: %s\n",
2117 xml ? "xml": "text");
2118 xmlGenericError(xmlGenericErrorContext, "URI: %s\n", URI);
2119 #endif
2122 * Save the base for this include (saving the current one)
2124 oldBase = ctxt->base;
2125 ctxt->base = base;
2127 if (xml) {
2128 ret = xmlXIncludeLoadDoc(ctxt, URI, nr);
2129 /* xmlXIncludeGetFragment(ctxt, cur, URI); */
2130 } else {
2131 ret = xmlXIncludeLoadTxt(ctxt, URI, nr);
2135 * Restore the original base before checking for fallback
2137 ctxt->base = oldBase;
2139 if (ret < 0) {
2140 xmlNodePtr children;
2143 * Time to try a fallback if available
2145 #ifdef DEBUG_XINCLUDE
2146 xmlGenericError(xmlGenericErrorContext, "error looking for fallback\n");
2147 #endif
2148 children = cur->children;
2149 while (children != NULL) {
2150 if ((children->type == XML_ELEMENT_NODE) &&
2151 (children->ns != NULL) &&
2152 (xmlStrEqual(children->name, XINCLUDE_FALLBACK)) &&
2153 ((xmlStrEqual(children->ns->href, XINCLUDE_NS)) ||
2154 (xmlStrEqual(children->ns->href, XINCLUDE_OLD_NS)))) {
2155 ret = xmlXIncludeLoadFallback(ctxt, children, nr);
2156 break;
2158 children = children->next;
2161 if (ret < 0) {
2162 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
2163 XML_XINCLUDE_NO_FALLBACK,
2164 "could not load %s, and no fallback was found\n",
2165 URI);
2169 * Cleanup
2171 if (URI != NULL)
2172 xmlFree(URI);
2173 if (parse != NULL)
2174 xmlFree(parse);
2175 if (href != NULL)
2176 xmlFree(href);
2177 if (base != NULL)
2178 xmlFree(base);
2179 return(0);
2183 * xmlXIncludeIncludeNode:
2184 * @ctxt: an XInclude context
2185 * @nr: the node number
2187 * Implement the infoset replacement for the given node
2189 * Returns 0 if substitution succeeded, -1 if some processing failed
2191 static int
2192 xmlXIncludeIncludeNode(xmlXIncludeCtxtPtr ctxt, int nr) {
2193 xmlNodePtr cur, end, list, tmp;
2195 if (ctxt == NULL)
2196 return(-1);
2197 if ((nr < 0) || (nr >= ctxt->incNr))
2198 return(-1);
2199 cur = ctxt->incTab[nr]->ref;
2200 if ((cur == NULL) || (cur->type == XML_NAMESPACE_DECL))
2201 return(-1);
2203 list = ctxt->incTab[nr]->inc;
2204 ctxt->incTab[nr]->inc = NULL;
2205 ctxt->incTab[nr]->emptyFb = 0;
2208 * Check against the risk of generating a multi-rooted document
2210 if ((cur->parent != NULL) &&
2211 (cur->parent->type != XML_ELEMENT_NODE)) {
2212 int nb_elem = 0;
2214 tmp = list;
2215 while (tmp != NULL) {
2216 if (tmp->type == XML_ELEMENT_NODE)
2217 nb_elem++;
2218 tmp = tmp->next;
2220 if (nb_elem > 1) {
2221 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
2222 XML_XINCLUDE_MULTIPLE_ROOT,
2223 "XInclude error: would result in multiple root nodes\n",
2224 NULL);
2225 xmlFreeNodeList(list);
2226 return(-1);
2230 if (ctxt->parseFlags & XML_PARSE_NOXINCNODE) {
2232 * Add the list of nodes
2234 while (list != NULL) {
2235 end = list;
2236 list = list->next;
2238 xmlAddPrevSibling(cur, end);
2240 xmlUnlinkNode(cur);
2241 xmlFreeNode(cur);
2242 } else {
2243 xmlNodePtr child, next;
2246 * Change the current node as an XInclude start one, and add an
2247 * XInclude end one
2249 if (ctxt->incTab[nr]->fallback)
2250 xmlUnsetProp(cur, BAD_CAST "href");
2251 cur->type = XML_XINCLUDE_START;
2252 /* Remove fallback children */
2253 for (child = cur->children; child != NULL; child = next) {
2254 next = child->next;
2255 xmlUnlinkNode(child);
2256 xmlFreeNode(child);
2258 end = xmlNewDocNode(cur->doc, cur->ns, cur->name, NULL);
2259 if (end == NULL) {
2260 xmlXIncludeErr(ctxt, ctxt->incTab[nr]->ref,
2261 XML_XINCLUDE_BUILD_FAILED,
2262 "failed to build node\n", NULL);
2263 xmlFreeNodeList(list);
2264 return(-1);
2266 end->type = XML_XINCLUDE_END;
2267 xmlAddNextSibling(cur, end);
2270 * Add the list of nodes
2272 while (list != NULL) {
2273 cur = list;
2274 list = list->next;
2276 xmlAddPrevSibling(end, cur);
2281 return(0);
2285 * xmlXIncludeTestNode:
2286 * @ctxt: the XInclude processing context
2287 * @node: an XInclude node
2289 * test if the node is an XInclude node
2291 * Returns 1 true, 0 otherwise
2293 static int
2294 xmlXIncludeTestNode(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node) {
2295 if (node == NULL)
2296 return(0);
2297 if (node->type != XML_ELEMENT_NODE)
2298 return(0);
2299 if (node->ns == NULL)
2300 return(0);
2301 if ((xmlStrEqual(node->ns->href, XINCLUDE_NS)) ||
2302 (xmlStrEqual(node->ns->href, XINCLUDE_OLD_NS))) {
2303 if (xmlStrEqual(node->ns->href, XINCLUDE_OLD_NS)) {
2304 if (ctxt->legacy == 0) {
2305 #if 0 /* wait for the XML Core Working Group to get something stable ! */
2306 xmlXIncludeWarn(ctxt, node, XML_XINCLUDE_DEPRECATED_NS,
2307 "Deprecated XInclude namespace found, use %s",
2308 XINCLUDE_NS);
2309 #endif
2310 ctxt->legacy = 1;
2313 if (xmlStrEqual(node->name, XINCLUDE_NODE)) {
2314 xmlNodePtr child = node->children;
2315 int nb_fallback = 0;
2317 while (child != NULL) {
2318 if ((child->type == XML_ELEMENT_NODE) &&
2319 (child->ns != NULL) &&
2320 ((xmlStrEqual(child->ns->href, XINCLUDE_NS)) ||
2321 (xmlStrEqual(child->ns->href, XINCLUDE_OLD_NS)))) {
2322 if (xmlStrEqual(child->name, XINCLUDE_NODE)) {
2323 xmlXIncludeErr(ctxt, node,
2324 XML_XINCLUDE_INCLUDE_IN_INCLUDE,
2325 "%s has an 'include' child\n",
2326 XINCLUDE_NODE);
2327 return(0);
2329 if (xmlStrEqual(child->name, XINCLUDE_FALLBACK)) {
2330 nb_fallback++;
2333 child = child->next;
2335 if (nb_fallback > 1) {
2336 xmlXIncludeErr(ctxt, node, XML_XINCLUDE_FALLBACKS_IN_INCLUDE,
2337 "%s has multiple fallback children\n",
2338 XINCLUDE_NODE);
2339 return(0);
2341 return(1);
2343 if (xmlStrEqual(node->name, XINCLUDE_FALLBACK)) {
2344 if ((node->parent == NULL) ||
2345 (node->parent->type != XML_ELEMENT_NODE) ||
2346 (node->parent->ns == NULL) ||
2347 ((!xmlStrEqual(node->parent->ns->href, XINCLUDE_NS)) &&
2348 (!xmlStrEqual(node->parent->ns->href, XINCLUDE_OLD_NS))) ||
2349 (!xmlStrEqual(node->parent->name, XINCLUDE_NODE))) {
2350 xmlXIncludeErr(ctxt, node,
2351 XML_XINCLUDE_FALLBACK_NOT_IN_INCLUDE,
2352 "%s is not the child of an 'include'\n",
2353 XINCLUDE_FALLBACK);
2357 return(0);
2361 * xmlXIncludeDoProcess:
2362 * @ctxt: the XInclude processing context
2363 * @doc: an XML document
2364 * @tree: the top of the tree to process
2365 * @skipRoot: don't process the root node of the tree
2367 * Implement the XInclude substitution on the XML document @doc
2369 * Returns 0 if no substitution were done, -1 if some processing failed
2370 * or the number of substitutions done.
2372 static int
2373 xmlXIncludeDoProcess(xmlXIncludeCtxtPtr ctxt, xmlDocPtr doc, xmlNodePtr tree,
2374 int skipRoot) {
2375 xmlNodePtr cur;
2376 int ret = 0;
2377 int i, start;
2379 if ((doc == NULL) || (tree == NULL) || (tree->type == XML_NAMESPACE_DECL))
2380 return(-1);
2381 if ((skipRoot) && (tree->children == NULL))
2382 return(-1);
2383 if (ctxt == NULL)
2384 return(-1);
2386 if (doc->URL != NULL) {
2387 ret = xmlXIncludeURLPush(ctxt, doc->URL);
2388 if (ret < 0)
2389 return(-1);
2391 start = ctxt->incNr;
2394 * TODO: The phases must run separately for recursive inclusions.
2396 * - Phase 1 should start with top-level XInclude nodes, load documents,
2397 * execute XPointer expressions, then process only the result nodes
2398 * (not whole document, see bug #324081) and only for phase 1
2399 * recursively. We will need a backreference from xmlNodes to
2400 * xmlIncludeRefs to detect references that were already visited.
2401 * This can also be used for proper cycle detection, see bug #344240.
2403 * - Phase 2 should visit all top-level XInclude nodes and expand
2404 * possible subreferences in the replacement recursively.
2406 * - Phase 3 should finally replace the top-level XInclude nodes.
2407 * It could also be run together with phase 2.
2411 * First phase: lookup the elements in the document
2413 if (skipRoot)
2414 cur = tree->children;
2415 else
2416 cur = tree;
2417 do {
2418 /* TODO: need to work on entities -> stack */
2419 if (xmlXIncludeTestNode(ctxt, cur) == 1) {
2420 #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
2422 * Avoid superlinear expansion by limiting the total number
2423 * of replacements.
2425 if (ctxt->incTotal >= 20)
2426 return(-1);
2427 #endif
2428 ctxt->incTotal++;
2429 xmlXIncludePreProcessNode(ctxt, cur);
2430 } else if ((cur->children != NULL) &&
2431 ((cur->type == XML_DOCUMENT_NODE) ||
2432 (cur->type == XML_ELEMENT_NODE))) {
2433 cur = cur->children;
2434 continue;
2436 do {
2437 if (cur == tree)
2438 break;
2439 if (cur->next != NULL) {
2440 cur = cur->next;
2441 break;
2443 cur = cur->parent;
2444 } while (cur != NULL);
2445 } while ((cur != NULL) && (cur != tree));
2448 * Second Phase : collect the infosets fragments
2450 for (i = start;i < ctxt->incNr; i++) {
2451 xmlXIncludeLoadNode(ctxt, i);
2452 ret++;
2456 * Third phase: extend the original document infoset.
2458 * Originally we bypassed the inclusion if there were any errors
2459 * encountered on any of the XIncludes. A bug was raised (bug
2460 * 132588) requesting that we output the XIncludes without error,
2461 * so the check for inc!=NULL || xptr!=NULL was put in. This may
2462 * give some other problems in the future, but for now it seems to
2463 * work ok.
2466 for (i = ctxt->incBase;i < ctxt->incNr; i++) {
2467 if ((ctxt->incTab[i]->inc != NULL) ||
2468 (ctxt->incTab[i]->emptyFb != 0)) /* (empty fallback) */
2469 xmlXIncludeIncludeNode(ctxt, i);
2472 if (doc->URL != NULL)
2473 xmlXIncludeURLPop(ctxt);
2474 return(ret);
2478 * xmlXIncludeSetFlags:
2479 * @ctxt: an XInclude processing context
2480 * @flags: a set of xmlParserOption used for parsing XML includes
2482 * Set the flags used for further processing of XML resources.
2484 * Returns 0 in case of success and -1 in case of error.
2487 xmlXIncludeSetFlags(xmlXIncludeCtxtPtr ctxt, int flags) {
2488 if (ctxt == NULL)
2489 return(-1);
2490 ctxt->parseFlags = flags;
2491 return(0);
2495 * xmlXIncludeProcessTreeFlagsData:
2496 * @tree: an XML node
2497 * @flags: a set of xmlParserOption used for parsing XML includes
2498 * @data: application data that will be passed to the parser context
2499 * in the _private field of the parser context(s)
2501 * Implement the XInclude substitution on the XML node @tree
2503 * Returns 0 if no substitution were done, -1 if some processing failed
2504 * or the number of substitutions done.
2508 xmlXIncludeProcessTreeFlagsData(xmlNodePtr tree, int flags, void *data) {
2509 xmlXIncludeCtxtPtr ctxt;
2510 int ret = 0;
2512 if ((tree == NULL) || (tree->type == XML_NAMESPACE_DECL) ||
2513 (tree->doc == NULL))
2514 return(-1);
2516 ctxt = xmlXIncludeNewContext(tree->doc);
2517 if (ctxt == NULL)
2518 return(-1);
2519 ctxt->_private = data;
2520 ctxt->base = xmlStrdup((xmlChar *)tree->doc->URL);
2521 xmlXIncludeSetFlags(ctxt, flags);
2522 ret = xmlXIncludeDoProcess(ctxt, tree->doc, tree, 0);
2523 if ((ret >= 0) && (ctxt->nbErrors > 0))
2524 ret = -1;
2526 xmlXIncludeFreeContext(ctxt);
2527 return(ret);
2531 * xmlXIncludeProcessFlagsData:
2532 * @doc: an XML document
2533 * @flags: a set of xmlParserOption used for parsing XML includes
2534 * @data: application data that will be passed to the parser context
2535 * in the _private field of the parser context(s)
2537 * Implement the XInclude substitution on the XML document @doc
2539 * Returns 0 if no substitution were done, -1 if some processing failed
2540 * or the number of substitutions done.
2543 xmlXIncludeProcessFlagsData(xmlDocPtr doc, int flags, void *data) {
2544 xmlNodePtr tree;
2546 if (doc == NULL)
2547 return(-1);
2548 tree = xmlDocGetRootElement(doc);
2549 if (tree == NULL)
2550 return(-1);
2551 return(xmlXIncludeProcessTreeFlagsData(tree, flags, data));
2555 * xmlXIncludeProcessFlags:
2556 * @doc: an XML document
2557 * @flags: a set of xmlParserOption used for parsing XML includes
2559 * Implement the XInclude substitution on the XML document @doc
2561 * Returns 0 if no substitution were done, -1 if some processing failed
2562 * or the number of substitutions done.
2565 xmlXIncludeProcessFlags(xmlDocPtr doc, int flags) {
2566 return xmlXIncludeProcessFlagsData(doc, flags, NULL);
2570 * xmlXIncludeProcess:
2571 * @doc: an XML document
2573 * Implement the XInclude substitution on the XML document @doc
2575 * Returns 0 if no substitution were done, -1 if some processing failed
2576 * or the number of substitutions done.
2579 xmlXIncludeProcess(xmlDocPtr doc) {
2580 return(xmlXIncludeProcessFlags(doc, 0));
2584 * xmlXIncludeProcessTreeFlags:
2585 * @tree: a node in an XML document
2586 * @flags: a set of xmlParserOption used for parsing XML includes
2588 * Implement the XInclude substitution for the given subtree
2590 * Returns 0 if no substitution were done, -1 if some processing failed
2591 * or the number of substitutions done.
2594 xmlXIncludeProcessTreeFlags(xmlNodePtr tree, int flags) {
2595 xmlXIncludeCtxtPtr ctxt;
2596 int ret = 0;
2598 if ((tree == NULL) || (tree->type == XML_NAMESPACE_DECL) ||
2599 (tree->doc == NULL))
2600 return(-1);
2601 ctxt = xmlXIncludeNewContext(tree->doc);
2602 if (ctxt == NULL)
2603 return(-1);
2604 ctxt->base = xmlNodeGetBase(tree->doc, tree);
2605 xmlXIncludeSetFlags(ctxt, flags);
2606 ret = xmlXIncludeDoProcess(ctxt, tree->doc, tree, 0);
2607 if ((ret >= 0) && (ctxt->nbErrors > 0))
2608 ret = -1;
2610 xmlXIncludeFreeContext(ctxt);
2611 return(ret);
2615 * xmlXIncludeProcessTree:
2616 * @tree: a node in an XML document
2618 * Implement the XInclude substitution for the given subtree
2620 * Returns 0 if no substitution were done, -1 if some processing failed
2621 * or the number of substitutions done.
2624 xmlXIncludeProcessTree(xmlNodePtr tree) {
2625 return(xmlXIncludeProcessTreeFlags(tree, 0));
2629 * xmlXIncludeProcessNode:
2630 * @ctxt: an existing XInclude context
2631 * @node: a node in an XML document
2633 * Implement the XInclude substitution for the given subtree reusing
2634 * the information and data coming from the given context.
2636 * Returns 0 if no substitution were done, -1 if some processing failed
2637 * or the number of substitutions done.
2640 xmlXIncludeProcessNode(xmlXIncludeCtxtPtr ctxt, xmlNodePtr node) {
2641 int ret = 0;
2643 if ((node == NULL) || (node->type == XML_NAMESPACE_DECL) ||
2644 (node->doc == NULL) || (ctxt == NULL))
2645 return(-1);
2646 ret = xmlXIncludeDoProcess(ctxt, node->doc, node, 0);
2647 if ((ret >= 0) && (ctxt->nbErrors > 0))
2648 ret = -1;
2649 return(ret);
2652 #else /* !LIBXML_XINCLUDE_ENABLED */
2653 #endif
2654 #define bottom_xinclude
2655 #include "elfgcchack.h"