OSDN Git Service

* init.c (build_new): Allow enumeration types for the array-bounds
[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 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. */
334
335 extern int flag_fast_math;
336
337 /* Nonzero allows GCC to optimize sibling and tail recursive calls.  */
338
339 extern int flag_optimize_sibling_calls;
340
341 /* Nonzero means the front end generally wants `errno' maintained by math
342    operations, like built-in SQRT, unless overridden by flag_fast_math.  */
343
344 extern int flag_errno_math;
345
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).  */
349
350 extern int flag_complex_divide_method;
351
352 /* Nonzero means to run loop optimizations twice.  */
353
354 extern int flag_rerun_loop_opt;
355
356 /* Nonzero means make functions that look like good inline candidates
357    go inline.  */
358
359 extern int flag_inline_functions;
360
361 /* Nonzero for -fkeep-inline-functions: even if we make a function
362    go inline everywhere, keep its definition around for debugging
363    purposes.  */
364
365 extern int flag_keep_inline_functions;
366
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.  */
372
373 extern int flag_no_inline;
374
375 /* Nonzero if we are only using compiler to check syntax errors.  */
376
377 extern int flag_syntax_only;
378
379 /* Nonzero means we should save auxiliary info into a .X file.  */
380
381 extern int flag_gen_aux_info;
382
383 /* Nonzero means make the text shared if supported.  */
384
385 extern int flag_shared_data;
386
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.  */
391
392 extern int flag_schedule_insns;
393 extern int flag_schedule_insns_after_reload;
394
395 /* The following flags have effect only for scheduling before register
396    allocation:
397
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.  */
404
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;
409
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;
413
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. */
417
418 extern int flag_single_precision_constant;
419
420 /* Nonzero means put things in delayed-branch slots if supported. */
421
422 extern int flag_delayed_branch;
423
424 /* Nonzero means suppress output of instruction numbers and line number
425    notes in debugging dumps.  */
426
427 extern int flag_dump_unnumbered;
428
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.  */
432
433 extern int flag_pretend_float;
434
435 /* Nonzero means change certain warnings into errors.
436    Usually these are warnings about failure to conform to some standard.  */
437
438 extern int flag_pedantic_errors;
439
440 /* Nonzero means generate position-independent code.
441    This is not fully implemented yet.  */
442
443 extern int flag_pic;
444
445 /* Nonzero means generate extra code for exception handling and enable
446    exception handling.  */
447
448 extern int flag_exceptions;
449
450 /* Nonzero means use the new model for exception handling. Replaces 
451    -DNEW_EH_MODEL as a compile option. */
452
453 extern int flag_new_exceptions;
454
455 /* Nonzero means generate frame unwind info table when supported */
456
457 extern int flag_unwind_tables;
458
459 /* Nonzero means don't place uninitialized global data in common storage
460    by default.  */
461
462 extern int flag_no_common;
463
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;
469
470 /* Nonzero means place each function into its own section on those platforms
471    which support arbitrary section names and unlimited numbers of sections.  */
472
473 extern int flag_function_sections;
474
475 /* ... and similar for data.  */
476  
477 extern int flag_data_sections;
478
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.  */
485
486 extern int flag_verbose_asm;
487
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.  */
494
495 extern int flag_debug_asm;
496
497 extern int flag_dump_rtl_in_asm;
498
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;
502
503 /* Tag all structures with __attribute__(packed) */
504 extern int flag_pack_struct;
505
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;
514
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;
520
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;
524
525 /* Do the full regmove optimization pass.  */
526 extern int flag_regmove;
527
528 /* Instrument functions with calls at entry and exit, for profiling.  */
529 extern int flag_instrument_function_entry_exit;
530
531 /* Perform a peephole pass before sched2. */
532 extern int flag_peephole2;
533
534 /* Try to guess branch probablities.  */
535 extern int flag_guess_branch_prob;
536
537 /* -fbounded-pointers causes gcc to compile pointers as composite
538    objects occupying three words: the pointer value, the base address
539    of the referent object, and the address immediately beyond the end
540    of the referent object.  The base and extent allow us to perform
541    runtime bounds checking.  -fbounded-pointers implies -fcheck-bounds.  */
542 extern int flag_bounded_pointers;
543
544 /* -fcheck-bounds causes gcc to generate array bounds checks.
545    For C, C++: defaults to value of flag_bounded_pointers.
546    For ObjC: defaults to off.
547    For Java: defaults to on.
548    For Fortran: defaults to off.
549    For CHILL: defaults to off.  */
550 extern int flag_bounds_check;
551
552 /* If one, renumber instruction UIDs to reduce the number of
553    unused UIDs if there are a lot of instructions.  If greater than
554    one, unconditionally renumber instruction UIDs.  */
555 extern int flag_renumber_insns;
556 \f
557 /* Other basic status info about current function.  */
558
559 /* Nonzero means current function must be given a frame pointer.
560    Set in stmt.c if anything is allocated on the stack there.
561    Set in reload1.c if anything is allocated on the stack there.  */
562
563 extern int frame_pointer_needed;
564
565 /* Nonzero if GCC must add code to check memory access (used by Checker).  */
566
567 extern int flag_check_memory_usage;
568
569 /* Nonzero if the generated code should trap on signed overflow
570    for PLUS / SUB / MULT.  */
571 extern int flag_trapv;
572
573 /* Nonzero if GCC must prefix function names (used with
574    flag_check_memory_usage).  */
575
576 extern int flag_prefix_function_name;
577
578 /* Value of the -G xx switch, and whether it was passed or not.  */
579 extern int g_switch_value;
580 extern int g_switch_set;
581
582 /* Values of the -falign-* flags: how much to align labels in code. 
583    0 means `use default', 1 means `don't align'.  
584    For each variable, there is an _log variant which is the power
585    of two not less than the variable, for .align output.  */
586
587 extern int align_loops;
588 extern int align_loops_log;
589 extern int align_jumps;
590 extern int align_jumps_log;
591 extern int align_labels;
592 extern int align_labels_log;
593 extern int align_functions;
594 extern int align_functions_log;
595
596 /* Nonzero if we dump in VCG format, not plain text.  */
597 extern int dump_for_graph;
598
599 /* Selection of the graph form.  */
600 enum graph_dump_types
601 {
602   no_graph = 0,
603   vcg
604 };
605 extern enum graph_dump_types graph_dump_format;
606
607 /* Nonzero means ignore `#ident' directives.  0 means handle them.
608    On SVR4 targets, it also controls whether or not to emit a
609    string identifying the compiler.  */
610
611 extern int flag_no_ident;
612
613 /* Nonzero means we should do dwarf2 duplicate elimination.  */
614
615 extern int flag_eliminate_dwarf2_dups;
616
617 /* Non-zero means to collect statistics which might be expensive
618    and to print them when we are done.  */
619 extern int flag_detailed_statistics;
620
621 #endif /* GCC_FLAGS_H */