2015-07-14 Vladimir Makarov <vmakarov@redhat.com>
[official-gcc.git] / gcc / diagnostic.c
blobfb9d1fbfd1ba72681b29f0f463aa877f0edf221a
1 /* Language-independent diagnostic subroutines for the GNU Compiler Collection
2 Copyright (C) 1999-2015 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
10 version.
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
15 for more details.
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
23 message module. */
25 #include "config.h"
26 #include "system.h"
27 #include "coretypes.h"
28 #include "version.h"
29 #include "demangle.h"
30 #include "intl.h"
31 #include "backtrace.h"
32 #include "diagnostic.h"
33 #include "diagnostic-color.h"
35 #ifdef HAVE_TERMIOS_H
36 # include <termios.h>
37 #endif
39 #ifdef GWINSZ_IN_SYS_IOCTL
40 # include <sys/ioctl.h>
41 #endif
43 #include <new> // For placement new.
45 #define pedantic_warning_kind(DC) \
46 ((DC)->pedantic_errors ? DK_ERROR : DK_WARNING)
47 #define permissive_error_kind(DC) ((DC)->permissive ? DK_WARNING : DK_ERROR)
48 #define permissive_error_option(DC) ((DC)->opt_permissive)
50 /* Prototypes. */
51 static void error_recursion (diagnostic_context *) ATTRIBUTE_NORETURN;
53 static void real_abort (void) ATTRIBUTE_NORETURN;
55 /* Name of program invoked, sans directories. */
57 const char *progname;
59 /* A diagnostic_context surrogate for stderr. */
60 static diagnostic_context global_diagnostic_context;
61 diagnostic_context *global_dc = &global_diagnostic_context;
63 /* Return a malloc'd string containing MSG formatted a la printf. The
64 caller is responsible for freeing the memory. */
65 char *
66 build_message_string (const char *msg, ...)
68 char *str;
69 va_list ap;
71 va_start (ap, msg);
72 str = xvasprintf (msg, ap);
73 va_end (ap);
75 return str;
78 /* Same as diagnostic_build_prefix, but only the source FILE is given. */
79 char *
80 file_name_as_prefix (diagnostic_context *context, const char *f)
82 const char *locus_cs
83 = colorize_start (pp_show_color (context->printer), "locus");
84 const char *locus_ce = colorize_stop (pp_show_color (context->printer));
85 return build_message_string ("%s%s:%s ", locus_cs, f, locus_ce);
90 /* Return the value of the getenv("COLUMNS") as an integer. If the
91 value is not set to a positive integer, use ioctl to get the
92 terminal width. If it fails, return INT_MAX. */
93 int
94 get_terminal_width (void)
96 const char * s = getenv ("COLUMNS");
97 if (s != NULL) {
98 int n = atoi (s);
99 if (n > 0)
100 return n;
103 #ifdef TIOCGWINSZ
104 struct winsize w;
105 w.ws_col = 0;
106 if (ioctl (0, TIOCGWINSZ, &w) == 0 && w.ws_col > 0)
107 return w.ws_col;
108 #endif
110 return INT_MAX;
113 /* Set caret_max_width to value. */
114 void
115 diagnostic_set_caret_max_width (diagnostic_context *context, int value)
117 /* One minus to account for the leading empty space. */
118 value = value ? value - 1
119 : (isatty (fileno (pp_buffer (context->printer)->stream))
120 ? get_terminal_width () - 1: INT_MAX);
122 if (value <= 0)
123 value = INT_MAX;
125 context->caret_max_width = value;
128 /* Initialize the diagnostic message outputting machinery. */
129 void
130 diagnostic_initialize (diagnostic_context *context, int n_opts)
132 int i;
134 /* Allocate a basic pretty-printer. Clients will replace this a
135 much more elaborated pretty-printer if they wish. */
136 context->printer = XNEW (pretty_printer);
137 new (context->printer) pretty_printer ();
139 memset (context->diagnostic_count, 0, sizeof context->diagnostic_count);
140 context->some_warnings_are_errors = false;
141 context->warning_as_error_requested = false;
142 context->n_opts = n_opts;
143 context->classify_diagnostic = XNEWVEC (diagnostic_t, n_opts);
144 for (i = 0; i < n_opts; i++)
145 context->classify_diagnostic[i] = DK_UNSPECIFIED;
146 context->show_caret = false;
147 diagnostic_set_caret_max_width (context, pp_line_cutoff (context->printer));
148 for (i = 0; i < MAX_LOCATIONS_PER_MESSAGE; i++)
149 context->caret_chars[i] = '^';
150 context->show_option_requested = false;
151 context->abort_on_error = false;
152 context->show_column = false;
153 context->pedantic_errors = false;
154 context->permissive = false;
155 context->opt_permissive = 0;
156 context->fatal_errors = false;
157 context->dc_inhibit_warnings = false;
158 context->dc_warn_system_headers = false;
159 context->max_errors = 0;
160 context->internal_error = NULL;
161 diagnostic_starter (context) = default_diagnostic_starter;
162 diagnostic_finalizer (context) = default_diagnostic_finalizer;
163 context->option_enabled = NULL;
164 context->option_state = NULL;
165 context->option_name = NULL;
166 context->last_location = UNKNOWN_LOCATION;
167 context->last_module = 0;
168 context->x_data = NULL;
169 context->lock = 0;
170 context->inhibit_notes_p = false;
173 /* Maybe initialize the color support. We require clients to do this
174 explicitly, since most clients don't want color. When called
175 without a VALUE, it initializes with DIAGNOSTICS_COLOR_DEFAULT. */
177 void
178 diagnostic_color_init (diagnostic_context *context, int value /*= -1 */)
180 /* value == -1 is the default value. */
181 if (value < 0)
183 /* If DIAGNOSTICS_COLOR_DEFAULT is -1, default to
184 -fdiagnostics-color=auto if GCC_COLORS is in the environment,
185 otherwise default to -fdiagnostics-color=never, for other
186 values default to that
187 -fdiagnostics-color={never,auto,always}. */
188 if (DIAGNOSTICS_COLOR_DEFAULT == -1)
190 if (!getenv ("GCC_COLORS"))
191 return;
192 value = DIAGNOSTICS_COLOR_AUTO;
194 else
195 value = DIAGNOSTICS_COLOR_DEFAULT;
197 pp_show_color (context->printer)
198 = colorize_init ((diagnostic_color_rule_t) value);
201 /* Do any cleaning up required after the last diagnostic is emitted. */
203 void
204 diagnostic_finish (diagnostic_context *context)
206 /* Some of the errors may actually have been warnings. */
207 if (context->some_warnings_are_errors)
209 /* -Werror was given. */
210 if (context->warning_as_error_requested)
211 pp_verbatim (context->printer,
212 _("%s: all warnings being treated as errors"),
213 progname);
214 /* At least one -Werror= was given. */
215 else
216 pp_verbatim (context->printer,
217 _("%s: some warnings being treated as errors"),
218 progname);
219 pp_newline_and_flush (context->printer);
222 diagnostic_file_cache_fini ();
224 XDELETEVEC (context->classify_diagnostic);
225 context->classify_diagnostic = NULL;
227 /* diagnostic_initialize allocates context->printer using XNEW
228 and placement-new. */
229 context->printer->~pretty_printer ();
230 XDELETE (context->printer);
231 context->printer = NULL;
234 /* Initialize DIAGNOSTIC, where the message MSG has already been
235 translated. */
236 void
237 diagnostic_set_info_translated (diagnostic_info *diagnostic, const char *msg,
238 va_list *args, location_t location,
239 diagnostic_t kind)
241 diagnostic->message.err_no = errno;
242 diagnostic->message.args_ptr = args;
243 diagnostic->message.format_spec = msg;
244 diagnostic->message.set_location (0, location);
245 for (int i = 1; i < MAX_LOCATIONS_PER_MESSAGE; i++)
246 diagnostic->message.set_location (i, UNKNOWN_LOCATION);
247 diagnostic->override_column = 0;
248 diagnostic->kind = kind;
249 diagnostic->option_index = 0;
252 /* Initialize DIAGNOSTIC, where the message GMSGID has not yet been
253 translated. */
254 void
255 diagnostic_set_info (diagnostic_info *diagnostic, const char *gmsgid,
256 va_list *args, location_t location,
257 diagnostic_t kind)
259 diagnostic_set_info_translated (diagnostic, _(gmsgid), args, location, kind);
262 /* Return a malloc'd string describing a location. The caller is
263 responsible for freeing the memory. */
264 char *
265 diagnostic_build_prefix (diagnostic_context *context,
266 const diagnostic_info *diagnostic)
268 static const char *const diagnostic_kind_text[] = {
269 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (T),
270 #include "diagnostic.def"
271 #undef DEFINE_DIAGNOSTIC_KIND
272 "must-not-happen"
274 static const char *const diagnostic_kind_color[] = {
275 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (C),
276 #include "diagnostic.def"
277 #undef DEFINE_DIAGNOSTIC_KIND
278 NULL
280 gcc_assert (diagnostic->kind < DK_LAST_DIAGNOSTIC_KIND);
282 const char *text = _(diagnostic_kind_text[diagnostic->kind]);
283 const char *text_cs = "", *text_ce = "";
284 const char *locus_cs, *locus_ce;
285 pretty_printer *pp = context->printer;
287 if (diagnostic_kind_color[diagnostic->kind])
289 text_cs = colorize_start (pp_show_color (pp),
290 diagnostic_kind_color[diagnostic->kind]);
291 text_ce = colorize_stop (pp_show_color (pp));
293 locus_cs = colorize_start (pp_show_color (pp), "locus");
294 locus_ce = colorize_stop (pp_show_color (pp));
296 expanded_location s = diagnostic_expand_location (diagnostic);
297 return
298 (s.file == NULL
299 ? build_message_string ("%s%s:%s %s%s%s", locus_cs, progname, locus_ce,
300 text_cs, text, text_ce)
301 : !strcmp (s.file, N_("<built-in>"))
302 ? build_message_string ("%s%s:%s %s%s%s", locus_cs, s.file, locus_ce,
303 text_cs, text, text_ce)
304 : context->show_column
305 ? build_message_string ("%s%s:%d:%d:%s %s%s%s", locus_cs, s.file, s.line,
306 s.column, locus_ce, text_cs, text, text_ce)
307 : build_message_string ("%s%s:%d:%s %s%s%s", locus_cs, s.file, s.line,
308 locus_ce, text_cs, text, text_ce));
311 /* If LINE is longer than MAX_WIDTH, and COLUMN is not smaller than
312 MAX_WIDTH by some margin, then adjust the start of the line such
313 that the COLUMN is smaller than MAX_WIDTH minus the margin. The
314 margin is either CARET_LINE_MARGIN characters or the difference
315 between the column and the length of the line, whatever is smaller.
316 The length of LINE is given by LINE_WIDTH. */
317 static const char *
318 adjust_line (const char *line, int line_width,
319 int max_width, int *column_p)
321 int right_margin = CARET_LINE_MARGIN;
322 int column = *column_p;
324 gcc_checking_assert (line_width >= column);
325 right_margin = MIN (line_width - column, right_margin);
326 right_margin = max_width - right_margin;
327 if (line_width >= max_width && column > right_margin)
329 line += column - right_margin;
330 *column_p = right_margin;
332 return line;
335 /* Print the physical source line corresponding to the location of
336 this diagnostic, and a caret indicating the precise column. This
337 function only prints two caret characters if the two locations
338 given by DIAGNOSTIC are on the same line according to
339 diagnostic_same_line(). */
340 void
341 diagnostic_show_locus (diagnostic_context * context,
342 const diagnostic_info *diagnostic)
344 if (!context->show_caret
345 || diagnostic_location (diagnostic, 0) <= BUILTINS_LOCATION
346 || diagnostic_location (diagnostic, 0) == context->last_location)
347 return;
349 context->last_location = diagnostic_location (diagnostic, 0);
350 expanded_location s0 = diagnostic_expand_location (diagnostic, 0);
351 expanded_location s1 = { };
352 /* Zero-initialized. This is checked later by diagnostic_print_caret_line. */
354 if (diagnostic_location (diagnostic, 1) > BUILTINS_LOCATION)
355 s1 = diagnostic_expand_location (diagnostic, 1);
357 diagnostic_print_caret_line (context, s0, s1,
358 context->caret_chars[0],
359 context->caret_chars[1]);
362 /* Print (part) of the source line given by xloc1 with caret1 pointing
363 at the column. If xloc2.column != 0 and it fits within the same
364 line as xloc1 according to diagnostic_same_line (), then caret2 is
365 printed at xloc2.colum. Otherwise, the caller has to set up things
366 to print a second caret line for xloc2. */
367 void
368 diagnostic_print_caret_line (diagnostic_context * context,
369 expanded_location xloc1,
370 expanded_location xloc2,
371 char caret1, char caret2)
373 if (!diagnostic_same_line (context, xloc1, xloc2))
374 /* This will mean ignore xloc2. */
375 xloc2.column = 0;
376 else if (xloc1.column == xloc2.column)
377 xloc2.column++;
379 int cmax = MAX (xloc1.column, xloc2.column);
380 int line_width;
381 const char *line = location_get_source_line (xloc1, &line_width);
382 if (line == NULL || cmax > line_width)
383 return;
385 /* Center the interesting part of the source line to fit in
386 max_width, and adjust all columns accordingly. */
387 int max_width = context->caret_max_width;
388 int offset = (int) cmax;
389 line = adjust_line (line, line_width, max_width, &offset);
390 offset -= cmax;
391 cmax += offset;
392 xloc1.column += offset;
393 if (xloc2.column)
394 xloc2.column += offset;
396 /* Print the source line. */
397 pp_newline (context->printer);
398 const char *saved_prefix = pp_get_prefix (context->printer);
399 pp_set_prefix (context->printer, NULL);
400 pp_space (context->printer);
401 while (max_width > 0 && line_width > 0)
403 char c = *line == '\t' ? ' ' : *line;
404 if (c == '\0')
405 c = ' ';
406 pp_character (context->printer, c);
407 max_width--;
408 line_width--;
409 line++;
411 pp_newline (context->printer);
413 /* Print the caret under the line. */
414 const char *caret_cs, *caret_ce;
415 caret_cs = colorize_start (pp_show_color (context->printer), "caret");
416 caret_ce = colorize_stop (pp_show_color (context->printer));
417 int cmin = xloc2.column
418 ? MIN (xloc1.column, xloc2.column) : xloc1.column;
419 int caret_min = cmin == xloc1.column ? caret1 : caret2;
420 int caret_max = cmin == xloc1.column ? caret2 : caret1;
422 /* cmin is >= 1, but we indent with an extra space at the start like
423 we did above. */
424 int i;
425 for (i = 0; i < cmin; i++)
426 pp_space (context->printer);
427 pp_printf (context->printer, "%s%c%s", caret_cs, caret_min, caret_ce);
429 if (xloc2.column)
431 for (i++; i < cmax; i++)
432 pp_space (context->printer);
433 pp_printf (context->printer, "%s%c%s", caret_cs, caret_max, caret_ce);
435 pp_set_prefix (context->printer, saved_prefix);
436 pp_needs_newline (context->printer) = true;
439 /* Functions at which to stop the backtrace print. It's not
440 particularly helpful to print the callers of these functions. */
442 static const char * const bt_stop[] =
444 "main",
445 "toplev::main",
446 "execute_one_pass",
447 "compile_file",
450 /* A callback function passed to the backtrace_full function. */
452 static int
453 bt_callback (void *data, uintptr_t pc, const char *filename, int lineno,
454 const char *function)
456 int *pcount = (int *) data;
458 /* If we don't have any useful information, don't print
459 anything. */
460 if (filename == NULL && function == NULL)
461 return 0;
463 /* Skip functions in diagnostic.c. */
464 if (*pcount == 0
465 && filename != NULL
466 && strcmp (lbasename (filename), "diagnostic.c") == 0)
467 return 0;
469 /* Print up to 20 functions. We could make this a --param, but
470 since this is only for debugging just use a constant for now. */
471 if (*pcount >= 20)
473 /* Returning a non-zero value stops the backtrace. */
474 return 1;
476 ++*pcount;
478 char *alc = NULL;
479 if (function != NULL)
481 char *str = cplus_demangle_v3 (function,
482 (DMGL_VERBOSE | DMGL_ANSI
483 | DMGL_GNU_V3 | DMGL_PARAMS));
484 if (str != NULL)
486 alc = str;
487 function = str;
490 for (size_t i = 0; i < ARRAY_SIZE (bt_stop); ++i)
492 size_t len = strlen (bt_stop[i]);
493 if (strncmp (function, bt_stop[i], len) == 0
494 && (function[len] == '\0' || function[len] == '('))
496 if (alc != NULL)
497 free (alc);
498 /* Returning a non-zero value stops the backtrace. */
499 return 1;
504 fprintf (stderr, "0x%lx %s\n\t%s:%d\n",
505 (unsigned long) pc,
506 function == NULL ? "???" : function,
507 filename == NULL ? "???" : filename,
508 lineno);
510 if (alc != NULL)
511 free (alc);
513 return 0;
516 /* A callback function passed to the backtrace_full function. This is
517 called if backtrace_full has an error. */
519 static void
520 bt_err_callback (void *data ATTRIBUTE_UNUSED, const char *msg, int errnum)
522 if (errnum < 0)
524 /* This means that no debug info was available. Just quietly
525 skip printing backtrace info. */
526 return;
528 fprintf (stderr, "%s%s%s\n", msg, errnum == 0 ? "" : ": ",
529 errnum == 0 ? "" : xstrerror (errnum));
532 /* Take any action which is expected to happen after the diagnostic
533 is written out. This function does not always return. */
534 void
535 diagnostic_action_after_output (diagnostic_context *context,
536 diagnostic_t diag_kind)
538 switch (diag_kind)
540 case DK_DEBUG:
541 case DK_NOTE:
542 case DK_ANACHRONISM:
543 case DK_WARNING:
544 break;
546 case DK_ERROR:
547 case DK_SORRY:
548 if (context->abort_on_error)
549 real_abort ();
550 if (context->fatal_errors)
552 fnotice (stderr, "compilation terminated due to -Wfatal-errors.\n");
553 diagnostic_finish (context);
554 exit (FATAL_EXIT_CODE);
556 if (context->max_errors != 0
557 && ((unsigned) (diagnostic_kind_count (context, DK_ERROR)
558 + diagnostic_kind_count (context, DK_SORRY)
559 + diagnostic_kind_count (context, DK_WERROR))
560 >= context->max_errors))
562 fnotice (stderr,
563 "compilation terminated due to -fmax-errors=%u.\n",
564 context->max_errors);
565 diagnostic_finish (context);
566 exit (FATAL_EXIT_CODE);
568 break;
570 case DK_ICE:
571 case DK_ICE_NOBT:
573 struct backtrace_state *state = NULL;
574 if (diag_kind == DK_ICE)
575 state = backtrace_create_state (NULL, 0, bt_err_callback, NULL);
576 int count = 0;
577 if (state != NULL)
578 backtrace_full (state, 2, bt_callback, bt_err_callback,
579 (void *) &count);
581 if (context->abort_on_error)
582 real_abort ();
584 fnotice (stderr, "Please submit a full bug report,\n"
585 "with preprocessed source if appropriate.\n");
586 if (count > 0)
587 fnotice (stderr,
588 ("Please include the complete backtrace "
589 "with any bug report.\n"));
590 fnotice (stderr, "See %s for instructions.\n", bug_report_url);
592 exit (ICE_EXIT_CODE);
595 case DK_FATAL:
596 if (context->abort_on_error)
597 real_abort ();
598 diagnostic_finish (context);
599 fnotice (stderr, "compilation terminated.\n");
600 exit (FATAL_EXIT_CODE);
602 default:
603 gcc_unreachable ();
607 void
608 diagnostic_report_current_module (diagnostic_context *context, location_t where)
610 const line_map_ordinary *map = NULL;
612 if (pp_needs_newline (context->printer))
614 pp_newline (context->printer);
615 pp_needs_newline (context->printer) = false;
618 if (where <= BUILTINS_LOCATION)
619 return;
621 linemap_resolve_location (line_table, where,
622 LRK_MACRO_DEFINITION_LOCATION,
623 &map);
625 if (map && diagnostic_last_module_changed (context, map))
627 diagnostic_set_last_module (context, map);
628 if (! MAIN_FILE_P (map))
630 map = INCLUDED_FROM (line_table, map);
631 if (context->show_column)
632 pp_verbatim (context->printer,
633 "In file included from %r%s:%d:%d%R", "locus",
634 LINEMAP_FILE (map),
635 LAST_SOURCE_LINE (map), LAST_SOURCE_COLUMN (map));
636 else
637 pp_verbatim (context->printer,
638 "In file included from %r%s:%d%R", "locus",
639 LINEMAP_FILE (map), LAST_SOURCE_LINE (map));
640 while (! MAIN_FILE_P (map))
642 map = INCLUDED_FROM (line_table, map);
643 pp_verbatim (context->printer,
644 ",\n from %r%s:%d%R", "locus",
645 LINEMAP_FILE (map), LAST_SOURCE_LINE (map));
647 pp_verbatim (context->printer, ":");
648 pp_newline (context->printer);
653 void
654 default_diagnostic_starter (diagnostic_context *context,
655 diagnostic_info *diagnostic)
657 diagnostic_report_current_module (context, diagnostic_location (diagnostic));
658 pp_set_prefix (context->printer, diagnostic_build_prefix (context,
659 diagnostic));
662 void
663 default_diagnostic_finalizer (diagnostic_context *context,
664 diagnostic_info *diagnostic)
666 diagnostic_show_locus (context, diagnostic);
667 pp_destroy_prefix (context->printer);
668 pp_newline_and_flush (context->printer);
671 /* Interface to specify diagnostic kind overrides. Returns the
672 previous setting, or DK_UNSPECIFIED if the parameters are out of
673 range. If OPTION_INDEX is zero, the new setting is for all the
674 diagnostics. */
675 diagnostic_t
676 diagnostic_classify_diagnostic (diagnostic_context *context,
677 int option_index,
678 diagnostic_t new_kind,
679 location_t where)
681 diagnostic_t old_kind;
683 if (option_index < 0
684 || option_index >= context->n_opts
685 || new_kind >= DK_LAST_DIAGNOSTIC_KIND)
686 return DK_UNSPECIFIED;
688 old_kind = context->classify_diagnostic[option_index];
690 /* Handle pragmas separately, since we need to keep track of *where*
691 the pragmas were. */
692 if (where != UNKNOWN_LOCATION)
694 int i;
696 /* Record the command-line status, so we can reset it back on DK_POP. */
697 if (old_kind == DK_UNSPECIFIED)
699 old_kind = context->option_enabled (option_index,
700 context->option_state)
701 ? DK_WARNING : DK_IGNORED;
702 context->classify_diagnostic[option_index] = old_kind;
705 for (i = context->n_classification_history - 1; i >= 0; i --)
706 if (context->classification_history[i].option == option_index)
708 old_kind = context->classification_history[i].kind;
709 break;
712 i = context->n_classification_history;
713 context->classification_history =
714 (diagnostic_classification_change_t *) xrealloc (context->classification_history, (i + 1)
715 * sizeof (diagnostic_classification_change_t));
716 context->classification_history[i].location = where;
717 context->classification_history[i].option = option_index;
718 context->classification_history[i].kind = new_kind;
719 context->n_classification_history ++;
721 else
722 context->classify_diagnostic[option_index] = new_kind;
724 return old_kind;
727 /* Save all diagnostic classifications in a stack. */
728 void
729 diagnostic_push_diagnostics (diagnostic_context *context, location_t where ATTRIBUTE_UNUSED)
731 context->push_list = (int *) xrealloc (context->push_list, (context->n_push + 1) * sizeof (int));
732 context->push_list[context->n_push ++] = context->n_classification_history;
735 /* Restore the topmost classification set off the stack. If the stack
736 is empty, revert to the state based on command line parameters. */
737 void
738 diagnostic_pop_diagnostics (diagnostic_context *context, location_t where)
740 int jump_to;
741 int i;
743 if (context->n_push)
744 jump_to = context->push_list [-- context->n_push];
745 else
746 jump_to = 0;
748 i = context->n_classification_history;
749 context->classification_history =
750 (diagnostic_classification_change_t *) xrealloc (context->classification_history, (i + 1)
751 * sizeof (diagnostic_classification_change_t));
752 context->classification_history[i].location = where;
753 context->classification_history[i].option = jump_to;
754 context->classification_history[i].kind = DK_POP;
755 context->n_classification_history ++;
758 /* Report a diagnostic message (an error or a warning) as specified by
759 DC. This function is *the* subroutine in terms of which front-ends
760 should implement their specific diagnostic handling modules. The
761 front-end independent format specifiers are exactly those described
762 in the documentation of output_format.
763 Return true if a diagnostic was printed, false otherwise. */
765 bool
766 diagnostic_report_diagnostic (diagnostic_context *context,
767 diagnostic_info *diagnostic)
769 location_t location = diagnostic_location (diagnostic);
770 diagnostic_t orig_diag_kind = diagnostic->kind;
771 const char *saved_format_spec;
773 /* Give preference to being able to inhibit warnings, before they
774 get reclassified to something else. */
775 if ((diagnostic->kind == DK_WARNING || diagnostic->kind == DK_PEDWARN)
776 && !diagnostic_report_warnings_p (context, location))
777 return false;
779 if (diagnostic->kind == DK_PEDWARN)
781 diagnostic->kind = pedantic_warning_kind (context);
782 /* We do this to avoid giving the message for -pedantic-errors. */
783 orig_diag_kind = diagnostic->kind;
786 if (diagnostic->kind == DK_NOTE && context->inhibit_notes_p)
787 return false;
789 if (context->lock > 0)
791 /* If we're reporting an ICE in the middle of some other error,
792 try to flush out the previous error, then let this one
793 through. Don't do this more than once. */
794 if ((diagnostic->kind == DK_ICE || diagnostic->kind == DK_ICE_NOBT)
795 && context->lock == 1)
796 pp_newline_and_flush (context->printer);
797 else
798 error_recursion (context);
801 /* If the user requested that warnings be treated as errors, so be
802 it. Note that we do this before the next block so that
803 individual warnings can be overridden back to warnings with
804 -Wno-error=*. */
805 if (context->warning_as_error_requested
806 && diagnostic->kind == DK_WARNING)
808 diagnostic->kind = DK_ERROR;
811 if (diagnostic->option_index
812 && diagnostic->option_index != permissive_error_option (context))
814 diagnostic_t diag_class = DK_UNSPECIFIED;
816 /* This tests if the user provided the appropriate -Wfoo or
817 -Wno-foo option. */
818 if (! context->option_enabled (diagnostic->option_index,
819 context->option_state))
820 return false;
822 /* This tests for #pragma diagnostic changes. */
823 if (context->n_classification_history > 0)
825 /* FIXME: Stupid search. Optimize later. */
826 for (int i = context->n_classification_history - 1; i >= 0; i --)
828 if (linemap_location_before_p
829 (line_table,
830 context->classification_history[i].location,
831 location))
833 if (context->classification_history[i].kind == (int) DK_POP)
835 i = context->classification_history[i].option;
836 continue;
838 int option = context->classification_history[i].option;
839 /* The option 0 is for all the diagnostics. */
840 if (option == 0 || option == diagnostic->option_index)
842 diag_class = context->classification_history[i].kind;
843 if (diag_class != DK_UNSPECIFIED)
844 diagnostic->kind = diag_class;
845 break;
850 /* This tests if the user provided the appropriate -Werror=foo
851 option. */
852 if (diag_class == DK_UNSPECIFIED
853 && context->classify_diagnostic[diagnostic->option_index] != DK_UNSPECIFIED)
855 diagnostic->kind = context->classify_diagnostic[diagnostic->option_index];
857 /* This allows for future extensions, like temporarily disabling
858 warnings for ranges of source code. */
859 if (diagnostic->kind == DK_IGNORED)
860 return false;
863 if (orig_diag_kind == DK_WARNING && diagnostic->kind == DK_ERROR)
864 context->some_warnings_are_errors = true;
866 context->lock++;
868 if (diagnostic->kind == DK_ICE || diagnostic->kind == DK_ICE_NOBT)
870 #ifndef ENABLE_CHECKING
871 /* When not checking, ICEs are converted to fatal errors when an
872 error has already occurred. This is counteracted by
873 abort_on_error. */
874 if ((diagnostic_kind_count (context, DK_ERROR) > 0
875 || diagnostic_kind_count (context, DK_SORRY) > 0)
876 && !context->abort_on_error)
878 expanded_location s
879 = expand_location (diagnostic_location (diagnostic));
880 fnotice (stderr, "%s:%d: confused by earlier errors, bailing out\n",
881 s.file, s.line);
882 exit (ICE_EXIT_CODE);
884 #endif
885 if (context->internal_error)
886 (*context->internal_error) (context,
887 diagnostic->message.format_spec,
888 diagnostic->message.args_ptr);
890 if (diagnostic->kind == DK_ERROR && orig_diag_kind == DK_WARNING)
891 ++diagnostic_kind_count (context, DK_WERROR);
892 else
893 ++diagnostic_kind_count (context, diagnostic->kind);
895 saved_format_spec = diagnostic->message.format_spec;
896 if (context->show_option_requested)
898 char *option_text;
900 option_text = context->option_name (context, diagnostic->option_index,
901 orig_diag_kind, diagnostic->kind);
903 if (option_text)
905 diagnostic->message.format_spec
906 = ACONCAT ((diagnostic->message.format_spec,
907 " ",
908 "[", option_text, "]",
909 NULL));
910 free (option_text);
913 diagnostic->message.x_data = &diagnostic->x_data;
914 diagnostic->x_data = NULL;
915 pp_format (context->printer, &diagnostic->message);
916 (*diagnostic_starter (context)) (context, diagnostic);
917 pp_output_formatted_text (context->printer);
918 (*diagnostic_finalizer (context)) (context, diagnostic);
919 diagnostic_action_after_output (context, diagnostic->kind);
920 diagnostic->message.format_spec = saved_format_spec;
921 diagnostic->x_data = NULL;
923 context->lock--;
925 return true;
928 /* Given a partial pathname as input, return another pathname that
929 shares no directory elements with the pathname of __FILE__. This
930 is used by fancy_abort() to print `Internal compiler error in expr.c'
931 instead of `Internal compiler error in ../../GCC/gcc/expr.c'. */
933 const char *
934 trim_filename (const char *name)
936 static const char this_file[] = __FILE__;
937 const char *p = name, *q = this_file;
939 /* First skip any "../" in each filename. This allows us to give a proper
940 reference to a file in a subdirectory. */
941 while (p[0] == '.' && p[1] == '.' && IS_DIR_SEPARATOR (p[2]))
942 p += 3;
944 while (q[0] == '.' && q[1] == '.' && IS_DIR_SEPARATOR (q[2]))
945 q += 3;
947 /* Now skip any parts the two filenames have in common. */
948 while (*p == *q && *p != 0 && *q != 0)
949 p++, q++;
951 /* Now go backwards until the previous directory separator. */
952 while (p > name && !IS_DIR_SEPARATOR (p[-1]))
953 p--;
955 return p;
958 /* Standard error reporting routines in increasing order of severity.
959 All of these take arguments like printf. */
961 /* Text to be emitted verbatim to the error message stream; this
962 produces no prefix and disables line-wrapping. Use rarely. */
963 void
964 verbatim (const char *gmsgid, ...)
966 text_info text;
967 va_list ap;
969 va_start (ap, gmsgid);
970 text.err_no = errno;
971 text.args_ptr = &ap;
972 text.format_spec = _(gmsgid);
973 text.x_data = NULL;
974 pp_format_verbatim (global_dc->printer, &text);
975 pp_newline_and_flush (global_dc->printer);
976 va_end (ap);
979 /* Add a note with text GMSGID and with LOCATION to the diagnostic CONTEXT. */
980 void
981 diagnostic_append_note (diagnostic_context *context,
982 location_t location,
983 const char * gmsgid, ...)
985 diagnostic_info diagnostic;
986 va_list ap;
987 const char *saved_prefix;
989 va_start (ap, gmsgid);
990 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_NOTE);
991 if (context->inhibit_notes_p)
993 va_end (ap);
994 return;
996 saved_prefix = pp_get_prefix (context->printer);
997 pp_set_prefix (context->printer,
998 diagnostic_build_prefix (context, &diagnostic));
999 pp_newline (context->printer);
1000 pp_format (context->printer, &diagnostic.message);
1001 pp_output_formatted_text (context->printer);
1002 pp_destroy_prefix (context->printer);
1003 pp_set_prefix (context->printer, saved_prefix);
1004 diagnostic_show_locus (context, &diagnostic);
1005 va_end (ap);
1008 bool
1009 emit_diagnostic (diagnostic_t kind, location_t location, int opt,
1010 const char *gmsgid, ...)
1012 diagnostic_info diagnostic;
1013 va_list ap;
1014 bool ret;
1016 va_start (ap, gmsgid);
1017 if (kind == DK_PERMERROR)
1019 diagnostic_set_info (&diagnostic, gmsgid, &ap, location,
1020 permissive_error_kind (global_dc));
1021 diagnostic.option_index = permissive_error_option (global_dc);
1023 else {
1024 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, kind);
1025 if (kind == DK_WARNING || kind == DK_PEDWARN)
1026 diagnostic.option_index = opt;
1029 ret = report_diagnostic (&diagnostic);
1030 va_end (ap);
1031 return ret;
1034 /* An informative note at LOCATION. Use this for additional details on an error
1035 message. */
1036 void
1037 inform (location_t location, const char *gmsgid, ...)
1039 diagnostic_info diagnostic;
1040 va_list ap;
1042 va_start (ap, gmsgid);
1043 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_NOTE);
1044 report_diagnostic (&diagnostic);
1045 va_end (ap);
1048 /* An informative note at LOCATION. Use this for additional details on an
1049 error message. */
1050 void
1051 inform_n (location_t location, int n, const char *singular_gmsgid,
1052 const char *plural_gmsgid, ...)
1054 diagnostic_info diagnostic;
1055 va_list ap;
1057 va_start (ap, plural_gmsgid);
1058 diagnostic_set_info_translated (&diagnostic,
1059 ngettext (singular_gmsgid, plural_gmsgid, n),
1060 &ap, location, DK_NOTE);
1061 report_diagnostic (&diagnostic);
1062 va_end (ap);
1065 /* A warning at INPUT_LOCATION. Use this for code which is correct according
1066 to the relevant language specification but is likely to be buggy anyway.
1067 Returns true if the warning was printed, false if it was inhibited. */
1068 bool
1069 warning (int opt, const char *gmsgid, ...)
1071 diagnostic_info diagnostic;
1072 va_list ap;
1073 bool ret;
1075 va_start (ap, gmsgid);
1076 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_WARNING);
1077 diagnostic.option_index = opt;
1079 ret = report_diagnostic (&diagnostic);
1080 va_end (ap);
1081 return ret;
1084 /* A warning at LOCATION. Use this for code which is correct according to the
1085 relevant language specification but is likely to be buggy anyway.
1086 Returns true if the warning was printed, false if it was inhibited. */
1088 bool
1089 warning_at (location_t location, int opt, const char *gmsgid, ...)
1091 diagnostic_info diagnostic;
1092 va_list ap;
1093 bool ret;
1095 va_start (ap, gmsgid);
1096 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_WARNING);
1097 diagnostic.option_index = opt;
1098 ret = report_diagnostic (&diagnostic);
1099 va_end (ap);
1100 return ret;
1103 /* A warning at LOCATION. Use this for code which is correct according to the
1104 relevant language specification but is likely to be buggy anyway.
1105 Returns true if the warning was printed, false if it was inhibited. */
1107 bool
1108 warning_n (location_t location, int opt, int n, const char *singular_gmsgid,
1109 const char *plural_gmsgid, ...)
1111 diagnostic_info diagnostic;
1112 va_list ap;
1113 bool ret;
1115 va_start (ap, plural_gmsgid);
1116 diagnostic_set_info_translated (&diagnostic,
1117 ngettext (singular_gmsgid, plural_gmsgid, n),
1118 &ap, location, DK_WARNING);
1119 diagnostic.option_index = opt;
1120 ret = report_diagnostic (&diagnostic);
1121 va_end (ap);
1122 return ret;
1125 /* A "pedantic" warning at LOCATION: issues a warning unless
1126 -pedantic-errors was given on the command line, in which case it
1127 issues an error. Use this for diagnostics required by the relevant
1128 language standard, if you have chosen not to make them errors.
1130 Note that these diagnostics are issued independent of the setting
1131 of the -Wpedantic command-line switch. To get a warning enabled
1132 only with that switch, use either "if (pedantic) pedwarn
1133 (OPT_Wpedantic,...)" or just "pedwarn (OPT_Wpedantic,..)". To get a
1134 pedwarn independently of the -Wpedantic switch use "pedwarn (0,...)".
1136 Returns true if the warning was printed, false if it was inhibited. */
1138 bool
1139 pedwarn (location_t location, int opt, const char *gmsgid, ...)
1141 diagnostic_info diagnostic;
1142 va_list ap;
1143 bool ret;
1145 va_start (ap, gmsgid);
1146 diagnostic_set_info (&diagnostic, gmsgid, &ap, location, DK_PEDWARN);
1147 diagnostic.option_index = opt;
1148 ret = report_diagnostic (&diagnostic);
1149 va_end (ap);
1150 return ret;
1153 /* A "permissive" error at LOCATION: issues an error unless
1154 -fpermissive was given on the command line, in which case it issues
1155 a warning. Use this for things that really should be errors but we
1156 want to support legacy code.
1158 Returns true if the warning was printed, false if it was inhibited. */
1160 bool
1161 permerror (location_t location, const char *gmsgid, ...)
1163 diagnostic_info diagnostic;
1164 va_list ap;
1165 bool ret;
1167 va_start (ap, gmsgid);
1168 diagnostic_set_info (&diagnostic, gmsgid, &ap, location,
1169 permissive_error_kind (global_dc));
1170 diagnostic.option_index = permissive_error_option (global_dc);
1171 ret = report_diagnostic (&diagnostic);
1172 va_end (ap);
1173 return ret;
1176 /* A hard error: the code is definitely ill-formed, and an object file
1177 will not be produced. */
1178 void
1179 error (const char *gmsgid, ...)
1181 diagnostic_info diagnostic;
1182 va_list ap;
1184 va_start (ap, gmsgid);
1185 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_ERROR);
1186 report_diagnostic (&diagnostic);
1187 va_end (ap);
1190 /* A hard error: the code is definitely ill-formed, and an object file
1191 will not be produced. */
1192 void
1193 error_n (location_t location, int n, const char *singular_gmsgid,
1194 const char *plural_gmsgid, ...)
1196 diagnostic_info diagnostic;
1197 va_list ap;
1199 va_start (ap, plural_gmsgid);
1200 diagnostic_set_info_translated (&diagnostic,
1201 ngettext (singular_gmsgid, plural_gmsgid, n),
1202 &ap, location, DK_ERROR);
1203 report_diagnostic (&diagnostic);
1204 va_end (ap);
1207 /* Same as ebove, but use location LOC instead of input_location. */
1208 void
1209 error_at (location_t loc, const char *gmsgid, ...)
1211 diagnostic_info diagnostic;
1212 va_list ap;
1214 va_start (ap, gmsgid);
1215 diagnostic_set_info (&diagnostic, gmsgid, &ap, loc, DK_ERROR);
1216 report_diagnostic (&diagnostic);
1217 va_end (ap);
1220 /* "Sorry, not implemented." Use for a language feature which is
1221 required by the relevant specification but not implemented by GCC.
1222 An object file will not be produced. */
1223 void
1224 sorry (const char *gmsgid, ...)
1226 diagnostic_info diagnostic;
1227 va_list ap;
1229 va_start (ap, gmsgid);
1230 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_SORRY);
1231 report_diagnostic (&diagnostic);
1232 va_end (ap);
1235 /* Return true if an error or a "sorry" has been seen. Various
1236 processing is disabled after errors. */
1237 bool
1238 seen_error (void)
1240 return errorcount || sorrycount;
1243 /* An error which is severe enough that we make no attempt to
1244 continue. Do not use this for internal consistency checks; that's
1245 internal_error. Use of this function should be rare. */
1246 void
1247 fatal_error (location_t loc, const char *gmsgid, ...)
1249 diagnostic_info diagnostic;
1250 va_list ap;
1252 va_start (ap, gmsgid);
1253 diagnostic_set_info (&diagnostic, gmsgid, &ap, loc, DK_FATAL);
1254 report_diagnostic (&diagnostic);
1255 va_end (ap);
1257 gcc_unreachable ();
1260 /* An internal consistency check has failed. We make no attempt to
1261 continue. Note that unless there is debugging value to be had from
1262 a more specific message, or some other good reason, you should use
1263 abort () instead of calling this function directly. */
1264 void
1265 internal_error (const char *gmsgid, ...)
1267 diagnostic_info diagnostic;
1268 va_list ap;
1270 va_start (ap, gmsgid);
1271 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_ICE);
1272 report_diagnostic (&diagnostic);
1273 va_end (ap);
1275 gcc_unreachable ();
1278 /* Like internal_error, but no backtrace will be printed. Used when
1279 the internal error does not happen at the current location, but happened
1280 somewhere else. */
1281 void
1282 internal_error_no_backtrace (const char *gmsgid, ...)
1284 diagnostic_info diagnostic;
1285 va_list ap;
1287 va_start (ap, gmsgid);
1288 diagnostic_set_info (&diagnostic, gmsgid, &ap, input_location, DK_ICE_NOBT);
1289 report_diagnostic (&diagnostic);
1290 va_end (ap);
1292 gcc_unreachable ();
1295 /* Special case error functions. Most are implemented in terms of the
1296 above, or should be. */
1298 /* Print a diagnostic MSGID on FILE. This is just fprintf, except it
1299 runs its second argument through gettext. */
1300 void
1301 fnotice (FILE *file, const char *cmsgid, ...)
1303 va_list ap;
1305 va_start (ap, cmsgid);
1306 vfprintf (file, _(cmsgid), ap);
1307 va_end (ap);
1310 /* Inform the user that an error occurred while trying to report some
1311 other error. This indicates catastrophic internal inconsistencies,
1312 so give up now. But do try to flush out the previous error.
1313 This mustn't use internal_error, that will cause infinite recursion. */
1315 static void
1316 error_recursion (diagnostic_context *context)
1318 if (context->lock < 3)
1319 pp_newline_and_flush (context->printer);
1321 fnotice (stderr,
1322 "Internal compiler error: Error reporting routines re-entered.\n");
1324 /* Call diagnostic_action_after_output to get the "please submit a bug
1325 report" message. */
1326 diagnostic_action_after_output (context, DK_ICE);
1328 /* Do not use gcc_unreachable here; that goes through internal_error
1329 and therefore would cause infinite recursion. */
1330 real_abort ();
1333 /* Report an internal compiler error in a friendly manner. This is
1334 the function that gets called upon use of abort() in the source
1335 code generally, thanks to a special macro. */
1337 void
1338 fancy_abort (const char *file, int line, const char *function)
1340 internal_error ("in %s, at %s:%d", function, trim_filename (file), line);
1343 /* Really call the system 'abort'. This has to go right at the end of
1344 this file, so that there are no functions after it that call abort
1345 and get the system abort instead of our macro. */
1346 #undef abort
1347 static void
1348 real_abort (void)
1350 abort ();