gcc/flags.h

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