1 /* Language-independent diagnostic subroutines for the GNU Compiler Collection
2 Copyright (C) 1999-2013 Free Software Foundation, Inc.
3 Contributed by Gabriel Dos Reis <gdr@codesourcery.com>
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 3, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
22 /* This file implements the language independent aspect of diagnostic
27 #include "coretypes.h"
32 #include "backtrace.h"
33 #include "diagnostic.h"
35 #define pedantic_warning_kind(DC) \
36 ((DC)->pedantic_errors ? DK_ERROR : DK_WARNING)
37 #define permissive_error_kind(DC) ((DC)->permissive ? DK_WARNING : DK_ERROR)
38 #define permissive_error_option(DC) ((DC)->opt_permissive)
41 static char *build_message_string (const char *, ...) ATTRIBUTE_PRINTF_1;
43 static void error_recursion (diagnostic_context *) ATTRIBUTE_NORETURN;
45 static void diagnostic_action_after_output (diagnostic_context *,
47 static void real_abort (void) ATTRIBUTE_NORETURN;
49 /* Name of program invoked, sans directories. */
53 /* A diagnostic_context surrogate for stderr. */
54 static diagnostic_context global_diagnostic_context;
55 diagnostic_context *global_dc = &global_diagnostic_context;
58 /* Return a malloc'd string containing MSG formatted a la printf. The
59 caller is responsible for freeing the memory. */
61 build_message_string (const char *msg, ...)
67 vasprintf (&str, msg, ap);
73 /* Same as diagnostic_build_prefix, but only the source FILE is given. */
75 file_name_as_prefix (const char *f)
77 return build_message_string ("%s: ", f);
82 /* Return the value of the getenv("COLUMNS") as an integer. If the
83 value is not set to a positive integer, then return INT_MAX. */
87 const char * s = getenv ("COLUMNS");
96 /* Set caret_max_width to value. */
98 diagnostic_set_caret_max_width (diagnostic_context *context, int value)
100 /* One minus to account for the leading empty space. */
101 value = value ? value - 1
102 : (isatty (fileno (context->printer->buffer->stream))
103 ? getenv_columns () - 1: INT_MAX);
108 context->caret_max_width = value;
111 /* Initialize the diagnostic message outputting machinery. */
113 diagnostic_initialize (diagnostic_context *context, int n_opts)
117 /* Allocate a basic pretty-printer. Clients will replace this a
118 much more elaborated pretty-printer if they wish. */
119 context->printer = XNEW (pretty_printer);
120 pp_construct (context->printer, NULL, 0);
121 /* By default, diagnostics are sent to stderr. */
122 context->printer->buffer->stream = stderr;
123 /* By default, we emit prefixes once per message. */
124 context->printer->wrapping.rule = DIAGNOSTICS_SHOW_PREFIX_ONCE;
126 memset (context->diagnostic_count, 0, sizeof context->diagnostic_count);
127 context->some_warnings_are_errors = false;
128 context->warning_as_error_requested = false;
129 context->n_opts = n_opts;
130 context->classify_diagnostic = XNEWVEC (diagnostic_t, n_opts);
131 for (i = 0; i < n_opts; i++)
132 context->classify_diagnostic[i] = DK_UNSPECIFIED;
133 context->show_caret = false;
134 diagnostic_set_caret_max_width (context, pp_line_cutoff (context->printer));
135 context->show_option_requested = false;
136 context->abort_on_error = false;
137 context->show_column = false;
138 context->pedantic_errors = false;
139 context->permissive = false;
140 context->opt_permissive = 0;
141 context->fatal_errors = false;
142 context->dc_inhibit_warnings = false;
143 context->dc_warn_system_headers = false;
144 context->max_errors = 0;
145 context->internal_error = NULL;
146 diagnostic_starter (context) = default_diagnostic_starter;
147 diagnostic_finalizer (context) = default_diagnostic_finalizer;
148 context->option_enabled = NULL;
149 context->option_state = NULL;
150 context->option_name = NULL;
151 context->last_location = UNKNOWN_LOCATION;
152 context->last_module = 0;
153 context->x_data = NULL;
155 context->inhibit_notes_p = false;
158 /* Do any cleaning up required after the last diagnostic is emitted. */
161 diagnostic_finish (diagnostic_context *context)
163 /* Some of the errors may actually have been warnings. */
164 if (context->some_warnings_are_errors)
166 /* -Werror was given. */
167 if (context->warning_as_error_requested)
168 pp_verbatim (context->printer,
169 _("%s: all warnings being treated as errors"),
171 /* At least one -Werror= was given. */
173 pp_verbatim (context->printer,
174 _("%s: some warnings being treated as errors"),
176 pp_newline_and_flush (context->printer);
180 /* Initialize DIAGNOSTIC, where the message MSG has already been
183 diagnostic_set_info_translated (diagnostic_info *diagnostic, const char *msg,
184 va_list *args, location_t location,
187 diagnostic->message.err_no = errno;
188 diagnostic->message.args_ptr = args;
189 diagnostic->message.format_spec = msg;
190 diagnostic->location = location;
191 diagnostic->override_column = 0;
192 diagnostic->kind = kind;
193 diagnostic->option_index = 0;
196 /* Initialize DIAGNOSTIC, where the message GMSGID has not yet been
199 diagnostic_set_info (diagnostic_info *diagnostic, const char *gmsgid,
200 va_list *args, location_t location,
203 diagnostic_set_info_translated (diagnostic, _(gmsgid), args, location, kind);
206 /* Return a malloc'd string describing a location. The caller is
207 responsible for freeing the memory. */
209 diagnostic_build_prefix (diagnostic_context *context,
210 const diagnostic_info *diagnostic)
212 static const char *const diagnostic_kind_text[] = {
213 #define DEFINE_DIAGNOSTIC_KIND(K, T) (T),
214 #include "diagnostic.def"
215 #undef DEFINE_DIAGNOSTIC_KIND
218 const char *text = _(diagnostic_kind_text[diagnostic->kind]);
219 expanded_location s = expand_location_to_spelling_point (diagnostic->location);
220 if (diagnostic->override_column)
221 s.column = diagnostic->override_column;
222 gcc_assert (diagnostic->kind < DK_LAST_DIAGNOSTIC_KIND);
226 ? build_message_string ("%s: %s", progname, text)
227 : context->show_column
228 ? build_message_string ("%s:%d:%d: %s", s.file, s.line, s.column, text)
229 : build_message_string ("%s:%d: %s", s.file, s.line, text));
232 /* If LINE is longer than MAX_WIDTH, and COLUMN is not smaller than
233 MAX_WIDTH by some margin, then adjust the start of the line such
234 that the COLUMN is smaller than MAX_WIDTH minus the margin. The
235 margin is either 10 characters or the difference between the column
236 and the length of the line, whatever is smaller. */
238 adjust_line (const char *line, int max_width, int *column_p)
240 int right_margin = 10;
241 int line_width = strlen (line);
242 int column = *column_p;
244 right_margin = MIN(line_width - column, right_margin);
245 right_margin = max_width - right_margin;
246 if (line_width >= max_width && column > right_margin)
248 line += column - right_margin;
249 *column_p = right_margin;
254 /* Print the physical source line corresponding to the location of
255 this diagnostics, and a caret indicating the precise column. */
257 diagnostic_show_locus (diagnostic_context * context,
258 const diagnostic_info *diagnostic)
264 const char *saved_prefix;
267 if (!context->show_caret
268 || diagnostic->location <= BUILTINS_LOCATION
269 || diagnostic->location == context->last_location)
272 context->last_location = diagnostic->location;
273 s = expand_location_to_spelling_point (diagnostic->location);
274 line = location_get_source_line (s);
278 max_width = context->caret_max_width;
279 line = adjust_line (line, max_width, &(s.column));
281 pp_newline (context->printer);
282 saved_prefix = pp_get_prefix (context->printer);
283 pp_set_prefix (context->printer, NULL);
284 pp_character (context->printer, ' ');
285 while (max_width > 0 && *line != '\0')
287 char c = *line == '\t' ? ' ' : *line;
288 pp_character (context->printer, c);
292 pp_newline (context->printer);
293 /* pp_printf does not implement %*c. */
294 buffer = XALLOCAVEC (char, s.column + 3);
295 snprintf (buffer, s.column + 3, " %*c", s.column, '^');
296 pp_string (context->printer, buffer);
297 pp_set_prefix (context->printer, saved_prefix);
300 /* Functions at which to stop the backtrace print. It's not
301 particularly helpful to print the callers of these functions. */
303 static const char * const bt_stop[] =
311 /* A callback function passed to the backtrace_full function. */
314 bt_callback (void *data, uintptr_t pc, const char *filename, int lineno,
315 const char *function)
317 int *pcount = (int *) data;
319 /* If we don't have any useful information, don't print
321 if (filename == NULL && function == NULL)
324 /* Skip functions in diagnostic.c. */
327 && strcmp (lbasename(filename), "diagnostic.c") == 0)
330 /* Print up to 20 functions. We could make this a --param, but
331 since this is only for debugging just use a constant for now. */
334 /* Returning a non-zero value stops the backtrace. */
340 if (function != NULL)
342 char *str = cplus_demangle_v3 (function,
343 (DMGL_VERBOSE | DMGL_ANSI
344 | DMGL_GNU_V3 | DMGL_PARAMS));
351 for (size_t i = 0; i < ARRAY_SIZE (bt_stop); ++i)
353 size_t len = strlen (bt_stop[i]);
354 if (strncmp (function, bt_stop[i], len) == 0
355 && (function[len] == '\0' || function[len] == '('))
359 /* Returning a non-zero value stops the backtrace. */
365 fprintf (stderr, "0x%lx %s\n\t%s:%d\n",
367 function == NULL ? "???" : function,
368 filename == NULL ? "???" : filename,
377 /* A callback function passed to the backtrace_full function. This is
378 called if backtrace_full has an error. */
381 bt_err_callback (void *data ATTRIBUTE_UNUSED, const char *msg, int errnum)
385 /* This means that no debug info was available. Just quietly
386 skip printing backtrace info. */
389 fprintf (stderr, "%s%s%s\n", msg, errnum == 0 ? "" : ": ",
390 errnum == 0 ? "" : xstrerror (errnum));
393 /* Take any action which is expected to happen after the diagnostic
394 is written out. This function does not always return. */
396 diagnostic_action_after_output (diagnostic_context *context,
397 diagnostic_info *diagnostic)
399 switch (diagnostic->kind)
409 if (context->abort_on_error)
411 if (context->fatal_errors)
413 fnotice (stderr, "compilation terminated due to -Wfatal-errors.\n");
414 diagnostic_finish (context);
415 exit (FATAL_EXIT_CODE);
417 if (context->max_errors != 0
418 && ((unsigned) (diagnostic_kind_count (context, DK_ERROR)
419 + diagnostic_kind_count (context, DK_SORRY))
420 >= context->max_errors))
423 "compilation terminated due to -fmax-errors=%u.\n",
424 context->max_errors);
425 diagnostic_finish (context);
426 exit (FATAL_EXIT_CODE);
432 struct backtrace_state *state =
433 backtrace_create_state (NULL, 0, bt_err_callback, NULL);
436 backtrace_full (state, 2, bt_callback, bt_err_callback,
439 if (context->abort_on_error)
442 fnotice (stderr, "Please submit a full bug report,\n"
443 "with preprocessed source if appropriate.\n");
446 ("Please include the complete backtrace "
447 "with any bug report.\n"));
448 fnotice (stderr, "See %s for instructions.\n", bug_report_url);
450 exit (ICE_EXIT_CODE);
454 if (context->abort_on_error)
456 diagnostic_finish (context);
457 fnotice (stderr, "compilation terminated.\n");
458 exit (FATAL_EXIT_CODE);
466 diagnostic_report_current_module (diagnostic_context *context, location_t where)
468 const struct line_map *map = NULL;
470 if (pp_needs_newline (context->printer))
472 pp_newline (context->printer);
473 pp_needs_newline (context->printer) = false;
476 if (where <= BUILTINS_LOCATION)
479 linemap_resolve_location (line_table, where,
480 LRK_MACRO_DEFINITION_LOCATION,
483 if (map && diagnostic_last_module_changed (context, map))
485 diagnostic_set_last_module (context, map);
486 if (! MAIN_FILE_P (map))
488 map = INCLUDED_FROM (line_table, map);
489 if (context->show_column)
490 pp_verbatim (context->printer,
491 "In file included from %s:%d:%d",
493 LAST_SOURCE_LINE (map), LAST_SOURCE_COLUMN (map));
495 pp_verbatim (context->printer,
496 "In file included from %s:%d",
497 LINEMAP_FILE (map), LAST_SOURCE_LINE (map));
498 while (! MAIN_FILE_P (map))
500 map = INCLUDED_FROM (line_table, map);
501 pp_verbatim (context->printer,
503 LINEMAP_FILE (map), LAST_SOURCE_LINE (map));
505 pp_verbatim (context->printer, ":");
506 pp_newline (context->printer);
512 default_diagnostic_starter (diagnostic_context *context,
513 diagnostic_info *diagnostic)
515 diagnostic_report_current_module (context, diagnostic->location);
516 pp_set_prefix (context->printer, diagnostic_build_prefix (context,
521 default_diagnostic_finalizer (diagnostic_context *context ATTRIBUTE_UNUSED,
522 diagnostic_info *diagnostic ATTRIBUTE_UNUSED)
526 /* Interface to specify diagnostic kind overrides. Returns the
527 previous setting, or DK_UNSPECIFIED if the parameters are out of
530 diagnostic_classify_diagnostic (diagnostic_context *context,
532 diagnostic_t new_kind,
535 diagnostic_t old_kind;
537 if (option_index <= 0
538 || option_index >= context->n_opts
539 || new_kind >= DK_LAST_DIAGNOSTIC_KIND)
540 return DK_UNSPECIFIED;
542 old_kind = context->classify_diagnostic[option_index];
544 /* Handle pragmas separately, since we need to keep track of *where*
546 if (where != UNKNOWN_LOCATION)
550 for (i = context->n_classification_history - 1; i >= 0; i --)
551 if (context->classification_history[i].option == option_index)
553 old_kind = context->classification_history[i].kind;
557 i = context->n_classification_history;
558 context->classification_history =
559 (diagnostic_classification_change_t *) xrealloc (context->classification_history, (i + 1)
560 * sizeof (diagnostic_classification_change_t));
561 context->classification_history[i].location = where;
562 context->classification_history[i].option = option_index;
563 context->classification_history[i].kind = new_kind;
564 context->n_classification_history ++;
567 context->classify_diagnostic[option_index] = new_kind;
572 /* Save all diagnostic classifications in a stack. */
574 diagnostic_push_diagnostics (diagnostic_context *context, location_t where ATTRIBUTE_UNUSED)
576 context->push_list = (int *) xrealloc (context->push_list, (context->n_push + 1) * sizeof (int));
577 context->push_list[context->n_push ++] = context->n_classification_history;
580 /* Restore the topmost classification set off the stack. If the stack
581 is empty, revert to the state based on command line parameters. */
583 diagnostic_pop_diagnostics (diagnostic_context *context, location_t where)
589 jump_to = context->push_list [-- context->n_push];
593 i = context->n_classification_history;
594 context->classification_history =
595 (diagnostic_classification_change_t *) xrealloc (context->classification_history, (i + 1)
596 * sizeof (diagnostic_classification_change_t));
597 context->classification_history[i].location = where;
598 context->classification_history[i].option = jump_to;
599 context->classification_history[i].kind = DK_POP;
600 context->n_classification_history ++;
603 /* Report a diagnostic message (an error or a warning) as specified by
604 DC. This function is *the* subroutine in terms of which front-ends
605 should implement their specific diagnostic handling modules. The
606 front-end independent format specifiers are exactly those described
607 in the documentation of output_format.
608 Return true if a diagnostic was printed, false otherwise. */
611 diagnostic_report_diagnostic (diagnostic_context *context,
612 diagnostic_info *diagnostic)
614 location_t location = diagnostic->location;
615 diagnostic_t orig_diag_kind = diagnostic->kind;
616 const char *saved_format_spec;
618 /* Give preference to being able to inhibit warnings, before they
619 get reclassified to something else. */
620 if ((diagnostic->kind == DK_WARNING || diagnostic->kind == DK_PEDWARN)
621 && !diagnostic_report_warnings_p (context, location))
624 if (diagnostic->kind == DK_PEDWARN)
626 diagnostic->kind = pedantic_warning_kind (context);
627 /* We do this to avoid giving the message for -pedantic-errors. */
628 orig_diag_kind = diagnostic->kind;
631 if (diagnostic->kind == DK_NOTE && context->inhibit_notes_p)
634 if (context->lock > 0)
636 /* If we're reporting an ICE in the middle of some other error,
637 try to flush out the previous error, then let this one
638 through. Don't do this more than once. */
639 if (diagnostic->kind == DK_ICE && context->lock == 1)
640 pp_newline_and_flush (context->printer);
642 error_recursion (context);
645 /* If the user requested that warnings be treated as errors, so be
646 it. Note that we do this before the next block so that
647 individual warnings can be overridden back to warnings with
649 if (context->warning_as_error_requested
650 && diagnostic->kind == DK_WARNING)
652 diagnostic->kind = DK_ERROR;
655 if (diagnostic->option_index
656 && diagnostic->option_index != permissive_error_option (context))
658 diagnostic_t diag_class = DK_UNSPECIFIED;
660 /* This tests if the user provided the appropriate -Wfoo or
662 if (! context->option_enabled (diagnostic->option_index,
663 context->option_state))
666 /* This tests for #pragma diagnostic changes. */
667 if (context->n_classification_history > 0)
670 /* FIXME: Stupid search. Optimize later. */
671 for (i = context->n_classification_history - 1; i >= 0; i --)
673 if (linemap_location_before_p
675 context->classification_history[i].location,
678 if (context->classification_history[i].kind == (int) DK_POP)
680 i = context->classification_history[i].option;
683 if (context->classification_history[i].option == diagnostic->option_index)
685 diag_class = context->classification_history[i].kind;
686 if (diag_class != DK_UNSPECIFIED)
687 diagnostic->kind = diag_class;
693 /* This tests if the user provided the appropriate -Werror=foo
695 if (diag_class == DK_UNSPECIFIED
696 && context->classify_diagnostic[diagnostic->option_index] != DK_UNSPECIFIED)
698 diagnostic->kind = context->classify_diagnostic[diagnostic->option_index];
700 /* This allows for future extensions, like temporarily disabling
701 warnings for ranges of source code. */
702 if (diagnostic->kind == DK_IGNORED)
706 if (orig_diag_kind == DK_WARNING && diagnostic->kind == DK_ERROR)
707 context->some_warnings_are_errors = true;
711 if (diagnostic->kind == DK_ICE)
713 #ifndef ENABLE_CHECKING
714 /* When not checking, ICEs are converted to fatal errors when an
715 error has already occurred. This is counteracted by
717 if ((diagnostic_kind_count (context, DK_ERROR) > 0
718 || diagnostic_kind_count (context, DK_SORRY) > 0)
719 && !context->abort_on_error)
721 expanded_location s = expand_location (diagnostic->location);
722 fnotice (stderr, "%s:%d: confused by earlier errors, bailing out\n",
724 exit (ICE_EXIT_CODE);
727 if (context->internal_error)
728 (*context->internal_error) (context,
729 diagnostic->message.format_spec,
730 diagnostic->message.args_ptr);
732 ++diagnostic_kind_count (context, diagnostic->kind);
734 saved_format_spec = diagnostic->message.format_spec;
735 if (context->show_option_requested)
739 option_text = context->option_name (context, diagnostic->option_index,
740 orig_diag_kind, diagnostic->kind);
744 diagnostic->message.format_spec
745 = ACONCAT ((diagnostic->message.format_spec,
747 "[", option_text, "]",
752 diagnostic->message.locus = &diagnostic->location;
753 diagnostic->message.x_data = &diagnostic->x_data;
754 diagnostic->x_data = NULL;
755 pp_format (context->printer, &diagnostic->message);
756 (*diagnostic_starter (context)) (context, diagnostic);
757 pp_output_formatted_text (context->printer);
758 diagnostic_show_locus (context, diagnostic);
759 (*diagnostic_finalizer (context)) (context, diagnostic);
760 pp_destroy_prefix (context->printer);
761 pp_newline_and_flush (context->printer);
762 diagnostic_action_after_output (context, diagnostic);
763 diagnostic->message.format_spec = saved_format_spec;
764 diagnostic->x_data = NULL;
771 /* Given a partial pathname as input, return another pathname that
772 shares no directory elements with the pathname of __FILE__. This
773 is used by fancy_abort() to print `Internal compiler error in expr.c'
774 instead of `Internal compiler error in ../../GCC/gcc/expr.c'. */
777 trim_filename (const char *name)
779 static const char this_file[] = __FILE__;
780 const char *p = name, *q = this_file;
782 /* First skip any "../" in each filename. This allows us to give a proper
783 reference to a file in a subdirectory. */
784 while (p[0] == '.' && p[1] == '.' && IS_DIR_SEPARATOR (p[2]))
787 while (q[0] == '.' && q[1] == '.' && IS_DIR_SEPARATOR (q[2]))
790 /* Now skip any parts the two filenames have in common. */
791 while (*p == *q && *p != 0 && *q != 0)
794 /* Now go backwards until the previous directory separator. */
795 while (p > name && !IS_DIR_SEPARATOR (p[-1]))
801 /* Standard error reporting routines in increasing order of severity.
802 All of these take arguments like printf. */
804 /* Text to be emitted verbatim to the error message stream; this
805 produces no prefix and disables line-wrapping. Use rarely. */
807 verbatim (const char *gmsgid, ...)
812 va_start (ap, gmsgid);
815 text.format_spec = _(gmsgid);
818 pp_format_verbatim (global_dc->printer, &text);
819 pp_newline_and_flush (global_dc->printer);
823 /* Add a note with text GMSGID and with LOCATION to the diagnostic CONTEXT. */
825 diagnostic_append_note (diagnostic_context *context,
827 const char * gmsgid, ...)
829 diagnostic_info diagnostic;
831 const char *saved_prefix;
833 va_start (ap, gmsgid);
834 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_NOTE);
835 if (context->inhibit_notes_p)
840 saved_prefix = pp_get_prefix (context->printer);
841 pp_set_prefix (context->printer,
842 diagnostic_build_prefix (context, &diagnostic));
843 pp_newline (context->printer);
844 pp_format (context->printer, &diagnostic.message);
845 pp_output_formatted_text (context->printer);
846 pp_destroy_prefix (context->printer);
847 pp_set_prefix (context->printer, saved_prefix);
848 diagnostic_show_locus (context, &diagnostic);
853 emit_diagnostic (diagnostic_t kind, location_t location, int opt,
854 const char *gmsgid, ...)
856 diagnostic_info diagnostic;
860 va_start (ap, gmsgid);
861 if (kind == DK_PERMERROR)
863 diagnostic_set_info (&diagnostic, gmsgid, &ap, location,
864 permissive_error_kind (global_dc));
865 diagnostic.option_index = permissive_error_option (global_dc);
868 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, kind);
869 if (kind == DK_WARNING || kind == DK_PEDWARN)
870 diagnostic.option_index = opt;
873 ret = report_diagnostic (&diagnostic);
878 /* An informative note at LOCATION. Use this for additional details on an error
881 inform (location_t location, const char *gmsgid, ...)
883 diagnostic_info diagnostic;
886 va_start (ap, gmsgid);
887 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_NOTE);
888 report_diagnostic (&diagnostic);
892 /* An informative note at LOCATION. Use this for additional details on an
895 inform_n (location_t location, int n, const char *singular_gmsgid,
896 const char *plural_gmsgid, ...)
898 diagnostic_info diagnostic;
901 va_start (ap, plural_gmsgid);
902 diagnostic_set_info_translated (&diagnostic,
903 ngettext (singular_gmsgid, plural_gmsgid, n),
904 &ap, location, DK_NOTE);
905 report_diagnostic (&diagnostic);
909 /* A warning at INPUT_LOCATION. Use this for code which is correct according
910 to the relevant language specification but is likely to be buggy anyway.
911 Returns true if the warning was printed, false if it was inhibited. */
913 warning (int opt, const char *gmsgid, ...)
915 diagnostic_info diagnostic;
919 va_start (ap, gmsgid);
920 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_WARNING);
921 diagnostic.option_index = opt;
923 ret = report_diagnostic (&diagnostic);
928 /* A warning at LOCATION. Use this for code which is correct according to the
929 relevant language specification but is likely to be buggy anyway.
930 Returns true if the warning was printed, false if it was inhibited. */
933 warning_at (location_t location, int opt, const char *gmsgid, ...)
935 diagnostic_info diagnostic;
939 va_start (ap, gmsgid);
940 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_WARNING);
941 diagnostic.option_index = opt;
942 ret = report_diagnostic (&diagnostic);
947 /* A "pedantic" warning at LOCATION: issues a warning unless
948 -pedantic-errors was given on the command line, in which case it
949 issues an error. Use this for diagnostics required by the relevant
950 language standard, if you have chosen not to make them errors.
952 Note that these diagnostics are issued independent of the setting
953 of the -Wpedantic command-line switch. To get a warning enabled
954 only with that switch, use either "if (pedantic) pedwarn
955 (OPT_Wpedantic,...)" or just "pedwarn (OPT_Wpedantic,..)". To get a
956 pedwarn independently of the -Wpedantic switch use "pedwarn (0,...)".
958 Returns true if the warning was printed, false if it was inhibited. */
961 pedwarn (location_t location, int opt, const char *gmsgid, ...)
963 diagnostic_info diagnostic;
967 va_start (ap, gmsgid);
968 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_PEDWARN);
969 diagnostic.option_index = opt;
970 ret = report_diagnostic (&diagnostic);
975 /* A "permissive" error at LOCATION: issues an error unless
976 -fpermissive was given on the command line, in which case it issues
977 a warning. Use this for things that really should be errors but we
978 want to support legacy code.
980 Returns true if the warning was printed, false if it was inhibited. */
983 permerror (location_t location, const char *gmsgid, ...)
985 diagnostic_info diagnostic;
989 va_start (ap, gmsgid);
990 diagnostic_set_info (&diagnostic, gmsgid, &ap, location,
991 permissive_error_kind (global_dc));
992 diagnostic.option_index = permissive_error_option (global_dc);
993 ret = report_diagnostic (&diagnostic);
998 /* A hard error: the code is definitely ill-formed, and an object file
999 will not be produced. */
1001 error (const char *gmsgid, ...)
1003 diagnostic_info diagnostic;
1006 va_start (ap, gmsgid);
1007 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_ERROR);
1008 report_diagnostic (&diagnostic);
1012 /* A hard error: the code is definitely ill-formed, and an object file
1013 will not be produced. */
1015 error_n (location_t location, int n, const char *singular_gmsgid,
1016 const char *plural_gmsgid, ...)
1018 diagnostic_info diagnostic;
1021 va_start (ap, plural_gmsgid);
1022 diagnostic_set_info_translated (&diagnostic,
1023 ngettext (singular_gmsgid, plural_gmsgid, n),
1024 &ap, location, DK_ERROR);
1025 report_diagnostic (&diagnostic);
1029 /* Same as ebove, but use location LOC instead of input_location. */
1031 error_at (location_t loc, const char *gmsgid, ...)
1033 diagnostic_info diagnostic;
1036 va_start (ap, gmsgid);
1037 diagnostic_set_info (&diagnostic, gmsgid, &ap, loc, DK_ERROR);
1038 report_diagnostic (&diagnostic);
1042 /* "Sorry, not implemented." Use for a language feature which is
1043 required by the relevant specification but not implemented by GCC.
1044 An object file will not be produced. */
1046 sorry (const char *gmsgid, ...)
1048 diagnostic_info diagnostic;
1051 va_start (ap, gmsgid);
1052 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_SORRY);
1053 report_diagnostic (&diagnostic);
1057 /* Return true if an error or a "sorry" has been seen. Various
1058 processing is disabled after errors. */
1062 return errorcount || sorrycount;
1065 /* An error which is severe enough that we make no attempt to
1066 continue. Do not use this for internal consistency checks; that's
1067 internal_error. Use of this function should be rare. */
1069 fatal_error (const char *gmsgid, ...)
1071 diagnostic_info diagnostic;
1074 va_start (ap, gmsgid);
1075 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_FATAL);
1076 report_diagnostic (&diagnostic);
1082 /* An internal consistency check has failed. We make no attempt to
1083 continue. Note that unless there is debugging value to be had from
1084 a more specific message, or some other good reason, you should use
1085 abort () instead of calling this function directly. */
1087 internal_error (const char *gmsgid, ...)
1089 diagnostic_info diagnostic;
1092 va_start (ap, gmsgid);
1093 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_ICE);
1094 report_diagnostic (&diagnostic);
1100 /* Special case error functions. Most are implemented in terms of the
1101 above, or should be. */
1103 /* Print a diagnostic MSGID on FILE. This is just fprintf, except it
1104 runs its second argument through gettext. */
1106 fnotice (FILE *file, const char *cmsgid, ...)
1110 va_start (ap, cmsgid);
1111 vfprintf (file, _(cmsgid), ap);
1115 /* Inform the user that an error occurred while trying to report some
1116 other error. This indicates catastrophic internal inconsistencies,
1117 so give up now. But do try to flush out the previous error.
1118 This mustn't use internal_error, that will cause infinite recursion. */
1121 error_recursion (diagnostic_context *context)
1123 diagnostic_info diagnostic;
1125 if (context->lock < 3)
1126 pp_newline_and_flush (context->printer);
1129 "Internal compiler error: Error reporting routines re-entered.\n");
1131 /* Call diagnostic_action_after_output to get the "please submit a bug
1132 report" message. It only looks at the kind field of diagnostic_info. */
1133 diagnostic.kind = DK_ICE;
1134 diagnostic_action_after_output (context, &diagnostic);
1136 /* Do not use gcc_unreachable here; that goes through internal_error
1137 and therefore would cause infinite recursion. */
1141 /* Report an internal compiler error in a friendly manner. This is
1142 the function that gets called upon use of abort() in the source
1143 code generally, thanks to a special macro. */
1146 fancy_abort (const char *file, int line, const char *function)
1148 internal_error ("in %s, at %s:%d", function, trim_filename (file), line);
1151 /* Really call the system 'abort'. This has to go right at the end of
1152 this file, so that there are no functions after it that call abort
1153 and get the system abort instead of our macro. */