OSDN Git Service

* toplev.c (warn_disabled_optimization): Declare new warning flag.
[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 /* Do print extra warnings (such as for uninitialized variables).  -W.  */
83
84 extern int extra_warnings;
85
86 /* Nonzero to warn about unused variables, functions et.al.  Use
87    set_Wunused() to update the -Wunused-* flags that correspond to the
88    -Wunused option. */
89
90 extern void set_Wunused PARAMS ((int setting));
91
92 extern int warn_unused_function;
93 extern int warn_unused_label;
94 extern int warn_unused_parameter;
95 extern int warn_unused_variable;
96 extern int warn_unused_value;
97
98 /* Nonzero to warn about code which is never reached.  */
99
100 extern int warn_notreached;
101
102 /* Nonzero means warn if inline function is too large.  */
103
104 extern int warn_inline;
105
106 /* Nonzero to warn about variables used before they are initialized.  */
107
108 extern int warn_uninitialized;
109
110 /* Zero if unknown pragmas are ignored
111    One if the compiler should warn about an unknown pragma not in
112    a system include file.
113    Greater than one if the compiler should warn for all unknown
114    pragmas.  */
115
116 extern int warn_unknown_pragmas;
117
118 /* Nonzero means warn about all declarations which shadow others.   */
119
120 extern int warn_shadow;
121
122 /* Warn if a switch on an enum fails to have a case for every enum value.  */
123
124 extern int warn_switch;
125
126 /* Nonzero means warn about function definitions that default the return type
127    or that use a null return and have a return-type other than void.  */
128
129 extern int warn_return_type;
130
131 /* Nonzero means warn about pointer casts that increase the required
132    alignment of the target type (and might therefore lead to a crash
133    due to a misaligned access).  */
134
135 extern int warn_cast_align;
136
137 /* Nonzero means warn about any identifiers that match in the first N
138    characters.  The value N is in `id_clash_len'.  */
139
140 extern int warn_id_clash;
141 extern int id_clash_len;
142
143 /* Nonzero means warn about any objects definitions whose size is larger
144    than N bytes.  Also want about function definitions whose returned
145    values are larger than N bytes. The value N is in `larger_than_size'.  */
146
147 extern int warn_larger_than;
148 extern HOST_WIDE_INT larger_than_size;
149
150 /* Warn if a function returns an aggregate,
151    since there are often incompatible calling conventions for doing this.  */
152
153 extern int warn_aggregate_return;
154
155 /* Warn if packed attribute on struct is unnecessary and inefficient.  */
156
157 extern int warn_packed;
158
159 /* Warn when gcc pads a structure to an alignment boundary.  */
160
161 extern int warn_padded;
162
163 /* Warn when an optimization pass is disabled.  */
164
165 extern int warn_disabled_optimization;
166
167 /* Nonzero if generating code to do profiling.  */
168
169 extern int profile_flag;
170
171 /* Nonzero if generating code to do profiling on the basis of basic blocks.  */
172
173 extern int profile_block_flag;
174
175 /* Nonzero if generating code to profile program flow graph arcs. */
176
177 extern int profile_arc_flag;
178
179 /* Nonzero if generating info for gcov to calculate line test coverage. */
180
181 extern int flag_test_coverage;
182
183 /* Nonzero indicates that branch taken probabilities should be calculated. */
184
185 extern int flag_branch_probabilities;
186
187 /* Nonzero for -pedantic switch: warn about anything
188    that standard C forbids.  */
189
190 extern int pedantic;
191
192 /* Temporarily suppress certain warnings.
193    This is set while reading code from a system header file.  */
194
195 extern int in_system_header;
196
197 /* Nonzero for -dp: annotate the assembly with a comment describing the
198    pattern and alternative used.  */
199
200 extern int flag_print_asm_name;
201 \f
202 /* Now the symbols that are set with `-f' switches.  */
203
204 /* Nonzero means `char' should be signed.  */
205
206 extern int flag_signed_char;
207
208 /* Nonzero means give an enum type only as many bytes as it needs.  */
209
210 extern int flag_short_enums;
211
212 /* Nonzero for -fcaller-saves: allocate values in regs that need to
213    be saved across function calls, if that produces overall better code.
214    Optional now, so people can test it.  */
215
216 extern int flag_caller_saves;
217
218 /* Nonzero for -fpcc-struct-return: return values the same way PCC does.  */
219
220 extern int flag_pcc_struct_return;
221
222 /* Nonzero for -fforce-mem: load memory value into a register
223    before arithmetic on it.  This makes better cse but slower compilation.  */
224
225 extern int flag_force_mem;
226
227 /* Nonzero for -fforce-addr: load memory address into a register before
228    reference to memory.  This makes better cse but slower compilation.  */
229
230 extern int flag_force_addr;
231
232 /* Nonzero for -fdefer-pop: don't pop args after each function call;
233    instead save them up to pop many calls' args with one insns.  */
234
235 extern int flag_defer_pop;
236
237 /* Nonzero for -ffloat-store: don't allocate floats and doubles
238    in extended-precision registers.  */
239
240 extern int flag_float_store;
241
242 /* Nonzero enables strength-reduction in loop.c.  */
243
244 extern int flag_strength_reduce;
245
246 /* Nonzero enables loop unrolling in unroll.c.  Only loops for which the
247    number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
248    UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
249    unrolled.  */
250
251 extern int flag_unroll_loops;
252
253 /* Nonzero enables loop unrolling in unroll.c.  All loops are unrolled.
254    This is generally not a win.  */
255
256 extern int flag_unroll_all_loops;
257
258 /* Nonzero forces all invariant computations in loops to be moved
259    outside the loop. */
260
261 extern int flag_move_all_movables;
262
263 /* Nonzero forces all general induction variables in loops to be
264    strength reduced. */
265
266 extern int flag_reduce_all_givs;
267
268 /* Nonzero for -fcse-follow-jumps:
269    have cse follow jumps to do a more extensive job.  */
270
271 extern int flag_cse_follow_jumps;
272
273 /* Nonzero for -fcse-skip-blocks:
274    have cse follow a branch around a block.  */
275
276 extern int flag_cse_skip_blocks;
277
278 /* Nonzero for -fexpensive-optimizations:
279    perform miscellaneous relatively-expensive optimizations.  */
280 extern int flag_expensive_optimizations;
281
282 /* Nonzero for -fwritable-strings:
283    store string constants in data segment and don't uniquize them.  */
284
285 extern int flag_writable_strings;
286
287 /* Nonzero means don't put addresses of constant functions in registers.
288    Used for compiling the Unix kernel, where strange substitutions are
289    done on the assembly output.  */
290
291 extern int flag_no_function_cse;
292
293 /* Nonzero for -fomit-frame-pointer:
294    don't make a frame pointer in simple functions that don't require one.  */
295
296 extern int flag_omit_frame_pointer;
297
298 /* Nonzero to inhibit use of define_optimization peephole opts.  */
299
300 extern int flag_no_peephole;
301
302 /* Nonzero means all references through pointers are volatile.  */
303
304 extern int flag_volatile;
305
306 /* Nonzero means treat all global and extern variables as volatile.  */
307
308 extern int flag_volatile_global;
309
310 /* Nonzero means treat all static variables as volatile.  */
311
312 extern int flag_volatile_static;
313
314 /* Nonzero allows GCC to violate some IEEE or ANSI rules regarding math
315    operations in the interest of optimization.  For example it allows
316    GCC to assume arguments to sqrt are nonnegative numbers, allowing
317    faster code for sqrt to be generated. */
318
319 extern int flag_fast_math;
320
321 /* Nonzero allows GCC to optimize sibling and tail recursive calls.  */
322
323 extern int flag_optimize_sibling_calls;
324
325 /* Nonzero means the front end generally wants `errno' maintained by math
326    operations, like built-in SQRT, unless overridden by flag_fast_math.  */
327
328 extern int flag_errno_math;
329
330 /* 0 means straightforward implementation of complex divide acceptable.
331    1 means wide ranges of inputs must work for complex divide.
332    2 means C9X-like requirements for complex divide (not yet implemented).  */
333
334 extern int flag_complex_divide_method;
335
336 /* Nonzero means to run loop optimizations twice.  */
337
338 extern int flag_rerun_loop_opt;
339
340 /* Nonzero means make functions that look like good inline candidates
341    go inline.  */
342
343 extern int flag_inline_functions;
344
345 /* Nonzero for -fkeep-inline-functions: even if we make a function
346    go inline everywhere, keep its definition around for debugging
347    purposes.  */
348
349 extern int flag_keep_inline_functions;
350
351 /* Nonzero means that functions declared `inline' will be treated
352    as `static'.  Prevents generation of zillions of copies of unused
353    static inline functions; instead, `inlines' are written out
354    only when actually used.  Used in conjunction with -g.  Also
355    does the right thing with #pragma interface.  */
356
357 extern int flag_no_inline;
358
359 /* Nonzero if we are only using compiler to check syntax errors.  */
360
361 extern int flag_syntax_only;
362
363 /* Nonzero means we should save auxiliary info into a .X file.  */
364
365 extern int flag_gen_aux_info;
366
367 /* Nonzero means make the text shared if supported.  */
368
369 extern int flag_shared_data;
370
371 /* flag_schedule_insns means schedule insns within basic blocks (before
372    local_alloc).
373    flag_schedule_insns_after_reload means schedule insns after
374    global_alloc.  */
375
376 extern int flag_schedule_insns;
377 extern int flag_schedule_insns_after_reload;
378
379 /* The following flags have effect only for scheduling before register
380    allocation:
381
382    flag_schedule_interblock means schedule insns accross basic blocks.
383    flag_schedule_speculative means allow speculative motion of non-load insns.
384    flag_schedule_speculative_load means allow speculative motion of some
385    load insns.
386    flag_schedule_speculative_load_dangerous allows speculative motion of more
387    load insns.  */
388
389 extern int flag_schedule_interblock;
390 extern int flag_schedule_speculative;
391 extern int flag_schedule_speculative_load;
392 extern int flag_schedule_speculative_load_dangerous;
393
394 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
395    by a cheaper branch, on a count register. */
396 extern int flag_branch_on_count_reg;
397
398 /* This option is set to 1 on -fsingle-precision-constant option which is
399    used to convert the floating point constants to single precision 
400    constants. */
401
402 extern int flag_single_precision_constant;
403
404 /* Nonzero means put things in delayed-branch slots if supported. */
405
406 extern int flag_delayed_branch;
407
408 /* Nonzero means suppress output of instruction numbers and line number
409    notes in debugging dumps.  */
410
411 extern int flag_dump_unnumbered;
412
413 /* Nonzero means pretend it is OK to examine bits of target floats,
414    even if that isn't true.  The resulting code will have incorrect constants,
415    but the same series of instructions that the native compiler would make.  */
416
417 extern int flag_pretend_float;
418
419 /* Nonzero means change certain warnings into errors.
420    Usually these are warnings about failure to conform to some standard.  */
421
422 extern int flag_pedantic_errors;
423
424 /* Nonzero means generate position-independent code.
425    This is not fully implemented yet.  */
426
427 extern int flag_pic;
428
429 /* Nonzero means generate extra code for exception handling and enable
430    exception handling.  */
431
432 extern int flag_exceptions;
433
434 /* Nonzero means use the new model for exception handling. Replaces 
435    -DNEW_EH_MODEL as a compile option. */
436
437 extern int flag_new_exceptions;
438
439 /* Nonzero means generate frame unwind info table when supported */
440
441 extern int flag_unwind_tables;
442
443 /* Nonzero means don't place uninitialized global data in common storage
444    by default.  */
445
446 extern int flag_no_common;
447
448 /* -finhibit-size-directive inhibits output of .size for ELF.
449    This is used only for compiling crtstuff.c,
450    and it may be extended to other effects
451    needed for crtstuff.c on other systems.  */
452 extern int flag_inhibit_size_directive;
453
454 /* Nonzero means place each function into its own section on those platforms
455    which support arbitrary section names and unlimited numbers of sections.  */
456
457 extern int flag_function_sections;
458
459 /* ... and similar for data.  */
460  
461 extern int flag_data_sections;
462
463 /* -fverbose-asm causes extra commentary information to be produced in
464    the generated assembly code (to make it more readable).  This option
465    is generally only of use to those who actually need to read the
466    generated assembly code (perhaps while debugging the compiler itself).
467    -fno-verbose-asm, the default, causes the extra information
468    to not be added and is useful when comparing two assembler files.  */
469
470 extern int flag_verbose_asm;
471
472 /* -dA causes debug information to be produced in
473    the generated assembly code (to make it more readable).  This option
474    is generally only of use to those who actually need to read the
475    generated assembly code (perhaps while debugging the compiler itself).
476    Currently, this switch is only used by dwarfout.c; however, it is intended
477    to be a catchall for printing debug information in the assembler file.  */
478
479 extern int flag_debug_asm;
480
481 extern int flag_dump_rtl_in_asm;
482
483 /* -fgnu-linker specifies use of the GNU linker for initializations.
484    -fno-gnu-linker says that collect will be used.  */
485 extern int flag_gnu_linker;
486
487 /* Tag all structures with __attribute__(packed) */
488 extern int flag_pack_struct;
489
490 /* This flag is only tested if alias checking is enabled.
491    0 if pointer arguments may alias each other.  True in C.
492    1 if pointer arguments may not alias each other but may alias
493    global variables.
494    2 if pointer arguments may not alias each other and may not
495    alias global variables.  True in Fortran.
496    The value is ignored if flag_alias_check is 0.  */
497 extern int flag_argument_noalias;
498
499 /* Nonzero if we should do (language-dependent) alias analysis.
500    Typically, this analysis will assume that expressions of certain
501    types do not alias expressions of certain other types.  Only used
502    if alias analysis (in general) is enabled.  */
503 extern int flag_strict_aliasing;
504
505 /* Emit code to probe the stack, to help detect stack overflow; also
506    may cause large objects to be allocated dynamically.  */
507 extern int flag_stack_check;
508
509 /* Do the full regmove optimization pass.  */
510 extern int flag_regmove;
511
512 /* Instrument functions with calls at entry and exit, for profiling.  */
513 extern int flag_instrument_function_entry_exit;
514
515 /* Perform a peephole pass before sched2. */
516 extern int flag_peephole2;
517
518 /* -fbounded-pointers causes gcc to compile pointers as composite
519    objects occupying three words: the pointer value, the base address
520    of the referent object, and the address immediately beyond the end
521    of the referent object.  The base and extent allow us to perform
522    runtime bounds checking.  -fbounded-pointers implies -fcheck-bounds.  */
523 extern int flag_bounded_pointers;
524
525 /* -fcheck-bounds causes gcc to generate array bounds checks.
526    For C, C++: defaults to value of flag_bounded_pointers.
527    For ObjC: defaults to off.
528    For Java: defaults to on.
529    For Fortran: defaults to off.
530    For CHILL: defaults to off.  */
531 extern int flag_bounds_check;
532
533 /* If one, renumber instruction UIDs to reduce the number of
534    unused UIDs if there are a lot of instructions.  If greater than
535    one, unconditionally renumber instruction UIDs.  */
536 extern int flag_renumber_insns;
537 \f
538 /* Other basic status info about current function.  */
539
540 /* Nonzero means current function must be given a frame pointer.
541    Set in stmt.c if anything is allocated on the stack there.
542    Set in reload1.c if anything is allocated on the stack there.  */
543
544 extern int frame_pointer_needed;
545
546 /* Set nonzero if jump_optimize finds that control falls through
547    at the end of the function.  */
548
549 extern int can_reach_end;
550
551 /* Nonzero if GCC must add code to check memory access (used by Checker).  */
552
553 extern int flag_check_memory_usage;
554
555 /* Nonzero if GCC must prefix function names (used with
556    flag_check_memory_usage).  */
557
558 extern int flag_prefix_function_name;
559
560 /* Value of the -G xx switch, and whether it was passed or not.  */
561 extern int g_switch_value;
562 extern int g_switch_set;
563
564 /* Value of the -finline-limit flag.  */
565
566 extern int inline_max_insns;
567
568 /* Values of the -falign-* flags: how much to align labels in code. 
569    0 means `use default', 1 means `don't align'.  
570    For each variable, there is an _log variant which is the power
571    of two not less than the variable, for .align output.  */
572
573 extern int align_loops;
574 extern int align_loops_log;
575 extern int align_jumps;
576 extern int align_jumps_log;
577 extern int align_labels;
578 extern int align_labels_log;
579 extern int align_functions;
580 extern int align_functions_log;
581
582 /* Nonzero if we dump in VCG format, not plain text.  */
583 extern int dump_for_graph;
584
585 /* Selection of the graph form.  */
586 enum graph_dump_types
587 {
588   no_graph = 0,
589   vcg
590 };
591 extern enum graph_dump_types graph_dump_format;
592
593 /* Nonzero means ignore `#ident' directives.  0 means handle them.
594    On SVR4 targets, it also controls whether or not to emit a
595    string identifying the compiler.  */
596
597 extern int flag_no_ident;
598
599 /* Nonzero means we should do dwarf2 duplicate elimination.  */
600
601 extern int flag_eliminate_dwarf2_dups;
602
603 /* Non-zero means to collect statistics which might be expensive
604    and to print them when we are done.  */
605 extern int flag_detailed_statistics;
606
607 #endif /* GCC_FLAGS_H */