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 int debug_ignore_block           PARAMS ((union tree_node *));
  41 extern const char *trim_filename        PARAMS ((const char *));
  42 extern void internal_error              PARAMS ((const char *, ...))
  43                                                ATTRIBUTE_PRINTF_1
  44                                                ATTRIBUTE_NORETURN;
  45 extern void fatal_io_error              PARAMS ((const char *, ...))
  46                                                ATTRIBUTE_PRINTF_1
  47                                                ATTRIBUTE_NORETURN;
  48 extern void _fatal_insn_not_found       PARAMS ((struct rtx_def *,
  49                                                 const char *, int,
  50                                                 const char *))
  51                                                ATTRIBUTE_NORETURN;
  52 extern void _fatal_insn                 PARAMS ((const char *,
  53                                                 struct rtx_def *,
  54                                                 const char *, int,
  55                                                 const char *))
  56                                               ATTRIBUTE_NORETURN;
  57
  58 #define fatal_insn(msgid, insn) \
  59         _fatal_insn (msgid, insn, __FILE__, __LINE__, __FUNCTION__)
  60 #define fatal_insn_not_found(insn) \
  61         _fatal_insn_not_found (insn, __FILE__, __LINE__, __FUNCTION__)
  62
  63 extern void warning                     PARAMS ((const char *, ...))
  64                                                ATTRIBUTE_PRINTF_1;
  65 extern void error                       PARAMS ((const char *, ...))
  66                                                ATTRIBUTE_PRINTF_1;
  67 extern void fatal_error                 PARAMS ((const char *, ...))
  68                                                ATTRIBUTE_NORETURN
  69                                                ATTRIBUTE_PRINTF_1;
  70 extern void pedwarn                     PARAMS ((const char *, ...))
  71                                                ATTRIBUTE_PRINTF_1;
  72 extern void pedwarn_with_file_and_line  PARAMS ((const char *, int,
  73                                                  const char *, ...))
  74                                                ATTRIBUTE_PRINTF_3;
  75 extern void warning_with_file_and_line  PARAMS ((const char *, int,
  76                                                  const char *, ...))
  77                                                ATTRIBUTE_PRINTF_3;
  78 extern void error_with_file_and_line    PARAMS ((const char *, int,
  79                                                  const char *, ...))
  80                                                ATTRIBUTE_PRINTF_3;
  81 extern void sorry                       PARAMS ((const char *, ...))
  82                                                ATTRIBUTE_PRINTF_1;
  83 extern void report_error_function       PARAMS ((const char *));
  84
  85 extern void rest_of_decl_compilation    PARAMS ((union tree_node *,
  86                                                 const char *, int, int));
  87 extern void rest_of_type_compilation    PARAMS ((union tree_node *, int));
  88 extern void rest_of_compilation         PARAMS ((union tree_node *));
  89
  90 /* The *_with_decl functions aren't suitable for ATTRIBUTE_PRINTF. */
  91 extern void pedwarn_with_decl           PARAMS ((union tree_node *,
  92                                                  const char *, ...));
  93 extern void warning_with_decl           PARAMS ((union tree_node *,
  94                                                  const char *, ...));
  95 extern void error_with_decl             PARAMS ((union tree_node *,
  96                                                  const char *, ...));
  97
  98 extern void announce_function           PARAMS ((union tree_node *));
  99
 100 extern void error_for_asm               PARAMS ((struct rtx_def *,
 101                                                  const char *, ...))
 102                                                ATTRIBUTE_PRINTF_2;
 103 extern void warning_for_asm             PARAMS ((struct rtx_def *,
 104                                                  const char *, ...))
 105                                                ATTRIBUTE_PRINTF_2;
 106 #if defined (_JBLEN) || defined (setjmp)
 107 extern void set_float_handler PARAMS ((jmp_buf));
 108 #endif
 109 extern int do_float_handler PARAMS ((void (*) (PTR), PTR));
 110
 111 #ifdef BUFSIZ
 112 extern void output_quoted_string        PARAMS ((FILE *, const char *));
 113 extern void output_file_directive       PARAMS ((FILE *, const char *));
 114 #endif
 115 extern void do_abort                    PARAMS ((void)) ATTRIBUTE_NORETURN;
 116 extern void botch                       PARAMS ((const char *))
 117   ATTRIBUTE_NORETURN;
 118
 119 #ifdef BUFSIZ
 120 extern void fnotice                     PARAMS ((FILE *, const char *, ...))
 121                                                ATTRIBUTE_PRINTF_2;
 122 #endif
 123
 124 extern int wrapup_global_declarations   PARAMS ((union tree_node **, int));
 125 extern void check_global_declarations   PARAMS ((union tree_node **, int));
 126 extern void note_deferral_of_defined_inline_function
 127                                         PARAMS ((union tree_node *));
 128 extern void note_outlining_of_inline_function
 129                                         PARAMS ((union tree_node *));
 130
 131 extern const char *progname;
 132 extern const char *dump_base_name;
 133
 134 /* Language-specific hooks.  Can be NULL unless otherwise specified.  */
 135 struct lang_hooks
 136 {
 137   /* Called first, to initialize the front end.  */
 138   void (*init) PARAMS ((void));
 139
 140   /* Called last, as a finalizer.  */
 141   void (*finish) PARAMS ((void));
 142
 143   /* Called to initialize options, before any calls to decode_option.  */
 144   void (*init_options) PARAMS ((void));
 145
 146   /* Function called with an option vector as argument, to decode a
 147      single option (typically starting with -f or -W or +).  It should
 148      return the number of command-line arguments it uses if it handles
 149      the option, or 0 and not complain if it does not recognise the
 150      option.  If this function returns a negative number, then its
 151      absolute value is the number of command-line arguments used, but,
 152      in addition, no language-independent option processing should be
 153      done for this option.
 154
 155      This hook cannot be NULL.  */
 156   int (*decode_option) PARAMS ((int, char **));
 157
 158   /* Called when all command line options have been processed.  */
 159   void (*post_options) PARAMS ((void));
 160 };
 161
 162 /* Each front end provides its own.  */
 163 extern struct lang_hooks lang_hooks;
 164
 165 /* The hashtable, so that the C front ends can pass it to cpplib.  */
 166 extern struct ht *ident_hash;
 167
 168 /* These functions can be used by targets to set the flags originally
 169    implied by -ffast-math and -fno-fast-math.  */
 170
 171 extern void set_fast_math_flags         PARAMS ((void));
 172 extern void set_no_fast_math_flags      PARAMS ((void));
 173
 174 /* The following functions accept a wide integer argument.  Rather
 175    than having to cast on every function call, we use a macro instead.  */
 176
 177 #ifndef exact_log2
 178 #define exact_log2(N) exact_log2_wide ((unsigned HOST_WIDE_INT) (N))
 179 #define floor_log2(N) floor_log2_wide ((unsigned HOST_WIDE_INT) (N))
 180 #endif
 181 extern int exact_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
 182 extern int floor_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
 183
 184 #endif /* ! GCC_TOPLEV_H */