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