1 /* Compilation switch flag definitions for GCC.
2 Copyright (C) 1987, 1988, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2002
3 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 2, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
25 /* Name of the input .c file being compiled. */
26 extern const char *main_input_filename
;
30 NO_DEBUG
, /* Write no debug info. */
31 DBX_DEBUG
, /* Write BSD .stabs for DBX (using dbxout.c). */
32 SDB_DEBUG
, /* Write COFF for (old) SDB (using sdbout.c). */
33 DWARF_DEBUG
, /* Write Dwarf debug info (using dwarfout.c). */
34 DWARF2_DEBUG
, /* Write Dwarf v2 debug info (using dwarf2out.c). */
35 XCOFF_DEBUG
, /* Write IBM/Xcoff debug info (using dbxout.c). */
36 VMS_DEBUG
, /* Write VMS debug info (using vmsdbgout.c). */
37 VMS_AND_DWARF2_DEBUG
/* Write VMS debug info (using vmsdbgout.c).
38 and DWARF v2 debug info (using dwarf2out.c). */
41 /* Specify which kind of debugging info to generate. */
42 extern enum debug_info_type write_symbols
;
46 DINFO_LEVEL_NONE
, /* Write no debugging info. */
47 DINFO_LEVEL_TERSE
, /* Write minimal info to support tracebacks only. */
48 DINFO_LEVEL_NORMAL
, /* Write info for all declarations (and line table). */
49 DINFO_LEVEL_VERBOSE
/* Write normal info plus #define/#undef info. */
52 /* Specify how much debugging info to generate. */
53 extern enum debug_info_level debug_info_level
;
55 /* Nonzero means use GNU-only extensions in the generated symbolic
56 debugging information. */
57 extern int use_gnu_debug_info_extensions
;
59 /* Nonzero means do optimizations. -opt. */
63 /* Nonzero means optimize for size. -Os. */
65 extern int optimize_size
;
67 /* Don't print functions as they are compiled and don't print
68 times taken by the various passes. -quiet. */
70 extern int quiet_flag
;
72 /* Print times taken by the various passes. -ftime-report. */
74 extern int time_report
;
76 /* Print memory still in use at end of compilation (which may have little
77 to do with peak memory consumption). -fmem-report. */
79 extern int mem_report
;
81 /* Don't print warning messages. -w. */
83 extern int inhibit_warnings
;
85 /* Don't suppress warnings from system headers. -Wsystem-headers. */
87 extern int warn_system_headers
;
89 /* Do print extra warnings (such as for uninitialized variables). -W. */
91 extern int extra_warnings
;
93 /* Nonzero to warn about unused variables, functions et.al. Use
94 set_Wunused() to update the -Wunused-* flags that correspond to the
97 extern void set_Wunused
PARAMS ((int setting
));
99 extern int warn_unused_function
;
100 extern int warn_unused_label
;
101 extern int warn_unused_parameter
;
102 extern int warn_unused_variable
;
103 extern int warn_unused_value
;
105 /* Nonzero to warn about code which is never reached. */
107 extern int warn_notreached
;
109 /* Nonzero means warn if inline function is too large. */
111 extern int warn_inline
;
113 /* Nonzero to warn about variables used before they are initialized. */
115 extern int warn_uninitialized
;
117 /* Zero if unknown pragmas are ignored
118 One if the compiler should warn about an unknown pragma not in
119 a system include file.
120 Greater than one if the compiler should warn for all unknown
123 extern int warn_unknown_pragmas
;
125 /* Nonzero means warn about all declarations which shadow others. */
127 extern int warn_shadow
;
129 /* Warn if a switch on an enum, that does not have a default case,
130 fails to have a case for every enum value. */
132 extern int warn_switch
;
134 /* Warn if a switch does not have a default case. */
136 extern int warn_switch_default
;
138 /* Warn if a switch on an enum fails to have a case for every enum
139 value (regardless of the presence or otherwise of a default case). */
141 extern int warn_switch_enum
;
143 /* Nonzero means warn about function definitions that default the return type
144 or that use a null return and have a return-type other than void. */
146 extern int warn_return_type
;
148 /* Warn about functions which might be candidates for attribute noreturn. */
150 extern int warn_missing_noreturn
;
152 /* Nonzero means warn about pointer casts that increase the required
153 alignment of the target type (and might therefore lead to a crash
154 due to a misaligned access). */
156 extern int warn_cast_align
;
158 /* Nonzero means warn about any objects definitions whose size is larger
159 than N bytes. Also want about function definitions whose returned
160 values are larger than N bytes. The value N is in `larger_than_size'. */
162 extern int warn_larger_than
;
163 extern HOST_WIDE_INT larger_than_size
;
165 /* Warn if a function returns an aggregate,
166 since there are often incompatible calling conventions for doing this. */
168 extern int warn_aggregate_return
;
170 /* Warn if packed attribute on struct is unnecessary and inefficient. */
172 extern int warn_packed
;
174 /* Warn when gcc pads a structure to an alignment boundary. */
176 extern int warn_padded
;
178 /* Warn when an optimization pass is disabled. */
180 extern int warn_disabled_optimization
;
182 /* Nonzero means warn about uses of __attribute__((deprecated))
185 extern int warn_deprecated_decl
;
187 /* Nonzero if generating code to do profiling. */
189 extern int profile_flag
;
191 /* Nonzero if generating code to profile program flow graph arcs. */
193 extern int profile_arc_flag
;
195 /* Nonzero if generating info for gcov to calculate line test coverage. */
197 extern int flag_test_coverage
;
199 /* Nonzero indicates that branch taken probabilities should be calculated. */
201 extern int flag_branch_probabilities
;
203 /* Nonzero if basic blocks should be reordered. */
205 extern int flag_reorder_blocks
;
207 /* Nonzero if functions should be reordered. */
209 extern int flag_reorder_functions
;
211 /* Nonzero if registers should be renamed. */
213 extern int flag_rename_registers
;
215 /* Nonzero for -pedantic switch: warn about anything
216 that standard C forbids. */
220 /* Temporarily suppress certain warnings.
221 This is set while reading code from a system header file. */
223 extern int in_system_header
;
225 /* Nonzero for -dp: annotate the assembly with a comment describing the
226 pattern and alternative used. */
228 extern int flag_print_asm_name
;
230 /* Now the symbols that are set with `-f' switches. */
232 /* Nonzero means `char' should be signed. */
234 extern int flag_signed_char
;
236 /* Nonzero means give an enum type only as many bytes as it needs. */
238 extern int flag_short_enums
;
240 /* Nonzero for -fcaller-saves: allocate values in regs that need to
241 be saved across function calls, if that produces overall better code.
242 Optional now, so people can test it. */
244 extern int flag_caller_saves
;
246 /* Nonzero for -fpcc-struct-return: return values the same way PCC does. */
248 extern int flag_pcc_struct_return
;
250 /* Nonzero for -fforce-mem: load memory value into a register
251 before arithmetic on it. This makes better cse but slower compilation. */
253 extern int flag_force_mem
;
255 /* Nonzero for -fforce-addr: load memory address into a register before
256 reference to memory. This makes better cse but slower compilation. */
258 extern int flag_force_addr
;
260 /* Nonzero for -fdefer-pop: don't pop args after each function call;
261 instead save them up to pop many calls' args with one insns. */
263 extern int flag_defer_pop
;
265 /* Nonzero for -ffloat-store: don't allocate floats and doubles
266 in extended-precision registers. */
268 extern int flag_float_store
;
270 /* Nonzero enables strength-reduction in loop.c. */
272 extern int flag_strength_reduce
;
274 /* Nonzero enables loop unrolling in unroll.c. Only loops for which the
275 number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
276 UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
279 extern int flag_unroll_loops
;
281 /* Nonzero enables loop unrolling in unroll.c. All loops are unrolled.
282 This is generally not a win. */
284 extern int flag_unroll_all_loops
;
286 /* Nonzero forces all invariant computations in loops to be moved
289 extern int flag_move_all_movables
;
291 /* Nonzero enables prefetch optimizations for arrays in loops. */
293 extern int flag_prefetch_loop_arrays
;
295 /* Nonzero forces all general induction variables in loops to be
298 extern int flag_reduce_all_givs
;
300 /* Nonzero for -fcse-follow-jumps:
301 have cse follow jumps to do a more extensive job. */
303 extern int flag_cse_follow_jumps
;
305 /* Nonzero for -fcse-skip-blocks:
306 have cse follow a branch around a block. */
308 extern int flag_cse_skip_blocks
;
310 /* Nonzero for -fexpensive-optimizations:
311 perform miscellaneous relatively-expensive optimizations. */
312 extern int flag_expensive_optimizations
;
314 /* Nonzero for -fwritable-strings:
315 store string constants in data segment and don't uniquize them. */
317 extern int flag_writable_strings
;
319 /* Nonzero means don't put addresses of constant functions in registers.
320 Used for compiling the Unix kernel, where strange substitutions are
321 done on the assembly output. */
323 extern int flag_no_function_cse
;
325 /* Nonzero for -fomit-frame-pointer:
326 don't make a frame pointer in simple functions that don't require one. */
328 extern int flag_omit_frame_pointer
;
330 /* Nonzero to inhibit use of define_optimization peephole opts. */
332 extern int flag_no_peephole
;
334 /* Nonzero means all references through pointers are volatile. */
336 extern int flag_volatile
;
338 /* Nonzero means treat all global and extern variables as volatile. */
340 extern int flag_volatile_global
;
342 /* Nonzero means treat all static variables as volatile. */
344 extern int flag_volatile_static
;
346 /* Nonzero allows GCC to optimize sibling and tail recursive calls. */
348 extern int flag_optimize_sibling_calls
;
350 /* Nonzero means the front end generally wants `errno' maintained by math
351 operations, like built-in SQRT. */
353 extern int flag_errno_math
;
355 /* Nonzero means that unsafe floating-point math optimizations are allowed
356 for the sake of speed. IEEE compliance is not guaranteed, and operations
357 are allowed to assume that their arguments and results are "normal"
358 (e.g., nonnegative for SQRT). */
360 extern int flag_unsafe_math_optimizations
;
362 /* Nonzero means that no NaNs or +-Infs are expected. */
364 extern int flag_finite_math_only
;
366 /* Zero means that floating-point math operations cannot generate a
367 (user-visible) trap. This is the case, for example, in nonstop
368 IEEE 754 arithmetic. */
370 extern int flag_trapping_math
;
372 /* 0 means straightforward implementation of complex divide acceptable.
373 1 means wide ranges of inputs must work for complex divide.
374 2 means C99-like requirements for complex divide (not yet implemented). */
376 extern int flag_complex_divide_method
;
378 /* Nonzero means to run loop optimizations twice. */
380 extern int flag_rerun_loop_opt
;
382 /* Nonzero means make functions that look like good inline candidates
385 extern int flag_inline_functions
;
387 /* Nonzero for -fkeep-inline-functions: even if we make a function
388 go inline everywhere, keep its definition around for debugging
391 extern int flag_keep_inline_functions
;
393 /* Nonzero means that functions declared `inline' will be treated
394 as `static'. Prevents generation of zillions of copies of unused
395 static inline functions; instead, `inlines' are written out
396 only when actually used. Used in conjunction with -g. Also
397 does the right thing with #pragma interface. */
399 extern int flag_no_inline
;
401 /* Nonzero means that we don't want inlining by virtue of -fno-inline,
402 not just because the tree inliner turned us off. */
404 extern int flag_really_no_inline
;
406 /* Nonzero if we are only using compiler to check syntax errors. */
408 extern int flag_syntax_only
;
410 /* Nonzero means we should save auxiliary info into a .X file. */
412 extern int flag_gen_aux_info
;
414 /* Nonzero means make the text shared if supported. */
416 extern int flag_shared_data
;
418 /* flag_schedule_insns means schedule insns within basic blocks (before
420 flag_schedule_insns_after_reload means schedule insns after
423 extern int flag_schedule_insns
;
424 extern int flag_schedule_insns_after_reload
;
426 /* The following flags have effect only for scheduling before register
429 flag_schedule_interblock means schedule insns accross basic blocks.
430 flag_schedule_speculative means allow speculative motion of non-load insns.
431 flag_schedule_speculative_load means allow speculative motion of some
433 flag_schedule_speculative_load_dangerous allows speculative motion of more
436 extern int flag_schedule_interblock
;
437 extern int flag_schedule_speculative
;
438 extern int flag_schedule_speculative_load
;
439 extern int flag_schedule_speculative_load_dangerous
;
441 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
442 by a cheaper branch, on a count register. */
443 extern int flag_branch_on_count_reg
;
445 /* This option is set to 1 on -fsingle-precision-constant option which is
446 used to convert the floating point constants to single precision
449 extern int flag_single_precision_constant
;
451 /* Nonzero means put things in delayed-branch slots if supported. */
453 extern int flag_delayed_branch
;
455 /* Nonzero means suppress output of instruction numbers and line number
456 notes in debugging dumps. */
458 extern int flag_dump_unnumbered
;
460 /* Nonzero means change certain warnings into errors.
461 Usually these are warnings about failure to conform to some standard. */
463 extern int flag_pedantic_errors
;
465 /* Nonzero means generate position-independent code. 1 vs 2 for a
466 target-dependent "small" or "large" mode. */
470 /* Nonzero means generate extra code for exception handling and enable
471 exception handling. */
473 extern int flag_exceptions
;
475 /* Nonzero means generate frame unwind info table when supported */
477 extern int flag_unwind_tables
;
479 /* Nonzero means generate frame unwind info table exact at each insn boundary */
481 extern int flag_asynchronous_unwind_tables
;
483 /* Nonzero means don't place uninitialized global data in common storage
486 extern int flag_no_common
;
488 /* -finhibit-size-directive inhibits output of .size for ELF.
489 This is used only for compiling crtstuff.c,
490 and it may be extended to other effects
491 needed for crtstuff.c on other systems. */
492 extern int flag_inhibit_size_directive
;
494 /* Nonzero means place each function into its own section on those platforms
495 which support arbitrary section names and unlimited numbers of sections. */
497 extern int flag_function_sections
;
499 /* ... and similar for data. */
501 extern int flag_data_sections
;
503 /* -fverbose-asm causes extra commentary information to be produced in
504 the generated assembly code (to make it more readable). This option
505 is generally only of use to those who actually need to read the
506 generated assembly code (perhaps while debugging the compiler itself).
507 -fno-verbose-asm, the default, causes the extra information
508 to not be added and is useful when comparing two assembler files. */
510 extern int flag_verbose_asm
;
512 /* -dA causes debug information to be produced in
513 the generated assembly code (to make it more readable). This option
514 is generally only of use to those who actually need to read the
515 generated assembly code (perhaps while debugging the compiler itself).
516 Currently, this switch is only used by dwarfout.c; however, it is intended
517 to be a catchall for printing debug information in the assembler file. */
519 extern int flag_debug_asm
;
521 extern int flag_dump_rtl_in_asm
;
523 /* -fgnu-linker specifies use of the GNU linker for initializations.
524 -fno-gnu-linker says that collect will be used. */
525 extern int flag_gnu_linker
;
527 /* Tag all structures with __attribute__(packed) */
528 extern int flag_pack_struct
;
530 /* This flag is only tested if alias checking is enabled.
531 0 if pointer arguments may alias each other. True in C.
532 1 if pointer arguments may not alias each other but may alias
534 2 if pointer arguments may not alias each other and may not
535 alias global variables. True in Fortran.
536 The value is ignored if flag_alias_check is 0. */
537 extern int flag_argument_noalias
;
539 /* Nonzero if we should do (language-dependent) alias analysis.
540 Typically, this analysis will assume that expressions of certain
541 types do not alias expressions of certain other types. Only used
542 if alias analysis (in general) is enabled. */
543 extern int flag_strict_aliasing
;
545 /* Emit code to probe the stack, to help detect stack overflow; also
546 may cause large objects to be allocated dynamically. */
547 extern int flag_stack_check
;
549 /* Do the full regmove optimization pass. */
550 extern int flag_regmove
;
552 /* Instrument functions with calls at entry and exit, for profiling. */
553 extern int flag_instrument_function_entry_exit
;
555 /* Perform a peephole pass before sched2. */
556 extern int flag_peephole2
;
558 /* Try to guess branch probablities. */
559 extern int flag_guess_branch_prob
;
561 /* -fbounded-pointers causes gcc to compile pointers as composite
562 objects occupying three words: the pointer value, the base address
563 of the referent object, and the address immediately beyond the end
564 of the referent object. The base and extent allow us to perform
565 runtime bounds checking. -fbounded-pointers implies -fcheck-bounds. */
566 extern int flag_bounded_pointers
;
568 /* -fcheck-bounds causes gcc to generate array bounds checks.
569 For C, C++: defaults to value of flag_bounded_pointers.
570 For ObjC: defaults to off.
571 For Java: defaults to on.
572 For Fortran: defaults to off.
573 For CHILL: defaults to off. */
574 extern int flag_bounds_check
;
576 /* This will attempt to merge constant section constants, if 1 only
577 string constants and constants from constant pool, if 2 also constant
579 extern int flag_merge_constants
;
581 /* If one, renumber instruction UIDs to reduce the number of
582 unused UIDs if there are a lot of instructions. If greater than
583 one, unconditionally renumber instruction UIDs. */
584 extern int flag_renumber_insns
;
586 /* Other basic status info about current function. */
588 /* Nonzero means current function must be given a frame pointer.
589 Set in stmt.c if anything is allocated on the stack there.
590 Set in reload1.c if anything is allocated on the stack there. */
592 extern int frame_pointer_needed
;
594 /* Nonzero if the generated code should trap on signed overflow
595 for PLUS / SUB / MULT. */
596 extern int flag_trapv
;
598 /* Value of the -G xx switch, and whether it was passed or not. */
599 extern int g_switch_value
;
600 extern int g_switch_set
;
602 /* Values of the -falign-* flags: how much to align labels in code.
603 0 means `use default', 1 means `don't align'.
604 For each variable, there is an _log variant which is the power
605 of two not less than the variable, for .align output. */
607 extern int align_loops
;
608 extern int align_loops_log
;
609 extern int align_loops_max_skip
;
610 extern int align_jumps
;
611 extern int align_jumps_log
;
612 extern int align_jumps_max_skip
;
613 extern int align_labels
;
614 extern int align_labels_log
;
615 extern int align_labels_max_skip
;
616 extern int align_functions
;
617 extern int align_functions_log
;
619 /* Like align_functions_log above, but used by front-ends to force the
620 minimum function alignment. Zero means no alignment is forced. */
621 extern int force_align_functions_log
;
623 /* Nonzero if we dump in VCG format, not plain text. */
624 extern int dump_for_graph
;
626 /* Selection of the graph form. */
627 enum graph_dump_types
632 extern enum graph_dump_types graph_dump_format
;
634 /* Nonzero means ignore `#ident' directives. 0 means handle them.
635 On SVR4 targets, it also controls whether or not to emit a
636 string identifying the compiler. */
638 extern int flag_no_ident
;
640 /* Nonzero if we want to perform enhanced load motion during gcse. */
642 extern int flag_gcse_lm
;
644 /* Nonzero if we want to perform store motion after gcse. */
646 extern int flag_gcse_sm
;
649 /* Nonzero means we should do dwarf2 duplicate elimination. */
651 extern int flag_eliminate_dwarf2_dups
;
653 /* Nonzero means to collect statistics which might be expensive
654 and to print them when we are done. */
655 extern int flag_detailed_statistics
;
657 /* Nonzero means enable synchronous exceptions for non-call instructions. */
658 extern int flag_non_call_exceptions
;
660 /* Nonzero means put zero initialized data in the bss section. */
661 extern int flag_zero_initialized_in_bss
;
663 /* Nonzero means disable transformations observable by signaling NaNs. */
664 extern int flag_signaling_nans
;
666 /* True if the given mode has a NaN representation and the treatment of
667 NaN operands is important. Certain optimizations, such as folding
668 x * 0 into x, are not correct for NaN operands, and are normally
669 disabled for modes with NaNs. The user can ask for them to be
670 done anyway using the -funsafe-math-optimizations switch. */
671 #define HONOR_NANS(MODE) \
672 (MODE_HAS_NANS (MODE) && !flag_finite_math_only)
674 /* Like HONOR_NANs, but true if we honor signaling NaNs (or sNaNs). */
675 #define HONOR_SNANS(MODE) (flag_signaling_nans && HONOR_NANS (MODE))
677 /* As for HONOR_NANS, but true if the mode can represent infinity and
678 the treatment of infinite values is important. */
679 #define HONOR_INFINITIES(MODE) \
680 (MODE_HAS_INFINITIES (MODE) && !flag_finite_math_only)
682 /* Like HONOR_NANS, but true if the given mode distinguishes between
683 postive and negative zero, and the sign of zero is important. */
684 #define HONOR_SIGNED_ZEROS(MODE) \
685 (MODE_HAS_SIGNED_ZEROS (MODE) && !flag_unsafe_math_optimizations)
687 /* Like HONOR_NANS, but true if given mode supports sign-dependent rounding,
688 and the rounding mode is important. */
689 #define HONOR_SIGN_DEPENDENT_ROUNDING(MODE) \
690 (MODE_HAS_SIGN_DEPENDENT_ROUNDING (MODE) && !flag_unsafe_math_optimizations)
692 #endif /* ! GCC_FLAGS_H */