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