Home | History | Annotate | Download | only in include
      1 /* Declarations of core diagnostic functionality for code that does
      2    not need to deal with diagnostic contexts or diagnostic info
      3    structures.
      4    Copyright (C) 1998-2013 Free Software Foundation, Inc.
      5 
      6 This file is part of GCC.
      7 
      8 GCC is free software; you can redistribute it and/or modify it under
      9 the terms of the GNU General Public License as published by the Free
     10 Software Foundation; either version 3, or (at your option) any later
     11 version.
     12 
     13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
     14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
     15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
     16 for more details.
     17 
     18 You should have received a copy of the GNU General Public License
     19 along with GCC; see the file COPYING3.  If not see
     20 <http://www.gnu.org/licenses/>.  */
     21 
     22 #ifndef GCC_DIAGNOSTIC_CORE_H
     23 #define GCC_DIAGNOSTIC_CORE_H
     24 
     25 #include "input.h"
     26 #include "bversion.h"
     27 
     28 /* Constants used to discriminate diagnostics.  */
     29 typedef enum
     30 {
     31 #define DEFINE_DIAGNOSTIC_KIND(K, msgid) K,
     32 #include "diagnostic.def"
     33 #undef DEFINE_DIAGNOSTIC_KIND
     34   DK_LAST_DIAGNOSTIC_KIND,
     35   /* This is used for tagging pragma pops in the diagnostic
     36      classification history chain.  */
     37   DK_POP
     38 } diagnostic_t;
     39 
     40 extern const char *progname;
     41 
     42 extern const char *trim_filename (const char *);
     43 
     44 /* If we haven't already defined a front-end-specific diagnostics
     45    style, use the generic one.  */
     46 #ifndef GCC_DIAG_STYLE
     47 #define GCC_DIAG_STYLE __gcc_tdiag__
     48 #endif
     49 /* None of these functions are suitable for ATTRIBUTE_PRINTF, because
     50    each language front end can extend them with its own set of format
     51    specifiers.  We must use custom format checks.  */
     52 #if (ENABLE_CHECKING && GCC_VERSION >= 4001) || GCC_VERSION == BUILDING_GCC_VERSION
     53 #define ATTRIBUTE_GCC_DIAG(m, n) __attribute__ ((__format__ (GCC_DIAG_STYLE, m, n))) ATTRIBUTE_NONNULL(m)
     54 #else
     55 #define ATTRIBUTE_GCC_DIAG(m, n) ATTRIBUTE_NONNULL(m)
     56 #endif
     57 extern void internal_error (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2)
     58      ATTRIBUTE_NORETURN;
     59 /* Pass one of the OPT_W* from options.h as the first parameter.  */
     60 extern bool warning (int, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
     61 extern bool warning_at (location_t, int, const char *, ...)
     62     ATTRIBUTE_GCC_DIAG(3,4);
     63 extern void error (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2);
     64 extern void error_n (location_t, int, const char *, const char *, ...)
     65     ATTRIBUTE_GCC_DIAG(3,5) ATTRIBUTE_GCC_DIAG(4,5);
     66 extern void error_at (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
     67 extern void fatal_error (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2)
     68      ATTRIBUTE_NORETURN;
     69 /* Pass one of the OPT_W* from options.h as the second parameter.  */
     70 extern bool pedwarn (location_t, int, const char *, ...)
     71      ATTRIBUTE_GCC_DIAG(3,4);
     72 extern bool permerror (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
     73 extern void sorry (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2);
     74 extern void inform (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
     75 extern void inform_n (location_t, int, const char *, const char *, ...)
     76     ATTRIBUTE_GCC_DIAG(3,5) ATTRIBUTE_GCC_DIAG(4,5);
     77 extern void verbatim (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2);
     78 extern bool emit_diagnostic (diagnostic_t, location_t, int,
     79 			     const char *, ...) ATTRIBUTE_GCC_DIAG(4,5);
     80 extern bool seen_error (void);
     81 
     82 #ifdef BUFSIZ
     83   /* N.B. Unlike all the others, fnotice is just gettext+fprintf, and
     84      therefore it can have ATTRIBUTE_PRINTF.  */
     85 extern void fnotice			(FILE *, const char *, ...)
     86      ATTRIBUTE_PRINTF_2;
     87 #endif
     88 
     89 #endif /* ! GCC_DIAGNOSTIC_CORE_H */
     90