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