OSDN Git Service

* except.h (flag_non_call_exceptions): Move ...
[pf3gnuchains/gcc-fork.git] / gcc / flags.h
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.
4
5 This file is part of GNU CC.
6
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.
11
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.
16
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.  */
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 };
37
38 /* Specify which kind of debugging info to generate.  */
39 extern enum debug_info_type write_symbols;
40
41 enum debug_info_level
42 {
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.  */
47 };
48
49 /* Specify how much debugging info to generate.  */
50 extern enum debug_info_level debug_info_level;
51
52 /* Nonzero means use GNU-only extensions in the generated symbolic
53    debugging information.  */
54 extern int use_gnu_debug_info_extensions;
55
56 /* Nonzero means do optimizations.  -opt.  */
57
58 extern int optimize;
59
60 /* Nonzero means optimize for size.  -Os.  */
61
62 extern int optimize_size;
63
64 /* Don't print functions as they are compiled and don't print
65    times taken by the various passes.  -quiet.  */
66
67 extern int quiet_flag;
68
69 /* Print times taken by the various passes.  -ftime-report.  */
70
71 extern int time_report;
72
73 /* Print memory still in use at end of compilation (which may have little
74    to do with peak memory consumption).  -fmem-report.  */
75
76 extern int mem_report;
77
78 /* Don't print warning messages.  -w.  */
79
80 extern int inhibit_warnings;
81
82 /* Don't suppress warnings from system headers.  -Wsystem-headers.  */
83
84 extern int warn_system_headers;
85
86 /* Do print extra warnings (such as for uninitialized variables).  -W.  */
87
88 extern int extra_warnings;
89
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. */
93
94 extern void set_Wunused PARAMS ((int setting));
95
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;
101
102 /* Nonzero to warn about code which is never reached.  */
103
104 extern int warn_notreached;
105
106 /* Nonzero means warn if inline function is too large.  */
107
108 extern int warn_inline;
109
110 /* Nonzero to warn about variables used before they are initialized.  */
111
112 extern int warn_uninitialized;
113
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.  */
119
120 extern int warn_unknown_pragmas;
121
122 /* Nonzero means warn about all declarations which shadow others.   */
123
124 extern int warn_shadow;
125
126 /* Warn if a switch on an enum fails to have a case for every enum value.  */
127
128 extern int warn_switch;
129
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.  */
132
133 extern int warn_return_type;
134
135 /* Warn about functions which might be candidates for attribute noreturn. */
136
137 extern int warn_missing_noreturn;
138
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).  */
142
143 extern int warn_cast_align;
144
145 /* Nonzero means warn about any identifiers that match in the first N
146    characters.  The value N is in `id_clash_len'.  */
147
148 extern int warn_id_clash;
149 extern int id_clash_len;
150
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'.  */
154
155 extern int warn_larger_than;
156 extern HOST_WIDE_INT larger_than_size;
157
158 /* Warn if a function returns an aggregate,
159    since there are often incompatible calling conventions for doing this.  */
160
161 extern int warn_aggregate_return;
162
163 /* Warn if packed attribute on struct is unnecessary and inefficient.  */
164
165 extern int warn_packed;
166
167 /* Warn when gcc pads a structure to an alignment boundary.  */
168
169 extern int warn_padded;
170
171 /* Warn when an optimization pass is disabled.  */
172
173 extern int warn_disabled_optimization;
174
175 /* Nonzero if generating code to do profiling.  */
176
177 extern int profile_flag;
178
179 /* Nonzero if generating code to do profiling on the basis of basic blocks.  */
180
181 extern int profile_block_flag;
182
183 /* Nonzero if generating code to profile program flow graph arcs. */
184
185 extern int profile_arc_flag;
186
187 /* Nonzero if generating info for gcov to calculate line test coverage. */
188
189 extern int flag_test_coverage;
190
191 /* Nonzero indicates that branch taken probabilities should be calculated. */
192
193 extern int flag_branch_probabilities;
194
195 /* Nonzero if basic blocks should be reordered.  */
196
197 extern int flag_reorder_blocks;
198
199 /* Nonzero if registers should be renamed.  */
200
201 extern int flag_rename_registers;
202
203 /* Nonzero for -pedantic switch: warn about anything
204    that standard C forbids.  */
205
206 extern int pedantic;
207
208 /* Temporarily suppress certain warnings.
209    This is set while reading code from a system header file.  */
210
211 extern int in_system_header;
212
213 /* Nonzero for -dp: annotate the assembly with a comment describing the
214    pattern and alternative used.  */
215
216 extern int flag_print_asm_name;
217 \f
218 /* Now the symbols that are set with `-f' switches.  */
219
220 /* Nonzero means `char' should be signed.  */
221
222 extern int flag_signed_char;
223
224 /* Nonzero means give an enum type only as many bytes as it needs.  */
225
226 extern 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
232 extern int flag_caller_saves;
233
234 /* Nonzero for -fpcc-struct-return: return values the same way PCC does.  */
235
236 extern 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
241 extern 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
246 extern 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
251 extern int flag_defer_pop;
252
253 /* Nonzero for -ffloat-store: don't allocate floats and doubles
254    in extended-precision registers.  */
255
256 extern int flag_float_store;
257
258 /* Nonzero enables strength-reduction in loop.c.  */
259
260 extern 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
267 extern 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
272 extern int flag_unroll_all_loops;
273
274 /* Nonzero forces all invariant computations in loops to be moved
275    outside the loop. */
276
277 extern int flag_move_all_movables;
278
279 /* Nonzero forces all general induction variables in loops to be
280    strength reduced. */
281
282 extern int flag_reduce_all_givs;
283
284 /* Nonzero for -fcse-follow-jumps:
285    have cse follow jumps to do a more extensive job.  */
286
287 extern int flag_cse_follow_jumps;
288
289 /* Nonzero for -fcse-skip-blocks:
290    have cse follow a branch around a block.  */
291
292 extern int flag_cse_skip_blocks;
293
294 /* Nonzero for -fexpensive-optimizations:
295    perform miscellaneous relatively-expensive optimizations.  */
296 extern int flag_expensive_optimizations;
297
298 /* Nonzero for -fwritable-strings:
299    store string constants in data segment and don't uniquize them.  */
300
301 extern int flag_writable_strings;
302
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.  */
306
307 extern int flag_no_function_cse;
308
309 /* Nonzero for -fomit-frame-pointer:
310    don't make a frame pointer in simple functions that don't require one.  */
311
312 extern int flag_omit_frame_pointer;
313
314 /* Nonzero to inhibit use of define_optimization peephole opts.  */
315
316 extern int flag_no_peephole;
317
318 /* Nonzero means all references through pointers are volatile.  */
319
320 extern int flag_volatile;
321
322 /* Nonzero means treat all global and extern variables as volatile.  */
323
324 extern int flag_volatile_global;
325
326 /* Nonzero means treat all static variables as volatile.  */
327
328 extern int flag_volatile_static;
329
330 /* Nonzero allows GCC to optimize sibling and tail recursive calls.  */
331
332 extern int flag_optimize_sibling_calls;
333
334 /* Nonzero means the front end generally wants `errno' maintained by math
335    operations, like built-in SQRT.  */
336
337 extern int flag_errno_math;
338
339 /* Nonzero means that unsafe floating-point math optimizations are allowed
340    for the sake of speed.  IEEE compliance is not guaranteed, and operations
341    are allowed to assume that their arguments and results are "normal"
342    (e.g., nonnegative for SQRT).  */
343
344 extern int flag_unsafe_math_optimizations;
345
346 /* Zero means that floating-point math operations cannot generate a
347    (user-visible) trap.  This is the case, for example, in nonstop
348    IEEE 754 arithmetic.  */
349
350 extern int flag_trapping_math;
351
352 /* 0 means straightforward implementation of complex divide acceptable.
353    1 means wide ranges of inputs must work for complex divide.
354    2 means C99-like requirements for complex divide (not yet implemented).  */
355
356 extern int flag_complex_divide_method;
357
358 /* Nonzero means to run loop optimizations twice.  */
359
360 extern int flag_rerun_loop_opt;
361
362 /* Nonzero means make functions that look like good inline candidates
363    go inline.  */
364
365 extern int flag_inline_functions;
366
367 /* Nonzero for -fkeep-inline-functions: even if we make a function
368    go inline everywhere, keep its definition around for debugging
369    purposes.  */
370
371 extern int flag_keep_inline_functions;
372
373 /* Nonzero means that functions declared `inline' will be treated
374    as `static'.  Prevents generation of zillions of copies of unused
375    static inline functions; instead, `inlines' are written out
376    only when actually used.  Used in conjunction with -g.  Also
377    does the right thing with #pragma interface.  */
378
379 extern int flag_no_inline;
380
381 /* Nonzero if we are only using compiler to check syntax errors.  */
382
383 extern int flag_syntax_only;
384
385 /* Nonzero means we should save auxiliary info into a .X file.  */
386
387 extern int flag_gen_aux_info;
388
389 /* Nonzero means make the text shared if supported.  */
390
391 extern int flag_shared_data;
392
393 /* flag_schedule_insns means schedule insns within basic blocks (before
394    local_alloc).
395    flag_schedule_insns_after_reload means schedule insns after
396    global_alloc.  */
397
398 extern int flag_schedule_insns;
399 extern int flag_schedule_insns_after_reload;
400
401 /* The following flags have effect only for scheduling before register
402    allocation:
403
404    flag_schedule_interblock means schedule insns accross basic blocks.
405    flag_schedule_speculative means allow speculative motion of non-load insns.
406    flag_schedule_speculative_load means allow speculative motion of some
407    load insns.
408    flag_schedule_speculative_load_dangerous allows speculative motion of more
409    load insns.  */
410
411 extern int flag_schedule_interblock;
412 extern int flag_schedule_speculative;
413 extern int flag_schedule_speculative_load;
414 extern int flag_schedule_speculative_load_dangerous;
415
416 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
417    by a cheaper branch, on a count register. */
418 extern int flag_branch_on_count_reg;
419
420 /* This option is set to 1 on -fsingle-precision-constant option which is
421    used to convert the floating point constants to single precision 
422    constants. */
423
424 extern int flag_single_precision_constant;
425
426 /* Nonzero means put things in delayed-branch slots if supported. */
427
428 extern int flag_delayed_branch;
429
430 /* Nonzero means suppress output of instruction numbers and line number
431    notes in debugging dumps.  */
432
433 extern int flag_dump_unnumbered;
434
435 /* Nonzero means pretend it is OK to examine bits of target floats,
436    even if that isn't true.  The resulting code will have incorrect constants,
437    but the same series of instructions that the native compiler would make.  */
438
439 extern int flag_pretend_float;
440
441 /* Nonzero means change certain warnings into errors.
442    Usually these are warnings about failure to conform to some standard.  */
443
444 extern int flag_pedantic_errors;
445
446 /* Nonzero means generate position-independent code.
447    This is not fully implemented yet.  */
448
449 extern int flag_pic;
450
451 /* Nonzero means generate extra code for exception handling and enable
452    exception handling.  */
453
454 extern int flag_exceptions;
455
456 /* Nonzero means use the new model for exception handling. Replaces 
457    -DNEW_EH_MODEL as a compile option. */
458
459 extern int flag_new_exceptions;
460
461 /* Nonzero means generate frame unwind info table when supported */
462
463 extern int flag_unwind_tables;
464
465 /* Nonzero means don't place uninitialized global data in common storage
466    by default.  */
467
468 extern int flag_no_common;
469
470 /* -finhibit-size-directive inhibits output of .size for ELF.
471    This is used only for compiling crtstuff.c,
472    and it may be extended to other effects
473    needed for crtstuff.c on other systems.  */
474 extern int flag_inhibit_size_directive;
475
476 /* Nonzero means place each function into its own section on those platforms
477    which support arbitrary section names and unlimited numbers of sections.  */
478
479 extern int flag_function_sections;
480
481 /* ... and similar for data.  */
482  
483 extern int flag_data_sections;
484
485 /* -fverbose-asm causes extra commentary information to be produced in
486    the generated assembly code (to make it more readable).  This option
487    is generally only of use to those who actually need to read the
488    generated assembly code (perhaps while debugging the compiler itself).
489    -fno-verbose-asm, the default, causes the extra information
490    to not be added and is useful when comparing two assembler files.  */
491
492 extern int flag_verbose_asm;
493
494 /* -dA causes debug information to be produced in
495    the generated assembly code (to make it more readable).  This option
496    is generally only of use to those who actually need to read the
497    generated assembly code (perhaps while debugging the compiler itself).
498    Currently, this switch is only used by dwarfout.c; however, it is intended
499    to be a catchall for printing debug information in the assembler file.  */
500
501 extern int flag_debug_asm;
502
503 extern int flag_dump_rtl_in_asm;
504
505 /* -fgnu-linker specifies use of the GNU linker for initializations.
506    -fno-gnu-linker says that collect will be used.  */
507 extern int flag_gnu_linker;
508
509 /* Tag all structures with __attribute__(packed) */
510 extern int flag_pack_struct;
511
512 /* This flag is only tested if alias checking is enabled.
513    0 if pointer arguments may alias each other.  True in C.
514    1 if pointer arguments may not alias each other but may alias
515    global variables.
516    2 if pointer arguments may not alias each other and may not
517    alias global variables.  True in Fortran.
518    The value is ignored if flag_alias_check is 0.  */
519 extern int flag_argument_noalias;
520
521 /* Nonzero if we should do (language-dependent) alias analysis.
522    Typically, this analysis will assume that expressions of certain
523    types do not alias expressions of certain other types.  Only used
524    if alias analysis (in general) is enabled.  */
525 extern int flag_strict_aliasing;
526
527 /* Emit code to probe the stack, to help detect stack overflow; also
528    may cause large objects to be allocated dynamically.  */
529 extern int flag_stack_check;
530
531 /* Do the full regmove optimization pass.  */
532 extern int flag_regmove;
533
534 /* Instrument functions with calls at entry and exit, for profiling.  */
535 extern int flag_instrument_function_entry_exit;
536
537 /* Perform a peephole pass before sched2. */
538 extern int flag_peephole2;
539
540 /* Try to guess branch probablities.  */
541 extern int flag_guess_branch_prob;
542
543 /* -fbounded-pointers causes gcc to compile pointers as composite
544    objects occupying three words: the pointer value, the base address
545    of the referent object, and the address immediately beyond the end
546    of the referent object.  The base and extent allow us to perform
547    runtime bounds checking.  -fbounded-pointers implies -fcheck-bounds.  */
548 extern int flag_bounded_pointers;
549
550 /* -fcheck-bounds causes gcc to generate array bounds checks.
551    For C, C++: defaults to value of flag_bounded_pointers.
552    For ObjC: defaults to off.
553    For Java: defaults to on.
554    For Fortran: defaults to off.
555    For CHILL: defaults to off.  */
556 extern int flag_bounds_check;
557
558 /* If one, renumber instruction UIDs to reduce the number of
559    unused UIDs if there are a lot of instructions.  If greater than
560    one, unconditionally renumber instruction UIDs.  */
561 extern int flag_renumber_insns;
562 \f
563 /* Other basic status info about current function.  */
564
565 /* Nonzero means current function must be given a frame pointer.
566    Set in stmt.c if anything is allocated on the stack there.
567    Set in reload1.c if anything is allocated on the stack there.  */
568
569 extern int frame_pointer_needed;
570
571 /* Nonzero if GCC must add code to check memory access (used by Checker).  */
572
573 extern int flag_check_memory_usage;
574
575 /* Nonzero if the generated code should trap on signed overflow
576    for PLUS / SUB / MULT.  */
577 extern int flag_trapv;
578
579 /* Nonzero if GCC must prefix function names (used with
580    flag_check_memory_usage).  */
581
582 extern int flag_prefix_function_name;
583
584 /* Value of the -G xx switch, and whether it was passed or not.  */
585 extern int g_switch_value;
586 extern int g_switch_set;
587
588 /* Values of the -falign-* flags: how much to align labels in code. 
589    0 means `use default', 1 means `don't align'.  
590    For each variable, there is an _log variant which is the power
591    of two not less than the variable, for .align output.  */
592
593 extern int align_loops;
594 extern int align_loops_log;
595 extern int align_jumps;
596 extern int align_jumps_log;
597 extern int align_labels;
598 extern int align_labels_log;
599 extern int align_functions;
600 extern int align_functions_log;
601
602 /* Nonzero if we dump in VCG format, not plain text.  */
603 extern int dump_for_graph;
604
605 /* Selection of the graph form.  */
606 enum graph_dump_types
607 {
608   no_graph = 0,
609   vcg
610 };
611 extern enum graph_dump_types graph_dump_format;
612
613 /* Nonzero means ignore `#ident' directives.  0 means handle them.
614    On SVR4 targets, it also controls whether or not to emit a
615    string identifying the compiler.  */
616
617 extern int flag_no_ident;
618
619 /* Nonzero means we should do dwarf2 duplicate elimination.  */
620
621 extern int flag_eliminate_dwarf2_dups;
622
623 /* Non-zero means to collect statistics which might be expensive
624    and to print them when we are done.  */
625 extern int flag_detailed_statistics;
626
627 /* Nonzero means enable synchronous exceptions for non-call instructions.  */
628 extern int flag_non_call_exceptions;
629
630 #endif /* GCC_FLAGS_H */