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 (code == XML_ERR_OK)
457 if ((xmlGetWarningsDefaultValue == 0) && (level == XML_ERR_WARNING))
459 if ((domain == XML_FROM_PARSER) || (domain == XML_FROM_HTML) ||
460 (domain == XML_FROM_DTD) || (domain == XML_FROM_NAMESPACE) ||
461 (domain == XML_FROM_IO) || (domain == XML_FROM_VALID)) {
462 ctxt = (xmlParserCtxtPtr) ctx;
463 if ((schannel == NULL) && (ctxt != NULL) && (ctxt->sax != NULL) &&
464 (ctxt->sax->initialized == XML_SAX2_MAGIC) &&
465 (ctxt->sax->serror != NULL)) {
466 schannel = ctxt->sax->serror;
467 data = ctxt->userData;
471 * Check if structured error handler set
473 if (schannel == NULL) {
474 schannel = xmlStructuredError;
476 * if user has defined handler, change data ptr to user's choice
478 if (schannel != NULL)
479 data = xmlStructuredErrorContext;
482 * Formatting the message
485 str = (char *) xmlStrdup(BAD_CAST "No error message provided");
487 XML_GET_VAR_STR(msg, str);
491 * specific processing if a parser context is provided
496 if ((input != NULL) && (input->filename == NULL) &&
497 (ctxt->inputNr > 1)) {
498 input = ctxt->inputTab[ctxt->inputNr - 2];
501 file = input->filename;
506 to = &ctxt->lastError;
507 } else if ((node != NULL) && (file == NULL)) {
510 if ((node->doc != NULL) && (node->doc->URL != NULL)) {
512 /* file = (const char *) node->doc->URL; */
515 ((i < 10) && (node != NULL) && (node->type != XML_ELEMENT_NODE));
518 if ((baseptr == NULL) && (node != NULL) &&
519 (node->doc != NULL) && (node->doc->URL != NULL))
522 if ((node != NULL) && (node->type == XML_ELEMENT_NODE))
527 * Save the information about the error
535 to->file = (char *) xmlStrdup((const xmlChar *) file);
536 else if (baseptr != NULL) {
537 #ifdef LIBXML_XINCLUDE_ENABLED
539 * We check if the error is within an XInclude section and,
540 * if so, attempt to print out the href of the XInclude instead
541 * of the usual "base" (doc->URL) for the node (bug 152623).
543 xmlNodePtr prev = baseptr;
545 while (prev != NULL) {
546 if (prev->prev == NULL)
550 if (prev->type == XML_XINCLUDE_START) {
553 } else if (prev->type == XML_XINCLUDE_END)
558 if (prev->type == XML_XINCLUDE_START) {
559 prev->type = XML_ELEMENT_NODE;
560 to->file = (char *) xmlGetProp(prev, BAD_CAST "href");
561 prev->type = XML_XINCLUDE_START;
563 to->file = (char *) xmlGetProp(prev, BAD_CAST "href");
567 to->file = (char *) xmlStrdup(baseptr->doc->URL);
568 if ((to->file == NULL) && (node != NULL) && (node->doc != NULL)) {
569 to->file = (char *) xmlStrdup(node->doc->URL);
574 to->str1 = (char *) xmlStrdup((const xmlChar *) str1);
576 to->str2 = (char *) xmlStrdup((const xmlChar *) str2);
578 to->str3 = (char *) xmlStrdup((const xmlChar *) str3);
584 if (to != &xmlLastError)
585 xmlCopyError(to,&xmlLastError);
587 if (schannel != NULL) {
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 channel = xmlGenericError;
605 data = xmlGenericErrorContext;
610 if ((channel == xmlParserError) ||
611 (channel == xmlParserWarning) ||
612 (channel == xmlParserValidityError) ||
613 (channel == xmlParserValidityWarning))
614 xmlReportError(to, ctxt, str, NULL, NULL);
615 else if ((channel == (xmlGenericErrorFunc) fprintf) ||
616 (channel == xmlGenericErrorDefaultFunc))
617 xmlReportError(to, ctxt, str, channel, data);
619 channel(data, "%s", str);
624 * @domain: where the error comes from
625 * @code: the error code
626 * @node: the context node
627 * @extra: extra informations
629 * Handle an out of memory condition
632 __xmlSimpleError(int domain, int code, xmlNodePtr node,
633 const char *msg, const char *extra)
636 if (code == XML_ERR_NO_MEMORY) {
638 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
639 XML_ERR_NO_MEMORY, XML_ERR_FATAL, NULL, 0, extra,
641 "Memory allocation failed : %s\n", extra);
643 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
644 XML_ERR_NO_MEMORY, XML_ERR_FATAL, NULL, 0, NULL,
645 NULL, NULL, 0, 0, "Memory allocation failed\n");
647 __xmlRaiseError(NULL, NULL, NULL, NULL, node, domain,
648 code, XML_ERR_ERROR, NULL, 0, extra,
649 NULL, NULL, 0, 0, msg, extra);
654 * @ctx: an XML parser context
655 * @msg: the message to display/transmit
656 * @...: extra parameters for the message display
658 * Display and format an error messages, gives file, line, position and
662 xmlParserError(void *ctx, const char *msg, ...)
664 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
665 xmlParserInputPtr input = NULL;
666 xmlParserInputPtr cur = NULL;
671 if ((input != NULL) && (input->filename == NULL) &&
672 (ctxt->inputNr > 1)) {
674 input = ctxt->inputTab[ctxt->inputNr - 2];
676 xmlParserPrintFileInfo(input);
679 xmlGenericError(xmlGenericErrorContext, "error: ");
680 XML_GET_VAR_STR(msg, str);
681 xmlGenericError(xmlGenericErrorContext, "%s", str);
686 xmlParserPrintFileContext(input);
688 xmlParserPrintFileInfo(cur);
689 xmlGenericError(xmlGenericErrorContext, "\n");
690 xmlParserPrintFileContext(cur);
697 * @ctx: an XML parser context
698 * @msg: the message to display/transmit
699 * @...: extra parameters for the message display
701 * Display and format a warning messages, gives file, line, position and
705 xmlParserWarning(void *ctx, const char *msg, ...)
707 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
708 xmlParserInputPtr input = NULL;
709 xmlParserInputPtr cur = NULL;
714 if ((input != NULL) && (input->filename == NULL) &&
715 (ctxt->inputNr > 1)) {
717 input = ctxt->inputTab[ctxt->inputNr - 2];
719 xmlParserPrintFileInfo(input);
722 xmlGenericError(xmlGenericErrorContext, "warning: ");
723 XML_GET_VAR_STR(msg, str);
724 xmlGenericError(xmlGenericErrorContext, "%s", str);
729 xmlParserPrintFileContext(input);
731 xmlParserPrintFileInfo(cur);
732 xmlGenericError(xmlGenericErrorContext, "\n");
733 xmlParserPrintFileContext(cur);
738 /************************************************************************
740 * Handling of validation errors *
742 ************************************************************************/
745 * xmlParserValidityError:
746 * @ctx: an XML parser context
747 * @msg: the message to display/transmit
748 * @...: extra parameters for the message display
750 * Display and format an validity error messages, gives file,
751 * line, position and extra parameters.
754 xmlParserValidityError(void *ctx, const char *msg, ...)
756 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
757 xmlParserInputPtr input = NULL;
759 int len = xmlStrlen((const xmlChar *) msg);
760 static int had_info = 0;
762 if ((len > 1) && (msg[len - 2] != ':')) {
765 if ((input->filename == NULL) && (ctxt->inputNr > 1))
766 input = ctxt->inputTab[ctxt->inputNr - 2];
769 xmlParserPrintFileInfo(input);
772 xmlGenericError(xmlGenericErrorContext, "validity error: ");
778 XML_GET_VAR_STR(msg, str);
779 xmlGenericError(xmlGenericErrorContext, "%s", str);
783 if ((ctxt != NULL) && (input != NULL)) {
784 xmlParserPrintFileContext(input);
789 * xmlParserValidityWarning:
790 * @ctx: an XML parser context
791 * @msg: the message to display/transmit
792 * @...: extra parameters for the message display
794 * Display and format a validity warning messages, gives file, line,
795 * position and extra parameters.
798 xmlParserValidityWarning(void *ctx, const char *msg, ...)
800 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
801 xmlParserInputPtr input = NULL;
803 int len = xmlStrlen((const xmlChar *) msg);
805 if ((ctxt != NULL) && (len != 0) && (msg[len - 1] != ':')) {
807 if ((input->filename == NULL) && (ctxt->inputNr > 1))
808 input = ctxt->inputTab[ctxt->inputNr - 2];
810 xmlParserPrintFileInfo(input);
813 xmlGenericError(xmlGenericErrorContext, "validity warning: ");
814 XML_GET_VAR_STR(msg, str);
815 xmlGenericError(xmlGenericErrorContext, "%s", str);
820 xmlParserPrintFileContext(input);
825 /************************************************************************
827 * Extended Error Handling *
829 ************************************************************************/
834 * Get the last global error registered. This is per thread if compiled
835 * with thread support.
837 * Returns NULL if no error occured or a pointer to the error
840 xmlGetLastError(void)
842 if (xmlLastError.code == XML_ERR_OK)
844 return (&xmlLastError);
849 * @err: pointer to the error.
854 xmlResetError(xmlErrorPtr err)
858 if (err->code == XML_ERR_OK)
860 if (err->message != NULL)
861 xmlFree(err->message);
862 if (err->file != NULL)
864 if (err->str1 != NULL)
866 if (err->str2 != NULL)
868 if (err->str3 != NULL)
870 memset(err, 0, sizeof(xmlError));
871 err->code = XML_ERR_OK;
877 * Cleanup the last global error registered. For parsing error
878 * this does not change the well-formedness result.
881 xmlResetLastError(void)
883 if (xmlLastError.code == XML_ERR_OK)
885 xmlResetError(&xmlLastError);
889 * xmlCtxtGetLastError:
890 * @ctx: an XML parser context
892 * Get the last parsing error registered.
894 * Returns NULL if no error occured or a pointer to the error
897 xmlCtxtGetLastError(void *ctx)
899 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
903 if (ctxt->lastError.code == XML_ERR_OK)
905 return (&ctxt->lastError);
909 * xmlCtxtResetLastError:
910 * @ctx: an XML parser context
912 * Cleanup the last global error registered. For parsing error
913 * this does not change the well-formedness result.
916 xmlCtxtResetLastError(void *ctx)
918 xmlParserCtxtPtr ctxt = (xmlParserCtxtPtr) ctx;
922 ctxt->errNo = XML_ERR_OK;
923 if (ctxt->lastError.code == XML_ERR_OK)
925 xmlResetError(&ctxt->lastError);
930 * @from: a source error
931 * @to: a target error
933 * Save the original error to the new place.
935 * Returns 0 in case of success and -1 in case of error.
938 xmlCopyError(xmlErrorPtr from, xmlErrorPtr to) {
939 char *message, *file, *str1, *str2, *str3;
941 if ((from == NULL) || (to == NULL))
944 message = (char *) xmlStrdup((xmlChar *) from->message);
945 file = (char *) xmlStrdup ((xmlChar *) from->file);
946 str1 = (char *) xmlStrdup ((xmlChar *) from->str1);
947 str2 = (char *) xmlStrdup ((xmlChar *) from->str2);
948 str3 = (char *) xmlStrdup ((xmlChar *) from->str3);
950 if (to->message != NULL)
951 xmlFree(to->message);
952 if (to->file != NULL)
954 if (to->str1 != NULL)
956 if (to->str2 != NULL)
958 if (to->str3 != NULL)
960 to->domain = from->domain;
961 to->code = from->code;
962 to->level = from->level;
963 to->line = from->line;
964 to->node = from->node;
965 to->int1 = from->int1;
966 to->int2 = from->int2;
967 to->node = from->node;
968 to->ctxt = from->ctxt;
969 to->message = message;
979 #include "elfgcchack.h"