2 * error.c: module displaying/handling XML parser errors
4 * See Copyright for the status of this software.
6 * Daniel Veillard <daniel@veillard.com>
14 #include <libxml/parser.h>
15 #include <libxml/xmlerror.h>
16 #include <libxml/xmlmemory.h>
17 #include <libxml/globals.h>
19 void XMLCDECL xmlGenericErrorDefaultFunc (void *ctx ATTRIBUTE_UNUSED,
23 #define XML_GET_VAR_STR(msg, str) { \
24 int size, prev_size = -1; \
29 str = (char *) xmlMalloc(150); \
34 while (size < 64000) { \
36 chars = vsnprintf(str, size, msg, ap); \
38 if ((chars > -1) && (chars < size)) { \
39 if (prev_size == chars) { \
49 if ((larger = (char *) xmlRealloc(str, size)) == NULL) {\
56 /************************************************************************
58 * Handling of out of context errors *
60 ************************************************************************/
63 * xmlGenericErrorDefaultFunc:
64 * @ctx: an error context
65 * @msg: the message to display/transmit
66 * @...: extra parameters for the message display
68 * Default handler for out of context error messages.
71 xmlGenericErrorDefaultFunc(void *ctx ATTRIBUTE_UNUSED, const char *msg, ...) {
74 if (xmlGenericErrorContext == NULL)
75 xmlGenericErrorContext = (void *) stderr;
78 vfprintf((FILE *)xmlGenericErrorContext, msg, args);
83 * initGenericErrorDefaultFunc:
84 * @handler: the handler
86 * Set or reset (if NULL) the default handler for generic errors
87 * to the builtin error function.
90 initGenericErrorDefaultFunc(xmlGenericErrorFunc * handler)
93 xmlGenericError = xmlGenericErrorDefaultFunc;
95 xmlGenericError = (*handler);
99 * xmlSetGenericErrorFunc:
100 * @ctx: the new error handling context
101 * @handler: the new handler function
103 * Function to reset the handler and the error context for out of
104 * context error messages.
105 * This simply means that @handler will be called for subsequent
106 * error messages while not parsing nor validating. And @ctx will
107 * be passed as first argument to @handler
108 * One can simply force messages to be emitted to another FILE * than
109 * stderr by setting @ctx to this file handle and @handler to NULL.
110 * For multi-threaded applications, this must be set separately for each thread.
113 xmlSetGenericErrorFunc(void *ctx, xmlGenericErrorFunc handler) {
114 xmlGenericErrorContext = ctx;
116 xmlGenericError = handler;
118 xmlGenericError = xmlGenericErrorDefaultFunc;
122 * xmlSetStructuredErrorFunc:
123 * @ctx: the new error handling context
124 * @handler: the new handler function
126 * Function to reset the handler and the error context for out of
127 * context structured error messages.
128 * This simply means that @handler will be called for subsequent
129 * error messages while not parsing nor validating. And @ctx will
130 * be passed as first argument to @handler
131 * For multi-threaded applications, this must be set separately for each thread.
134 xmlSetStructuredErrorFunc(void *ctx, xmlStructuredErrorFunc handler) {
135 xmlStructuredErrorContext = ctx;
136 xmlStructuredError = handler;
139 /************************************************************************
141 * Handling of parsing errors *
143 ************************************************************************/
146 * xmlParserPrintFileInfo:
147 * @input: an xmlParserInputPtr input
149 * Displays the associated file and line informations for the current input
153 xmlParserPrintFileInfo(xmlParserInputPtr input) {
156 xmlGenericError(xmlGenericErrorContext,
157 "%s:%d: ", input->filename,
160 xmlGenericError(xmlGenericErrorContext,
161 "Entity: line %d: ", input->line);
166 * xmlParserPrintFileContext:
167 * @input: an xmlParserInputPtr input
169 * Displays current context within the input content for error tracking
173 xmlParserPrintFileContextInternal(xmlParserInputPtr input ,
174 xmlGenericErrorFunc channel, void *data ) {
175 const xmlChar *cur, *base;
176 unsigned int n, col; /* GCC warns if signed, because compared with sizeof() */
177 xmlChar content[81]; /* space for 80 chars + line terminator */
180 if (input == NULL) return;
183 /* skip backwards over any end-of-lines */
184 while ((cur > base) && ((*(cur) == '\n') || (*(cur) == '\r'))) {
188 /* search backwards for beginning-of-line (to max buff size) */
189 while ((n++ < (sizeof(content)-1)) && (cur > base) &&
190 (*(cur) != '\n') && (*(cur) != '\r'))
192 if ((*(cur) == '\n') || (*(cur) == '\r')) cur++;
193 /* calculate the error position in terms of the current position */
194 col = input->cur - cur;
195 /* search forward for end-of-line (to max buff size) */
198 /* copy selected text to our buffer */
199 while ((*cur != 0) && (*(cur) != '\n') &&
200 (*(cur) != '\r') && (n < sizeof(content)-1)) {
205 /* print out the selected text */
206 channel(data ,"%s\n", content);
207 /* create blank line with problem pointer */
210 /* (leave buffer space for pointer + line terminator) */
211 while ((n<col) && (n++ < sizeof(content)-2) && (*ctnt != 0)) {
218 channel(data ,"%s\n", content);
222 * xmlParserPrintFileContext:
223 * @input: an xmlParserInputPtr input
225 * Displays current context within the input content for error tracking
228 xmlParserPrintFileContext(xmlParserInputPtr input) {
229 xmlParserPrintFileContextInternal(input, xmlGenericError,
230 xmlGenericErrorContext);
236 * @ctx: the parser context or NULL
237 * @str: the formatted error message
239 * Report an erro with its context, replace the 4 old error/warning
243 xmlReportError(xmlErrorPtr err, xmlParserCtxtPtr ctxt, const char *str,
244 xmlGenericErrorFunc channel, void *data)
250 const xmlChar *name = NULL;
253 xmlParserInputPtr input = NULL;
254 xmlParserInputPtr cur = NULL;
259 if (channel == NULL) {
260 channel = xmlGenericError;
261 data = xmlGenericErrorContext;
266 domain = err->domain;
270 if (code == XML_ERR_OK)
273 if ((node != NULL) && (node->type == XML_ELEMENT_NODE))
277 * Maintain the compatibility with the legacy error handling
281 if ((input != NULL) && (input->filename == NULL) &&
282 (ctxt->inputNr > 1)) {
284 input = ctxt->inputTab[ctxt->inputNr - 2];
288 channel(data, "%s:%d: ", input->filename, input->line);
289 else if ((line != 0) && (domain == XML_FROM_PARSER))
290 channel(data, "Entity: line %d: ", input->line);
294 channel(data, "%s:%d: ", file, line);
295 else if ((line != 0) && (domain == XML_FROM_PARSER))
296 channel(data, "Entity: line %d: ", line);
299 channel(data, "element %s: ", name);
302 case XML_FROM_PARSER:
303 channel(data, "parser ");
305 case XML_FROM_NAMESPACE:
306 channel(data, "namespace ");
310 channel(data, "validity ");
313 channel(data, "HTML parser ");
315 case XML_FROM_MEMORY:
316 channel(data, "memory ");
318 case XML_FROM_OUTPUT:
319 channel(data, "output ");
322 channel(data, "I/O ");
324 case XML_FROM_XINCLUDE:
325 channel(data, "XInclude ");
328 channel(data, "XPath ");
330 case XML_FROM_XPOINTER:
331 channel(data, "parser ");
333 case XML_FROM_REGEXP:
334 channel(data, "regexp ");
336 case XML_FROM_MODULE:
337 channel(data, "module ");
339 case XML_FROM_SCHEMASV:
340 channel(data, "Schemas validity ");
342 case XML_FROM_SCHEMASP:
343 channel(data, "Schemas parser ");
345 case XML_FROM_RELAXNGP:
346 channel(data, "Relax-NG parser ");
348 case XML_FROM_RELAXNGV:
349 channel(data, "Relax-NG validity ");
351 case XML_FROM_CATALOG:
352 channel(data, "Catalog ");
355 channel(data, "C14N ");
358 channel(data, "XSLT ");
361 channel(data, "encoding ");
370 case XML_ERR_WARNING:
371 channel(data, "warning : ");
374 channel(data, "error : ");
377 channel(data, "error : ");
382 len = xmlStrlen((const xmlChar *)str);
383 if ((len > 0) && (str[len - 1] != '\n'))
384 channel(data, "%s\n", str);
386 channel(data, "%s", str);
388 channel(data, "%s\n", "out of memory error");
392 xmlParserPrintFileContextInternal(input, channel, data);
395 channel(data, "%s:%d: \n", cur->filename, cur->line);
396 else if ((line != 0) && (domain == XML_FROM_PARSER))
397 channel(data, "Entity: line %d: \n", cur->line);
398 xmlParserPrintFileContextInternal(cur, channel, data);
401 if ((domain == XML_FROM_XPATH) && (err->str1 != NULL) &&
403 (err->int1 < xmlStrlen((const xmlChar *)err->str1))) {
407 channel(data, "%s\n", err->str1);
408 for (i=0;i < err->int1;i++)
412 channel(data, "%s\n", buf);
418 * @schannel: the structured callback channel
419 * @channel: the old callback channel
420 * @data: the callback data
421 * @ctx: the parser context or NULL
422 * @ctx: the parser context or NULL
423 * @domain: the domain for the error
424 * @code: the code for the error
425 * @level: the xmlErrorLevel for the error
426 * @file: the file source of the error (or NULL)
427 * @line: the line of the error or 0 if N/A
428 * @str1: extra string info
429 * @str2: extra string info
430 * @str3: extra string info
431 * @int1: extra int info
432 * @col: column number of the error or 0 if N/A
433 * @msg: the message to display/transmit
434 * @...: extra parameters for the message display
436 * Update the appropriate global or contextual error structure,
437 * then forward the error message down the parser or generic
438 * error callback handler
441 __xmlRaiseError(xmlStructuredErrorFunc schannel,
442 xmlGenericErrorFunc channel, void *data, void *ctx,
443 void *nod, int domain, int code, xmlErrorLevel level,
444 const char *file, int line, const char *str1,
445 const char *str2, const char *str3, int int1, int col,
446 const char *msg, ...)
448 xmlParserCtxtPtr ctxt = NULL;
449 xmlNodePtr node = (xmlNodePtr) nod;
451 xmlParserInputPtr input = NULL;
452 xmlErrorPtr to = &xmlLastError;
453 xmlNodePtr baseptr = NULL;
455 if ((xmlGetWarningsDefaultValue == 0) && (level == XML_ERR_WARNING))
457 if ((domain == XML_FROM_PARSER) || (domain == XML_FROM_HTML) ||
458 (domain == XML_FROM_DTD) || (domain == XML_FROM_NAMESPACE) ||
459 (domain == XML_FROM_IO) || (domain == XML_FROM_VALID)) {
460 ctxt = (xmlParserCtxtPtr) ctx;
461 if ((schannel == NULL) && (ctxt != NULL) && (ctxt->sax != NULL) &&
462 (ctxt->sax->initialized == XML_SAX2_MAGIC))
463 schannel = ctxt->sax->serror;
466 * Check if structured error handler set
468 if (schannel == NULL) {
469 schannel = xmlStructuredError;
471 * if user has defined handler, change data ptr to user's choice
473 if (schannel != NULL)
474 data = xmlStructuredErrorContext;
476 if ((domain == XML_FROM_VALID) &&
477 ((channel == xmlParserValidityError) ||
478 (channel == xmlParserValidityWarning))) {
479 ctxt = (xmlParserCtxtPtr) ctx;
480 if ((schannel == NULL) && (ctxt != NULL) && (ctxt->sax != NULL) &&
481 (ctxt->sax->initialized == XML_SAX2_MAGIC))
482 schannel = ctxt->sax->serror;
484 if (code == XML_ERR_OK)
487 * Formatting the message
490 str = (char *) xmlStrdup(BAD_CAST "No error message provided");
492 XML_GET_VAR_STR(msg, str);
496 * specific processing if a parser context is provided
501 if ((input != NULL) && (input->filename == NULL) &&
502 (ctxt->inputNr > 1)) {
503 input = ctxt->inputTab[ctxt->inputNr - 2];
506 file = input->filename;
511 to = &ctxt->lastError;
512 } else if ((node != NULL) && (file == NULL)) {
515 if ((node->doc != NULL) && (node->doc->URL != NULL)) {
517 /* file = (const char *) node->doc->URL; */
520 ((i < 10) && (node != NULL) && (node->type != XML_ELEMENT_NODE));
523 if ((baseptr == NULL) && (node != NULL) &&
524 (node->doc != NULL) && (node->doc->URL != NULL))
527 if ((node != NULL) && (node->type == XML_ELEMENT_NODE))
532 * Save the information about the error
540 to->file = (char *) xmlStrdup((const xmlChar *) file);
541 else if (baseptr != NULL) {
542 #ifdef LIBXML_XINCLUDE_ENABLED
544 * We check if the error is within an XInclude section and,
545 * if so, attempt to print out the href of the XInclude instead
546 * of the usual "base" (doc->URL) for the node (bug 152623).
548 xmlNodePtr prev = baseptr;
550 while (prev != NULL) {
551 if (prev->prev == NULL)
555 if (prev->type == XML_XINCLUDE_START) {
558 } else if (prev->type == XML_XINCLUDE_END)
563 if (prev->type == XML_XINCLUDE_START) {
564 prev->type = XML_ELEMENT_NODE;
565 to->file = (char *) xmlGetProp(prev, BAD_CAST "href");
566 prev->type = XML_XINCLUDE_START;
568 to->file = (char *) xmlGetProp(prev, BAD_CAST "href");
572 to->file = (char *) xmlStrdup(baseptr->doc->URL);
573 if ((to->file == NULL) && (node != NULL) && (node->doc != NULL)) {
574 to->file = (char *) xmlStrdup(node->doc->URL);
579 to->str1 = (char *) xmlStrdup((const xmlChar *) str1);
581 to->str2 = (char *) xmlStrdup((const xmlChar *) str2);
583 to->str3 = (char *) xmlStrdup((const xmlChar *) str3);
589 if (to != &xmlLastError)
590 xmlCopyError(to,&xmlLastError);
593 * Find the callback channel if channel param is NULL
595 if ((ctxt != NULL) && (channel == NULL) &&
596 (xmlStructuredError == NULL) && (ctxt->sax != NULL)) {
597 if (level == XML_ERR_WARNING)
598 channel = ctxt->sax->warning;
600 channel = ctxt->sax->error;
601 data = ctxt->userData;
602 } else if (channel == NULL) {
603 if ((schannel == NULL) && (xmlStructuredError != NULL)) {
604 schannel = xmlStructuredError;
605 data = xmlStructuredErrorContext;
607 channel = xmlGenericError;
609 data = xmlGenericErrorContext;
613 if (schannel != NULL) {
620 if ((channel == xmlParserError) ||
621 (channel == xmlParserWarning) ||
622 (channel == xmlParserValidityError) ||
623 (channel == xmlParserValidityWarning))
624 xmlReportError(to, ctxt, str, NULL, NULL);
625 else if ((channel == (xmlGenericErrorFunc) fprintf) ||
626 (channel == xmlGenericErrorDefaultFunc))
627 xmlReportError(to, ctxt, str, channel, data);
629 channel(data, "%s", str);
634 * @domain: where the error comes from
635 * @code: the error code
636 * @node: the context node
637 * @extra: extra informations
639 * Handle an out of memory condition
642 __xmlSimpleError(int domain, int code, xmlNodePtr node,
643 const char *msg, const char *extra)
646 if (code == XML_ERR_NO_MEMORY) {
648 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
649 XML_ERR_NO_MEMORY, XML_ERR_FATAL, NULL, 0, extra,
651 "Memory allocation failed : %s\n", extra);
653 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
654 XML_ERR_NO_MEMORY, XML_ERR_FATAL, NULL, 0, NULL,
655 NULL, NULL, 0, 0, "Memory allocation failed\n");
657 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
658 code, XML_ERR_ERROR, NULL, 0, extra,
659 NULL, NULL, 0, 0, msg, extra);
664 * @ctx: an XML parser context
665 * @msg: the message to display/transmit
666 * @...: extra parameters for the message display
668 * Display and format an error messages, gives file, line, position and
672 xmlParserError(void *ctx, const char *msg, ...)
674 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
675 xmlParserInputPtr input = NULL;
676 xmlParserInputPtr cur = NULL;
681 if ((input != NULL) && (input->filename == NULL) &&
682 (ctxt->inputNr > 1)) {
684 input = ctxt->inputTab[ctxt->inputNr - 2];
686 xmlParserPrintFileInfo(input);
689 xmlGenericError(xmlGenericErrorContext, "error: ");
690 XML_GET_VAR_STR(msg, str);
691 xmlGenericError(xmlGenericErrorContext, "%s", str);
696 xmlParserPrintFileContext(input);
698 xmlParserPrintFileInfo(cur);
699 xmlGenericError(xmlGenericErrorContext, "\n");
700 xmlParserPrintFileContext(cur);
707 * @ctx: an XML parser context
708 * @msg: the message to display/transmit
709 * @...: extra parameters for the message display
711 * Display and format a warning messages, gives file, line, position and
715 xmlParserWarning(void *ctx, const char *msg, ...)
717 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
718 xmlParserInputPtr input = NULL;
719 xmlParserInputPtr cur = NULL;
724 if ((input != NULL) && (input->filename == NULL) &&
725 (ctxt->inputNr > 1)) {
727 input = ctxt->inputTab[ctxt->inputNr - 2];
729 xmlParserPrintFileInfo(input);
732 xmlGenericError(xmlGenericErrorContext, "warning: ");
733 XML_GET_VAR_STR(msg, str);
734 xmlGenericError(xmlGenericErrorContext, "%s", str);
739 xmlParserPrintFileContext(input);
741 xmlParserPrintFileInfo(cur);
742 xmlGenericError(xmlGenericErrorContext, "\n");
743 xmlParserPrintFileContext(cur);
748 /************************************************************************
750 * Handling of validation errors *
752 ************************************************************************/
755 * xmlParserValidityError:
756 * @ctx: an XML parser context
757 * @msg: the message to display/transmit
758 * @...: extra parameters for the message display
760 * Display and format an validity error messages, gives file,
761 * line, position and extra parameters.
764 xmlParserValidityError(void *ctx, const char *msg, ...)
766 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
767 xmlParserInputPtr input = NULL;
769 int len = xmlStrlen((const xmlChar *) msg);
770 static int had_info = 0;
772 if ((len > 1) && (msg[len - 2] != ':')) {
775 if ((input->filename == NULL) && (ctxt->inputNr > 1))
776 input = ctxt->inputTab[ctxt->inputNr - 2];
779 xmlParserPrintFileInfo(input);
782 xmlGenericError(xmlGenericErrorContext, "validity error: ");
788 XML_GET_VAR_STR(msg, str);
789 xmlGenericError(xmlGenericErrorContext, "%s", str);
793 if ((ctxt != NULL) && (input != NULL)) {
794 xmlParserPrintFileContext(input);
799 * xmlParserValidityWarning:
800 * @ctx: an XML parser context
801 * @msg: the message to display/transmit
802 * @...: extra parameters for the message display
804 * Display and format a validity warning messages, gives file, line,
805 * position and extra parameters.
808 xmlParserValidityWarning(void *ctx, const char *msg, ...)
810 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
811 xmlParserInputPtr input = NULL;
813 int len = xmlStrlen((const xmlChar *) msg);
815 if ((ctxt != NULL) && (len != 0) && (msg[len - 1] != ':')) {
817 if ((input->filename == NULL) && (ctxt->inputNr > 1))
818 input = ctxt->inputTab[ctxt->inputNr - 2];
820 xmlParserPrintFileInfo(input);
823 xmlGenericError(xmlGenericErrorContext, "validity warning: ");
824 XML_GET_VAR_STR(msg, str);
825 xmlGenericError(xmlGenericErrorContext, "%s", str);
830 xmlParserPrintFileContext(input);
835 /************************************************************************
837 * Extended Error Handling *
839 ************************************************************************/
844 * Get the last global error registered. This is per thread if compiled
845 * with thread support.
847 * Returns NULL if no error occured or a pointer to the error
850 xmlGetLastError(void)
852 if (xmlLastError.code == XML_ERR_OK)
854 return (&xmlLastError);
859 * @err: pointer to the error.
864 xmlResetError(xmlErrorPtr err)
868 if (err->code == XML_ERR_OK)
870 if (err->message != NULL)
871 xmlFree(err->message);
872 if (err->file != NULL)
874 if (err->str1 != NULL)
876 if (err->str2 != NULL)
878 if (err->str3 != NULL)
880 memset(err, 0, sizeof(xmlError));
881 err->code = XML_ERR_OK;
887 * Cleanup the last global error registered. For parsing error
888 * this does not change the well-formedness result.
891 xmlResetLastError(void)
893 if (xmlLastError.code == XML_ERR_OK)
895 xmlResetError(&xmlLastError);
899 * xmlCtxtGetLastError:
900 * @ctx: an XML parser context
902 * Get the last parsing error registered.
904 * Returns NULL if no error occured or a pointer to the error
907 xmlCtxtGetLastError(void *ctx)
909 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
913 if (ctxt->lastError.code == XML_ERR_OK)
915 return (&ctxt->lastError);
919 * xmlCtxtResetLastError:
920 * @ctx: an XML parser context
922 * Cleanup the last global error registered. For parsing error
923 * this does not change the well-formedness result.
926 xmlCtxtResetLastError(void *ctx)
928 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
932 ctxt->errNo = XML_ERR_OK;
933 if (ctxt->lastError.code == XML_ERR_OK)
935 xmlResetError(&ctxt->lastError);
940 * @from: a source error
941 * @to: a target error
943 * Save the original error to the new place.
945 * Returns 0 in case of success and -1 in case of error.
948 xmlCopyError(xmlErrorPtr from, xmlErrorPtr to) {
949 char *message, *file, *str1, *str2, *str3;
951 if ((from == NULL) || (to == NULL))
954 message = (char *) xmlStrdup((xmlChar *) from->message);
955 file = (char *) xmlStrdup ((xmlChar *) from->file);
956 str1 = (char *) xmlStrdup ((xmlChar *) from->str1);
957 str2 = (char *) xmlStrdup ((xmlChar *) from->str2);
958 str3 = (char *) xmlStrdup ((xmlChar *) from->str3);
960 if (to->message != NULL)
961 xmlFree(to->message);
962 if (to->file != NULL)
964 if (to->str1 != NULL)
966 if (to->str2 != NULL)
968 if (to->str3 != NULL)
970 to->domain = from->domain;
971 to->code = from->code;
972 to->level = from->level;
973 to->line = from->line;
974 to->node = from->node;
975 to->int1 = from->int1;
976 to->int2 = from->int2;
977 to->node = from->node;
978 to->ctxt = from->ctxt;
979 to->message = message;
989 #include "elfgcchack.h"