gcc/flags.h

   1 /* Compilation switch flag definitions for GNU CC.
   2    Copyright (C) 1987, 1988 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, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19
  20 /* Name of the input .c file being compiled.  */
  21 extern char *main_input_filename;
  22
  23 enum debug_info_type
  24 {
  25   NO_DEBUG,         /* Write no debug info.  */
  26   DBX_DEBUG,        /* Write BSD .stabs for DBX (using dbxout.c).  */
  27   SDB_DEBUG,        /* Write COFF for (old) SDB (using sdbout.c).  */
  28   DWARF_DEBUG,      /* Write Dwarf debug info (using dwarfout.c).  */
  29   XCOFF_DEBUG       /* Write IBM/Xcoff debug info (using dbxout.c).  */
  30 };
  31
  32 /* Specify which kind of debugging info to generate.  */
  33 extern enum debug_info_type write_symbols;
  34
  35 enum debug_info_level
  36 {
  37   DINFO_LEVEL_NONE,     /* Write no debugging info.  */
  38   DINFO_LEVEL_TERSE,    /* Write minimal info to support tracebacks only.  */
  39   DINFO_LEVEL_NORMAL,   /* Write info for all declarations (and line table). */
  40   DINFO_LEVEL_VERBOSE   /* Write normal info plus #define/#undef info.  */
  41 };
  42
  43 /* Specify how much debugging info to generate.  */
  44 extern enum debug_info_level debug_info_level;
  45
  46 #if defined (DBX_DEBUGGING_INFO) || defined (XCOFF_DEBUGGING_INFO)
  47 /* Nonzero means use GDB-only extensions of DBX format.  */
  48 extern int use_gdb_dbx_extensions;
  49 #endif
  50
  51 /* Nonzero means do optimizations.  -opt.  */
  52
  53 extern int optimize;
  54
  55 /* Nonzero means do stupid register allocation.  -noreg.
  56    Currently, this is 1 if `optimize' is 0.  */
  57
  58 extern int obey_regdecls;
  59
  60 /* Don't print functions as they are compiled and don't print
  61    times taken by the various passes.  -quiet.  */
  62
  63 extern int quiet_flag;
  64
  65 /* Don't print warning messages.  -w.  */
  66
  67 extern int inhibit_warnings;
  68
  69 /* Do print extra warnings (such as for uninitialized variables).  -W.  */
  70
  71 extern int extra_warnings;
  72
  73 /* Nonzero to warn about unused local variables.  */
  74
  75 extern int warn_unused;
  76
  77 /* Nonzero to warn about variables used before they are initialized.  */
  78
  79 extern int warn_uninitialized;
  80
  81 /* Nonzero means warn about all declarations which shadow others.   */
  82
  83 extern int warn_shadow;
  84
  85 /* Warn if a switch on an enum fails to have a case for every enum value.  */
  86
  87 extern int warn_switch;
  88
  89 /* Nonzero means warn about function definitions that default the return type
  90    or that use a null return and have a return-type other than void.  */
  91
  92 extern int warn_return_type;
  93
  94 /* Nonzero means warn about pointer casts that increase the required
  95    alignment of the target type (and might therefore lead to a crash
  96    due to a misaligned access).  */
  97
  98 extern int warn_cast_align;
  99
 100 /* Nonzero means warn about any identifiers that match in the first N
 101    characters.  The value N is in `id_clash_len'.  */
 102
 103 extern int warn_id_clash;
 104 extern int id_clash_len;
 105
 106 /* Warn if a function returns an aggregate,
 107    since there are often incompatible calling conventions for doing this.  */
 108
 109 extern int warn_aggregate_return;
 110
 111 /* Nonzero if generating code to do profiling.  */
 112
 113 extern int profile_flag;
 114
 115 /* Nonzero if generating code to do profiling on the basis of basic blocks.  */
 116
 117 extern int profile_block_flag;
 118
 119 /* Nonzero for -pedantic switch: warn about anything
 120    that standard C forbids.  */
 121
 122 extern int pedantic;
 123
 124 /* Temporarily suppress certain warnings.
 125    This is set while reading code from a system header file.  */
 126
 127 extern int in_system_header;
 128
 129 /* Nonzero for -dp: annotate the assembly with a comment describing the
 130    pattern and alternative used.  */
 131
 132 extern int flag_print_asm_name;
 133 \f
 134 /* Now the symbols that are set with `-f' switches.  */
 135
 136 /* Nonzero means `char' should be signed.  */
 137
 138 extern int flag_signed_char;
 139
 140 /* Nonzero means give an enum type only as many bytes as it needs.  */
 141
 142 extern int flag_short_enums;
 143
 144 /* Nonzero for -fcaller-saves: allocate values in regs that need to
 145    be saved across function calls, if that produces overall better code.
 146    Optional now, so people can test it.  */
 147
 148 extern int flag_caller_saves;
 149
 150 /* Nonzero for -fpcc-struct-return: return values the same way PCC does.  */
 151
 152 extern int flag_pcc_struct_return;
 153
 154 /* Nonzero for -fforce-mem: load memory value into a register
 155    before arithmetic on it.  This makes better cse but slower compilation.  */
 156
 157 extern int flag_force_mem;
 158
 159 /* Nonzero for -fforce-addr: load memory address into a register before
 160    reference to memory.  This makes better cse but slower compilation.  */
 161
 162 extern int flag_force_addr;
 163
 164 /* Nonzero for -fdefer-pop: don't pop args after each function call;
 165    instead save them up to pop many calls' args with one insns.  */
 166
 167 extern int flag_defer_pop;
 168
 169 /* Nonzero for -ffloat-store: don't allocate floats and doubles
 170    in extended-precision registers.  */
 171
 172 extern int flag_float_store;
 173
 174 /* Nonzero enables strength-reduction in loop.c.  */
 175
 176 extern int flag_strength_reduce;
 177
 178 /* Nonzero enables loop unrolling in unroll.c.  Only loops for which the
 179    number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
 180    UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
 181    unrolled.  */
 182
 183 extern int flag_unroll_loops;
 184
 185 /* Nonzero enables loop unrolling in unroll.c.  All loops are unrolled.
 186    This is generally not a win.  */
 187
 188 extern int flag_unroll_all_loops;
 189
 190 /* Nonzero for -fcse-follow-jumps:
 191    have cse follow jumps to do a more extensive job.  */
 192
 193 extern int flag_cse_follow_jumps;
 194
 195 /* Nonzero for -fcse-skip-blocks:
 196    have cse follow a branch around a block.  */
 197
 198 extern int flag_cse_skip_blocks;
 199
 200 /* Nonzero for -fexpensive-optimizations:
 201    perform miscellaneous relatively-expensive optimizations.  */
 202 extern int flag_expensive_optimizations;
 203
 204 /* Nonzero for -fwritable-strings:
 205    store string constants in data segment and don't uniquize them.  */
 206
 207 extern int flag_writable_strings;
 208
 209 /* Nonzero means don't put addresses of constant functions in registers.
 210    Used for compiling the Unix kernel, where strange substitutions are
 211    done on the assembly output.  */
 212
 213 extern int flag_no_function_cse;
 214
 215 /* Nonzero for -fomit-frame-pointer:
 216    don't make a frame pointer in simple functions that don't require one.  */
 217
 218 extern int flag_omit_frame_pointer;
 219
 220 /* Nonzero to inhibit use of define_optimization peephole opts.  */
 221
 222 extern int flag_no_peephole;
 223
 224 /* Nonzero means all references through pointers are volatile.  */
 225
 226 extern int flag_volatile;
 227
 228 /* Nonzero allows GCC to violate some IEEE or ANSI rules regarding math
 229    operations in the interest of optimization.  For example it allows
 230    GCC to assume arguments to sqrt are nonnegative numbers, allowing
 231    faster code for sqrt to be generated. */
 232
 233 extern int flag_fast_math;
 234
 235 /* Nonzero means make functions that look like good inline candidates
 236    go inline.  */
 237
 238 extern int flag_inline_functions;
 239
 240 /* Nonzero for -fkeep-inline-functions: even if we make a function
 241    go inline everywhere, keep its defintion around for debugging
 242    purposes.  */
 243
 244 extern int flag_keep_inline_functions;
 245
 246 /* Nonzero means that functions declared `inline' will be treated
 247    as `static'.  Prevents generation of zillions of copies of unused
 248    static inline functions; instead, `inlines' are written out
 249    only when actually used.  Used in conjunction with -g.  Also
 250    does the right thing with #pragma interface.  */
 251
 252 extern int flag_no_inline;
 253
 254 /* Nonzero if we are only using compiler to check syntax errors.  */
 255
 256 extern int flag_syntax_only;
 257
 258 /* Nonzero means we should save auxiliary info into a .X file.  */
 259
 260 extern int flag_gen_aux_info;
 261
 262 /* Nonzero means make the text shared if supported.  */
 263
 264 extern int flag_shared_data;
 265
 266 /* flag_schedule_insns means schedule insns within basic blocks (before
 267    local_alloc).
 268    flag_schedule_insns_after_reload means schedule insns after
 269    global_alloc.  */
 270
 271 extern int flag_schedule_insns;
 272 extern int flag_schedule_insns_after_reload;
 273
 274 /* Nonzero means put things in delayed-branch slots if supported. */
 275
 276 extern int flag_delayed_branch;
 277
 278 /* Nonzero means pretend it is OK to examine bits of target floats,
 279    even if that isn't true.  The resulting code will have incorrect constants,
 280    but the same series of instructions that the native compiler would make.  */
 281
 282 extern int flag_pretend_float;
 283
 284 /* Nonzero means change certain warnings into errors.
 285    Usually these are warnings about failure to conform to some standard.  */
 286
 287 extern int flag_pedantic_errors;
 288
 289 /* Nonzero means generate position-independent code.
 290    This is not fully implemented yet.  */
 291
 292 extern int flag_pic;
 293
 294 /* Nonzero means place uninitialized global data in the bss section.  */
 295
 296 extern int flag_no_common;
 297
 298 /* -finhibit-size-directive inhibits output of .size for ELF.
 299    This is used only for compiling crtstuff.c,
 300    and it may be extended to other effects
 301    needed for crtstuff.c on other systems.  */
 302 extern int flag_inhibit_size_directive;
 303
 304 /* -fgnu-linker specifies use of the GNU linker for initializations.
 305    -fno-gnu-linker says that collect will be used.  */
 306 extern int flag_gnu_linker;
 307 \f
 308 /* Other basic status info about current function.  */
 309
 310 /* Nonzero means current function must be given a frame pointer.
 311    Set in stmt.c if anything is allocated on the stack there.
 312    Set in reload1.c if anything is allocated on the stack there.  */
 313
 314 extern int frame_pointer_needed;
 315
 316 /* Set nonzero if jump_optimize finds that control falls through
 317    at the end of the function.  */
 318
 319 extern int can_reach_end;
 320
 321 /* Nonzero if function being compiled receives nonlocal gotos
 322    from nested functions.  */
 323
 324 extern int current_function_has_nonlocal_label;
 325