1 /* Language-independent diagnostic subroutines for the GNU Compiler Collection
2 Copyright (C) 1999-2016 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"
31 #include "backtrace.h"
32 #include "diagnostic.h"
33 #include "diagnostic-color.h"
34 #include "edit-context.h"
41 #ifdef GWINSZ_IN_SYS_IOCTL
42 # include <sys/ioctl.h>
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)
51 static bool diagnostic_impl (rich_location
*, int, const char *,
52 va_list *, diagnostic_t
) ATTRIBUTE_GCC_DIAG(3,0);
53 static bool diagnostic_n_impl (location_t
, int, int, const char *,
54 const char *, va_list *,
55 diagnostic_t
) ATTRIBUTE_GCC_DIAG(5,0);
56 static bool diagnostic_n_impl_richloc (rich_location
*, int, int, const char *,
57 const char *, va_list *,
58 diagnostic_t
) ATTRIBUTE_GCC_DIAG(5,0);
60 static void error_recursion (diagnostic_context
*) ATTRIBUTE_NORETURN
;
61 static void real_abort (void) ATTRIBUTE_NORETURN
;
63 /* Name of program invoked, sans directories. */
67 /* A diagnostic_context surrogate for stderr. */
68 static diagnostic_context global_diagnostic_context
;
69 diagnostic_context
*global_dc
= &global_diagnostic_context
;
71 /* Return a malloc'd string containing MSG formatted a la printf. The
72 caller is responsible for freeing the memory. */
74 build_message_string (const char *msg
, ...)
80 str
= xvasprintf (msg
, ap
);
86 /* Same as diagnostic_build_prefix, but only the source FILE is given. */
88 file_name_as_prefix (diagnostic_context
*context
, const char *f
)
91 = colorize_start (pp_show_color (context
->printer
), "locus");
92 const char *locus_ce
= colorize_stop (pp_show_color (context
->printer
));
93 return build_message_string ("%s%s:%s ", locus_cs
, f
, locus_ce
);
98 /* Return the value of the getenv("COLUMNS") as an integer. If the
99 value is not set to a positive integer, use ioctl to get the
100 terminal width. If it fails, return INT_MAX. */
102 get_terminal_width (void)
104 const char * s
= getenv ("COLUMNS");
114 if (ioctl (0, TIOCGWINSZ
, &w
) == 0 && w
.ws_col
> 0)
121 /* Set caret_max_width to value. */
123 diagnostic_set_caret_max_width (diagnostic_context
*context
, int value
)
125 /* One minus to account for the leading empty space. */
126 value
= value
? value
- 1
127 : (isatty (fileno (pp_buffer (context
->printer
)->stream
))
128 ? get_terminal_width () - 1: INT_MAX
);
133 context
->caret_max_width
= value
;
136 /* Initialize the diagnostic message outputting machinery. */
138 diagnostic_initialize (diagnostic_context
*context
, int n_opts
)
142 /* Allocate a basic pretty-printer. Clients will replace this a
143 much more elaborated pretty-printer if they wish. */
144 context
->printer
= XNEW (pretty_printer
);
145 new (context
->printer
) pretty_printer ();
147 memset (context
->diagnostic_count
, 0, sizeof context
->diagnostic_count
);
148 context
->warning_as_error_requested
= false;
149 context
->n_opts
= n_opts
;
150 context
->classify_diagnostic
= XNEWVEC (diagnostic_t
, n_opts
);
151 for (i
= 0; i
< n_opts
; i
++)
152 context
->classify_diagnostic
[i
] = DK_UNSPECIFIED
;
153 context
->show_caret
= false;
154 diagnostic_set_caret_max_width (context
, pp_line_cutoff (context
->printer
));
155 for (i
= 0; i
< rich_location::STATICALLY_ALLOCATED_RANGES
; i
++)
156 context
->caret_chars
[i
] = '^';
157 context
->show_option_requested
= false;
158 context
->abort_on_error
= false;
159 context
->show_column
= false;
160 context
->pedantic_errors
= false;
161 context
->permissive
= false;
162 context
->opt_permissive
= 0;
163 context
->fatal_errors
= false;
164 context
->dc_inhibit_warnings
= false;
165 context
->dc_warn_system_headers
= false;
166 context
->max_errors
= 0;
167 context
->internal_error
= NULL
;
168 diagnostic_starter (context
) = default_diagnostic_starter
;
169 context
->start_span
= default_diagnostic_start_span_fn
;
170 diagnostic_finalizer (context
) = default_diagnostic_finalizer
;
171 context
->option_enabled
= NULL
;
172 context
->option_state
= NULL
;
173 context
->option_name
= NULL
;
174 context
->last_location
= UNKNOWN_LOCATION
;
175 context
->last_module
= 0;
176 context
->x_data
= NULL
;
178 context
->inhibit_notes_p
= false;
179 context
->colorize_source_p
= false;
180 context
->show_ruler_p
= false;
181 context
->parseable_fixits_p
= false;
182 context
->edit_context_ptr
= NULL
;
185 /* Maybe initialize the color support. We require clients to do this
186 explicitly, since most clients don't want color. When called
187 without a VALUE, it initializes with DIAGNOSTICS_COLOR_DEFAULT. */
190 diagnostic_color_init (diagnostic_context
*context
, int value
/*= -1 */)
192 /* value == -1 is the default value. */
195 /* If DIAGNOSTICS_COLOR_DEFAULT is -1, default to
196 -fdiagnostics-color=auto if GCC_COLORS is in the environment,
197 otherwise default to -fdiagnostics-color=never, for other
198 values default to that
199 -fdiagnostics-color={never,auto,always}. */
200 if (DIAGNOSTICS_COLOR_DEFAULT
== -1)
202 if (!getenv ("GCC_COLORS"))
204 value
= DIAGNOSTICS_COLOR_AUTO
;
207 value
= DIAGNOSTICS_COLOR_DEFAULT
;
209 pp_show_color (context
->printer
)
210 = colorize_init ((diagnostic_color_rule_t
) value
);
213 /* Do any cleaning up required after the last diagnostic is emitted. */
216 diagnostic_finish (diagnostic_context
*context
)
218 /* Some of the errors may actually have been warnings. */
219 if (diagnostic_kind_count (context
, DK_WERROR
))
221 /* -Werror was given. */
222 if (context
->warning_as_error_requested
)
223 pp_verbatim (context
->printer
,
224 _("%s: all warnings being treated as errors"),
226 /* At least one -Werror= was given. */
228 pp_verbatim (context
->printer
,
229 _("%s: some warnings being treated as errors"),
231 pp_newline_and_flush (context
->printer
);
234 diagnostic_file_cache_fini ();
236 XDELETEVEC (context
->classify_diagnostic
);
237 context
->classify_diagnostic
= NULL
;
239 /* diagnostic_initialize allocates context->printer using XNEW
240 and placement-new. */
241 context
->printer
->~pretty_printer ();
242 XDELETE (context
->printer
);
243 context
->printer
= NULL
;
245 if (context
->edit_context_ptr
)
247 delete context
->edit_context_ptr
;
248 context
->edit_context_ptr
= NULL
;
252 /* Initialize DIAGNOSTIC, where the message MSG has already been
255 diagnostic_set_info_translated (diagnostic_info
*diagnostic
, const char *msg
,
256 va_list *args
, rich_location
*richloc
,
259 gcc_assert (richloc
);
260 diagnostic
->message
.err_no
= errno
;
261 diagnostic
->message
.args_ptr
= args
;
262 diagnostic
->message
.format_spec
= msg
;
263 diagnostic
->message
.m_richloc
= richloc
;
264 diagnostic
->richloc
= richloc
;
265 diagnostic
->kind
= kind
;
266 diagnostic
->option_index
= 0;
269 /* Initialize DIAGNOSTIC, where the message GMSGID has not yet been
272 diagnostic_set_info (diagnostic_info
*diagnostic
, const char *gmsgid
,
273 va_list *args
, rich_location
*richloc
,
276 gcc_assert (richloc
);
277 diagnostic_set_info_translated (diagnostic
, _(gmsgid
), args
, richloc
, kind
);
280 static const char *const diagnostic_kind_color
[] = {
281 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (C),
282 #include "diagnostic.def"
283 #undef DEFINE_DIAGNOSTIC_KIND
287 /* Get a color name for diagnostics of type KIND
288 Result could be NULL. */
291 diagnostic_get_color_for_kind (diagnostic_t kind
)
293 return diagnostic_kind_color
[kind
];
296 /* Return a malloc'd string describing a location e.g. "foo.c:42:10".
297 The caller is responsible for freeing the memory. */
300 diagnostic_get_location_text (diagnostic_context
*context
,
303 pretty_printer
*pp
= context
->printer
;
304 const char *locus_cs
= colorize_start (pp_show_color (pp
), "locus");
305 const char *locus_ce
= colorize_stop (pp_show_color (pp
));
308 return build_message_string ("%s%s:%s", locus_cs
, progname
, locus_ce
);
310 if (!strcmp (s
.file
, N_("<built-in>")))
311 return build_message_string ("%s%s:%s", locus_cs
, s
.file
, locus_ce
);
313 if (context
->show_column
)
314 return build_message_string ("%s%s:%d:%d:%s", locus_cs
, s
.file
, s
.line
,
317 return build_message_string ("%s%s:%d:%s", locus_cs
, s
.file
, s
.line
,
321 /* Return a malloc'd string describing a location and the severity of the
322 diagnostic, e.g. "foo.c:42:10: error: ". The caller is responsible for
323 freeing the memory. */
325 diagnostic_build_prefix (diagnostic_context
*context
,
326 const diagnostic_info
*diagnostic
)
328 static const char *const diagnostic_kind_text
[] = {
329 #define DEFINE_DIAGNOSTIC_KIND(K, T, C) (T),
330 #include "diagnostic.def"
331 #undef DEFINE_DIAGNOSTIC_KIND
334 gcc_assert (diagnostic
->kind
< DK_LAST_DIAGNOSTIC_KIND
);
336 const char *text
= _(diagnostic_kind_text
[diagnostic
->kind
]);
337 const char *text_cs
= "", *text_ce
= "";
338 pretty_printer
*pp
= context
->printer
;
340 if (diagnostic_kind_color
[diagnostic
->kind
])
342 text_cs
= colorize_start (pp_show_color (pp
),
343 diagnostic_kind_color
[diagnostic
->kind
]);
344 text_ce
= colorize_stop (pp_show_color (pp
));
347 expanded_location s
= diagnostic_expand_location (diagnostic
);
348 char *location_text
= diagnostic_get_location_text (context
, s
);
350 char *result
= build_message_string ("%s %s%s%s", location_text
,
351 text_cs
, text
, text_ce
);
352 free (location_text
);
356 /* Functions at which to stop the backtrace print. It's not
357 particularly helpful to print the callers of these functions. */
359 static const char * const bt_stop
[] =
367 /* A callback function passed to the backtrace_full function. */
370 bt_callback (void *data
, uintptr_t pc
, const char *filename
, int lineno
,
371 const char *function
)
373 int *pcount
= (int *) data
;
375 /* If we don't have any useful information, don't print
377 if (filename
== NULL
&& function
== NULL
)
380 /* Skip functions in diagnostic.c. */
383 && strcmp (lbasename (filename
), "diagnostic.c") == 0)
386 /* Print up to 20 functions. We could make this a --param, but
387 since this is only for debugging just use a constant for now. */
390 /* Returning a non-zero value stops the backtrace. */
396 if (function
!= NULL
)
398 char *str
= cplus_demangle_v3 (function
,
399 (DMGL_VERBOSE
| DMGL_ANSI
400 | DMGL_GNU_V3
| DMGL_PARAMS
));
407 for (size_t i
= 0; i
< ARRAY_SIZE (bt_stop
); ++i
)
409 size_t len
= strlen (bt_stop
[i
]);
410 if (strncmp (function
, bt_stop
[i
], len
) == 0
411 && (function
[len
] == '\0' || function
[len
] == '('))
415 /* Returning a non-zero value stops the backtrace. */
421 fprintf (stderr
, "0x%lx %s\n\t%s:%d\n",
423 function
== NULL
? "???" : function
,
424 filename
== NULL
? "???" : filename
,
433 /* A callback function passed to the backtrace_full function. This is
434 called if backtrace_full has an error. */
437 bt_err_callback (void *data ATTRIBUTE_UNUSED
, const char *msg
, int errnum
)
441 /* This means that no debug info was available. Just quietly
442 skip printing backtrace info. */
445 fprintf (stderr
, "%s%s%s\n", msg
, errnum
== 0 ? "" : ": ",
446 errnum
== 0 ? "" : xstrerror (errnum
));
449 /* Take any action which is expected to happen after the diagnostic
450 is written out. This function does not always return. */
452 diagnostic_action_after_output (diagnostic_context
*context
,
453 diagnostic_t diag_kind
)
465 if (context
->abort_on_error
)
467 if (context
->fatal_errors
)
469 fnotice (stderr
, "compilation terminated due to -Wfatal-errors.\n");
470 diagnostic_finish (context
);
471 exit (FATAL_EXIT_CODE
);
473 if (context
->max_errors
!= 0
474 && ((unsigned) (diagnostic_kind_count (context
, DK_ERROR
)
475 + diagnostic_kind_count (context
, DK_SORRY
)
476 + diagnostic_kind_count (context
, DK_WERROR
))
477 >= context
->max_errors
))
480 "compilation terminated due to -fmax-errors=%u.\n",
481 context
->max_errors
);
482 diagnostic_finish (context
);
483 exit (FATAL_EXIT_CODE
);
490 struct backtrace_state
*state
= NULL
;
491 if (diag_kind
== DK_ICE
)
492 state
= backtrace_create_state (NULL
, 0, bt_err_callback
, NULL
);
495 backtrace_full (state
, 2, bt_callback
, bt_err_callback
,
498 if (context
->abort_on_error
)
501 fnotice (stderr
, "Please submit a full bug report,\n"
502 "with preprocessed source if appropriate.\n");
505 ("Please include the complete backtrace "
506 "with any bug report.\n"));
507 fnotice (stderr
, "See %s for instructions.\n", bug_report_url
);
509 exit (ICE_EXIT_CODE
);
513 if (context
->abort_on_error
)
515 diagnostic_finish (context
);
516 fnotice (stderr
, "compilation terminated.\n");
517 exit (FATAL_EXIT_CODE
);
525 diagnostic_report_current_module (diagnostic_context
*context
, location_t where
)
527 const line_map_ordinary
*map
= NULL
;
529 if (pp_needs_newline (context
->printer
))
531 pp_newline (context
->printer
);
532 pp_needs_newline (context
->printer
) = false;
535 if (where
<= BUILTINS_LOCATION
)
538 linemap_resolve_location (line_table
, where
,
539 LRK_MACRO_DEFINITION_LOCATION
,
542 if (map
&& diagnostic_last_module_changed (context
, map
))
544 diagnostic_set_last_module (context
, map
);
545 if (! MAIN_FILE_P (map
))
547 map
= INCLUDED_FROM (line_table
, map
);
548 if (context
->show_column
)
549 pp_verbatim (context
->printer
,
550 "In file included from %r%s:%d:%d%R", "locus",
552 LAST_SOURCE_LINE (map
), LAST_SOURCE_COLUMN (map
));
554 pp_verbatim (context
->printer
,
555 "In file included from %r%s:%d%R", "locus",
556 LINEMAP_FILE (map
), LAST_SOURCE_LINE (map
));
557 while (! MAIN_FILE_P (map
))
559 map
= INCLUDED_FROM (line_table
, map
);
560 pp_verbatim (context
->printer
,
561 ",\n from %r%s:%d%R", "locus",
562 LINEMAP_FILE (map
), LAST_SOURCE_LINE (map
));
564 pp_verbatim (context
->printer
, ":");
565 pp_newline (context
->printer
);
571 default_diagnostic_starter (diagnostic_context
*context
,
572 diagnostic_info
*diagnostic
)
574 diagnostic_report_current_module (context
, diagnostic_location (diagnostic
));
575 pp_set_prefix (context
->printer
, diagnostic_build_prefix (context
,
580 default_diagnostic_start_span_fn (diagnostic_context
*context
,
581 expanded_location exploc
)
583 pp_set_prefix (context
->printer
,
584 diagnostic_get_location_text (context
, exploc
));
585 pp_string (context
->printer
, "");
586 pp_newline (context
->printer
);
590 default_diagnostic_finalizer (diagnostic_context
*context
,
591 diagnostic_info
*diagnostic
)
593 diagnostic_show_locus (context
, diagnostic
->richloc
, diagnostic
->kind
);
594 pp_destroy_prefix (context
->printer
);
595 pp_flush (context
->printer
);
598 /* Interface to specify diagnostic kind overrides. Returns the
599 previous setting, or DK_UNSPECIFIED if the parameters are out of
600 range. If OPTION_INDEX is zero, the new setting is for all the
603 diagnostic_classify_diagnostic (diagnostic_context
*context
,
605 diagnostic_t new_kind
,
608 diagnostic_t old_kind
;
611 || option_index
>= context
->n_opts
612 || new_kind
>= DK_LAST_DIAGNOSTIC_KIND
)
613 return DK_UNSPECIFIED
;
615 old_kind
= context
->classify_diagnostic
[option_index
];
617 /* Handle pragmas separately, since we need to keep track of *where*
619 if (where
!= UNKNOWN_LOCATION
)
623 /* Record the command-line status, so we can reset it back on DK_POP. */
624 if (old_kind
== DK_UNSPECIFIED
)
626 old_kind
= !context
->option_enabled (option_index
,
627 context
->option_state
)
628 ? DK_IGNORED
: (context
->warning_as_error_requested
629 ? DK_ERROR
: DK_WARNING
);
630 context
->classify_diagnostic
[option_index
] = old_kind
;
633 for (i
= context
->n_classification_history
- 1; i
>= 0; i
--)
634 if (context
->classification_history
[i
].option
== option_index
)
636 old_kind
= context
->classification_history
[i
].kind
;
640 i
= context
->n_classification_history
;
641 context
->classification_history
=
642 (diagnostic_classification_change_t
*) xrealloc (context
->classification_history
, (i
+ 1)
643 * sizeof (diagnostic_classification_change_t
));
644 context
->classification_history
[i
].location
= where
;
645 context
->classification_history
[i
].option
= option_index
;
646 context
->classification_history
[i
].kind
= new_kind
;
647 context
->n_classification_history
++;
650 context
->classify_diagnostic
[option_index
] = new_kind
;
655 /* Save all diagnostic classifications in a stack. */
657 diagnostic_push_diagnostics (diagnostic_context
*context
, location_t where ATTRIBUTE_UNUSED
)
659 context
->push_list
= (int *) xrealloc (context
->push_list
, (context
->n_push
+ 1) * sizeof (int));
660 context
->push_list
[context
->n_push
++] = context
->n_classification_history
;
663 /* Restore the topmost classification set off the stack. If the stack
664 is empty, revert to the state based on command line parameters. */
666 diagnostic_pop_diagnostics (diagnostic_context
*context
, location_t where
)
672 jump_to
= context
->push_list
[-- context
->n_push
];
676 i
= context
->n_classification_history
;
677 context
->classification_history
=
678 (diagnostic_classification_change_t
*) xrealloc (context
->classification_history
, (i
+ 1)
679 * sizeof (diagnostic_classification_change_t
));
680 context
->classification_history
[i
].location
= where
;
681 context
->classification_history
[i
].option
= jump_to
;
682 context
->classification_history
[i
].kind
= DK_POP
;
683 context
->n_classification_history
++;
686 /* Helper function for print_parseable_fixits. Print TEXT to PP, obeying the
687 escaping rules for -fdiagnostics-parseable-fixits. */
690 print_escaped_string (pretty_printer
*pp
, const char *text
)
695 pp_character (pp
, '"');
696 for (const char *ch
= text
; *ch
; ch
++)
701 /* Escape backslash as two backslashes. */
702 pp_string (pp
, "\\\\");
705 /* Escape tab as "\t". */
706 pp_string (pp
, "\\t");
709 /* Escape newline as "\n". */
710 pp_string (pp
, "\\n");
713 /* Escape doublequotes as \". */
714 pp_string (pp
, "\\\"");
718 pp_character (pp
, *ch
);
720 /* Use octal for non-printable chars. */
722 unsigned char c
= (*ch
& 0xff);
723 pp_printf (pp
, "\\%o%o%o", (c
/ 64), (c
/ 8) & 007, c
& 007);
728 pp_character (pp
, '"');
731 /* Implementation of -fdiagnostics-parseable-fixits. Print a
732 machine-parseable version of all fixits in RICHLOC to PP. */
735 print_parseable_fixits (pretty_printer
*pp
, rich_location
*richloc
)
738 gcc_assert (richloc
);
740 for (unsigned i
= 0; i
< richloc
->get_num_fixit_hints (); i
++)
742 const fixit_hint
*hint
= richloc
->get_fixit_hint (i
);
743 source_location start_loc
= hint
->get_start_loc ();
744 expanded_location start_exploc
= expand_location (start_loc
);
745 pp_string (pp
, "fix-it:");
746 print_escaped_string (pp
, start_exploc
.file
);
747 source_location end_loc
;
749 /* For compatibility with clang, print as a half-open range. */
750 if (hint
->maybe_get_end_loc (&end_loc
))
752 expanded_location end_exploc
= expand_location (end_loc
);
753 pp_printf (pp
, ":{%i:%i-%i:%i}:",
754 start_exploc
.line
, start_exploc
.column
,
755 end_exploc
.line
, end_exploc
.column
+ 1);
759 pp_printf (pp
, ":{%i:%i-%i:%i}:",
760 start_exploc
.line
, start_exploc
.column
,
761 start_exploc
.line
, start_exploc
.column
);
763 switch (hint
->get_kind ())
765 case fixit_hint::INSERT
:
767 const fixit_insert
*insert
768 = static_cast <const fixit_insert
*> (hint
);
769 print_escaped_string (pp
, insert
->get_string ());
773 case fixit_hint::REPLACE
:
775 const fixit_replace
*replace
776 = static_cast <const fixit_replace
*> (hint
);
777 print_escaped_string (pp
, replace
->get_string ());
788 /* Report a diagnostic message (an error or a warning) as specified by
789 DC. This function is *the* subroutine in terms of which front-ends
790 should implement their specific diagnostic handling modules. The
791 front-end independent format specifiers are exactly those described
792 in the documentation of output_format.
793 Return true if a diagnostic was printed, false otherwise. */
796 diagnostic_report_diagnostic (diagnostic_context
*context
,
797 diagnostic_info
*diagnostic
)
799 location_t location
= diagnostic_location (diagnostic
);
800 diagnostic_t orig_diag_kind
= diagnostic
->kind
;
801 const char *saved_format_spec
;
803 /* Give preference to being able to inhibit warnings, before they
804 get reclassified to something else. */
805 if ((diagnostic
->kind
== DK_WARNING
|| diagnostic
->kind
== DK_PEDWARN
)
806 && !diagnostic_report_warnings_p (context
, location
))
809 if (diagnostic
->kind
== DK_PEDWARN
)
811 diagnostic
->kind
= pedantic_warning_kind (context
);
812 /* We do this to avoid giving the message for -pedantic-errors. */
813 orig_diag_kind
= diagnostic
->kind
;
816 if (diagnostic
->kind
== DK_NOTE
&& context
->inhibit_notes_p
)
819 if (context
->lock
> 0)
821 /* If we're reporting an ICE in the middle of some other error,
822 try to flush out the previous error, then let this one
823 through. Don't do this more than once. */
824 if ((diagnostic
->kind
== DK_ICE
|| diagnostic
->kind
== DK_ICE_NOBT
)
825 && context
->lock
== 1)
826 pp_newline_and_flush (context
->printer
);
828 error_recursion (context
);
831 /* If the user requested that warnings be treated as errors, so be
832 it. Note that we do this before the next block so that
833 individual warnings can be overridden back to warnings with
835 if (context
->warning_as_error_requested
836 && diagnostic
->kind
== DK_WARNING
)
838 diagnostic
->kind
= DK_ERROR
;
841 if (diagnostic
->option_index
842 && diagnostic
->option_index
!= permissive_error_option (context
))
844 diagnostic_t diag_class
= DK_UNSPECIFIED
;
846 /* This tests if the user provided the appropriate -Wfoo or
848 if (! context
->option_enabled (diagnostic
->option_index
,
849 context
->option_state
))
852 /* This tests for #pragma diagnostic changes. */
853 if (context
->n_classification_history
> 0)
855 /* FIXME: Stupid search. Optimize later. */
856 for (int i
= context
->n_classification_history
- 1; i
>= 0; i
--)
858 if (linemap_location_before_p
860 context
->classification_history
[i
].location
,
863 if (context
->classification_history
[i
].kind
== (int) DK_POP
)
865 i
= context
->classification_history
[i
].option
;
868 int option
= context
->classification_history
[i
].option
;
869 /* The option 0 is for all the diagnostics. */
870 if (option
== 0 || option
== diagnostic
->option_index
)
872 diag_class
= context
->classification_history
[i
].kind
;
873 if (diag_class
!= DK_UNSPECIFIED
)
874 diagnostic
->kind
= diag_class
;
881 /* This tests if the user provided the appropriate -Werror=foo
883 if (diag_class
== DK_UNSPECIFIED
884 && (context
->classify_diagnostic
[diagnostic
->option_index
]
887 = context
->classify_diagnostic
[diagnostic
->option_index
];
889 /* This allows for future extensions, like temporarily disabling
890 warnings for ranges of source code. */
891 if (diagnostic
->kind
== DK_IGNORED
)
897 if (diagnostic
->kind
== DK_ICE
|| diagnostic
->kind
== DK_ICE_NOBT
)
899 /* When not checking, ICEs are converted to fatal errors when an
900 error has already occurred. This is counteracted by
903 && (diagnostic_kind_count (context
, DK_ERROR
) > 0
904 || diagnostic_kind_count (context
, DK_SORRY
) > 0)
905 && !context
->abort_on_error
)
908 = expand_location (diagnostic_location (diagnostic
));
909 fnotice (stderr
, "%s:%d: confused by earlier errors, bailing out\n",
911 exit (ICE_EXIT_CODE
);
913 if (context
->internal_error
)
914 (*context
->internal_error
) (context
,
915 diagnostic
->message
.format_spec
,
916 diagnostic
->message
.args_ptr
);
918 if (diagnostic
->kind
== DK_ERROR
&& orig_diag_kind
== DK_WARNING
)
919 ++diagnostic_kind_count (context
, DK_WERROR
);
921 ++diagnostic_kind_count (context
, diagnostic
->kind
);
923 saved_format_spec
= diagnostic
->message
.format_spec
;
924 if (context
->show_option_requested
)
928 option_text
= context
->option_name (context
, diagnostic
->option_index
,
929 orig_diag_kind
, diagnostic
->kind
);
934 = colorize_start (pp_show_color (context
->printer
),
935 diagnostic_kind_color
[diagnostic
->kind
]);
936 const char *ce
= colorize_stop (pp_show_color (context
->printer
));
937 diagnostic
->message
.format_spec
938 = ACONCAT ((diagnostic
->message
.format_spec
,
940 "[", cs
, option_text
, ce
, "]",
945 diagnostic
->message
.x_data
= &diagnostic
->x_data
;
946 diagnostic
->x_data
= NULL
;
947 pp_format (context
->printer
, &diagnostic
->message
);
948 (*diagnostic_starter (context
)) (context
, diagnostic
);
949 pp_output_formatted_text (context
->printer
);
950 (*diagnostic_finalizer (context
)) (context
, diagnostic
);
951 if (context
->parseable_fixits_p
)
953 print_parseable_fixits (context
->printer
, diagnostic
->richloc
);
954 pp_flush (context
->printer
);
956 diagnostic_action_after_output (context
, diagnostic
->kind
);
957 diagnostic
->message
.format_spec
= saved_format_spec
;
958 diagnostic
->x_data
= NULL
;
960 if (context
->edit_context_ptr
)
961 context
->edit_context_ptr
->add_fixits (diagnostic
->richloc
);
968 /* Given a partial pathname as input, return another pathname that
969 shares no directory elements with the pathname of __FILE__. This
970 is used by fancy_abort() to print `Internal compiler error in expr.c'
971 instead of `Internal compiler error in ../../GCC/gcc/expr.c'. */
974 trim_filename (const char *name
)
976 static const char this_file
[] = __FILE__
;
977 const char *p
= name
, *q
= this_file
;
979 /* First skip any "../" in each filename. This allows us to give a proper
980 reference to a file in a subdirectory. */
981 while (p
[0] == '.' && p
[1] == '.' && IS_DIR_SEPARATOR (p
[2]))
984 while (q
[0] == '.' && q
[1] == '.' && IS_DIR_SEPARATOR (q
[2]))
987 /* Now skip any parts the two filenames have in common. */
988 while (*p
== *q
&& *p
!= 0 && *q
!= 0)
991 /* Now go backwards until the previous directory separator. */
992 while (p
> name
&& !IS_DIR_SEPARATOR (p
[-1]))
998 /* Standard error reporting routines in increasing order of severity.
999 All of these take arguments like printf. */
1001 /* Text to be emitted verbatim to the error message stream; this
1002 produces no prefix and disables line-wrapping. Use rarely. */
1004 verbatim (const char *gmsgid
, ...)
1009 va_start (ap
, gmsgid
);
1010 text
.err_no
= errno
;
1011 text
.args_ptr
= &ap
;
1012 text
.format_spec
= _(gmsgid
);
1014 pp_format_verbatim (global_dc
->printer
, &text
);
1015 pp_newline_and_flush (global_dc
->printer
);
1019 /* Add a note with text GMSGID and with LOCATION to the diagnostic CONTEXT. */
1021 diagnostic_append_note (diagnostic_context
*context
,
1022 location_t location
,
1023 const char * gmsgid
, ...)
1025 diagnostic_info diagnostic
;
1027 const char *saved_prefix
;
1028 rich_location
richloc (line_table
, location
);
1030 va_start (ap
, gmsgid
);
1031 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, &richloc
, DK_NOTE
);
1032 if (context
->inhibit_notes_p
)
1037 saved_prefix
= pp_get_prefix (context
->printer
);
1038 pp_set_prefix (context
->printer
,
1039 diagnostic_build_prefix (context
, &diagnostic
));
1040 pp_format (context
->printer
, &diagnostic
.message
);
1041 pp_output_formatted_text (context
->printer
);
1042 pp_destroy_prefix (context
->printer
);
1043 pp_set_prefix (context
->printer
, saved_prefix
);
1044 diagnostic_show_locus (context
, &richloc
, DK_NOTE
);
1048 /* Implement emit_diagnostic, inform, inform_at_rich_loc, warning, warning_at,
1049 warning_at_rich_loc, pedwarn, permerror, permerror_at_rich_loc, error,
1050 error_at, error_at_rich_loc, sorry, fatal_error, internal_error, and
1051 internal_error_no_backtrace, as documented and defined below. */
1053 diagnostic_impl (rich_location
*richloc
, int opt
,
1055 va_list *ap
, diagnostic_t kind
)
1057 diagnostic_info diagnostic
;
1058 if (kind
== DK_PERMERROR
)
1060 diagnostic_set_info (&diagnostic
, gmsgid
, ap
, richloc
,
1061 permissive_error_kind (global_dc
));
1062 diagnostic
.option_index
= permissive_error_option (global_dc
);
1066 diagnostic_set_info (&diagnostic
, gmsgid
, ap
, richloc
, kind
);
1067 if (kind
== DK_WARNING
|| kind
== DK_PEDWARN
)
1068 diagnostic
.option_index
= opt
;
1070 return report_diagnostic (&diagnostic
);
1073 /* Same as diagonostic_n_impl taking rich_location instead of location_t. */
1075 diagnostic_n_impl_richloc (rich_location
*richloc
, int opt
, int n
,
1076 const char *singular_gmsgid
,
1077 const char *plural_gmsgid
,
1078 va_list *ap
, diagnostic_t kind
)
1080 diagnostic_info diagnostic
;
1081 diagnostic_set_info_translated (&diagnostic
,
1082 ngettext (singular_gmsgid
, plural_gmsgid
, n
),
1084 if (kind
== DK_WARNING
)
1085 diagnostic
.option_index
= opt
;
1086 return report_diagnostic (&diagnostic
);
1089 /* Implement inform_n, warning_n, and error_n, as documented and
1092 diagnostic_n_impl (location_t location
, int opt
, int n
,
1093 const char *singular_gmsgid
,
1094 const char *plural_gmsgid
,
1095 va_list *ap
, diagnostic_t kind
)
1097 rich_location
richloc (line_table
, location
);
1098 return diagnostic_n_impl_richloc (&richloc
, opt
, n
,
1099 singular_gmsgid
, plural_gmsgid
, ap
, kind
);
1103 emit_diagnostic (diagnostic_t kind
, location_t location
, int opt
,
1104 const char *gmsgid
, ...)
1107 va_start (ap
, gmsgid
);
1108 rich_location
richloc (line_table
, location
);
1109 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, kind
);
1114 /* An informative note at LOCATION. Use this for additional details on an error
1117 inform (location_t location
, const char *gmsgid
, ...)
1120 va_start (ap
, gmsgid
);
1121 rich_location
richloc (line_table
, location
);
1122 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_NOTE
);
1126 /* Same as "inform", but at RICHLOC. */
1128 inform_at_rich_loc (rich_location
*richloc
, const char *gmsgid
, ...)
1131 va_start (ap
, gmsgid
);
1132 diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_NOTE
);
1136 /* An informative note at LOCATION. Use this for additional details on an
1139 inform_n (location_t location
, int n
, const char *singular_gmsgid
,
1140 const char *plural_gmsgid
, ...)
1143 va_start (ap
, plural_gmsgid
);
1144 diagnostic_n_impl (location
, -1, n
, singular_gmsgid
, plural_gmsgid
,
1149 /* A warning at INPUT_LOCATION. Use this for code which is correct according
1150 to the relevant language specification but is likely to be buggy anyway.
1151 Returns true if the warning was printed, false if it was inhibited. */
1153 warning (int opt
, const char *gmsgid
, ...)
1156 va_start (ap
, gmsgid
);
1157 rich_location
richloc (line_table
, input_location
);
1158 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1163 /* A warning at LOCATION. Use this for code which is correct according to the
1164 relevant language specification but is likely to be buggy anyway.
1165 Returns true if the warning was printed, false if it was inhibited. */
1168 warning_at (location_t location
, int opt
, const char *gmsgid
, ...)
1171 va_start (ap
, gmsgid
);
1172 rich_location
richloc (line_table
, location
);
1173 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1178 /* Same as warning at, but using RICHLOC. */
1181 warning_at_rich_loc (rich_location
*richloc
, int opt
, const char *gmsgid
, ...)
1184 va_start (ap
, gmsgid
);
1185 bool ret
= diagnostic_impl (richloc
, opt
, gmsgid
, &ap
, DK_WARNING
);
1190 /* Same as warning_at_rich_loc but for plural variant. */
1193 warning_at_rich_loc_n (rich_location
*richloc
, int opt
, int n
,
1194 const char *singular_gmsgid
, const char *plural_gmsgid
, ...)
1197 va_start (ap
, plural_gmsgid
);
1198 bool ret
= diagnostic_n_impl_richloc (richloc
, opt
, n
,
1199 singular_gmsgid
, plural_gmsgid
,
1205 /* A warning at LOCATION. Use this for code which is correct according to the
1206 relevant language specification but is likely to be buggy anyway.
1207 Returns true if the warning was printed, false if it was inhibited. */
1210 warning_n (location_t location
, int opt
, int n
, const char *singular_gmsgid
,
1211 const char *plural_gmsgid
, ...)
1214 va_start (ap
, plural_gmsgid
);
1215 bool ret
= diagnostic_n_impl (location
, opt
, n
,
1216 singular_gmsgid
, plural_gmsgid
,
1222 /* A "pedantic" warning at LOCATION: issues a warning unless
1223 -pedantic-errors was given on the command line, in which case it
1224 issues an error. Use this for diagnostics required by the relevant
1225 language standard, if you have chosen not to make them errors.
1227 Note that these diagnostics are issued independent of the setting
1228 of the -Wpedantic command-line switch. To get a warning enabled
1229 only with that switch, use either "if (pedantic) pedwarn
1230 (OPT_Wpedantic,...)" or just "pedwarn (OPT_Wpedantic,..)". To get a
1231 pedwarn independently of the -Wpedantic switch use "pedwarn (0,...)".
1233 Returns true if the warning was printed, false if it was inhibited. */
1236 pedwarn (location_t location
, int opt
, const char *gmsgid
, ...)
1239 va_start (ap
, gmsgid
);
1240 rich_location
richloc (line_table
, location
);
1241 bool ret
= diagnostic_impl (&richloc
, opt
, gmsgid
, &ap
, DK_PEDWARN
);
1246 /* Same as pedwarn, but using RICHLOC. */
1249 pedwarn_at_rich_loc (rich_location
*richloc
, int opt
, const char *gmsgid
, ...)
1252 va_start (ap
, gmsgid
);
1253 bool ret
= diagnostic_impl (richloc
, opt
, gmsgid
, &ap
, DK_PEDWARN
);
1258 /* A "permissive" error at LOCATION: issues an error unless
1259 -fpermissive was given on the command line, in which case it issues
1260 a warning. Use this for things that really should be errors but we
1261 want to support legacy code.
1263 Returns true if the warning was printed, false if it was inhibited. */
1266 permerror (location_t location
, const char *gmsgid
, ...)
1269 va_start (ap
, gmsgid
);
1270 rich_location
richloc (line_table
, location
);
1271 bool ret
= diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_PERMERROR
);
1276 /* Same as "permerror", but at RICHLOC. */
1279 permerror_at_rich_loc (rich_location
*richloc
, const char *gmsgid
, ...)
1282 va_start (ap
, gmsgid
);
1283 bool ret
= diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_PERMERROR
);
1288 /* A hard error: the code is definitely ill-formed, and an object file
1289 will not be produced. */
1291 error (const char *gmsgid
, ...)
1294 va_start (ap
, gmsgid
);
1295 rich_location
richloc (line_table
, input_location
);
1296 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1300 /* A hard error: the code is definitely ill-formed, and an object file
1301 will not be produced. */
1303 error_n (location_t location
, int n
, const char *singular_gmsgid
,
1304 const char *plural_gmsgid
, ...)
1307 va_start (ap
, plural_gmsgid
);
1308 diagnostic_n_impl (location
, -1, n
, singular_gmsgid
, plural_gmsgid
,
1313 /* Same as above, but use location LOC instead of input_location. */
1315 error_at (location_t loc
, const char *gmsgid
, ...)
1318 va_start (ap
, gmsgid
);
1319 rich_location
richloc (line_table
, loc
);
1320 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1324 /* Same as above, but use RICH_LOC. */
1327 error_at_rich_loc (rich_location
*richloc
, const char *gmsgid
, ...)
1330 va_start (ap
, gmsgid
);
1331 diagnostic_impl (richloc
, -1, gmsgid
, &ap
, DK_ERROR
);
1335 /* "Sorry, not implemented." Use for a language feature which is
1336 required by the relevant specification but not implemented by GCC.
1337 An object file will not be produced. */
1339 sorry (const char *gmsgid
, ...)
1342 va_start (ap
, gmsgid
);
1343 rich_location
richloc (line_table
, input_location
);
1344 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_SORRY
);
1348 /* Return true if an error or a "sorry" has been seen. Various
1349 processing is disabled after errors. */
1353 return errorcount
|| sorrycount
;
1356 /* An error which is severe enough that we make no attempt to
1357 continue. Do not use this for internal consistency checks; that's
1358 internal_error. Use of this function should be rare. */
1360 fatal_error (location_t loc
, const char *gmsgid
, ...)
1363 va_start (ap
, gmsgid
);
1364 rich_location
richloc (line_table
, loc
);
1365 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_FATAL
);
1371 /* An internal consistency check has failed. We make no attempt to
1372 continue. Note that unless there is debugging value to be had from
1373 a more specific message, or some other good reason, you should use
1374 abort () instead of calling this function directly. */
1376 internal_error (const char *gmsgid
, ...)
1379 va_start (ap
, gmsgid
);
1380 rich_location
richloc (line_table
, input_location
);
1381 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ICE
);
1387 /* Like internal_error, but no backtrace will be printed. Used when
1388 the internal error does not happen at the current location, but happened
1391 internal_error_no_backtrace (const char *gmsgid
, ...)
1394 va_start (ap
, gmsgid
);
1395 rich_location
richloc (line_table
, input_location
);
1396 diagnostic_impl (&richloc
, -1, gmsgid
, &ap
, DK_ICE_NOBT
);
1402 /* Special case error functions. Most are implemented in terms of the
1403 above, or should be. */
1405 /* Print a diagnostic MSGID on FILE. This is just fprintf, except it
1406 runs its second argument through gettext. */
1408 fnotice (FILE *file
, const char *cmsgid
, ...)
1412 va_start (ap
, cmsgid
);
1413 vfprintf (file
, _(cmsgid
), ap
);
1417 /* Inform the user that an error occurred while trying to report some
1418 other error. This indicates catastrophic internal inconsistencies,
1419 so give up now. But do try to flush out the previous error.
1420 This mustn't use internal_error, that will cause infinite recursion. */
1423 error_recursion (diagnostic_context
*context
)
1425 if (context
->lock
< 3)
1426 pp_newline_and_flush (context
->printer
);
1429 "Internal compiler error: Error reporting routines re-entered.\n");
1431 /* Call diagnostic_action_after_output to get the "please submit a bug
1433 diagnostic_action_after_output (context
, DK_ICE
);
1435 /* Do not use gcc_unreachable here; that goes through internal_error
1436 and therefore would cause infinite recursion. */
1440 /* Report an internal compiler error in a friendly manner. This is
1441 the function that gets called upon use of abort() in the source
1442 code generally, thanks to a special macro. */
1445 fancy_abort (const char *file
, int line
, const char *function
)
1447 internal_error ("in %s, at %s:%d", function
, trim_filename (file
), line
);
1450 /* Really call the system 'abort'. This has to go right at the end of
1451 this file, so that there are no functions after it that call abort
1452 and get the system abort instead of our macro. */
1462 namespace selftest
{
1464 /* Helper function for test_print_escaped_string. */
1467 assert_print_escaped_string (const location
&loc
, const char *expected_output
,
1471 print_escaped_string (&pp
, input
);
1472 ASSERT_STREQ_AT (loc
, expected_output
, pp_formatted_text (&pp
));
1475 #define ASSERT_PRINT_ESCAPED_STRING_STREQ(EXPECTED_OUTPUT, INPUT) \
1476 assert_print_escaped_string (SELFTEST_LOCATION, EXPECTED_OUTPUT, INPUT)
1478 /* Tests of print_escaped_string. */
1481 test_print_escaped_string ()
1484 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"\"", "");
1486 /* Non-empty string. */
1487 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"hello world\"", "hello world");
1489 /* Various things that need to be escaped: */
1491 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\\\after\"",
1494 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\tafter\"",
1497 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\nafter\"",
1500 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\\"after\"",
1503 /* Non-printable characters: BEL: '\a': 0x07 */
1504 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\007after\"",
1506 /* Non-printable characters: vertical tab: '\v': 0x0b */
1507 ASSERT_PRINT_ESCAPED_STRING_STREQ ("\"before\\013after\"",
1511 /* Tests of print_parseable_fixits. */
1513 /* Verify that print_parseable_fixits emits the empty string if there
1517 test_print_parseable_fixits_none ()
1520 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1522 print_parseable_fixits (&pp
, &richloc
);
1523 ASSERT_STREQ ("", pp_formatted_text (&pp
));
1526 /* Verify that print_parseable_fixits does the right thing if there
1527 is an insertion fixit hint. */
1530 test_print_parseable_fixits_insert ()
1533 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1535 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1536 linemap_line_start (line_table
, 5, 100);
1537 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1538 location_t where
= linemap_position_for_column (line_table
, 10);
1539 richloc
.add_fixit_insert_before (where
, "added content");
1541 print_parseable_fixits (&pp
, &richloc
);
1542 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:10}:\"added content\"\n",
1543 pp_formatted_text (&pp
));
1546 /* Verify that print_parseable_fixits does the right thing if there
1547 is an removal fixit hint. */
1550 test_print_parseable_fixits_remove ()
1553 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1555 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1556 linemap_line_start (line_table
, 5, 100);
1557 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1559 where
.m_start
= linemap_position_for_column (line_table
, 10);
1560 where
.m_finish
= linemap_position_for_column (line_table
, 20);
1561 richloc
.add_fixit_remove (where
);
1563 print_parseable_fixits (&pp
, &richloc
);
1564 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:21}:\"\"\n",
1565 pp_formatted_text (&pp
));
1568 /* Verify that print_parseable_fixits does the right thing if there
1569 is an replacement fixit hint. */
1572 test_print_parseable_fixits_replace ()
1575 rich_location
richloc (line_table
, UNKNOWN_LOCATION
);
1577 linemap_add (line_table
, LC_ENTER
, false, "test.c", 0);
1578 linemap_line_start (line_table
, 5, 100);
1579 linemap_add (line_table
, LC_LEAVE
, false, NULL
, 0);
1581 where
.m_start
= linemap_position_for_column (line_table
, 10);
1582 where
.m_finish
= linemap_position_for_column (line_table
, 20);
1583 richloc
.add_fixit_replace (where
, "replacement");
1585 print_parseable_fixits (&pp
, &richloc
);
1586 ASSERT_STREQ ("fix-it:\"test.c\":{5:10-5:21}:\"replacement\"\n",
1587 pp_formatted_text (&pp
));
1590 /* Run all of the selftests within this file. */
1593 diagnostic_c_tests ()
1595 test_print_escaped_string ();
1596 test_print_parseable_fixits_none ();
1597 test_print_parseable_fixits_insert ();
1598 test_print_parseable_fixits_remove ();
1599 test_print_parseable_fixits_replace ();
1602 } // namespace selftest
1604 #endif /* #if CHECKING_P */