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 if (diagnostic
->kind
== DK_ERROR
&& orig_diag_kind
== DK_WARNING
)
733 ++diagnostic_kind_count (context
, DK_WERROR
);
735 ++diagnostic_kind_count (context
, diagnostic
->kind
);
737 saved_format_spec
= diagnostic
->message
.format_spec
;
738 if (context
->show_option_requested
)
742 option_text
= context
->option_name (context
, diagnostic
->option_index
,
743 orig_diag_kind
, diagnostic
->kind
);
747 diagnostic
->message
.format_spec
748 = ACONCAT ((diagnostic
->message
.format_spec
,
750 "[", option_text
, "]",
755 diagnostic
->message
.locus
= &diagnostic
->location
;
756 diagnostic
->message
.x_data
= &diagnostic
->x_data
;
757 diagnostic
->x_data
= NULL
;
758 pp_format (context
->printer
, &diagnostic
->message
);
759 (*diagnostic_starter (context
)) (context
, diagnostic
);
760 pp_output_formatted_text (context
->printer
);
761 diagnostic_show_locus (context
, diagnostic
);
762 (*diagnostic_finalizer (context
)) (context
, diagnostic
);
763 pp_destroy_prefix (context
->printer
);
764 pp_newline_and_flush (context
->printer
);
765 diagnostic_action_after_output (context
, diagnostic
);
766 diagnostic
->message
.format_spec
= saved_format_spec
;
767 diagnostic
->x_data
= NULL
;
774 /* Given a partial pathname as input, return another pathname that
775 shares no directory elements with the pathname of __FILE__. This
776 is used by fancy_abort() to print `Internal compiler error in expr.c'
777 instead of `Internal compiler error in ../../GCC/gcc/expr.c'. */
780 trim_filename (const char *name
)
782 static const char this_file
[] = __FILE__
;
783 const char *p
= name
, *q
= this_file
;
785 /* First skip any "../" in each filename. This allows us to give a proper
786 reference to a file in a subdirectory. */
787 while (p
[0] == '.' && p
[1] == '.' && IS_DIR_SEPARATOR (p
[2]))
790 while (q
[0] == '.' && q
[1] == '.' && IS_DIR_SEPARATOR (q
[2]))
793 /* Now skip any parts the two filenames have in common. */
794 while (*p
== *q
&& *p
!= 0 && *q
!= 0)
797 /* Now go backwards until the previous directory separator. */
798 while (p
> name
&& !IS_DIR_SEPARATOR (p
[-1]))
804 /* Standard error reporting routines in increasing order of severity.
805 All of these take arguments like printf. */
807 /* Text to be emitted verbatim to the error message stream; this
808 produces no prefix and disables line-wrapping. Use rarely. */
810 verbatim (const char *gmsgid
, ...)
815 va_start (ap
, gmsgid
);
818 text
.format_spec
= _(gmsgid
);
821 pp_format_verbatim (global_dc
->printer
, &text
);
822 pp_newline_and_flush (global_dc
->printer
);
826 /* Add a note with text GMSGID and with LOCATION to the diagnostic CONTEXT. */
828 diagnostic_append_note (diagnostic_context
*context
,
830 const char * gmsgid
, ...)
832 diagnostic_info diagnostic
;
834 const char *saved_prefix
;
836 va_start (ap
, gmsgid
);
837 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
, DK_NOTE
);
838 if (context
->inhibit_notes_p
)
843 saved_prefix
= pp_get_prefix (context
->printer
);
844 pp_set_prefix (context
->printer
,
845 diagnostic_build_prefix (context
, &diagnostic
));
846 pp_newline (context
->printer
);
847 pp_format (context
->printer
, &diagnostic
.message
);
848 pp_output_formatted_text (context
->printer
);
849 pp_destroy_prefix (context
->printer
);
850 pp_set_prefix (context
->printer
, saved_prefix
);
851 diagnostic_show_locus (context
, &diagnostic
);
856 emit_diagnostic (diagnostic_t kind
, location_t location
, int opt
,
857 const char *gmsgid
, ...)
859 diagnostic_info diagnostic
;
863 va_start (ap
, gmsgid
);
864 if (kind
== DK_PERMERROR
)
866 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
,
867 permissive_error_kind (global_dc
));
868 diagnostic
.option_index
= permissive_error_option (global_dc
);
871 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
, kind
);
872 if (kind
== DK_WARNING
|| kind
== DK_PEDWARN
)
873 diagnostic
.option_index
= opt
;
876 ret
= report_diagnostic (&diagnostic
);
881 /* An informative note at LOCATION. Use this for additional details on an error
884 inform (location_t location
, const char *gmsgid
, ...)
886 diagnostic_info diagnostic
;
889 va_start (ap
, gmsgid
);
890 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
, DK_NOTE
);
891 report_diagnostic (&diagnostic
);
895 /* An informative note at LOCATION. Use this for additional details on an
898 inform_n (location_t location
, int n
, const char *singular_gmsgid
,
899 const char *plural_gmsgid
, ...)
901 diagnostic_info diagnostic
;
904 va_start (ap
, plural_gmsgid
);
905 diagnostic_set_info_translated (&diagnostic
,
906 ngettext (singular_gmsgid
, plural_gmsgid
, n
),
907 &ap
, location
, DK_NOTE
);
908 report_diagnostic (&diagnostic
);
912 /* A warning at INPUT_LOCATION. Use this for code which is correct according
913 to the relevant language specification but is likely to be buggy anyway.
914 Returns true if the warning was printed, false if it was inhibited. */
916 warning (int opt
, const char *gmsgid
, ...)
918 diagnostic_info diagnostic
;
922 va_start (ap
, gmsgid
);
923 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, input_location
, DK_WARNING
);
924 diagnostic
.option_index
= opt
;
926 ret
= report_diagnostic (&diagnostic
);
931 /* A warning at LOCATION. Use this for code which is correct according to the
932 relevant language specification but is likely to be buggy anyway.
933 Returns true if the warning was printed, false if it was inhibited. */
936 warning_at (location_t location
, int opt
, const char *gmsgid
, ...)
938 diagnostic_info diagnostic
;
942 va_start (ap
, gmsgid
);
943 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
, DK_WARNING
);
944 diagnostic
.option_index
= opt
;
945 ret
= report_diagnostic (&diagnostic
);
950 /* A "pedantic" warning at LOCATION: issues a warning unless
951 -pedantic-errors was given on the command line, in which case it
952 issues an error. Use this for diagnostics required by the relevant
953 language standard, if you have chosen not to make them errors.
955 Note that these diagnostics are issued independent of the setting
956 of the -Wpedantic command-line switch. To get a warning enabled
957 only with that switch, use either "if (pedantic) pedwarn
958 (OPT_Wpedantic,...)" or just "pedwarn (OPT_Wpedantic,..)". To get a
959 pedwarn independently of the -Wpedantic switch use "pedwarn (0,...)".
961 Returns true if the warning was printed, false if it was inhibited. */
964 pedwarn (location_t location
, int opt
, const char *gmsgid
, ...)
966 diagnostic_info diagnostic
;
970 va_start (ap
, gmsgid
);
971 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
, DK_PEDWARN
);
972 diagnostic
.option_index
= opt
;
973 ret
= report_diagnostic (&diagnostic
);
978 /* A "permissive" error at LOCATION: issues an error unless
979 -fpermissive was given on the command line, in which case it issues
980 a warning. Use this for things that really should be errors but we
981 want to support legacy code.
983 Returns true if the warning was printed, false if it was inhibited. */
986 permerror (location_t location
, const char *gmsgid
, ...)
988 diagnostic_info diagnostic
;
992 va_start (ap
, gmsgid
);
993 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, location
,
994 permissive_error_kind (global_dc
));
995 diagnostic
.option_index
= permissive_error_option (global_dc
);
996 ret
= report_diagnostic (&diagnostic
);
1001 /* A hard error: the code is definitely ill-formed, and an object file
1002 will not be produced. */
1004 error (const char *gmsgid
, ...)
1006 diagnostic_info diagnostic
;
1009 va_start (ap
, gmsgid
);
1010 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, input_location
, DK_ERROR
);
1011 report_diagnostic (&diagnostic
);
1015 /* A hard error: the code is definitely ill-formed, and an object file
1016 will not be produced. */
1018 error_n (location_t location
, int n
, const char *singular_gmsgid
,
1019 const char *plural_gmsgid
, ...)
1021 diagnostic_info diagnostic
;
1024 va_start (ap
, plural_gmsgid
);
1025 diagnostic_set_info_translated (&diagnostic
,
1026 ngettext (singular_gmsgid
, plural_gmsgid
, n
),
1027 &ap
, location
, DK_ERROR
);
1028 report_diagnostic (&diagnostic
);
1032 /* Same as ebove, but use location LOC instead of input_location. */
1034 error_at (location_t loc
, const char *gmsgid
, ...)
1036 diagnostic_info diagnostic
;
1039 va_start (ap
, gmsgid
);
1040 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, loc
, DK_ERROR
);
1041 report_diagnostic (&diagnostic
);
1045 /* "Sorry, not implemented." Use for a language feature which is
1046 required by the relevant specification but not implemented by GCC.
1047 An object file will not be produced. */
1049 sorry (const char *gmsgid
, ...)
1051 diagnostic_info diagnostic
;
1054 va_start (ap
, gmsgid
);
1055 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, input_location
, DK_SORRY
);
1056 report_diagnostic (&diagnostic
);
1060 /* Return true if an error or a "sorry" has been seen. Various
1061 processing is disabled after errors. */
1065 return errorcount
|| sorrycount
;
1068 /* An error which is severe enough that we make no attempt to
1069 continue. Do not use this for internal consistency checks; that's
1070 internal_error. Use of this function should be rare. */
1072 fatal_error (const char *gmsgid
, ...)
1074 diagnostic_info diagnostic
;
1077 va_start (ap
, gmsgid
);
1078 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, input_location
, DK_FATAL
);
1079 report_diagnostic (&diagnostic
);
1085 /* An internal consistency check has failed. We make no attempt to
1086 continue. Note that unless there is debugging value to be had from
1087 a more specific message, or some other good reason, you should use
1088 abort () instead of calling this function directly. */
1090 internal_error (const char *gmsgid
, ...)
1092 diagnostic_info diagnostic
;
1095 va_start (ap
, gmsgid
);
1096 diagnostic_set_info (&diagnostic
, gmsgid
, &ap
, input_location
, DK_ICE
);
1097 report_diagnostic (&diagnostic
);
1103 /* Special case error functions. Most are implemented in terms of the
1104 above, or should be. */
1106 /* Print a diagnostic MSGID on FILE. This is just fprintf, except it
1107 runs its second argument through gettext. */
1109 fnotice (FILE *file
, const char *cmsgid
, ...)
1113 va_start (ap
, cmsgid
);
1114 vfprintf (file
, _(cmsgid
), ap
);
1118 /* Inform the user that an error occurred while trying to report some
1119 other error. This indicates catastrophic internal inconsistencies,
1120 so give up now. But do try to flush out the previous error.
1121 This mustn't use internal_error, that will cause infinite recursion. */
1124 error_recursion (diagnostic_context
*context
)
1126 diagnostic_info diagnostic
;
1128 if (context
->lock
< 3)
1129 pp_newline_and_flush (context
->printer
);
1132 "Internal compiler error: Error reporting routines re-entered.\n");
1134 /* Call diagnostic_action_after_output to get the "please submit a bug
1135 report" message. It only looks at the kind field of diagnostic_info. */
1136 diagnostic
.kind
= DK_ICE
;
1137 diagnostic_action_after_output (context
, &diagnostic
);
1139 /* Do not use gcc_unreachable here; that goes through internal_error
1140 and therefore would cause infinite recursion. */
1144 /* Report an internal compiler error in a friendly manner. This is
1145 the function that gets called upon use of abort() in the source
1146 code generally, thanks to a special macro. */
1149 fancy_abort (const char *file
, int line
, const char *function
)
1151 internal_error ("in %s, at %s:%d", function
, trim_filename (file
), line
);
1154 /* Really call the system 'abort'. This has to go right at the end of
1155 this file, so that there are no functions after it that call abort
1156 and get the system abort instead of our macro. */