gcc/flags.h

   1 /* Compilation switch flag definitions for GNU CC.
   2    Copyright (C) 1987, 88, 94-98, 1999 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 /* Name of the input .c file being compiled.  */
  22 extern char *main_input_filename;
  23
  24 enum debug_info_type
  25 {
  26   NO_DEBUG,         /* Write no debug info.  */
  27   DBX_DEBUG,        /* Write BSD .stabs for DBX (using dbxout.c).  */
  28   SDB_DEBUG,        /* Write COFF for (old) SDB (using sdbout.c).  */
  29   DWARF_DEBUG,      /* Write Dwarf debug info (using dwarfout.c).  */
  30   DWARF2_DEBUG,     /* Write Dwarf v2 debug info (using dwarf2out.c).  */
  31   XCOFF_DEBUG       /* Write IBM/Xcoff debug info (using dbxout.c).  */
  32 };
  33
  34 /* Specify which kind of debugging info to generate.  */
  35 extern enum debug_info_type write_symbols;
  36
  37 enum debug_info_level
  38 {
  39   DINFO_LEVEL_NONE,     /* Write no debugging info.  */
  40   DINFO_LEVEL_TERSE,    /* Write minimal info to support tracebacks only.  */
  41   DINFO_LEVEL_NORMAL,   /* Write info for all declarations (and line table). */
  42   DINFO_LEVEL_VERBOSE   /* Write normal info plus #define/#undef info.  */
  43 };
  44
  45 /* Specify how much debugging info to generate.  */
  46 extern enum debug_info_level debug_info_level;
  47
  48 /* Nonzero means use GNU-only extensions in the generated symbolic
  49    debugging information.  */
  50 extern int use_gnu_debug_info_extensions;
  51
  52 /* Nonzero means do optimizations.  -opt.  */
  53
  54 extern int optimize;
  55
  56 /* Nonzero means optimize for size.  -Os.  */
  57
  58 extern int optimize_size;
  59
  60 /* Nonzero means do stupid register allocation.  -noreg.
  61    Currently, this is 1 if `optimize' is 0.  */
  62
  63 extern int obey_regdecls;
  64
  65 /* Don't print functions as they are compiled and don't print
  66    times taken by the various passes.  -quiet.  */
  67
  68 extern int quiet_flag;
  69
  70 /* Don't print warning messages.  -w.  */
  71
  72 extern int inhibit_warnings;
  73
  74 /* Do print extra warnings (such as for uninitialized variables).  -W.  */
  75
  76 extern int extra_warnings;
  77
  78 /* Nonzero to warn about unused local variables.  */
  79
  80 extern int warn_unused;
  81
  82 /* Nonzero to warn about code which is never reached.  */
  83
  84 extern int warn_notreached;
  85
  86 /* Nonzero means warn if inline function is too large.  */
  87
  88 extern int warn_inline;
  89
  90 /* Nonzero to warn about variables used before they are initialized.  */
  91
  92 extern int warn_uninitialized;
  93
  94 /* Zero if unknown pragmas are ignored
  95    One if the compiler should warn about an unknown pragma not in
  96    a system include file.
  97    Greater than one if the compiler should warn for all unknown
  98    pragmas.  */
  99
 100 extern int warn_unknown_pragmas;
 101
 102 /* Nonzero means warn about all declarations which shadow others.   */
 103
 104 extern int warn_shadow;
 105
 106 /* Warn if a switch on an enum fails to have a case for every enum value.  */
 107
 108 extern int warn_switch;
 109
 110 /* Nonzero means warn about function definitions that default the return type
 111    or that use a null return and have a return-type other than void.  */
 112
 113 extern int warn_return_type;
 114
 115 /* Nonzero means warn about pointer casts that increase the required
 116    alignment of the target type (and might therefore lead to a crash
 117    due to a misaligned access).  */
 118
 119 extern int warn_cast_align;
 120
 121 /* Nonzero means warn that dbx info for template class methods isn't fully
 122    supported yet.  */
 123
 124 extern int warn_template_debugging;
 125
 126 /* Nonzero means warn about any identifiers that match in the first N
 127    characters.  The value N is in `id_clash_len'.  */
 128
 129 extern int warn_id_clash;
 130 extern unsigned id_clash_len;
 131
 132 /* Nonzero means warn about any objects definitions whose size is larger
 133    than N bytes.  Also want about function definitions whose returned
 134    values are larger than N bytes. The value N is in `larger_than_size'.  */
 135
 136 extern int warn_larger_than;
 137 extern unsigned larger_than_size;
 138
 139 /* Warn if a function returns an aggregate,
 140    since there are often incompatible calling conventions for doing this.  */
 141
 142 extern int warn_aggregate_return;
 143
 144 /* Nonzero if generating code to do profiling.  */
 145
 146 extern int profile_flag;
 147
 148 /* Nonzero if generating code to do profiling on the basis of basic blocks.  */
 149
 150 extern int profile_block_flag;
 151
 152 /* Nonzero if generating code to profile program flow graph arcs. */
 153
 154 extern int profile_arc_flag;
 155
 156 /* Nonzero if generating info for gcov to calculate line test coverage. */
 157
 158 extern int flag_test_coverage;
 159
 160 /* Nonzero indicates that branch taken probabilities should be calculated. */
 161
 162 extern int flag_branch_probabilities;
 163
 164 /* Nonzero for -pedantic switch: warn about anything
 165    that standard C forbids.  */
 166
 167 extern int pedantic;
 168
 169 /* Temporarily suppress certain warnings.
 170    This is set while reading code from a system header file.  */
 171
 172 extern int in_system_header;
 173
 174 /* Nonzero for -dp: annotate the assembly with a comment describing the
 175    pattern and alternative used.  */
 176
 177 extern int flag_print_asm_name;
 178 \f
 179 /* Now the symbols that are set with `-f' switches.  */
 180
 181 /* Nonzero means `char' should be signed.  */
 182
 183 extern int flag_signed_char;
 184
 185 /* Nonzero means give an enum type only as many bytes as it needs.  */
 186
 187 extern int flag_short_enums;
 188
 189 /* Nonzero for -fcaller-saves: allocate values in regs that need to
 190    be saved across function calls, if that produces overall better code.
 191    Optional now, so people can test it.  */
 192
 193 extern int flag_caller_saves;
 194
 195 /* Nonzero for -fpcc-struct-return: return values the same way PCC does.  */
 196
 197 extern int flag_pcc_struct_return;
 198
 199 /* Nonzero for -fforce-mem: load memory value into a register
 200    before arithmetic on it.  This makes better cse but slower compilation.  */
 201
 202 extern int flag_force_mem;
 203
 204 /* Nonzero for -fforce-addr: load memory address into a register before
 205    reference to memory.  This makes better cse but slower compilation.  */
 206
 207 extern int flag_force_addr;
 208
 209 /* Nonzero for -fdefer-pop: don't pop args after each function call;
 210    instead save them up to pop many calls' args with one insns.  */
 211
 212 extern int flag_defer_pop;
 213
 214 /* Nonzero for -ffloat-store: don't allocate floats and doubles
 215    in extended-precision registers.  */
 216
 217 extern int flag_float_store;
 218
 219 /* Nonzero enables strength-reduction in loop.c.  */
 220
 221 extern int flag_strength_reduce;
 222
 223 /* Nonzero enables loop unrolling in unroll.c.  Only loops for which the
 224    number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
 225    UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
 226    unrolled.  */
 227
 228 extern int flag_unroll_loops;
 229
 230 /* Nonzero enables loop unrolling in unroll.c.  All loops are unrolled.
 231    This is generally not a win.  */
 232
 233 extern int flag_unroll_all_loops;
 234
 235 /* Nonzero forces all invariant computations in loops to be moved
 236    outside the loop. */
 237
 238 extern int flag_move_all_movables;
 239
 240 /* Nonzero forces all general induction variables in loops to be
 241    strength reduced. */
 242
 243 extern int flag_reduce_all_givs;
 244
 245 /* Nonzero for -fcse-follow-jumps:
 246    have cse follow jumps to do a more extensive job.  */
 247
 248 extern int flag_cse_follow_jumps;
 249
 250 /* Nonzero for -fcse-skip-blocks:
 251    have cse follow a branch around a block.  */
 252
 253 extern int flag_cse_skip_blocks;
 254
 255 /* Nonzero for -fexpensive-optimizations:
 256    perform miscellaneous relatively-expensive optimizations.  */
 257 extern int flag_expensive_optimizations;
 258
 259 /* Nonzero for -fwritable-strings:
 260    store string constants in data segment and don't uniquize them.  */
 261
 262 extern int flag_writable_strings;
 263
 264 /* Nonzero means don't put addresses of constant functions in registers.
 265    Used for compiling the Unix kernel, where strange substitutions are
 266    done on the assembly output.  */
 267
 268 extern int flag_no_function_cse;
 269
 270 /* Nonzero for -fomit-frame-pointer:
 271    don't make a frame pointer in simple functions that don't require one.  */
 272
 273 extern int flag_omit_frame_pointer;
 274
 275 /* Nonzero to inhibit use of define_optimization peephole opts.  */
 276
 277 extern int flag_no_peephole;
 278
 279 /* Nonzero means all references through pointers are volatile.  */
 280
 281 extern int flag_volatile;
 282
 283 /* Nonzero means treat all global and extern variables as volatile.  */
 284
 285 extern int flag_volatile_global;
 286
 287 /* Nonzero means treat all static variables as volatile.  */
 288
 289 extern int flag_volatile_static;
 290
 291 /* Nonzero allows GCC to violate some IEEE or ANSI rules regarding math
 292    operations in the interest of optimization.  For example it allows
 293    GCC to assume arguments to sqrt are nonnegative numbers, allowing
 294    faster code for sqrt to be generated. */
 295
 296 extern int flag_fast_math;
 297
 298 /* Nonzero means the front end generally wants `errno' maintained by math
 299    operations, like built-in SQRT, unless overridden by flag_fast_math.  */
 300
 301 extern int flag_errno_math;
 302
 303 /* 0 means straightforward implementation of complex divide acceptable.
 304    1 means wide ranges of inputs must work for complex divide.
 305    2 means C9X-like requirements for complex divide (not yet implemented).  */
 306
 307 extern int flag_complex_divide_method;
 308
 309 /* Nonzero means to run loop optimizations twice.  */
 310
 311 extern int flag_rerun_loop_opt;
 312
 313 /* Nonzero means make functions that look like good inline candidates
 314    go inline.  */
 315
 316 extern int flag_inline_functions;
 317
 318 /* Nonzero for -fkeep-inline-functions: even if we make a function
 319    go inline everywhere, keep its definition around for debugging
 320    purposes.  */
 321
 322 extern int flag_keep_inline_functions;
 323
 324 /* Nonzero means that functions declared `inline' will be treated
 325    as `static'.  Prevents generation of zillions of copies of unused
 326    static inline functions; instead, `inlines' are written out
 327    only when actually used.  Used in conjunction with -g.  Also
 328    does the right thing with #pragma interface.  */
 329
 330 extern int flag_no_inline;
 331
 332 /* Nonzero if we are only using compiler to check syntax errors.  */
 333
 334 extern int flag_syntax_only;
 335
 336 /* Nonzero means we should save auxiliary info into a .X file.  */
 337
 338 extern int flag_gen_aux_info;
 339
 340 /* Nonzero means make the text shared if supported.  */
 341
 342 extern int flag_shared_data;
 343
 344 /* flag_schedule_insns means schedule insns within basic blocks (before
 345    local_alloc).
 346    flag_schedule_insns_after_reload means schedule insns after
 347    global_alloc.  */
 348
 349 extern int flag_schedule_insns;
 350 extern int flag_schedule_insns_after_reload;
 351
 352 #ifdef HAIFA
 353 /* The following flags have effect only for scheduling before register
 354    allocation:
 355
 356    flag_schedule_interblock means schedule insns accross basic blocks.
 357    flag_schedule_speculative means allow speculative motion of non-load insns.
 358    flag_schedule_speculative_load means allow speculative motion of some
 359    load insns.
 360    flag_schedule_speculative_load_dangerous allows speculative motion of more
 361    load insns.  */
 362
 363 extern int flag_schedule_interblock;
 364 extern int flag_schedule_speculative;
 365 extern int flag_schedule_speculative_load;
 366 extern int flag_schedule_speculative_load_dangerous;
 367 #endif  /* HAIFA */
 368
 369 /* flag_on_branch_count_reg means try to replace add-1,compare,branch tupple
 370    by a cheaper branch, on a count register. */
 371 extern int flag_branch_on_count_reg;
 372
 373
 374 /* Nonzero means put things in delayed-branch slots if supported. */
 375
 376 extern int flag_delayed_branch;
 377
 378 /* Nonzero means suppress output of instruction numbers and line number
 379    notes in debugging dumps.  */
 380
 381 extern int flag_dump_unnumbered;
 382
 383 /* Nonzero means pretend it is OK to examine bits of target floats,
 384    even if that isn't true.  The resulting code will have incorrect constants,
 385    but the same series of instructions that the native compiler would make.  */
 386
 387 extern int flag_pretend_float;
 388
 389 /* Nonzero means change certain warnings into errors.
 390    Usually these are warnings about failure to conform to some standard.  */
 391
 392 extern int flag_pedantic_errors;
 393
 394 /* Nonzero means generate position-independent code.
 395    This is not fully implemented yet.  */
 396
 397 extern int flag_pic;
 398
 399 /* Nonzero means generate extra code for exception handling and enable
 400    exception handling.  */
 401
 402 extern int flag_exceptions;
 403
 404 /* Nonzero means use the new model for exception handling. Replaces
 405    -DNEW_EH_MODEL as a compile option. */
 406
 407 extern int flag_new_exceptions;
 408
 409 /* Nonzero means don't place uninitialized global data in common storage
 410    by default.  */
 411
 412 extern int flag_no_common;
 413
 414 /* -finhibit-size-directive inhibits output of .size for ELF.
 415    This is used only for compiling crtstuff.c,
 416    and it may be extended to other effects
 417    needed for crtstuff.c on other systems.  */
 418 extern int flag_inhibit_size_directive;
 419
 420 /* Nonzero means place each function into its own section on those platforms
 421    which support arbitrary section names and unlimited numbers of sections.  */
 422
 423 extern int flag_function_sections;
 424
 425 /* ... and similar for data.  */
 426
 427 extern int flag_data_sections;
 428
 429 /* -fverbose-asm causes extra commentary information to be produced in
 430    the generated assembly code (to make it more readable).  This option
 431    is generally only of use to those who actually need to read the
 432    generated assembly code (perhaps while debugging the compiler itself).
 433    -fno-verbose-asm, the default, causes the extra information
 434    to not be added and is useful when comparing two assembler files.  */
 435
 436 extern int flag_verbose_asm;
 437
 438 /* -dA causes debug information to be produced in
 439    the generated assembly code (to make it more readable).  This option
 440    is generally only of use to those who actually need to read the
 441    generated assembly code (perhaps while debugging the compiler itself).
 442    Currently, this switch is only used by dwarfout.c; however, it is intended
 443    to be a catchall for printing debug information in the assembler file.  */
 444
 445 extern int flag_debug_asm;
 446
 447 /* -fgnu-linker specifies use of the GNU linker for initializations.
 448    -fno-gnu-linker says that collect will be used.  */
 449 extern int flag_gnu_linker;
 450
 451 /* Tag all structures with __attribute__(packed) */
 452 extern int flag_pack_struct;
 453
 454 /* This flag is only tested if alias checking is enabled.
 455    0 if pointer arguments may alias each other.  True in C.
 456    1 if pointer arguments may not alias each other but may alias
 457    global variables.
 458    2 if pointer arguments may not alias each other and may not
 459    alias global variables.  True in Fortran.
 460    The value is ignored if flag_alias_check is 0.  */
 461 extern int flag_argument_noalias;
 462
 463 /* Nonzero if we should do (language-dependent) alias analysis.
 464    Typically, this analysis will assume that expressions of certain
 465    types do not alias expressions of certain other types.  Only used
 466    if alias analysis (in general) is enabled.  */
 467 extern int flag_strict_aliasing;
 468
 469 /* Emit code to check for stack overflow; also may cause large objects
 470    to be allocated dynamically.  */
 471 extern int flag_stack_check;
 472
 473 /* Do the full regmove optimization pass.  */
 474 extern int flag_regmove;
 475
 476 /* Instrument functions with calls at entry and exit, for profiling.  */
 477 extern int flag_instrument_function_entry_exit;
 478 \f
 479 /* Other basic status info about current function.  */
 480
 481 /* Nonzero means current function must be given a frame pointer.
 482    Set in stmt.c if anything is allocated on the stack there.
 483    Set in reload1.c if anything is allocated on the stack there.  */
 484
 485 extern int frame_pointer_needed;
 486
 487 /* Set nonzero if jump_optimize finds that control falls through
 488    at the end of the function.  */
 489
 490 extern int can_reach_end;
 491
 492 /* Nonzero if GCC must add code to check memory access (used by Checker).  */
 493
 494 extern int flag_check_memory_usage;
 495
 496 /* Nonzero if GCC must prefix function names (used with
 497    flag_check_memory_usage).  */
 498
 499 extern int flag_prefix_function_name;
 500
 501 /* Value of the -G xx switch, and whether it was passed or not.  */
 502 extern int g_switch_value;
 503 extern int g_switch_set;
 504
 505 /* Value of the -finline-limit flag.  */
 506
 507 extern int inline_max_insns;
 508
 509 /* Nonzero if we dump in VCG format, not plain text.  */
 510 extern int dump_for_graph;
 511
 512 /* Selection of the graph form.  */
 513 enum graph_dump_types
 514 {
 515   no_graph = 0,
 516   vcg
 517 };
 518 extern enum graph_dump_types graph_dump_format;
 519
 520 /* Nonzero means ignore `#ident' directives.  0 means handle them.
 521    On SVR4 targets, it also controls whether or not to emit a
 522    string identifying the compiler.  */
 523
 524 extern int flag_no_ident;