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