OSDN Git Service

* config/frv/frv.h: Remove declaration of g_switch_value.
[pf3gnuchains/gcc-fork.git] / gcc / flags.h
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.
4
5 This file is part of GCC.
6
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
10 version.
11
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
15 for more details.
16
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
20 02111-1307, USA.  */
21
22 #ifndef GCC_FLAGS_H
23 #define GCC_FLAGS_H
24
25 /* Name of the input .c file being compiled.  */
26 extern const char *main_input_filename;
27
28 enum debug_info_type
29 {
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).  */
39 };
40
41 /* Specify which kind of debugging info to generate.  */
42 extern enum debug_info_type write_symbols;
43
44 /* Names of debug_info_type, for error messages.  */
45 extern const char *const debug_type_names[];
46
47 enum debug_info_level
48 {
49   DINFO_LEVEL_NONE,     /* Write no debugging info.  */
50   DINFO_LEVEL_TERSE,    /* Write minimal info to support tracebacks only.  */
51   DINFO_LEVEL_NORMAL,   /* Write info for all declarations (and line table).  */
52   DINFO_LEVEL_VERBOSE   /* Write normal info plus #define/#undef info.  */
53 };
54
55 /* Specify how much debugging info to generate.  */
56 extern enum debug_info_level debug_info_level;
57
58 /* Nonzero means use GNU-only extensions in the generated symbolic
59    debugging information.  */
60 extern int use_gnu_debug_info_extensions;
61
62 /* Nonzero means do optimizations.  -opt.  */
63
64 extern int optimize;
65
66 /* Nonzero means optimize for size.  -Os.  */
67
68 extern int optimize_size;
69
70 /* Don't print functions as they are compiled and don't print
71    times taken by the various passes.  -quiet.  */
72
73 extern int quiet_flag;
74
75 /* Print memory still in use at end of compilation (which may have little
76    to do with peak memory consumption).  -fmem-report.  */
77
78 extern int mem_report;
79
80 /* Don't print warning messages.  -w.  */
81
82 extern int inhibit_warnings;
83
84 /* Don't suppress warnings from system headers.  -Wsystem-headers.  */
85
86 extern int warn_system_headers;
87
88 /* Do print extra warnings (such as for uninitialized variables).
89    -W/-Wextra.  */
90
91 extern int extra_warnings;
92
93 /* Nonzero to warn about unused variables, functions et.al.  Use
94    set_Wunused() to update the -Wunused-* flags that correspond to the
95    -Wunused option.  */
96
97 extern void set_Wunused PARAMS ((int setting));
98
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;
104
105 /* Nonzero to warn about code which is never reached.  */
106
107 extern int warn_notreached;
108
109 /* Nonzero means warn if inline function is too large.  */
110
111 extern int warn_inline;
112
113 /* Nonzero to warn about variables used before they are initialized.  */
114
115 extern int warn_uninitialized;
116
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
121    pragmas.  */
122
123 extern int warn_unknown_pragmas;
124
125 /* Nonzero means warn about all declarations which shadow others.  */
126
127 extern int warn_shadow;
128
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.  */
131
132 extern int warn_switch;
133
134 /* Warn if a switch does not have a default case.  */
135
136 extern int warn_switch_default;
137
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).  */
140
141 extern int warn_switch_enum;
142
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.  */
145
146 extern int warn_return_type;
147
148 /* Warn about functions which might be candidates for attribute noreturn.  */
149
150 extern int warn_missing_noreturn;
151
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).  */
155
156 extern int warn_cast_align;
157
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'.  */
161
162 extern int warn_larger_than;
163 extern HOST_WIDE_INT larger_than_size;
164
165 /* Warn if a function returns an aggregate,
166    since there are often incompatible calling conventions for doing this.  */
167
168 extern int warn_aggregate_return;
169
170 /* Warn if packed attribute on struct is unnecessary and inefficient.  */
171
172 extern int warn_packed;
173
174 /* Warn when gcc pads a structure to an alignment boundary.  */
175
176 extern int warn_padded;
177
178 /* Warn when an optimization pass is disabled.  */
179
180 extern int warn_disabled_optimization;
181
182 /* Nonzero means warn about uses of __attribute__((deprecated)) 
183    declarations.  */
184
185 extern int warn_deprecated_decl;
186
187 /* Nonzero means warn about constructs which might not be strict
188    aliasing safe.  */
189
190 extern int warn_strict_aliasing;
191
192 /* Nonzero if generating code to do profiling.  */
193
194 extern int profile_flag;
195
196 /* Nonzero if generating code to profile program flow graph arcs.  */
197
198 extern int profile_arc_flag;
199
200 /* Nonzero if generating info for gcov to calculate line test coverage.  */
201
202 extern int flag_test_coverage;
203
204 /* Nonzero indicates that branch taken probabilities should be calculated.  */
205
206 extern int flag_branch_probabilities;
207
208 /* Nonzero if basic blocks should be reordered.  */
209
210 extern int flag_reorder_blocks;
211
212 /* Nonzero if functions should be reordered.  */
213
214 extern int flag_reorder_functions;
215
216 /* Nonzero if registers should be renamed.  */
217
218 extern int flag_rename_registers;
219
220 /* Nonzero for -pedantic switch: warn about anything
221    that standard C forbids.  */
222
223 extern int pedantic;
224
225 /* Temporarily suppress certain warnings.
226    This is set while reading code from a system header file.  */
227
228 extern int in_system_header;
229
230 /* Nonzero for -dp: annotate the assembly with a comment describing the
231    pattern and alternative used.  */
232
233 extern int flag_print_asm_name;
234 \f
235 /* Now the symbols that are set with `-f' switches.  */
236
237 /* Nonzero means `char' should be signed.  */
238
239 extern int flag_signed_char;
240
241 /* Nonzero means give an enum type only as many bytes as it needs.  */
242
243 extern int flag_short_enums;
244
245 /* Nonzero for -fcaller-saves: allocate values in regs that need to
246    be saved across function calls, if that produces overall better code.
247    Optional now, so people can test it.  */
248
249 extern int flag_caller_saves;
250
251 /* Nonzero for -fpcc-struct-return: return values the same way PCC does.  */
252
253 extern int flag_pcc_struct_return;
254
255 /* Nonzero for -fforce-mem: load memory value into a register
256    before arithmetic on it.  This makes better cse but slower compilation.  */
257
258 extern int flag_force_mem;
259
260 /* Nonzero for -fforce-addr: load memory address into a register before
261    reference to memory.  This makes better cse but slower compilation.  */
262
263 extern int flag_force_addr;
264
265 /* Nonzero for -fdefer-pop: don't pop args after each function call;
266    instead save them up to pop many calls' args with one insns.  */
267
268 extern int flag_defer_pop;
269
270 /* Nonzero for -ffloat-store: don't allocate floats and doubles
271    in extended-precision registers.  */
272
273 extern int flag_float_store;
274
275 /* Nonzero enables strength-reduction in loop.c.  */
276
277 extern int flag_strength_reduce;
278
279 /* Nonzero enables loop unrolling in unroll.c.  Only loops for which the
280    number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
281    UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
282    unrolled.  */
283
284 extern int flag_old_unroll_loops;
285
286 /* Nonzero enables loop unrolling in unroll.c.  All loops are unrolled.
287    This is generally not a win.  */
288
289 extern int flag_old_unroll_all_loops;
290
291 /* Nonzero forces all invariant computations in loops to be moved
292    outside the loop.  */
293
294 extern int flag_move_all_movables;
295
296 /* Nonzero enables prefetch optimizations for arrays in loops.  */
297
298 extern int flag_prefetch_loop_arrays;
299
300 /* Nonzero forces all general induction variables in loops to be
301    strength reduced.  */
302
303 extern int flag_reduce_all_givs;
304
305 /* Nonzero for -fcse-follow-jumps:
306    have cse follow jumps to do a more extensive job.  */
307
308 extern int flag_cse_follow_jumps;
309
310 /* Nonzero for -fcse-skip-blocks:
311    have cse follow a branch around a block.  */
312
313 extern int flag_cse_skip_blocks;
314
315 /* Nonzero for -fexpensive-optimizations:
316    perform miscellaneous relatively-expensive optimizations.  */
317 extern int flag_expensive_optimizations;
318
319 /* Nonzero for -fwritable-strings:
320    store string constants in data segment and don't uniquize them.  */
321
322 extern int flag_writable_strings;
323
324 /* Nonzero means don't put addresses of constant functions in registers.
325    Used for compiling the Unix kernel, where strange substitutions are
326    done on the assembly output.  */
327
328 extern int flag_no_function_cse;
329
330 /* Nonzero for -fomit-frame-pointer:
331    don't make a frame pointer in simple functions that don't require one.  */
332
333 extern int flag_omit_frame_pointer;
334
335 /* Nonzero to inhibit use of define_optimization peephole opts.  */
336
337 extern int flag_no_peephole;
338
339 /* Nonzero allows GCC to optimize sibling and tail recursive calls.  */
340
341 extern int flag_optimize_sibling_calls;
342
343 /* Nonzero means the front end generally wants `errno' maintained by math
344    operations, like built-in SQRT.  */
345
346 extern int flag_errno_math;
347
348 /* Nonzero means that unsafe floating-point math optimizations are allowed
349    for the sake of speed.  IEEE compliance is not guaranteed, and operations
350    are allowed to assume that their arguments and results are "normal"
351    (e.g., nonnegative for SQRT).  */
352
353 extern int flag_unsafe_math_optimizations;
354
355 /* Nonzero means that no NaNs or +-Infs are expected.  */
356
357 extern int flag_finite_math_only;
358
359 /* Zero means that floating-point math operations cannot generate a
360    (user-visible) trap.  This is the case, for example, in nonstop
361    IEEE 754 arithmetic.  */
362
363 extern int flag_trapping_math;
364
365 /* 0 means straightforward implementation of complex divide acceptable.
366    1 means wide ranges of inputs must work for complex divide.
367    2 means C99-like requirements for complex divide (not yet implemented).  */
368
369 extern int flag_complex_divide_method;
370
371 /* Nonzero means to run loop optimizations twice.  */
372
373 extern int flag_rerun_loop_opt;
374
375 /* Nonzero means make functions that look like good inline candidates
376    go inline.  */
377
378 extern int flag_inline_functions;
379
380 /* Nonzero for -fkeep-inline-functions: even if we make a function
381    go inline everywhere, keep its definition around for debugging
382    purposes.  */
383
384 extern int flag_keep_inline_functions;
385
386 /* Nonzero means that functions declared `inline' will be treated
387    as `static'.  Prevents generation of zillions of copies of unused
388    static inline functions; instead, `inlines' are written out
389    only when actually used.  Used in conjunction with -g.  Also
390    does the right thing with #pragma interface.  */
391
392 extern int flag_no_inline;
393
394 /* Nonzero means that we don't want inlining by virtue of -fno-inline,
395    not just because the tree inliner turned us off.  */
396
397 extern int flag_really_no_inline;
398
399 /* Nonzero if we are only using compiler to check syntax errors.  */
400
401 extern int flag_syntax_only;
402
403 /* Nonzero means we should save auxiliary info into a .X file.  */
404
405 extern int flag_gen_aux_info;
406
407 /* Nonzero means make the text shared if supported.  */
408
409 extern int flag_shared_data;
410
411 /* flag_schedule_insns means schedule insns within basic blocks (before
412    local_alloc).
413    flag_schedule_insns_after_reload means schedule insns after
414    global_alloc.  */
415
416 extern int flag_schedule_insns;
417 extern int flag_schedule_insns_after_reload;
418 extern int flag_sched2_use_superblocks;
419 extern int flag_sched2_use_traces;
420
421 /* The following flags have effect only for scheduling before register
422    allocation:
423
424    flag_schedule_interblock means schedule insns across basic blocks.
425    flag_schedule_speculative means allow speculative motion of non-load insns.
426    flag_schedule_speculative_load means allow speculative motion of some
427    load insns.
428    flag_schedule_speculative_load_dangerous allows speculative motion of more
429    load insns.  */
430
431 extern int flag_schedule_interblock;
432 extern int flag_schedule_speculative;
433 extern int flag_schedule_speculative_load;
434 extern int flag_schedule_speculative_load_dangerous;
435
436 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
437    by a cheaper branch, on a count register.  */
438 extern int flag_branch_on_count_reg;
439
440 /* This option is set to 1 on -fsingle-precision-constant option which is
441    used to convert the floating point constants to single precision 
442    constants.  */
443
444 extern int flag_single_precision_constant;
445
446 /* Nonzero means put things in delayed-branch slots if supported.  */
447
448 extern int flag_delayed_branch;
449
450 /* Nonzero means suppress output of instruction numbers and line number
451    notes in debugging dumps.  */
452
453 extern int flag_dump_unnumbered;
454
455 /* Nonzero means change certain warnings into errors.
456    Usually these are warnings about failure to conform to some standard.  */
457
458 extern int flag_pedantic_errors;
459
460 /* Nonzero means generate position-independent code.  1 vs 2 for a 
461    target-dependent "small" or "large" mode.  */
462
463 extern int flag_pic;
464
465 /* Nonzero if we are compiling position independent code for executable.
466    1 vs 2 for a target-dependent "small" or "large" mode.  */
467       
468 extern int flag_pie;
469       
470 /* Nonzero if we are compiling code for a shared library, zero for
471    executable.  */
472
473 extern int flag_shlib;
474
475 /* Nonzero means generate extra code for exception handling and enable
476    exception handling.  */
477
478 extern int flag_exceptions;
479
480 /* Nonzero means generate frame unwind info table when supported */
481
482 extern int flag_unwind_tables;
483
484 /* Nonzero means generate frame unwind info table exact at each insn boundary */
485
486 extern int flag_asynchronous_unwind_tables;
487
488 /* Nonzero means don't place uninitialized global data in common storage
489    by default.  */
490
491 extern int flag_no_common;
492
493 /* -finhibit-size-directive inhibits output of .size for ELF.
494    This is used only for compiling crtstuff.c,
495    and it may be extended to other effects
496    needed for crtstuff.c on other systems.  */
497 extern int flag_inhibit_size_directive;
498
499 /* Nonzero means place each function into its own section on those platforms
500    which support arbitrary section names and unlimited numbers of sections.  */
501
502 extern int flag_function_sections;
503
504 /* ... and similar for data.  */
505  
506 extern int flag_data_sections;
507
508 /* -fverbose-asm causes extra commentary information to be produced in
509    the generated assembly code (to make it more readable).  This option
510    is generally only of use to those who actually need to read the
511    generated assembly code (perhaps while debugging the compiler itself).
512    -fno-verbose-asm, the default, causes the extra information
513    to not be added and is useful when comparing two assembler files.  */
514
515 extern int flag_verbose_asm;
516
517 /* -dA causes debug information to be produced in
518    the generated assembly code (to make it more readable).  This option
519    is generally only of use to those who actually need to read the
520    generated assembly code (perhaps while debugging the compiler itself).
521    Currently, this switch is only used by dwarfout.c; however, it is intended
522    to be a catchall for printing debug information in the assembler file.  */
523
524 extern int flag_debug_asm;
525
526 extern int flag_dump_rtl_in_asm;
527
528 /* Greater than zero if user symbols are prepended by a leading underscore
529    in generated assembly code.  */
530 extern int flag_leading_underscore;
531
532 /* -fgnu-linker specifies use of the GNU linker for initializations.
533    -fno-gnu-linker says that collect will be used.  */
534 extern int flag_gnu_linker;
535
536 /* Tag all structures with __attribute__(packed) */
537 extern int flag_pack_struct;
538
539 /* This flag is only tested if alias checking is enabled.
540    0 if pointer arguments may alias each other.  True in C.
541    1 if pointer arguments may not alias each other but may alias
542    global variables.
543    2 if pointer arguments may not alias each other and may not
544    alias global variables.  True in Fortran.
545    The value is ignored if flag_alias_check is 0.  */
546 extern int flag_argument_noalias;
547
548 /* Nonzero if we should do (language-dependent) alias analysis.
549    Typically, this analysis will assume that expressions of certain
550    types do not alias expressions of certain other types.  Only used
551    if alias analysis (in general) is enabled.  */
552 extern int flag_strict_aliasing;
553
554 /* Emit code to probe the stack, to help detect stack overflow; also
555    may cause large objects to be allocated dynamically.  */
556 extern int flag_stack_check;
557
558 /* Do the full regmove optimization pass.  */
559 extern int flag_regmove;
560
561 /* Instrument functions with calls at entry and exit, for profiling.  */
562 extern int flag_instrument_function_entry_exit;
563
564 /* Perform a peephole pass before sched2.  */
565 extern int flag_peephole2;
566
567 /* Try to guess branch probabilities.  */
568 extern int flag_guess_branch_prob;
569
570 /* -fcheck-bounds causes gcc to generate array bounds checks.
571    For C, C++ and ObjC: defaults off.
572    For Java: defaults to on.
573    For Fortran: defaults to off.  */
574 extern int flag_bounds_check;
575
576 /* This will attempt to merge constant section constants, if 1 only
577    string constants and constants from constant pool, if 2 also constant
578    variables.  */
579 extern int flag_merge_constants;
580
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;
585 \f
586 /* Other basic status info about current function.  */
587
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.  */
591
592 extern int frame_pointer_needed;
593
594 /* Nonzero if the generated code should trap on signed overflow
595    for PLUS / SUB / MULT.  */
596 extern int flag_trapv;
597
598 /* Nonzero if the signed arithmetic overflow should wrap around.  */
599 extern int flag_wrapv;
600
601 /* Value of the -G xx switch, and whether it was passed or not.  */
602 extern unsigned HOST_WIDE_INT g_switch_value;
603 extern bool g_switch_set;
604
605 /* Values of the -falign-* flags: how much to align labels in code. 
606    0 means `use default', 1 means `don't align'.  
607    For each variable, there is an _log variant which is the power
608    of two not less than the variable, for .align output.  */
609
610 extern int align_loops;
611 extern int align_loops_log;
612 extern int align_loops_max_skip;
613 extern int align_jumps;
614 extern int align_jumps_log;
615 extern int align_jumps_max_skip;
616 extern int align_labels;
617 extern int align_labels_log;
618 extern int align_labels_max_skip;
619 extern int align_functions;
620 extern int align_functions_log;
621
622 /* Like align_functions_log above, but used by front-ends to force the
623    minimum function alignment.  Zero means no alignment is forced.  */
624 extern int force_align_functions_log;
625
626 /* Nonzero if we dump in VCG format, not plain text.  */
627 extern int dump_for_graph;
628
629 /* Selection of the graph form.  */
630 enum graph_dump_types
631 {
632   no_graph = 0,
633   vcg
634 };
635 extern enum graph_dump_types graph_dump_format;
636
637 /* Nonzero means ignore `#ident' directives.  0 means handle them.
638    On SVR4 targets, it also controls whether or not to emit a
639    string identifying the compiler.  */
640
641 extern int flag_no_ident;
642
643 /* Nonzero means perform global CSE.  */
644
645 extern int flag_gcse;
646
647 /* Nonzero if we want to perform enhanced load motion during gcse.  */
648
649 extern int flag_gcse_lm;
650
651 /* Nonzero if we want to perform store motion after gcse.  */
652
653 extern int flag_gcse_sm;
654
655
656 /* Nonzero means we should do dwarf2 duplicate elimination.  */
657
658 extern int flag_eliminate_dwarf2_dups;
659
660 /* Nonzero means we should do unused type elimination.  */
661
662 extern int flag_eliminate_unused_debug_types;
663
664 /* Nonzero means to collect statistics which might be expensive
665    and to print them when we are done.  */
666 extern int flag_detailed_statistics;
667
668 /* Nonzero means enable synchronous exceptions for non-call instructions.  */
669 extern int flag_non_call_exceptions;
670
671 /* Nonzero means put zero initialized data in the bss section.  */
672 extern int flag_zero_initialized_in_bss;
673
674 /* Nonzero means disable transformations observable by signaling NaNs.  */
675 extern int flag_signaling_nans;
676
677 extern int flag_unit_at_a_time;
678
679 /* A string that's used when a random name is required.  NULL means
680    to make it really random.  */
681
682 extern const char *flag_random_seed;
683
684 /* True if the given mode has a NaN representation and the treatment of
685    NaN operands is important.  Certain optimizations, such as folding
686    x * 0 into x, are not correct for NaN operands, and are normally
687    disabled for modes with NaNs.  The user can ask for them to be
688    done anyway using the -funsafe-math-optimizations switch.  */
689 #define HONOR_NANS(MODE) \
690   (MODE_HAS_NANS (MODE) && !flag_finite_math_only)
691
692 /* Like HONOR_NANs, but true if we honor signaling NaNs (or sNaNs).  */
693 #define HONOR_SNANS(MODE) (flag_signaling_nans && HONOR_NANS (MODE))
694
695 /* As for HONOR_NANS, but true if the mode can represent infinity and
696    the treatment of infinite values is important.  */
697 #define HONOR_INFINITIES(MODE) \
698   (MODE_HAS_INFINITIES (MODE) && !flag_finite_math_only)
699
700 /* Like HONOR_NANS, but true if the given mode distinguishes between
701    positive and negative zero, and the sign of zero is important.  */
702 #define HONOR_SIGNED_ZEROS(MODE) \
703   (MODE_HAS_SIGNED_ZEROS (MODE) && !flag_unsafe_math_optimizations)
704
705 /* Like HONOR_NANS, but true if given mode supports sign-dependent rounding,
706    and the rounding mode is important.  */
707 #define HONOR_SIGN_DEPENDENT_ROUNDING(MODE) \
708   (MODE_HAS_SIGN_DEPENDENT_ROUNDING (MODE) && !flag_unsafe_math_optimizations)
709
710 #endif /* ! GCC_FLAGS_H */