gcc/toplev.h

   1 /* toplev.h - Various declarations for functions found in toplev.c
   2    Copyright (C) 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006, 2007
   3    Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   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
  10 version.
  11
  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
  15 for more details.
  16
  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/>.  */
  20
  21 #ifndef GCC_TOPLEV_H
  22 #define GCC_TOPLEV_H
  23 #include "input.h"
  24
  25 /* If non-NULL, return one past-the-end of the matching SUBPART of
  26    the WHOLE string.  */
  27 #define skip_leading_substring(whole,  part) \
  28    (strncmp (whole, part, strlen (part)) ? NULL : whole + strlen (part))
  29
  30 extern int toplev_main (unsigned int, const char **);
  31 extern int read_integral_parameter (const char *, const char *, const int);
  32 extern void strip_off_ending (char *, int);
  33 extern const char *trim_filename (const char *);
  34 extern void _fatal_insn_not_found (const_rtx, const char *, int, const char *)
  35      ATTRIBUTE_NORETURN;
  36 extern void _fatal_insn (const char *, const_rtx, const char *, int, const char *)
  37      ATTRIBUTE_NORETURN;
  38
  39 #define fatal_insn(msgid, insn) \
  40         _fatal_insn (msgid, insn, __FILE__, __LINE__, __FUNCTION__)
  41 #define fatal_insn_not_found(insn) \
  42         _fatal_insn_not_found (insn, __FILE__, __LINE__, __FUNCTION__)
  43
  44 /* If we haven't already defined a frontend 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 GCC_VERSION >= 4001
  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_at (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
  65 extern void fatal_error (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2)
  66      ATTRIBUTE_NORETURN;
  67 /* Pass one of the OPT_W* from options.h as the second parameter.  */
  68 extern bool pedwarn (location_t, int, const char *, ...)
  69      ATTRIBUTE_GCC_DIAG(3,4);
  70 extern bool permerror (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
  71 extern void sorry (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2);
  72 extern void inform (location_t, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
  73 extern void verbatim (const char *, ...) ATTRIBUTE_GCC_DIAG(1,2);
  74
  75 extern void rest_of_decl_compilation (tree, int, int);
  76 extern void rest_of_type_compilation (tree, int);
  77 extern void tree_rest_of_compilation (tree);
  78 extern void init_optimization_passes (void);
  79 extern void finish_optimization_passes (void);
  80 extern bool enable_rtl_dump_file (void);
  81
  82 extern void announce_function (tree);
  83
  84 extern void error_for_asm (const_rtx, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
  85 extern void warning_for_asm (const_rtx, const char *, ...) ATTRIBUTE_GCC_DIAG(2,3);
  86 extern void warn_deprecated_use (tree);
  87 extern bool parse_optimize_options (tree, bool);
  88
  89 #ifdef BUFSIZ
  90 extern void output_quoted_string        (FILE *, const char *);
  91 extern void output_file_directive       (FILE *, const char *);
  92 #endif
  93
  94 #ifdef BUFSIZ
  95   /* N.B. Unlike all the others, fnotice is just gettext+fprintf, and
  96      therefore it can have ATTRIBUTE_PRINTF.  */
  97 extern void fnotice                     (FILE *, const char *, ...)
  98      ATTRIBUTE_PRINTF_2;
  99 #endif
 100
 101 extern void wrapup_global_declaration_1 (tree);
 102 extern bool wrapup_global_declaration_2 (tree);
 103 extern bool wrapup_global_declarations (tree *, int);
 104 extern void check_global_declaration_1 (tree);
 105 extern void check_global_declarations (tree *, int);
 106 extern void emit_debug_global_declarations (tree *, int);
 107 extern void write_global_declarations (void);
 108
 109 extern void dump_memory_report (bool);
 110
 111 extern void target_reinit (void);
 112
 113 /* A unique local time stamp, might be zero if none is available.  */
 114 extern unsigned local_tick;
 115
 116 extern const char *progname;
 117 extern const char *dump_base_name;
 118 extern const char *aux_base_name;
 119 extern const char *aux_info_file_name;
 120 extern const char *profile_data_prefix;
 121 extern const char *asm_file_name;
 122 extern bool exit_after_options;
 123
 124 /* True if the user has tagged the function with the 'section'
 125    attribute.  */
 126
 127 extern bool user_defined_section_attribute;
 128
 129 /* See toplev.c.  */
 130 extern int flag_crossjumping;
 131 extern int flag_if_conversion;
 132 extern int flag_if_conversion2;
 133 extern int flag_keep_static_consts;
 134 extern int flag_peel_loops;
 135 extern int flag_rerun_cse_after_loop;
 136 extern int flag_thread_jumps;
 137 extern int flag_tracer;
 138 extern int flag_unroll_loops;
 139 extern int flag_unroll_all_loops;
 140 extern int flag_unswitch_loops;
 141 extern int flag_cprop_registers;
 142 extern int time_report;
 143 extern int flag_ira;
 144 extern int flag_ira_coalesce;
 145 extern int flag_ira_move_spills;
 146 extern int flag_ira_share_save_slots;
 147 extern int flag_ira_share_spill_slots;
 148
 149 /* Things to do with target switches.  */
 150 extern void print_version (FILE *, const char *);
 151 extern void * default_get_pch_validity (size_t *);
 152 extern const char * default_pch_valid_p (const void *, size_t);
 153
 154 /* The hashtable, so that the C front ends can pass it to cpplib.  */
 155 extern struct ht *ident_hash;
 156
 157 /* This function can be used by targets to set the flags originally
 158     implied by -ffast-math and -fno-fast-math.  */
 159
 160 extern void set_fast_math_flags         (int);
 161
 162 extern void set_unsafe_math_optimizations_flags (int);
 163
 164 /* Handle -d switch.  */
 165 extern void decode_d_option             (const char *);
 166
 167 /* Return true iff flags are set as if -ffast-math.  */
 168 extern bool fast_math_flags_set_p       (void);
 169 extern bool fast_math_flags_struct_set_p (struct cl_optimization *);
 170
 171 /* Return log2, or -1 if not exact.  */
 172 extern int exact_log2                  (unsigned HOST_WIDE_INT);
 173
 174 /* Return floor of log2, with -1 for zero.  */
 175 extern int floor_log2                  (unsigned HOST_WIDE_INT);
 176
 177 /* Inline versions of the above for speed.  */
 178 #if GCC_VERSION >= 3004
 179 # if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
 180 #  define CLZ_HWI __builtin_clzl
 181 #  define CTZ_HWI __builtin_ctzl
 182 # elif HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONGLONG
 183 #  define CLZ_HWI __builtin_clzll
 184 #  define CTZ_HWI __builtin_ctzll
 185 # else
 186 #  define CLZ_HWI __builtin_clz
 187 #  define CTZ_HWI __builtin_ctz
 188 # endif
 189
 190 extern inline int
 191 floor_log2 (unsigned HOST_WIDE_INT x)
 192 {
 193   return x ? HOST_BITS_PER_WIDE_INT - 1 - (int) CLZ_HWI (x) : -1;
 194 }
 195
 196 extern inline int
 197 exact_log2 (unsigned HOST_WIDE_INT x)
 198 {
 199   return x == (x & -x) && x ? (int) CTZ_HWI (x) : -1;
 200 }
 201 #endif /* GCC_VERSION >= 3004 */
 202
 203 /* Functions used to get and set GCC's notion of in what directory
 204    compilation was started.  */
 205
 206 extern const char *get_src_pwd         (void);
 207 extern bool set_src_pwd                (const char *);
 208
 209 /* Functions used to manipulate the random seed.  */
 210
 211 extern const char *get_random_seed (bool);
 212 extern const char *set_random_seed (const char *);
 213
 214 #endif /* ! GCC_TOPLEV_H */