gcc/toplev.h

   1 /* toplev.h - Various declarations for functions found in toplev.c
   2    Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
   3
   4 This file is part of GNU CC.
   5
   6 GNU CC is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU CC is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU CC; see the file COPYING.  If not, write to
  18 the Free Software Foundation, 59 Temple Place - Suite 330,
  19 Boston, MA 02111-1307, USA.  */
  20
  21 #ifndef GCC_TOPLEV_H
  22 #define GCC_TOPLEV_H
  23
  24 #ifdef ANSI_PROTOTYPES
  25 union tree_node;
  26 struct rtx_def;
  27 #endif
  28
  29 /* If non-NULL, return one past-the-end of the matching SUBPART of
  30    the WHOLE string.  */
  31 #define skip_leading_substring(whole,  part) \
  32    (strncmp (whole, part, strlen (part)) ? NULL : whole + strlen (part))
  33
  34 extern int toplev_main                  PARAMS ((int argc, char **argv));
  35 extern int read_integral_parameter      PARAMS ((const char *, const char *,
  36                                                 const int));
  37 extern int count_error                  PARAMS ((int));
  38 extern void strip_off_ending            PARAMS ((char *, int));
  39 extern void print_time                  PARAMS ((const char *, long));
  40 extern void debug_start_source_file     PARAMS ((const char *));
  41 extern void debug_end_source_file       PARAMS ((unsigned));
  42 extern void debug_define                PARAMS ((unsigned, const char *));
  43 extern void debug_undef                 PARAMS ((unsigned, const char *));
  44 extern int debug_ignore_block           PARAMS ((union tree_node *));
  45 extern const char *trim_filename        PARAMS ((const char *));
  46 extern void internal_error              PARAMS ((const char *, ...))
  47                                                ATTRIBUTE_PRINTF_1
  48                                                ATTRIBUTE_NORETURN;
  49 extern void fatal_io_error              PARAMS ((const char *, ...))
  50                                                ATTRIBUTE_PRINTF_1
  51                                                ATTRIBUTE_NORETURN;
  52 extern void _fatal_insn_not_found       PARAMS ((struct rtx_def *,
  53                                                 const char *, int,
  54                                                 const char *))
  55                                                ATTRIBUTE_NORETURN;
  56 extern void _fatal_insn                 PARAMS ((const char *,
  57                                                 struct rtx_def *,
  58                                                 const char *, int,
  59                                                 const char *))
  60                                               ATTRIBUTE_NORETURN;
  61
  62 #define fatal_insn(msgid, insn) \
  63         _fatal_insn (msgid, insn, __FILE__, __LINE__, __FUNCTION__)
  64 #define fatal_insn_not_found(insn) \
  65         _fatal_insn_not_found (insn, __FILE__, __LINE__, __FUNCTION__)
  66
  67 extern void warning                     PARAMS ((const char *, ...))
  68                                                ATTRIBUTE_PRINTF_1;
  69 extern void error                       PARAMS ((const char *, ...))
  70                                                ATTRIBUTE_PRINTF_1;
  71 extern void fatal_error                 PARAMS ((const char *, ...))
  72                                                ATTRIBUTE_NORETURN
  73                                                ATTRIBUTE_PRINTF_1;
  74 extern void pedwarn                     PARAMS ((const char *, ...))
  75                                                ATTRIBUTE_PRINTF_1;
  76 extern void pedwarn_with_file_and_line  PARAMS ((const char *, int,
  77                                                  const char *, ...))
  78                                                ATTRIBUTE_PRINTF_3;
  79 extern void warning_with_file_and_line  PARAMS ((const char *, int,
  80                                                  const char *, ...))
  81                                                ATTRIBUTE_PRINTF_3;
  82 extern void error_with_file_and_line    PARAMS ((const char *, int,
  83                                                  const char *, ...))
  84                                                ATTRIBUTE_PRINTF_3;
  85 extern void sorry                       PARAMS ((const char *, ...))
  86                                                ATTRIBUTE_PRINTF_1;
  87 extern void report_error_function       PARAMS ((const char *));
  88
  89 extern void rest_of_decl_compilation    PARAMS ((union tree_node *,
  90                                                 const char *, int, int));
  91 extern void rest_of_type_compilation    PARAMS ((union tree_node *, int));
  92 extern void rest_of_compilation         PARAMS ((union tree_node *));
  93
  94 /* The *_with_decl functions aren't suitable for ATTRIBUTE_PRINTF. */
  95 extern void pedwarn_with_decl           PARAMS ((union tree_node *,
  96                                                  const char *, ...));
  97 extern void warning_with_decl           PARAMS ((union tree_node *,
  98                                                  const char *, ...));
  99 extern void error_with_decl             PARAMS ((union tree_node *,
 100                                                  const char *, ...));
 101
 102 extern void announce_function           PARAMS ((union tree_node *));
 103
 104 extern void error_for_asm               PARAMS ((struct rtx_def *,
 105                                                  const char *, ...))
 106                                                ATTRIBUTE_PRINTF_2;
 107 extern void warning_for_asm             PARAMS ((struct rtx_def *,
 108                                                  const char *, ...))
 109                                                ATTRIBUTE_PRINTF_2;
 110 #if defined (_JBLEN) || defined (setjmp)
 111 extern void set_float_handler PARAMS ((jmp_buf));
 112 #endif
 113 extern int do_float_handler PARAMS ((void (*) (PTR), PTR));
 114
 115 #ifdef BUFSIZ
 116 extern void output_quoted_string        PARAMS ((FILE *, const char *));
 117 extern void output_file_directive       PARAMS ((FILE *, const char *));
 118 #endif
 119 extern void do_abort                    PARAMS ((void)) ATTRIBUTE_NORETURN;
 120 extern void botch                       PARAMS ((const char *))
 121   ATTRIBUTE_NORETURN;
 122
 123 #ifdef BUFSIZ
 124 extern void fnotice                     PARAMS ((FILE *, const char *, ...))
 125                                                ATTRIBUTE_PRINTF_2;
 126 #endif
 127
 128 extern int wrapup_global_declarations   PARAMS ((union tree_node **, int));
 129 extern void check_global_declarations   PARAMS ((union tree_node **, int));
 130 extern void note_deferral_of_defined_inline_function
 131                                         PARAMS ((union tree_node *));
 132 extern void note_outlining_of_inline_function
 133                                         PARAMS ((union tree_node *));
 134
 135 extern const char *progname;
 136 extern const char *dump_base_name;
 137
 138 /* Language-specific hooks.  Can be NULL unless otherwise specified.  */
 139 struct lang_hooks
 140 {
 141   /* Called first, to initialize the front end.  */
 142   void (*init) PARAMS ((void));
 143
 144   /* Called last, as a finalizer.  */
 145   void (*finish) PARAMS ((void));
 146
 147   /* Called to initialize options, before any calls to decode_option.  */
 148   void (*init_options) PARAMS ((void));
 149
 150   /* Function called with an option vector as argument, to decode a
 151      single option (typically starting with -f or -W or +).  It should
 152      return the number of command-line arguments it uses if it handles
 153      the option, or 0 and not complain if it does not recognise the
 154      option.  If this function returns a negative number, then its
 155      absolute value is the number of command-line arguments used, but,
 156      in addition, no language-independent option processing should be
 157      done for this option.
 158
 159      This hook cannot be NULL.  */
 160   int (*decode_option) PARAMS ((int, char **));
 161
 162   /* Called when all command line options have been processed.  */
 163   void (*post_options) PARAMS ((void));
 164 };
 165
 166 /* Each front end provides its own.  */
 167 extern struct lang_hooks lang_hooks;
 168
 169 /* The hashtable, so that the C front ends can pass it to cpplib.  */
 170 extern struct ht *ident_hash;
 171
 172 /* These functions can be used by targets to set the flags originally
 173    implied by -ffast-math and -fno-fast-math.  */
 174
 175 extern void set_fast_math_flags         PARAMS ((void));
 176 extern void set_no_fast_math_flags      PARAMS ((void));
 177
 178 /* The following functions accept a wide integer argument.  Rather
 179    than having to cast on every function call, we use a macro instead.  */
 180
 181 #ifndef exact_log2
 182 #define exact_log2(N) exact_log2_wide ((unsigned HOST_WIDE_INT) (N))
 183 #define floor_log2(N) floor_log2_wide ((unsigned HOST_WIDE_INT) (N))
 184 #endif
 185 extern int exact_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
 186 extern int floor_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
 187
 188 #endif /* ! GCC_TOPLEV_H */