combine.c (reversed_comparison): Fix typo in last patch.
[official-gcc.git] / gcc / flags.h
blobfc19efe3da493d73da1b03b7d95b52cb5efb9949
1 /* Compilation switch flag definitions for GNU CC.
2 Copyright (C) 1987, 1988, 1994, 1995, 1996, 1997, 1998, 1999, 2000
3 Free Software Foundation, Inc.
5 This file is part of GNU CC.
7 GNU CC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU CC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU CC; see the file COPYING. If not, write to
19 the Free Software Foundation, 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 #ifndef GCC_FLAGS_H
23 #define GCC_FLAGS_H
25 /* Name of the input .c file being compiled. */
26 extern const char *main_input_filename;
28 enum debug_info_type
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). */
38 /* Specify which kind of debugging info to generate. */
39 extern enum debug_info_type write_symbols;
41 enum debug_info_level
43 DINFO_LEVEL_NONE, /* Write no debugging info. */
44 DINFO_LEVEL_TERSE, /* Write minimal info to support tracebacks only. */
45 DINFO_LEVEL_NORMAL, /* Write info for all declarations (and line table). */
46 DINFO_LEVEL_VERBOSE /* Write normal info plus #define/#undef info. */
49 /* Specify how much debugging info to generate. */
50 extern enum debug_info_level debug_info_level;
52 /* Nonzero means use GNU-only extensions in the generated symbolic
53 debugging information. */
54 extern int use_gnu_debug_info_extensions;
56 /* Nonzero means do optimizations. -opt. */
58 extern int optimize;
60 /* Nonzero means optimize for size. -Os. */
62 extern int optimize_size;
64 /* Don't print functions as they are compiled and don't print
65 times taken by the various passes. -quiet. */
67 extern int quiet_flag;
69 /* Print times taken by the various passes. -ftime-report. */
71 extern int time_report;
73 /* Print memory still in use at end of compilation (which may have little
74 to do with peak memory consumption). -fmem-report. */
76 extern int mem_report;
78 /* Don't print warning messages. -w. */
80 extern int inhibit_warnings;
82 /* Don't suppress warnings from system headers. -Wsystem-headers. */
84 extern int warn_system_headers;
86 /* Do print extra warnings (such as for uninitialized variables). -W. */
88 extern int extra_warnings;
90 /* Nonzero to warn about unused variables, functions et.al. Use
91 set_Wunused() to update the -Wunused-* flags that correspond to the
92 -Wunused option. */
94 extern void set_Wunused PARAMS ((int setting));
96 extern int warn_unused_function;
97 extern int warn_unused_label;
98 extern int warn_unused_parameter;
99 extern int warn_unused_variable;
100 extern int warn_unused_value;
102 /* Nonzero to warn about code which is never reached. */
104 extern int warn_notreached;
106 /* Nonzero means warn if inline function is too large. */
108 extern int warn_inline;
110 /* Nonzero to warn about variables used before they are initialized. */
112 extern int warn_uninitialized;
114 /* Zero if unknown pragmas are ignored
115 One if the compiler should warn about an unknown pragma not in
116 a system include file.
117 Greater than one if the compiler should warn for all unknown
118 pragmas. */
120 extern int warn_unknown_pragmas;
122 /* Nonzero means warn about all declarations which shadow others. */
124 extern int warn_shadow;
126 /* Warn if a switch on an enum fails to have a case for every enum value. */
128 extern int warn_switch;
130 /* Nonzero means warn about function definitions that default the return type
131 or that use a null return and have a return-type other than void. */
133 extern int warn_return_type;
135 /* Warn about functions which might be candidates for attribute noreturn. */
137 extern int warn_missing_noreturn;
139 /* Nonzero means warn about pointer casts that increase the required
140 alignment of the target type (and might therefore lead to a crash
141 due to a misaligned access). */
143 extern int warn_cast_align;
145 /* Nonzero means warn about any identifiers that match in the first N
146 characters. The value N is in `id_clash_len'. */
148 extern int warn_id_clash;
149 extern int id_clash_len;
151 /* Nonzero means warn about any objects definitions whose size is larger
152 than N bytes. Also want about function definitions whose returned
153 values are larger than N bytes. The value N is in `larger_than_size'. */
155 extern int warn_larger_than;
156 extern HOST_WIDE_INT larger_than_size;
158 /* Warn if a function returns an aggregate,
159 since there are often incompatible calling conventions for doing this. */
161 extern int warn_aggregate_return;
163 /* Warn if packed attribute on struct is unnecessary and inefficient. */
165 extern int warn_packed;
167 /* Warn when gcc pads a structure to an alignment boundary. */
169 extern int warn_padded;
171 /* Warn when an optimization pass is disabled. */
173 extern int warn_disabled_optimization;
175 /* Nonzero if generating code to do profiling. */
177 extern int profile_flag;
179 /* Nonzero if generating code to do profiling on the basis of basic blocks. */
181 extern int profile_block_flag;
183 /* Nonzero if generating code to profile program flow graph arcs. */
185 extern int profile_arc_flag;
187 /* Nonzero if generating info for gcov to calculate line test coverage. */
189 extern int flag_test_coverage;
191 /* Nonzero indicates that branch taken probabilities should be calculated. */
193 extern int flag_branch_probabilities;
195 /* Nonzero if basic blocks should be reordered. */
197 extern int flag_reorder_blocks;
199 /* Nonzero if registers should be renamed. */
201 extern int flag_rename_registers;
203 /* Nonzero for -pedantic switch: warn about anything
204 that standard C forbids. */
206 extern int pedantic;
208 /* Temporarily suppress certain warnings.
209 This is set while reading code from a system header file. */
211 extern int in_system_header;
213 /* Nonzero for -dp: annotate the assembly with a comment describing the
214 pattern and alternative used. */
216 extern int flag_print_asm_name;
218 /* Now the symbols that are set with `-f' switches. */
220 /* Nonzero means `char' should be signed. */
222 extern int flag_signed_char;
224 /* Nonzero means give an enum type only as many bytes as it needs. */
226 extern int flag_short_enums;
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. */
232 extern int flag_caller_saves;
234 /* Nonzero for -fpcc-struct-return: return values the same way PCC does. */
236 extern int flag_pcc_struct_return;
238 /* Nonzero for -fforce-mem: load memory value into a register
239 before arithmetic on it. This makes better cse but slower compilation. */
241 extern int flag_force_mem;
243 /* Nonzero for -fforce-addr: load memory address into a register before
244 reference to memory. This makes better cse but slower compilation. */
246 extern int flag_force_addr;
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. */
251 extern int flag_defer_pop;
253 /* Nonzero for -ffloat-store: don't allocate floats and doubles
254 in extended-precision registers. */
256 extern int flag_float_store;
258 /* Nonzero enables strength-reduction in loop.c. */
260 extern int flag_strength_reduce;
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. */
267 extern int flag_unroll_loops;
269 /* Nonzero enables loop unrolling in unroll.c. All loops are unrolled.
270 This is generally not a win. */
272 extern int flag_unroll_all_loops;
274 /* Nonzero forces all invariant computations in loops to be moved
275 outside the loop. */
277 extern int flag_move_all_movables;
279 /* Nonzero forces all general induction variables in loops to be
280 strength reduced. */
282 extern int flag_reduce_all_givs;
284 /* Nonzero for -fcse-follow-jumps:
285 have cse follow jumps to do a more extensive job. */
287 extern int flag_cse_follow_jumps;
289 /* Nonzero for -fcse-skip-blocks:
290 have cse follow a branch around a block. */
292 extern int flag_cse_skip_blocks;
294 /* Nonzero for -fexpensive-optimizations:
295 perform miscellaneous relatively-expensive optimizations. */
296 extern int flag_expensive_optimizations;
298 /* Nonzero for -fwritable-strings:
299 store string constants in data segment and don't uniquize them. */
301 extern int flag_writable_strings;
303 /* Nonzero means don't put addresses of constant functions in registers.
304 Used for compiling the Unix kernel, where strange substitutions are
305 done on the assembly output. */
307 extern int flag_no_function_cse;
309 /* Nonzero for -fomit-frame-pointer:
310 don't make a frame pointer in simple functions that don't require one. */
312 extern int flag_omit_frame_pointer;
314 /* Nonzero to inhibit use of define_optimization peephole opts. */
316 extern int flag_no_peephole;
318 /* Nonzero means all references through pointers are volatile. */
320 extern int flag_volatile;
322 /* Nonzero means treat all global and extern variables as volatile. */
324 extern int flag_volatile_global;
326 /* Nonzero means treat all static variables as volatile. */
328 extern int flag_volatile_static;
330 /* Nonzero allows GCC to violate some IEEE or ANSI rules regarding math
331 operations in the interest of optimization. For example it allows
332 GCC to assume arguments to sqrt are nonnegative numbers, allowing
333 faster code for sqrt to be generated. */
335 extern int flag_fast_math;
337 /* Nonzero allows GCC to optimize sibling and tail recursive calls. */
339 extern int flag_optimize_sibling_calls;
341 /* Nonzero means the front end generally wants `errno' maintained by math
342 operations, like built-in SQRT, unless overridden by flag_fast_math. */
344 extern int flag_errno_math;
346 /* 0 means straightforward implementation of complex divide acceptable.
347 1 means wide ranges of inputs must work for complex divide.
348 2 means C99-like requirements for complex divide (not yet implemented). */
350 extern int flag_complex_divide_method;
352 /* Nonzero means to run loop optimizations twice. */
354 extern int flag_rerun_loop_opt;
356 /* Nonzero means make functions that look like good inline candidates
357 go inline. */
359 extern int flag_inline_functions;
361 /* Nonzero for -fkeep-inline-functions: even if we make a function
362 go inline everywhere, keep its definition around for debugging
363 purposes. */
365 extern int flag_keep_inline_functions;
367 /* Nonzero means that functions declared `inline' will be treated
368 as `static'. Prevents generation of zillions of copies of unused
369 static inline functions; instead, `inlines' are written out
370 only when actually used. Used in conjunction with -g. Also
371 does the right thing with #pragma interface. */
373 extern int flag_no_inline;
375 /* Nonzero if we are only using compiler to check syntax errors. */
377 extern int flag_syntax_only;
379 /* Nonzero means we should save auxiliary info into a .X file. */
381 extern int flag_gen_aux_info;
383 /* Nonzero means make the text shared if supported. */
385 extern int flag_shared_data;
387 /* flag_schedule_insns means schedule insns within basic blocks (before
388 local_alloc).
389 flag_schedule_insns_after_reload means schedule insns after
390 global_alloc. */
392 extern int flag_schedule_insns;
393 extern int flag_schedule_insns_after_reload;
395 /* The following flags have effect only for scheduling before register
396 allocation:
398 flag_schedule_interblock means schedule insns accross basic blocks.
399 flag_schedule_speculative means allow speculative motion of non-load insns.
400 flag_schedule_speculative_load means allow speculative motion of some
401 load insns.
402 flag_schedule_speculative_load_dangerous allows speculative motion of more
403 load insns. */
405 extern int flag_schedule_interblock;
406 extern int flag_schedule_speculative;
407 extern int flag_schedule_speculative_load;
408 extern int flag_schedule_speculative_load_dangerous;
410 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
411 by a cheaper branch, on a count register. */
412 extern int flag_branch_on_count_reg;
414 /* This option is set to 1 on -fsingle-precision-constant option which is
415 used to convert the floating point constants to single precision
416 constants. */
418 extern int flag_single_precision_constant;
420 /* Nonzero means put things in delayed-branch slots if supported. */
422 extern int flag_delayed_branch;
424 /* Nonzero means suppress output of instruction numbers and line number
425 notes in debugging dumps. */
427 extern int flag_dump_unnumbered;
429 /* Nonzero means pretend it is OK to examine bits of target floats,
430 even if that isn't true. The resulting code will have incorrect constants,
431 but the same series of instructions that the native compiler would make. */
433 extern int flag_pretend_float;
435 /* Nonzero means change certain warnings into errors.
436 Usually these are warnings about failure to conform to some standard. */
438 extern int flag_pedantic_errors;
440 /* Nonzero means generate position-independent code.
441 This is not fully implemented yet. */
443 extern int flag_pic;
445 /* Nonzero means generate extra code for exception handling and enable
446 exception handling. */
448 extern int flag_exceptions;
450 /* Nonzero means use the new model for exception handling. Replaces
451 -DNEW_EH_MODEL as a compile option. */
453 extern int flag_new_exceptions;
455 /* Nonzero means generate frame unwind info table when supported */
457 extern int flag_unwind_tables;
459 /* Nonzero means don't place uninitialized global data in common storage
460 by default. */
462 extern int flag_no_common;
464 /* -finhibit-size-directive inhibits output of .size for ELF.
465 This is used only for compiling crtstuff.c,
466 and it may be extended to other effects
467 needed for crtstuff.c on other systems. */
468 extern int flag_inhibit_size_directive;
470 /* Nonzero means place each function into its own section on those platforms
471 which support arbitrary section names and unlimited numbers of sections. */
473 extern int flag_function_sections;
475 /* ... and similar for data. */
477 extern int flag_data_sections;
479 /* -fverbose-asm causes extra commentary information to be produced in
480 the generated assembly code (to make it more readable). This option
481 is generally only of use to those who actually need to read the
482 generated assembly code (perhaps while debugging the compiler itself).
483 -fno-verbose-asm, the default, causes the extra information
484 to not be added and is useful when comparing two assembler files. */
486 extern int flag_verbose_asm;
488 /* -dA causes debug 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 Currently, this switch is only used by dwarfout.c; however, it is intended
493 to be a catchall for printing debug information in the assembler file. */
495 extern int flag_debug_asm;
497 extern int flag_dump_rtl_in_asm;
499 /* -fgnu-linker specifies use of the GNU linker for initializations.
500 -fno-gnu-linker says that collect will be used. */
501 extern int flag_gnu_linker;
503 /* Tag all structures with __attribute__(packed) */
504 extern int flag_pack_struct;
506 /* This flag is only tested if alias checking is enabled.
507 0 if pointer arguments may alias each other. True in C.
508 1 if pointer arguments may not alias each other but may alias
509 global variables.
510 2 if pointer arguments may not alias each other and may not
511 alias global variables. True in Fortran.
512 The value is ignored if flag_alias_check is 0. */
513 extern int flag_argument_noalias;
515 /* Nonzero if we should do (language-dependent) alias analysis.
516 Typically, this analysis will assume that expressions of certain
517 types do not alias expressions of certain other types. Only used
518 if alias analysis (in general) is enabled. */
519 extern int flag_strict_aliasing;
521 /* Emit code to probe the stack, to help detect stack overflow; also
522 may cause large objects to be allocated dynamically. */
523 extern int flag_stack_check;
525 /* Do the full regmove optimization pass. */
526 extern int flag_regmove;
528 /* Instrument functions with calls at entry and exit, for profiling. */
529 extern int flag_instrument_function_entry_exit;
531 /* Perform a peephole pass before sched2. */
532 extern int flag_peephole2;
534 /* -fbounded-pointers causes gcc to compile pointers as composite
535 objects occupying three words: the pointer value, the base address
536 of the referent object, and the address immediately beyond the end
537 of the referent object. The base and extent allow us to perform
538 runtime bounds checking. -fbounded-pointers implies -fcheck-bounds. */
539 extern int flag_bounded_pointers;
541 /* -fcheck-bounds causes gcc to generate array bounds checks.
542 For C, C++: defaults to value of flag_bounded_pointers.
543 For ObjC: defaults to off.
544 For Java: defaults to on.
545 For Fortran: defaults to off.
546 For CHILL: defaults to off. */
547 extern int flag_bounds_check;
549 /* If one, renumber instruction UIDs to reduce the number of
550 unused UIDs if there are a lot of instructions. If greater than
551 one, unconditionally renumber instruction UIDs. */
552 extern int flag_renumber_insns;
554 /* Other basic status info about current function. */
556 /* Nonzero means current function must be given a frame pointer.
557 Set in stmt.c if anything is allocated on the stack there.
558 Set in reload1.c if anything is allocated on the stack there. */
560 extern int frame_pointer_needed;
562 /* Nonzero if GCC must add code to check memory access (used by Checker). */
564 extern int flag_check_memory_usage;
566 /* Nonzero if the generated code should trap on signed overflow
567 for PLUS / SUB / MULT. */
568 extern int flag_trapv;
570 /* Nonzero if GCC must prefix function names (used with
571 flag_check_memory_usage). */
573 extern int flag_prefix_function_name;
575 /* Value of the -G xx switch, and whether it was passed or not. */
576 extern int g_switch_value;
577 extern int g_switch_set;
579 /* Value of the -finline-limit flag. */
581 extern int inline_max_insns;
583 /* Values of the -falign-* flags: how much to align labels in code.
584 0 means `use default', 1 means `don't align'.
585 For each variable, there is an _log variant which is the power
586 of two not less than the variable, for .align output. */
588 extern int align_loops;
589 extern int align_loops_log;
590 extern int align_jumps;
591 extern int align_jumps_log;
592 extern int align_labels;
593 extern int align_labels_log;
594 extern int align_functions;
595 extern int align_functions_log;
597 /* Nonzero if we dump in VCG format, not plain text. */
598 extern int dump_for_graph;
600 /* Selection of the graph form. */
601 enum graph_dump_types
603 no_graph = 0,
606 extern enum graph_dump_types graph_dump_format;
608 /* Nonzero means ignore `#ident' directives. 0 means handle them.
609 On SVR4 targets, it also controls whether or not to emit a
610 string identifying the compiler. */
612 extern int flag_no_ident;
614 /* Nonzero means we should do dwarf2 duplicate elimination. */
616 extern int flag_eliminate_dwarf2_dups;
618 /* Non-zero means to collect statistics which might be expensive
619 and to print them when we are done. */
620 extern int flag_detailed_statistics;
622 #endif /* GCC_FLAGS_H */