flags.h revision 90090
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#ifndef GCC_FLAGS_H 23#define GCC_FLAGS_H 24 25/* $FreeBSD: head/contrib/gcc/flags.h 90090 2002-02-01 19:38:44Z obrien $ */ 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 if we are only using compiler to check syntax errors. */ 386 387extern int flag_syntax_only; 388 389/* Nonzero means we should save auxiliary info into a .X file. */ 390 391extern int flag_gen_aux_info; 392 393/* Nonzero means make the text shared if supported. */ 394 395extern int flag_shared_data; 396 397/* flag_schedule_insns means schedule insns within basic blocks (before 398 local_alloc). 399 flag_schedule_insns_after_reload means schedule insns after 400 global_alloc. */ 401 402extern int flag_schedule_insns; 403extern int flag_schedule_insns_after_reload; 404 405/* The following flags have effect only for scheduling before register 406 allocation: 407 408 flag_schedule_interblock means schedule insns accross basic blocks. 409 flag_schedule_speculative means allow speculative motion of non-load insns. 410 flag_schedule_speculative_load means allow speculative motion of some 411 load insns. 412 flag_schedule_speculative_load_dangerous allows speculative motion of more 413 load insns. */ 414 415extern int flag_schedule_interblock; 416extern int flag_schedule_speculative; 417extern int flag_schedule_speculative_load; 418extern int flag_schedule_speculative_load_dangerous; 419 420/* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple 421 by a cheaper branch, on a count register. */ 422extern int flag_branch_on_count_reg; 423 424/* This option is set to 1 on -fsingle-precision-constant option which is 425 used to convert the floating point constants to single precision 426 constants. */ 427 428extern int flag_single_precision_constant; 429 430/* Nonzero means put things in delayed-branch slots if supported. */ 431 432extern int flag_delayed_branch; 433 434/* Nonzero means suppress output of instruction numbers and line number 435 notes in debugging dumps. */ 436 437extern int flag_dump_unnumbered; 438 439/* Nonzero means pretend it is OK to examine bits of target floats, 440 even if that isn't true. The resulting code will have incorrect constants, 441 but the same series of instructions that the native compiler would make. */ 442 443extern int flag_pretend_float; 444 445/* Nonzero means change certain warnings into errors. 446 Usually these are warnings about failure to conform to some standard. */ 447 448extern int flag_pedantic_errors; 449 450/* Nonzero means generate position-independent code. 451 This is not fully implemented yet. */ 452 453extern int flag_pic; 454 455/* Nonzero means generate extra code for exception handling and enable 456 exception handling. */ 457 458extern int flag_exceptions; 459 460/* Nonzero means generate frame unwind info table when supported */ 461 462extern int flag_unwind_tables; 463 464/* Nonzero means generate frame unwind info table exact at each insn boundary */ 465 466extern int flag_asynchronous_unwind_tables; 467 468/* Nonzero means don't place uninitialized global data in common storage 469 by default. */ 470 471extern int flag_no_common; 472 473/* -finhibit-size-directive inhibits output of .size for ELF. 474 This is used only for compiling crtstuff.c, 475 and it may be extended to other effects 476 needed for crtstuff.c on other systems. */ 477extern int flag_inhibit_size_directive; 478 479/* Nonzero means place each function into its own section on those platforms 480 which support arbitrary section names and unlimited numbers of sections. */ 481 482extern int flag_function_sections; 483 484/* ... and similar for data. */ 485 486extern int flag_data_sections; 487 488/* -fverbose-asm causes extra commentary information to be produced in 489 the generated assembly code (to make it more readable). This option 490 is generally only of use to those who actually need to read the 491 generated assembly code (perhaps while debugging the compiler itself). 492 -fno-verbose-asm, the default, causes the extra information 493 to not be added and is useful when comparing two assembler files. */ 494 495extern int flag_verbose_asm; 496 497/* -dA causes debug information to be produced in 498 the generated assembly code (to make it more readable). This option 499 is generally only of use to those who actually need to read the 500 generated assembly code (perhaps while debugging the compiler itself). 501 Currently, this switch is only used by dwarfout.c; however, it is intended 502 to be a catchall for printing debug information in the assembler file. */ 503 504extern int flag_debug_asm; 505 506extern int flag_dump_rtl_in_asm; 507 508/* -fgnu-linker specifies use of the GNU linker for initializations. 509 -fno-gnu-linker says that collect will be used. */ 510extern int flag_gnu_linker; 511 512/* Tag all structures with __attribute__(packed) */ 513extern int flag_pack_struct; 514 515/* This flag is only tested if alias checking is enabled. 516 0 if pointer arguments may alias each other. True in C. 517 1 if pointer arguments may not alias each other but may alias 518 global variables. 519 2 if pointer arguments may not alias each other and may not 520 alias global variables. True in Fortran. 521 The value is ignored if flag_alias_check is 0. */ 522extern int flag_argument_noalias; 523 524/* Nonzero if we should do (language-dependent) alias analysis. 525 Typically, this analysis will assume that expressions of certain 526 types do not alias expressions of certain other types. Only used 527 if alias analysis (in general) is enabled. */ 528extern int flag_strict_aliasing; 529 530/* Emit code to probe the stack, to help detect stack overflow; also 531 may cause large objects to be allocated dynamically. */ 532extern int flag_stack_check; 533 534/* Do the full regmove optimization pass. */ 535extern int flag_regmove; 536 537/* Instrument functions with calls at entry and exit, for profiling. */ 538extern int flag_instrument_function_entry_exit; 539 540/* Perform a peephole pass before sched2. */ 541extern int flag_peephole2; 542 543/* Try to guess branch probablities. */ 544extern int flag_guess_branch_prob; 545 546/* -fbounded-pointers causes gcc to compile pointers as composite 547 objects occupying three words: the pointer value, the base address 548 of the referent object, and the address immediately beyond the end 549 of the referent object. The base and extent allow us to perform 550 runtime bounds checking. -fbounded-pointers implies -fcheck-bounds. */ 551extern int flag_bounded_pointers; 552 553/* -fcheck-bounds causes gcc to generate array bounds checks. 554 For C, C++: defaults to value of flag_bounded_pointers. 555 For ObjC: defaults to off. 556 For Java: defaults to on. 557 For Fortran: defaults to off. 558 For CHILL: defaults to off. */ 559extern int flag_bounds_check; 560 561/* This will attempt to merge constant section constants, if 1 only 562 string constants and constants from constant pool, if 2 also constant 563 variables. */ 564extern int flag_merge_constants; 565 566/* If one, renumber instruction UIDs to reduce the number of 567 unused UIDs if there are a lot of instructions. If greater than 568 one, unconditionally renumber instruction UIDs. */ 569extern int flag_renumber_insns; 570 571/* Other basic status info about current function. */ 572 573/* Nonzero means current function must be given a frame pointer. 574 Set in stmt.c if anything is allocated on the stack there. 575 Set in reload1.c if anything is allocated on the stack there. */ 576 577extern int frame_pointer_needed; 578 579/* Nonzero if the generated code should trap on signed overflow 580 for PLUS / SUB / MULT. */ 581extern int flag_trapv; 582 583/* Value of the -G xx switch, and whether it was passed or not. */ 584extern int g_switch_value; 585extern int g_switch_set; 586 587/* Values of the -falign-* flags: how much to align labels in code. 588 0 means `use default', 1 means `don't align'. 589 For each variable, there is an _log variant which is the power 590 of two not less than the variable, for .align output. */ 591 592extern int align_loops; 593extern int align_loops_log; 594extern int align_loops_max_skip; 595extern int align_jumps; 596extern int align_jumps_log; 597extern int align_jumps_max_skip; 598extern int align_labels; 599extern int align_labels_log; 600extern int align_labels_max_skip; 601extern int align_functions; 602extern int align_functions_log; 603 604/* Nonzero if we dump in VCG format, not plain text. */ 605extern int dump_for_graph; 606 607/* Selection of the graph form. */ 608enum graph_dump_types 609{ 610 no_graph = 0, 611 vcg 612}; 613extern enum graph_dump_types graph_dump_format; 614 615/* Nonzero means ignore `#ident' directives. 0 means handle them. 616 On SVR4 targets, it also controls whether or not to emit a 617 string identifying the compiler. */ 618 619extern int flag_no_ident; 620 621/* Nonzero if we want to perform enhanced load motion during gcse. */ 622 623extern int flag_gcse_lm; 624 625/* Nonzero if we want to perform store motion after gcse. */ 626 627extern int flag_gcse_sm; 628 629 630/* Nonzero means we should do dwarf2 duplicate elimination. */ 631 632extern int flag_eliminate_dwarf2_dups; 633 634/* Non-zero means to collect statistics which might be expensive 635 and to print them when we are done. */ 636extern int flag_detailed_statistics; 637 638/* Nonzero means enable synchronous exceptions for non-call instructions. */ 639extern int flag_non_call_exceptions; 640 641#endif /* ! GCC_FLAGS_H */ 642