2002-04-02 David S. Miller <davem@redhat.com>
[official-gcc.git] / gcc / toplev.c
blob24009593366b30c164b5e1002ca9d37c641ac55b
1 /* Top level of GNU C compiler
2 Copyright (C) 1987, 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
3 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
5 This file is part of GCC.
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.
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.
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. */
22 /* This is the top level of cc1/c++.
23 It parses command args, opens files, invokes the various passes
24 in the proper order, and counts the time used by each.
25 Error messages and low-level interface to malloc also handled here. */
27 #include "config.h"
28 #undef FLOAT /* This is for hpux. They should change hpux. */
29 #undef FFS /* Some systems define this in param.h. */
30 #include "system.h"
31 #include <signal.h>
33 #ifdef HAVE_SYS_RESOURCE_H
34 # include <sys/resource.h>
35 #endif
37 #ifdef HAVE_SYS_TIMES_H
38 # include <sys/times.h>
39 #endif
41 #include "input.h"
42 #include "tree.h"
43 #include "rtl.h"
44 #include "tm_p.h"
45 #include "flags.h"
46 #include "insn-attr.h"
47 #include "insn-config.h"
48 #include "insn-flags.h"
49 #include "hard-reg-set.h"
50 #include "recog.h"
51 #include "output.h"
52 #include "except.h"
53 #include "function.h"
54 #include "toplev.h"
55 #include "expr.h"
56 #include "basic-block.h"
57 #include "intl.h"
58 #include "ggc.h"
59 #include "graph.h"
60 #include "loop.h"
61 #include "regs.h"
62 #include "timevar.h"
63 #include "diagnostic.h"
64 #include "ssa.h"
65 #include "params.h"
66 #include "reload.h"
67 #include "dwarf2asm.h"
68 #include "integrate.h"
69 #include "debug.h"
70 #include "target.h"
71 #include "langhooks.h"
73 #if defined (DWARF2_UNWIND_INFO) || defined (DWARF2_DEBUGGING_INFO)
74 #include "dwarf2out.h"
75 #endif
77 #if defined(DBX_DEBUGGING_INFO) || defined(XCOFF_DEBUGGING_INFO)
78 #include "dbxout.h"
79 #endif
81 #ifdef SDB_DEBUGGING_INFO
82 #include "sdbout.h"
83 #endif
85 #ifdef XCOFF_DEBUGGING_INFO
86 #include "xcoffout.h" /* Needed for external data
87 declarations for e.g. AIX 4.x. */
88 #endif
90 #ifdef HALF_PIC_DEBUG
91 #include "halfpic.h"
92 #endif
94 /* Carry information from ASM_DECLARE_OBJECT_NAME
95 to ASM_FINISH_DECLARE_OBJECT. */
97 extern int size_directive_output;
98 extern tree last_assemble_variable_decl;
100 static void general_init PARAMS ((char *));
101 static void parse_options_and_default_flags PARAMS ((int, char **));
102 static void do_compile PARAMS ((void));
103 static void process_options PARAMS ((void));
104 static void lang_independent_init PARAMS ((void));
105 static int lang_dependent_init PARAMS ((const char *));
106 static void init_asm_output PARAMS ((const char *));
107 static void finalize PARAMS ((void));
109 static void set_target_switch PARAMS ((const char *));
111 static void crash_signal PARAMS ((int)) ATTRIBUTE_NORETURN;
112 static void compile_file PARAMS ((void));
113 static void display_help PARAMS ((void));
114 static void display_target_options PARAMS ((void));
116 static void decode_d_option PARAMS ((const char *));
117 static int decode_f_option PARAMS ((const char *));
118 static int decode_W_option PARAMS ((const char *));
119 static int decode_g_option PARAMS ((const char *));
120 static unsigned int independent_decode_option PARAMS ((int, char **));
122 static void print_version PARAMS ((FILE *, const char *));
123 static int print_single_switch PARAMS ((FILE *, int, int, const char *,
124 const char *, const char *,
125 const char *, const char *));
126 static void print_switch_values PARAMS ((FILE *, int, int, const char *,
127 const char *, const char *));
129 /* Length of line when printing switch values. */
130 #define MAX_LINE 75
132 /* Name of program invoked, sans directories. */
134 const char *progname;
136 /* Copy of arguments to toplev_main. */
137 int save_argc;
138 char **save_argv;
140 /* Name of current original source file (what was input to cpp).
141 This comes from each #-command in the actual input. */
143 const char *input_filename;
145 /* Name of top-level original source file (what was input to cpp).
146 This comes from the #-command at the beginning of the actual input.
147 If there isn't any there, then this is the cc1 input file name. */
149 const char *main_input_filename;
151 /* Current line number in real source file. */
153 int lineno;
155 /* Nonzero if it is unsafe to create any new pseudo registers. */
156 int no_new_pseudos;
158 /* Stack of currently pending input files. */
160 struct file_stack *input_file_stack;
162 /* Incremented on each change to input_file_stack. */
163 int input_file_stack_tick;
165 /* Name to use as base of names for dump output files. */
167 const char *dump_base_name;
169 /* Format to use to print dumpfile index value */
170 #ifndef DUMPFILE_FORMAT
171 #define DUMPFILE_FORMAT ".%02d."
172 #endif
174 /* Bit flags that specify the machine subtype we are compiling for.
175 Bits are tested using macros TARGET_... defined in the tm.h file
176 and set by `-m...' switches. Must be defined in rtlanal.c. */
178 extern int target_flags;
180 /* Debug hooks - dependent upon command line options. */
182 const struct gcc_debug_hooks *debug_hooks = &do_nothing_debug_hooks;
184 /* Describes a dump file. */
186 struct dump_file_info
188 /* The unique extension to apply, e.g. ".jump". */
189 const char *const extension;
191 /* The -d<c> character that enables this dump file. */
192 char const debug_switch;
194 /* True if there is a corresponding graph dump file. */
195 char const graph_dump_p;
197 /* True if the user selected this dump. */
198 char enabled;
200 /* True if the files have been initialized (ie truncated). */
201 char initialized;
204 /* Enumerate the extant dump files. */
206 enum dump_file_index
208 DFI_rtl,
209 DFI_sibling,
210 DFI_eh,
211 DFI_jump,
212 DFI_ssa,
213 DFI_ssa_ccp,
214 DFI_ssa_dce,
215 DFI_ussa,
216 DFI_null,
217 DFI_cse,
218 DFI_addressof,
219 DFI_gcse,
220 DFI_loop,
221 DFI_cfg,
222 DFI_bp,
223 DFI_cse2,
224 DFI_life,
225 DFI_combine,
226 DFI_ce,
227 DFI_regmove,
228 DFI_sched,
229 DFI_lreg,
230 DFI_greg,
231 DFI_postreload,
232 DFI_flow2,
233 DFI_peephole2,
234 DFI_rnreg,
235 DFI_ce2,
236 DFI_sched2,
237 DFI_stack,
238 DFI_bbro,
239 DFI_mach,
240 DFI_dbr,
241 DFI_MAX
244 /* Describes all the dump files. Should be kept in order of the
245 pass and in sync with dump_file_index above.
247 Remaining -d letters:
249 " o q "
250 " H JK OPQ TUV YZ"
253 static struct dump_file_info dump_file[DFI_MAX] =
255 { "rtl", 'r', 0, 0, 0 },
256 { "sibling", 'i', 0, 0, 0 },
257 { "eh", 'h', 0, 0, 0 },
258 { "jump", 'j', 0, 0, 0 },
259 { "ssa", 'e', 1, 0, 0 },
260 { "ssaccp", 'W', 1, 0, 0 },
261 { "ssadce", 'X', 1, 0, 0 },
262 { "ussa", 'e', 1, 0, 0 }, /* Yes, duplicate enable switch. */
263 { "null", 'u', 0, 0, 0 },
264 { "cse", 's', 0, 0, 0 },
265 { "addressof", 'F', 0, 0, 0 },
266 { "gcse", 'G', 1, 0, 0 },
267 { "loop", 'L', 1, 0, 0 },
268 { "cfg", 'f', 1, 0, 0 },
269 { "bp", 'b', 1, 0, 0 },
270 { "cse2", 't', 1, 0, 0 },
271 { "life", 'f', 1, 0, 0 }, /* Yes, duplicate enable switch. */
272 { "combine", 'c', 1, 0, 0 },
273 { "ce", 'C', 1, 0, 0 },
274 { "regmove", 'N', 1, 0, 0 },
275 { "sched", 'S', 1, 0, 0 },
276 { "lreg", 'l', 1, 0, 0 },
277 { "greg", 'g', 1, 0, 0 },
278 { "postreload", 'o', 1, 0, 0 },
279 { "flow2", 'w', 1, 0, 0 },
280 { "peephole2", 'z', 1, 0, 0 },
281 { "rnreg", 'n', 1, 0, 0 },
282 { "ce2", 'E', 1, 0, 0 },
283 { "sched2", 'R', 1, 0, 0 },
284 { "stack", 'k', 1, 0, 0 },
285 { "bbro", 'B', 1, 0, 0 },
286 { "mach", 'M', 1, 0, 0 },
287 { "dbr", 'd', 0, 0, 0 },
290 static int open_dump_file PARAMS ((enum dump_file_index, tree));
291 static void close_dump_file PARAMS ((enum dump_file_index,
292 void (*) (FILE *, rtx), rtx));
294 /* Other flags saying which kinds of debugging dump have been requested. */
296 int rtl_dump_and_exit;
297 int flag_print_asm_name;
298 static int version_flag;
299 static char *filename;
300 enum graph_dump_types graph_dump_format;
302 /* Name for output file of assembly code, specified with -o. */
304 char *asm_file_name;
306 /* Value of the -G xx switch, and whether it was passed or not. */
307 int g_switch_value;
308 int g_switch_set;
310 /* Type(s) of debugging information we are producing (if any).
311 See flags.h for the definitions of the different possible
312 types of debugging information. */
313 enum debug_info_type write_symbols = NO_DEBUG;
315 /* Level of debugging information we are producing. See flags.h
316 for the definitions of the different possible levels. */
317 enum debug_info_level debug_info_level = DINFO_LEVEL_NONE;
319 /* Nonzero means use GNU-only extensions in the generated symbolic
320 debugging information. */
321 /* Currently, this only has an effect when write_symbols is set to
322 DBX_DEBUG, XCOFF_DEBUG, or DWARF_DEBUG. */
323 int use_gnu_debug_info_extensions = 0;
325 /* Nonzero means do optimizations. -O.
326 Particular numeric values stand for particular amounts of optimization;
327 thus, -O2 stores 2 here. However, the optimizations beyond the basic
328 ones are not controlled directly by this variable. Instead, they are
329 controlled by individual `flag_...' variables that are defaulted
330 based on this variable. */
332 int optimize = 0;
334 /* Nonzero means optimize for size. -Os.
335 The only valid values are zero and non-zero. When optimize_size is
336 non-zero, optimize defaults to 2, but certain individual code
337 bloating optimizations are disabled. */
339 int optimize_size = 0;
341 /* Nonzero if we should exit after parsing options. */
342 static int exit_after_options = 0;
344 /* The FUNCTION_DECL for the function currently being compiled,
345 or 0 if between functions. */
346 tree current_function_decl;
348 /* Set to the FUNC_BEGIN label of the current function, or NULL_TREE
349 if none. */
350 tree current_function_func_begin_label;
352 /* Nonzero if doing dwarf2 duplicate elimination. */
354 int flag_eliminate_dwarf2_dups = 0;
356 /* Nonzero if generating code to do profiling. */
358 int profile_flag = 0;
360 /* Nonzero if generating code to profile program flow graph arcs. */
362 int profile_arc_flag = 0;
364 /* Nonzero if generating info for gcov to calculate line test coverage. */
366 int flag_test_coverage = 0;
368 /* Nonzero indicates that branch taken probabilities should be calculated. */
370 int flag_branch_probabilities = 0;
372 /* Nonzero if basic blocks should be reordered. */
374 int flag_reorder_blocks = 0;
376 /* Nonzero if registers should be renamed. */
378 int flag_rename_registers = 0;
379 int flag_cprop_registers = 0;
381 /* Nonzero for -pedantic switch: warn about anything
382 that standard spec forbids. */
384 int pedantic = 0;
386 /* Temporarily suppress certain warnings.
387 This is set while reading code from a system header file. */
389 int in_system_header = 0;
391 /* Don't print functions as they are compiled. -quiet. */
393 int quiet_flag = 0;
395 /* Print times taken by the various passes. -ftime-report. */
397 int time_report = 0;
399 /* Print memory still in use at end of compilation (which may have little
400 to do with peak memory consumption). -fmem-report. */
402 int mem_report = 0;
404 /* Non-zero means to collect statistics which might be expensive
405 and to print them when we are done. */
406 int flag_detailed_statistics = 0;
409 /* -f flags. */
411 /* Nonzero means `char' should be signed. */
413 int flag_signed_char;
415 /* Nonzero means give an enum type only as many bytes as it needs. */
417 int flag_short_enums;
419 /* Nonzero for -fcaller-saves: allocate values in regs that need to
420 be saved across function calls, if that produces overall better code.
421 Optional now, so people can test it. */
423 #ifdef DEFAULT_CALLER_SAVES
424 int flag_caller_saves = 1;
425 #else
426 int flag_caller_saves = 0;
427 #endif
429 /* Nonzero if structures and unions should be returned in memory.
431 This should only be defined if compatibility with another compiler or
432 with an ABI is needed, because it results in slower code. */
434 #ifndef DEFAULT_PCC_STRUCT_RETURN
435 #define DEFAULT_PCC_STRUCT_RETURN 1
436 #endif
438 /* Nonzero for -fpcc-struct-return: return values the same way PCC does. */
440 int flag_pcc_struct_return = DEFAULT_PCC_STRUCT_RETURN;
442 /* Nonzero for -fforce-mem: load memory value into a register
443 before arithmetic on it. This makes better cse but slower compilation. */
445 int flag_force_mem = 0;
447 /* Nonzero for -fforce-addr: load memory address into a register before
448 reference to memory. This makes better cse but slower compilation. */
450 int flag_force_addr = 0;
452 /* Nonzero for -fdefer-pop: don't pop args after each function call;
453 instead save them up to pop many calls' args with one insns. */
455 int flag_defer_pop = 0;
457 /* Nonzero for -ffloat-store: don't allocate floats and doubles
458 in extended-precision registers. */
460 int flag_float_store = 0;
462 /* Nonzero for -fcse-follow-jumps:
463 have cse follow jumps to do a more extensive job. */
465 int flag_cse_follow_jumps;
467 /* Nonzero for -fcse-skip-blocks:
468 have cse follow a branch around a block. */
469 int flag_cse_skip_blocks;
471 /* Nonzero for -fexpensive-optimizations:
472 perform miscellaneous relatively-expensive optimizations. */
473 int flag_expensive_optimizations;
475 /* Nonzero for -fthread-jumps:
476 have jump optimize output of loop. */
478 int flag_thread_jumps;
480 /* Nonzero enables strength-reduction in loop.c. */
482 int flag_strength_reduce = 0;
484 /* Nonzero enables loop unrolling in unroll.c. Only loops for which the
485 number of iterations can be calculated at compile-time (UNROLL_COMPLETELY,
486 UNROLL_MODULO) or at run-time (preconditioned to be UNROLL_MODULO) are
487 unrolled. */
489 int flag_unroll_loops;
491 /* Nonzero enables loop unrolling in unroll.c. All loops are unrolled.
492 This is generally not a win. */
494 int flag_unroll_all_loops;
496 /* Nonzero enables prefetch optimizations for arrays in loops. */
498 int flag_prefetch_loop_arrays;
500 /* Nonzero forces all invariant computations in loops to be moved
501 outside the loop. */
503 int flag_move_all_movables = 0;
505 /* Nonzero forces all general induction variables in loops to be
506 strength reduced. */
508 int flag_reduce_all_givs = 0;
510 /* Nonzero to perform full register move optimization passes. This is the
511 default for -O2. */
513 int flag_regmove = 0;
515 /* Nonzero for -fwritable-strings:
516 store string constants in data segment and don't uniquize them. */
518 int flag_writable_strings = 0;
520 /* Nonzero means don't put addresses of constant functions in registers.
521 Used for compiling the Unix kernel, where strange substitutions are
522 done on the assembly output. */
524 int flag_no_function_cse = 0;
526 /* Nonzero for -fomit-frame-pointer:
527 don't make a frame pointer in simple functions that don't require one. */
529 int flag_omit_frame_pointer = 0;
531 /* Nonzero means place each function into its own section on those platforms
532 which support arbitrary section names and unlimited numbers of sections. */
534 int flag_function_sections = 0;
536 /* ... and similar for data. */
538 int flag_data_sections = 0;
540 /* Nonzero to inhibit use of define_optimization peephole opts. */
542 int flag_no_peephole = 0;
544 /* Nonzero allows GCC to optimize sibling and tail recursive calls. */
546 int flag_optimize_sibling_calls = 0;
548 /* Nonzero means the front end generally wants `errno' maintained by math
549 operations, like built-in SQRT. */
551 int flag_errno_math = 1;
553 /* Nonzero means that unsafe floating-point math optimizations are allowed
554 for the sake of speed. IEEE compliance is not guaranteed, and operations
555 are allowed to assume that their arguments and results are "normal"
556 (e.g., nonnegative for SQRT). */
558 int flag_unsafe_math_optimizations = 0;
560 /* Zero means that floating-point math operations cannot generate a
561 (user-visible) trap. This is the case, for example, in nonstop
562 IEEE 754 arithmetic. */
564 int flag_trapping_math = 1;
566 /* 0 means straightforward implementation of complex divide acceptable.
567 1 means wide ranges of inputs must work for complex divide.
568 2 means C99-like requirements for complex divide (not yet implemented). */
570 int flag_complex_divide_method = 0;
572 /* Nonzero means all references through pointers are volatile. */
574 int flag_volatile;
576 /* Nonzero means treat all global and extern variables as volatile. */
578 int flag_volatile_global;
580 /* Nonzero means treat all static variables as volatile. */
582 int flag_volatile_static;
584 /* Nonzero means just do syntax checking; don't output anything. */
586 int flag_syntax_only = 0;
588 /* Nonzero means perform global cse. */
590 static int flag_gcse;
592 /* Nonzero means perform loop optimizer. */
594 static int flag_loop_optimize;
596 /* Nonzero means perform crossjumping. */
598 static int flag_crossjumping;
600 /* Nonzero means to use global dataflow analysis to eliminate
601 useless null pointer tests. */
603 static int flag_delete_null_pointer_checks;
605 /* Nonzero means to do the enhanced load motion during gcse, which trys
606 to hoist loads by not killing them when a store to the same location
607 is seen. */
609 int flag_gcse_lm = 1;
611 /* Nonzero means to perform store motion after gcse, which will try to
612 move stores closer to the exit block. Its not very effective without
613 flag_gcse_lm. */
615 int flag_gcse_sm = 1;
617 /* Nonzero means to rerun cse after loop optimization. This increases
618 compilation time about 20% and picks up a few more common expressions. */
620 static int flag_rerun_cse_after_loop;
622 /* Nonzero means to run loop optimizations twice. */
624 int flag_rerun_loop_opt;
626 /* Nonzero for -finline-functions: ok to inline functions that look like
627 good inline candidates. */
629 int flag_inline_functions;
631 /* Nonzero for -fkeep-inline-functions: even if we make a function
632 go inline everywhere, keep its definition around for debugging
633 purposes. */
635 int flag_keep_inline_functions;
637 /* Nonzero means that functions will not be inlined. */
639 int flag_no_inline;
641 /* Nonzero means that we don't want inlining by virtue of -fno-inline,
642 not just because the tree inliner turned us off. */
644 int flag_really_no_inline;
646 /* Nonzero means that we should emit static const variables
647 regardless of whether or not optimization is turned on. */
649 int flag_keep_static_consts = 1;
651 /* Nonzero means we should be saving declaration info into a .X file. */
653 int flag_gen_aux_info = 0;
655 /* Specified name of aux-info file. */
657 static char *aux_info_file_name;
659 /* Nonzero means make the text shared if supported. */
661 int flag_shared_data;
663 /* Nonzero means schedule into delayed branch slots if supported. */
665 int flag_delayed_branch;
667 /* Nonzero if we are compiling pure (sharable) code.
668 Value is 1 if we are doing reasonable (i.e. simple
669 offset into offset table) pic. Value is 2 if we can
670 only perform register offsets. */
672 int flag_pic;
674 /* Nonzero means generate extra code for exception handling and enable
675 exception handling. */
677 int flag_exceptions;
679 /* Nonzero means generate frame unwind info table when supported. */
681 int flag_unwind_tables = 0;
683 /* Nonzero means generate frame unwind info table exact at each insn boundary */
685 int flag_asynchronous_unwind_tables = 0;
687 /* Nonzero means don't place uninitialized global data in common storage
688 by default. */
690 int flag_no_common;
692 /* Nonzero means change certain warnings into errors.
693 Usually these are warnings about failure to conform to some standard. */
695 int flag_pedantic_errors = 0;
697 /* flag_schedule_insns means schedule insns within basic blocks (before
698 local_alloc).
699 flag_schedule_insns_after_reload means schedule insns after
700 global_alloc. */
702 int flag_schedule_insns = 0;
703 int flag_schedule_insns_after_reload = 0;
705 /* The following flags have effect only for scheduling before register
706 allocation:
708 flag_schedule_interblock means schedule insns accross basic blocks.
709 flag_schedule_speculative means allow speculative motion of non-load insns.
710 flag_schedule_speculative_load means allow speculative motion of some
711 load insns.
712 flag_schedule_speculative_load_dangerous allows speculative motion of more
713 load insns. */
715 int flag_schedule_interblock = 1;
716 int flag_schedule_speculative = 1;
717 int flag_schedule_speculative_load = 0;
718 int flag_schedule_speculative_load_dangerous = 0;
720 int flag_single_precision_constant;
722 /* flag_branch_on_count_reg means try to replace add-1,compare,branch tupple
723 by a cheaper branch on a count register. */
724 int flag_branch_on_count_reg = 1;
726 /* -finhibit-size-directive inhibits output of .size for ELF.
727 This is used only for compiling crtstuff.c,
728 and it may be extended to other effects
729 needed for crtstuff.c on other systems. */
730 int flag_inhibit_size_directive = 0;
732 /* -fverbose-asm causes extra commentary information to be produced in
733 the generated assembly code (to make it more readable). This option
734 is generally only of use to those who actually need to read the
735 generated assembly code (perhaps while debugging the compiler itself).
736 -fno-verbose-asm, the default, causes the extra information
737 to be omitted and is useful when comparing two assembler files. */
739 int flag_verbose_asm = 0;
741 /* -dA causes debug commentary information to be produced in
742 the generated assembly code (to make it more readable). This option
743 is generally only of use to those who actually need to read the
744 generated assembly code (perhaps while debugging the compiler itself).
745 Currently, this switch is only used by dwarfout.c; however, it is intended
746 to be a catchall for printing debug information in the assembler file. */
748 int flag_debug_asm = 0;
750 /* -dP causes the rtl to be emitted as a comment in assembly. */
752 int flag_dump_rtl_in_asm = 0;
754 /* -fgnu-linker specifies use of the GNU linker for initializations.
755 (Or, more generally, a linker that handles initializations.)
756 -fno-gnu-linker says that collect2 will be used. */
757 #ifdef USE_COLLECT2
758 int flag_gnu_linker = 0;
759 #else
760 int flag_gnu_linker = 1;
761 #endif
763 /* Nonzero means put zero initialized data in the bss section. */
764 int flag_zero_initialized_in_bss = 1;
766 /* Enable SSA. */
767 int flag_ssa = 0;
769 /* Enable ssa conditional constant propagation. */
770 int flag_ssa_ccp = 0;
772 /* Enable ssa aggressive dead code elimination. */
773 int flag_ssa_dce = 0;
775 /* Tag all structures with __attribute__(packed). */
776 int flag_pack_struct = 0;
778 /* Emit code to check for stack overflow; also may cause large objects
779 to be allocated dynamically. */
780 int flag_stack_check;
782 /* When non-NULL, indicates that whenever space is allocated on the
783 stack, the resulting stack pointer must not pass this
784 address---that is, for stacks that grow downward, the stack pointer
785 must always be greater than or equal to this address; for stacks
786 that grow upward, the stack pointer must be less than this address.
787 At present, the rtx may be either a REG or a SYMBOL_REF, although
788 the support provided depends on the backend. */
789 rtx stack_limit_rtx;
791 /* 0 if pointer arguments may alias each other. True in C.
792 1 if pointer arguments may not alias each other but may alias
793 global variables.
794 2 if pointer arguments may not alias each other and may not
795 alias global variables. True in Fortran.
796 This defaults to 0 for C. */
797 int flag_argument_noalias = 0;
799 /* Nonzero if we should do (language-dependent) alias analysis.
800 Typically, this analysis will assume that expressions of certain
801 types do not alias expressions of certain other types. Only used
802 if alias analysis (in general) is enabled. */
803 int flag_strict_aliasing = 0;
805 /* Instrument functions with calls at entry and exit, for profiling. */
806 int flag_instrument_function_entry_exit = 0;
808 /* Nonzero means ignore `#ident' directives. 0 means handle them.
809 On SVR4 targets, it also controls whether or not to emit a
810 string identifying the compiler. */
812 int flag_no_ident = 0;
814 /* This will perform a peephole pass before sched2. */
815 int flag_peephole2 = 0;
817 /* This will try to guess branch probabilities. */
818 int flag_guess_branch_prob = 0;
820 /* -fbounded-pointers causes gcc to compile pointers as composite
821 objects occupying three words: the pointer value, the base address
822 of the referent object, and the address immediately beyond the end
823 of the referent object. The base and extent allow us to perform
824 runtime bounds checking. -fbounded-pointers implies -fcheck-bounds. */
825 int flag_bounded_pointers = 0;
827 /* -fcheck-bounds causes gcc to generate array bounds checks.
828 For C, C++: defaults to value of flag_bounded_pointers.
829 For ObjC: defaults to off.
830 For Java: defaults to on.
831 For Fortran: defaults to off.
832 For CHILL: defaults to off. */
833 int flag_bounds_check = 0;
835 /* This will attempt to merge constant section constants, if 1 only
836 string constants and constants from constant pool, if 2 also constant
837 variables. */
838 int flag_merge_constants = 1;
840 /* If one, renumber instruction UIDs to reduce the number of
841 unused UIDs if there are a lot of instructions. If greater than
842 one, unconditionally renumber instruction UIDs. */
843 int flag_renumber_insns = 1;
845 /* Values of the -falign-* flags: how much to align labels in code.
846 0 means `use default', 1 means `don't align'.
847 For each variable, there is an _log variant which is the power
848 of two not less than the variable, for .align output. */
850 int align_loops;
851 int align_loops_log;
852 int align_loops_max_skip;
853 int align_jumps;
854 int align_jumps_log;
855 int align_jumps_max_skip;
856 int align_labels;
857 int align_labels_log;
858 int align_labels_max_skip;
859 int align_functions;
860 int align_functions_log;
862 /* Table of supported debugging formats. */
863 static const struct
865 const char *const arg;
866 /* Since PREFERRED_DEBUGGING_TYPE isn't necessarily a
867 constant expression, we use NO_DEBUG in its place. */
868 const enum debug_info_type debug_type;
869 const int use_extensions_p;
870 const char *const description;
871 } *da,
872 debug_args[] =
874 { "", NO_DEBUG, DEFAULT_GDB_EXTENSIONS,
875 N_("Generate debugging info in default format") },
876 { "gdb", NO_DEBUG, 1, N_("Generate debugging info in default extended format") },
877 #ifdef DBX_DEBUGGING_INFO
878 { "stabs", DBX_DEBUG, 0, N_("Generate STABS format debug info") },
879 { "stabs+", DBX_DEBUG, 1, N_("Generate extended STABS format debug info") },
880 #endif
881 #ifdef DWARF_DEBUGGING_INFO
882 { "dwarf", DWARF_DEBUG, 0, N_("Generate DWARF-1 format debug info") },
883 { "dwarf+", DWARF_DEBUG, 1,
884 N_("Generate extended DWARF-1 format debug info") },
885 #endif
886 #ifdef DWARF2_DEBUGGING_INFO
887 { "dwarf-2", DWARF2_DEBUG, 0, N_("Generate DWARF-2 debug info") },
888 #endif
889 #ifdef XCOFF_DEBUGGING_INFO
890 { "xcoff", XCOFF_DEBUG, 0, N_("Generate XCOFF format debug info") },
891 { "xcoff+", XCOFF_DEBUG, 1, N_("Generate extended XCOFF format debug info") },
892 #endif
893 #ifdef SDB_DEBUGGING_INFO
894 { "coff", SDB_DEBUG, 0, N_("Generate COFF format debug info") },
895 #endif
896 #ifdef VMS_DEBUGGING_INFO
897 { "vms", VMS_DEBUG, 0, N_("Generate VMS format debug info") },
898 #endif
899 { 0, 0, 0, 0 }
902 typedef struct
904 const char *const string;
905 int *const variable;
906 const int on_value;
907 const char *const description;
909 lang_independent_options;
911 int flag_trapv = 0;
913 /* Add or remove a leading underscore from user symbols. */
914 int flag_leading_underscore = -1;
916 /* The user symbol prefix after having resolved same. */
917 const char *user_label_prefix;
919 static const param_info lang_independent_params[] = {
920 #define DEFPARAM(ENUM, OPTION, HELP, DEFAULT) \
921 { OPTION, DEFAULT, HELP },
922 #include "params.def"
923 #undef DEFPARAM
924 { NULL, 0, NULL }
927 /* A default for same. */
928 #ifndef USER_LABEL_PREFIX
929 #define USER_LABEL_PREFIX ""
930 #endif
932 /* Table of language-independent -f options.
933 STRING is the option name. VARIABLE is the address of the variable.
934 ON_VALUE is the value to store in VARIABLE
935 if `-fSTRING' is seen as an option.
936 (If `-fno-STRING' is seen as an option, the opposite value is stored.) */
938 static const lang_independent_options f_options[] =
940 {"eliminate-dwarf2-dups", &flag_eliminate_dwarf2_dups, 1,
941 N_("Perform DWARF2 duplicate elimination") },
942 {"float-store", &flag_float_store, 1,
943 N_("Do not store floats in registers") },
944 {"volatile", &flag_volatile, 1,
945 N_("Consider all mem refs through pointers as volatile") },
946 {"volatile-global", &flag_volatile_global, 1,
947 N_("Consider all mem refs to global data to be volatile") },
948 {"volatile-static", &flag_volatile_static, 1,
949 N_("Consider all mem refs to static data to be volatile") },
950 {"defer-pop", &flag_defer_pop, 1,
951 N_("Defer popping functions args from stack until later") },
952 {"omit-frame-pointer", &flag_omit_frame_pointer, 1,
953 N_("When possible do not generate stack frames") },
954 {"optimize-sibling-calls", &flag_optimize_sibling_calls, 1,
955 N_("Optimize sibling and tail recursive calls") },
956 {"cse-follow-jumps", &flag_cse_follow_jumps, 1,
957 N_("When running CSE, follow jumps to their targets") },
958 {"cse-skip-blocks", &flag_cse_skip_blocks, 1,
959 N_("When running CSE, follow conditional jumps") },
960 {"expensive-optimizations", &flag_expensive_optimizations, 1,
961 N_("Perform a number of minor, expensive optimizations") },
962 {"thread-jumps", &flag_thread_jumps, 1,
963 N_("Perform jump threading optimizations") },
964 {"strength-reduce", &flag_strength_reduce, 1,
965 N_("Perform strength reduction optimizations") },
966 {"unroll-loops", &flag_unroll_loops, 1,
967 N_("Perform loop unrolling when iteration count is known") },
968 {"unroll-all-loops", &flag_unroll_all_loops, 1,
969 N_("Perform loop unrolling for all loops") },
970 {"prefetch-loop-arrays", &flag_prefetch_loop_arrays, 1,
971 N_("Generate prefetch instructions, if available, for arrays in loops") },
972 {"move-all-movables", &flag_move_all_movables, 1,
973 N_("Force all loop invariant computations out of loops") },
974 {"reduce-all-givs", &flag_reduce_all_givs, 1,
975 N_("Strength reduce all loop general induction variables") },
976 {"writable-strings", &flag_writable_strings, 1,
977 N_("Store strings in writable data section") },
978 {"peephole", &flag_no_peephole, 0,
979 N_("Enable machine specific peephole optimizations") },
980 {"force-mem", &flag_force_mem, 1,
981 N_("Copy memory operands into registers before using") },
982 {"force-addr", &flag_force_addr, 1,
983 N_("Copy memory address constants into regs before using") },
984 {"function-cse", &flag_no_function_cse, 0,
985 N_("Allow function addresses to be held in registers") },
986 {"inline-functions", &flag_inline_functions, 1,
987 N_("Integrate simple functions into their callers") },
988 {"keep-inline-functions", &flag_keep_inline_functions, 1,
989 N_("Generate code for funcs even if they are fully inlined") },
990 {"inline", &flag_no_inline, 0,
991 N_("Pay attention to the 'inline' keyword") },
992 {"keep-static-consts", &flag_keep_static_consts, 1,
993 N_("Emit static const variables even if they are not used") },
994 {"syntax-only", &flag_syntax_only, 1,
995 N_("Check for syntax errors, then stop") },
996 {"shared-data", &flag_shared_data, 1,
997 N_("Mark data as shared rather than private") },
998 {"caller-saves", &flag_caller_saves, 1,
999 N_("Enable saving registers around function calls") },
1000 {"pcc-struct-return", &flag_pcc_struct_return, 1,
1001 N_("Return 'short' aggregates in memory, not registers") },
1002 {"reg-struct-return", &flag_pcc_struct_return, 0,
1003 N_("Return 'short' aggregates in registers") },
1004 {"delayed-branch", &flag_delayed_branch, 1,
1005 N_("Attempt to fill delay slots of branch instructions") },
1006 {"gcse", &flag_gcse, 1,
1007 N_("Perform the global common subexpression elimination") },
1008 {"gcse-lm", &flag_gcse_lm, 1,
1009 N_("Perform enhanced load motion during global subexpression elimination") },
1010 {"gcse-sm", &flag_gcse_sm, 1,
1011 N_("Perform store motion after global subexpression elimination") },
1012 {"loop-optimize", &flag_loop_optimize, 1,
1013 N_("Perform the loop optimizations") },
1014 {"crossjumping", &flag_crossjumping, 1,
1015 N_("Perform cross-jumping optimization") },
1016 {"rerun-cse-after-loop", &flag_rerun_cse_after_loop, 1,
1017 N_("Run CSE pass after loop optimizations") },
1018 {"rerun-loop-opt", &flag_rerun_loop_opt, 1,
1019 N_("Run the loop optimizer twice") },
1020 {"delete-null-pointer-checks", &flag_delete_null_pointer_checks, 1,
1021 N_("Delete useless null pointer checks") },
1022 {"schedule-insns", &flag_schedule_insns, 1,
1023 N_("Reschedule instructions before register allocation") },
1024 {"schedule-insns2", &flag_schedule_insns_after_reload, 1,
1025 N_("Reschedule instructions after register allocation") },
1026 {"sched-interblock",&flag_schedule_interblock, 1,
1027 N_("Enable scheduling across basic blocks") },
1028 {"sched-spec",&flag_schedule_speculative, 1,
1029 N_("Allow speculative motion of non-loads") },
1030 {"sched-spec-load",&flag_schedule_speculative_load, 1,
1031 N_("Allow speculative motion of some loads") },
1032 {"sched-spec-load-dangerous",&flag_schedule_speculative_load_dangerous, 1,
1033 N_("Allow speculative motion of more loads") },
1034 {"branch-count-reg",&flag_branch_on_count_reg, 1,
1035 N_("Replace add,compare,branch with branch on count reg") },
1036 {"pic", &flag_pic, 1,
1037 N_("Generate position independent code, if possible") },
1038 {"PIC", &flag_pic, 2, ""},
1039 {"exceptions", &flag_exceptions, 1,
1040 N_("Enable exception handling") },
1041 {"unwind-tables", &flag_unwind_tables, 1,
1042 N_("Just generate unwind tables for exception handling") },
1043 {"asynchronous-unwind-tables", &flag_asynchronous_unwind_tables, 1,
1044 N_("Generate unwind tables exact at each instruction boundary") },
1045 {"non-call-exceptions", &flag_non_call_exceptions, 1,
1046 N_("Support synchronous non-call exceptions") },
1047 {"profile-arcs", &profile_arc_flag, 1,
1048 N_("Insert arc based program profiling code") },
1049 {"test-coverage", &flag_test_coverage, 1,
1050 N_("Create data files needed by gcov") },
1051 {"branch-probabilities", &flag_branch_probabilities, 1,
1052 N_("Use profiling information for branch probabilities") },
1053 {"reorder-blocks", &flag_reorder_blocks, 1,
1054 N_("Reorder basic blocks to improve code placement") },
1055 {"rename-registers", &flag_rename_registers, 1,
1056 N_("Do the register renaming optimization pass") },
1057 {"cprop-registers", &flag_cprop_registers, 1,
1058 N_("Do the register copy-propagation optimization pass") },
1059 {"common", &flag_no_common, 0,
1060 N_("Do not put uninitialized globals in the common section") },
1061 {"inhibit-size-directive", &flag_inhibit_size_directive, 1,
1062 N_("Do not generate .size directives") },
1063 {"function-sections", &flag_function_sections, 1,
1064 N_("place each function into its own section") },
1065 {"data-sections", &flag_data_sections, 1,
1066 N_("place data items into their own section") },
1067 {"verbose-asm", &flag_verbose_asm, 1,
1068 N_("Add extra commentry to assembler output") },
1069 {"gnu-linker", &flag_gnu_linker, 1,
1070 N_("Output GNU ld formatted global initializers") },
1071 {"regmove", &flag_regmove, 1,
1072 N_("Enables a register move optimization") },
1073 {"optimize-register-move", &flag_regmove, 1,
1074 N_("Do the full regmove optimization pass") },
1075 {"pack-struct", &flag_pack_struct, 1,
1076 N_("Pack structure members together without holes") },
1077 {"stack-check", &flag_stack_check, 1,
1078 N_("Insert stack checking code into the program") },
1079 {"argument-alias", &flag_argument_noalias, 0,
1080 N_("Specify that arguments may alias each other & globals") },
1081 {"argument-noalias", &flag_argument_noalias, 1,
1082 N_("Assume arguments may alias globals but not each other") },
1083 {"argument-noalias-global", &flag_argument_noalias, 2,
1084 N_("Assume arguments do not alias each other or globals") },
1085 {"strict-aliasing", &flag_strict_aliasing, 1,
1086 N_("Assume strict aliasing rules apply") },
1087 {"align-loops", &align_loops, 0,
1088 N_("Align the start of loops") },
1089 {"align-jumps", &align_jumps, 0,
1090 N_("Align labels which are only reached by jumping") },
1091 {"align-labels", &align_labels, 0,
1092 N_("Align all labels") },
1093 {"align-functions", &align_functions, 0,
1094 N_("Align the start of functions") },
1095 {"merge-constants", &flag_merge_constants, 1,
1096 N_("Attempt to merge identical constants accross compilation units") },
1097 {"merge-all-constants", &flag_merge_constants, 2,
1098 N_("Attempt to merge identical constants and constant variables") },
1099 {"dump-unnumbered", &flag_dump_unnumbered, 1,
1100 N_("Suppress output of instruction numbers and line number notes in debugging dumps") },
1101 {"instrument-functions", &flag_instrument_function_entry_exit, 1,
1102 N_("Instrument function entry/exit with profiling calls") },
1103 {"zero-initialized-in-bss", &flag_zero_initialized_in_bss, 1,
1104 N_("Put zero initialized data in the bss section") },
1105 {"ssa", &flag_ssa, 1,
1106 N_("Enable SSA optimizations") },
1107 {"ssa-ccp", &flag_ssa_ccp, 1,
1108 N_("Enable SSA conditional constant propagation") },
1109 {"ssa-dce", &flag_ssa_dce, 1,
1110 N_("Enable aggressive SSA dead code elimination") },
1111 {"leading-underscore", &flag_leading_underscore, 1,
1112 N_("External symbols have a leading underscore") },
1113 {"ident", &flag_no_ident, 0,
1114 N_("Process #ident directives") },
1115 { "peephole2", &flag_peephole2, 1,
1116 N_("Enables an rtl peephole pass run before sched2") },
1117 { "guess-branch-probability", &flag_guess_branch_prob, 1,
1118 N_("Enables guessing of branch probabilities") },
1119 {"math-errno", &flag_errno_math, 1,
1120 N_("Set errno after built-in math functions") },
1121 {"trapping-math", &flag_trapping_math, 1,
1122 N_("Floating-point operations can trap") },
1123 {"unsafe-math-optimizations", &flag_unsafe_math_optimizations, 1,
1124 N_("Allow math optimizations that may violate IEEE or ANSI standards") },
1125 {"bounded-pointers", &flag_bounded_pointers, 1,
1126 N_("Compile pointers as triples: value, base & end") },
1127 {"bounds-check", &flag_bounds_check, 1,
1128 N_("Generate code to check bounds before dereferencing pointers and arrays") },
1129 {"single-precision-constant", &flag_single_precision_constant, 1,
1130 N_("Convert floating point constant to single precision constant") },
1131 {"time-report", &time_report, 1,
1132 N_("Report time taken by each compiler pass at end of run") },
1133 {"mem-report", &mem_report, 1,
1134 N_("Report on permanent memory allocation at end of run") },
1135 { "trapv", &flag_trapv, 1,
1136 N_("Trap for signed overflow in addition / subtraction / multiplication") },
1139 /* Table of language-specific options. */
1141 static const struct lang_opt
1143 const char *const option;
1144 const char *const description;
1146 documented_lang_options[] =
1148 /* In order not to overload the --help output, the convention
1149 used here is to only describe those options which are not
1150 enabled by default. */
1152 { "-ansi",
1153 N_("Compile just for ISO C89") },
1154 { "-std= ",
1155 N_("Determine language standard") },
1157 { "-fsigned-bitfields", "" },
1158 { "-funsigned-bitfields",
1159 N_("Make bit-fields by unsigned by default") },
1160 { "-fno-signed-bitfields", "" },
1161 { "-fno-unsigned-bitfields","" },
1162 { "-fsigned-char",
1163 N_("Make 'char' be signed by default") },
1164 { "-funsigned-char",
1165 N_("Make 'char' be unsigned by default") },
1166 { "-fno-signed-char", "" },
1167 { "-fno-unsigned-char", "" },
1169 { "-fasm", "" },
1170 { "-fno-asm",
1171 N_("Do not recognize the 'asm' keyword") },
1172 { "-fbuiltin", "" },
1173 { "-fno-builtin",
1174 N_("Do not recognize any built in functions") },
1175 { "-fhosted",
1176 N_("Assume normal C execution environment") },
1177 { "-fno-hosted", "" },
1178 { "-ffreestanding",
1179 N_("Assume that standard libraries & main might not exist") },
1180 { "-fno-freestanding", "" },
1181 { "-fcond-mismatch",
1182 N_("Allow different types as args of ? operator") },
1183 { "-fno-cond-mismatch", "" },
1184 { "-fdollars-in-identifiers",
1185 N_("Allow the use of $ inside identifiers") },
1186 { "-fno-dollars-in-identifiers", "" },
1187 { "-fpreprocessed", "" },
1188 { "-fno-preprocessed", "" },
1189 { "-fshort-double",
1190 N_("Use the same size for double as for float") },
1191 { "-fno-short-double", "" },
1192 { "-fshort-enums",
1193 N_("Use the smallest fitting integer to hold enums") },
1194 { "-fno-short-enums", "" },
1195 { "-fshort-wchar",
1196 N_("Override the underlying type for wchar_t to `unsigned short'") },
1197 { "-fno-short-wchar", "" },
1199 { "-Wall",
1200 N_("Enable most warning messages") },
1201 { "-Wbad-function-cast",
1202 N_("Warn about casting functions to incompatible types") },
1203 { "-Wno-bad-function-cast", "" },
1204 { "-Wmissing-format-attribute",
1205 N_("Warn about functions which might be candidates for format attributes") },
1206 { "-Wno-missing-format-attribute", "" },
1207 { "-Wcast-qual",
1208 N_("Warn about casts which discard qualifiers") },
1209 { "-Wno-cast-qual", "" },
1210 { "-Wchar-subscripts",
1211 N_("Warn about subscripts whose type is 'char'") },
1212 { "-Wno-char-subscripts", "" },
1213 { "-Wcomment",
1214 N_("Warn if nested comments are detected") },
1215 { "-Wno-comment", "" },
1216 { "-Wcomments",
1217 N_("Warn if nested comments are detected") },
1218 { "-Wno-comments", "" },
1219 { "-Wconversion",
1220 N_("Warn about possibly confusing type conversions") },
1221 { "-Wno-conversion", "" },
1222 { "-Wdiv-by-zero", "" },
1223 { "-Wno-div-by-zero",
1224 N_("Do not warn about compile-time integer division by zero") },
1225 { "-Wfloat-equal",
1226 N_("Warn about testing equality of floating point numbers") },
1227 { "-Wno-float-equal", "" },
1228 { "-Wformat",
1229 N_("Warn about printf/scanf/strftime/strfmon format anomalies") },
1230 { "-Wno-format", "" },
1231 { "-Wformat-extra-args", "" },
1232 { "-Wno-format-extra-args",
1233 N_("Don't warn about too many arguments to format functions") },
1234 { "-Wformat-nonliteral",
1235 N_("Warn about non-string-literal format strings") },
1236 { "-Wno-format-nonliteral", "" },
1237 { "-Wformat-security",
1238 N_("Warn about possible security problems with format functions") },
1239 { "-Wno-format-security", "" },
1240 { "-Wformat-y2k", "" },
1241 { "-Wno-format-y2k",
1242 N_("Don't warn about strftime formats yielding 2 digit years") },
1243 { "-Wimplicit-function-declaration",
1244 N_("Warn about implicit function declarations") },
1245 { "-Wno-implicit-function-declaration", "" },
1246 { "-Werror-implicit-function-declaration", "" },
1247 { "-Wimplicit-int",
1248 N_("Warn when a declaration does not specify a type") },
1249 { "-Wno-implicit-int", "" },
1250 { "-Wimplicit", "" },
1251 { "-Wno-implicit", "" },
1252 { "-Wimport",
1253 N_("Warn about the use of the #import directive") },
1254 { "-Wno-import", "" },
1255 { "-Wlong-long","" },
1256 { "-Wno-long-long",
1257 N_("Do not warn about using 'long long' when -pedantic") },
1258 { "-Wmain",
1259 N_("Warn about suspicious declarations of main") },
1260 { "-Wno-main", "" },
1261 { "-Wmissing-braces",
1262 N_("Warn about possibly missing braces around initializers") },
1263 { "-Wno-missing-braces", "" },
1264 { "-Wmissing-declarations",
1265 N_("Warn about global funcs without previous declarations") },
1266 { "-Wno-missing-declarations", "" },
1267 { "-Wmissing-prototypes",
1268 N_("Warn about global funcs without prototypes") },
1269 { "-Wno-missing-prototypes", "" },
1270 { "-Wmultichar",
1271 N_("Warn about use of multicharacter literals") },
1272 { "-Wno-multichar", "" },
1273 { "-Wnested-externs",
1274 N_("Warn about externs not at file scope level") },
1275 { "-Wno-nested-externs", "" },
1276 { "-Wparentheses",
1277 N_("Warn about possible missing parentheses") },
1278 { "-Wno-parentheses", "" },
1279 { "-Wpointer-arith",
1280 N_("Warn about function pointer arithmetic") },
1281 { "-Wno-pointer-arith", "" },
1282 { "-Wredundant-decls",
1283 N_("Warn about multiple declarations of the same object") },
1284 { "-Wno-redundant-decls", "" },
1285 { "-Wreturn-type",
1286 N_("Warn whenever a function's return-type defaults to int") },
1287 { "-Wno-return-type", "" },
1288 { "-Wsequence-point",
1289 N_("Warn about possible violations of sequence point rules") },
1290 { "-Wno-sequence-point", "" },
1291 { "-Wsign-compare",
1292 N_("Warn about signed/unsigned comparisons") },
1293 { "-Wno-sign-compare", "" },
1294 { "-Wstrict-prototypes",
1295 N_("Warn about non-prototyped function decls") },
1296 { "-Wno-strict-prototypes", "" },
1297 { "-Wtraditional",
1298 N_("Warn about constructs whose meanings change in ISO C") },
1299 { "-Wno-traditional", "" },
1300 { "-Wtrigraphs",
1301 N_("Warn when trigraphs are encountered") },
1302 { "-Wno-trigraphs", "" },
1303 { "-Wundef", "" },
1304 { "-Wno-undef", "" },
1305 { "-Wunknown-pragmas",
1306 N_("Warn about unrecognized pragmas") },
1307 { "-Wno-unknown-pragmas", "" },
1308 { "-Wwrite-strings",
1309 N_("Mark strings as 'const char *'") },
1310 { "-Wno-write-strings", "" },
1312 #define DEFINE_LANG_NAME(NAME) { NULL, NAME },
1314 #include "options.h"
1318 /* Here is a table, controlled by the tm.h file, listing each -m switch
1319 and which bits in `target_switches' it should set or clear.
1320 If VALUE is positive, it is bits to set.
1321 If VALUE is negative, -VALUE is bits to clear.
1322 (The sign bit is not used so there is no confusion.) */
1324 static const struct
1326 const char *const name;
1327 const int value;
1328 const char *const description;
1330 target_switches [] = TARGET_SWITCHES;
1332 /* This table is similar, but allows the switch to have a value. */
1334 #ifdef TARGET_OPTIONS
1335 static const struct
1337 const char *const prefix;
1338 const char **const variable;
1339 const char *const description;
1341 target_options [] = TARGET_OPTIONS;
1342 #endif
1344 /* Options controlling warnings. */
1346 /* Don't print warning messages. -w. */
1348 int inhibit_warnings = 0;
1350 /* Don't suppress warnings from system headers. -Wsystem-headers. */
1352 int warn_system_headers = 0;
1354 /* Print various extra warnings. -W. */
1356 int extra_warnings = 0;
1358 /* Treat warnings as errors. -Werror. */
1360 int warnings_are_errors = 0;
1362 /* Nonzero to warn about unused variables, functions et.al. */
1364 int warn_unused_function;
1365 int warn_unused_label;
1366 int warn_unused_parameter;
1367 int warn_unused_variable;
1368 int warn_unused_value;
1370 /* Nonzero to warn about code which is never reached. */
1372 int warn_notreached;
1374 /* Nonzero to warn about variables used before they are initialized. */
1376 int warn_uninitialized;
1378 /* Nonzero means warn about all declarations which shadow others. */
1380 int warn_shadow;
1382 /* Warn if a switch on an enum, that does not have a default case,
1383 fails to have a case for every enum value. */
1385 int warn_switch;
1387 /* Warn if a switch does not have a default case. */
1389 int warn_switch_default;
1391 /* Warn if a switch on an enum fails to have a case for every enum
1392 value (regardless of the presence or otherwise of a default case). */
1394 int warn_switch_enum;
1396 /* Nonzero means warn about function definitions that default the return type
1397 or that use a null return and have a return-type other than void. */
1399 int warn_return_type;
1401 /* Nonzero means warn about pointer casts that increase the required
1402 alignment of the target type (and might therefore lead to a crash
1403 due to a misaligned access). */
1405 int warn_cast_align;
1407 /* Nonzero means warn about any objects definitions whose size is larger
1408 than N bytes. Also want about function definitions whose returned
1409 values are larger than N bytes. The value N is in `larger_than_size'. */
1411 int warn_larger_than;
1412 HOST_WIDE_INT larger_than_size;
1414 /* Nonzero means warn if inline function is too large. */
1416 int warn_inline;
1418 /* Warn if a function returns an aggregate,
1419 since there are often incompatible calling conventions for doing this. */
1421 int warn_aggregate_return;
1423 /* Warn if packed attribute on struct is unnecessary and inefficient. */
1425 int warn_packed;
1427 /* Warn when gcc pads a structure to an alignment boundary. */
1429 int warn_padded;
1431 /* Warn when an optimization pass is disabled. */
1433 int warn_disabled_optimization;
1435 /* Warn about functions which might be candidates for attribute noreturn. */
1437 int warn_missing_noreturn;
1439 /* Nonzero means warn about uses of __attribute__((deprecated))
1440 declarations. */
1442 int warn_deprecated_decl = 1;
1444 /* Likewise for -W. */
1446 static const lang_independent_options W_options[] =
1448 {"unused-function", &warn_unused_function, 1,
1449 N_("Warn when a function is unused") },
1450 {"unused-label", &warn_unused_label, 1,
1451 N_("Warn when a label is unused") },
1452 {"unused-parameter", &warn_unused_parameter, 1,
1453 N_("Warn when a function parameter is unused") },
1454 {"unused-variable", &warn_unused_variable, 1,
1455 N_("Warn when a variable is unused") },
1456 {"unused-value", &warn_unused_value, 1,
1457 N_("Warn when an expression value is unused") },
1458 {"system-headers", &warn_system_headers, 1,
1459 N_("Do not suppress warnings from system headers") },
1460 {"error", &warnings_are_errors, 1,
1461 N_("Treat all warnings as errors") },
1462 {"shadow", &warn_shadow, 1,
1463 N_("Warn when one local variable shadows another") },
1464 {"switch", &warn_switch, 1,
1465 N_("Warn about enumerated switches, with no default, missing a case") },
1466 {"switch-default", &warn_switch_default, 1,
1467 N_("Warn about enumerated switches missing a default case") },
1468 {"switch-enum", &warn_switch_enum, 1,
1469 N_("Warn about all enumerated switches missing a specific case") },
1470 {"aggregate-return", &warn_aggregate_return, 1,
1471 N_("Warn about returning structures, unions or arrays") },
1472 {"cast-align", &warn_cast_align, 1,
1473 N_("Warn about pointer casts which increase alignment") },
1474 {"unreachable-code", &warn_notreached, 1,
1475 N_("Warn about code that will never be executed") },
1476 {"uninitialized", &warn_uninitialized, 1,
1477 N_("Warn about uninitialized automatic variables") },
1478 {"inline", &warn_inline, 1,
1479 N_("Warn when an inlined function cannot be inlined") },
1480 {"packed", &warn_packed, 1,
1481 N_("Warn when the packed attribute has no effect on struct layout") },
1482 {"padded", &warn_padded, 1,
1483 N_("Warn when padding is required to align struct members") },
1484 {"disabled-optimization", &warn_disabled_optimization, 1,
1485 N_("Warn when an optimization pass is disabled") },
1486 {"deprecated-declarations", &warn_deprecated_decl, 1,
1487 N_("Warn about uses of __attribute__((deprecated)) declarations") },
1488 {"missing-noreturn", &warn_missing_noreturn, 1,
1489 N_("Warn about functions which might be candidates for attribute noreturn") }
1492 void
1493 set_Wunused (setting)
1494 int setting;
1496 warn_unused_function = setting;
1497 warn_unused_label = setting;
1498 /* Unused function parameter warnings are reported when either ``-W
1499 -Wunused'' or ``-Wunused-parameter'' is specified. Differentiate
1500 -Wunused by setting WARN_UNUSED_PARAMETER to -1. */
1501 if (!setting)
1502 warn_unused_parameter = 0;
1503 else if (!warn_unused_parameter)
1504 warn_unused_parameter = -1;
1505 warn_unused_variable = setting;
1506 warn_unused_value = setting;
1509 /* The following routines are useful in setting all the flags that
1510 -ffast-math and -fno-fast-math imply. */
1512 void
1513 set_fast_math_flags ()
1515 flag_trapping_math = 0;
1516 flag_unsafe_math_optimizations = 1;
1517 flag_errno_math = 0;
1520 void
1521 set_no_fast_math_flags ()
1523 flag_trapping_math = 1;
1524 flag_unsafe_math_optimizations = 0;
1525 flag_errno_math = 1;
1529 /* Output files for assembler code (real compiler output)
1530 and debugging dumps. */
1532 FILE *asm_out_file;
1533 FILE *aux_info_file;
1534 FILE *rtl_dump_file = NULL;
1536 /* Decode the string P as an integral parameter.
1537 If the string is indeed an integer return its numeric value else
1538 issue an Invalid Option error for the option PNAME and return DEFVAL.
1539 If PNAME is zero just return DEFVAL, do not call error. */
1542 read_integral_parameter (p, pname, defval)
1543 const char *p;
1544 const char *pname;
1545 const int defval;
1547 const char *endp = p;
1549 while (*endp)
1551 if (ISDIGIT (*endp))
1552 endp++;
1553 else
1554 break;
1557 if (*endp != 0)
1559 if (pname != 0)
1560 error ("invalid option `%s'", pname);
1561 return defval;
1564 return atoi (p);
1567 /* This calls abort and is used to avoid problems when abort if a macro.
1568 It is used when we need to pass the address of abort. */
1570 void
1571 do_abort ()
1573 abort ();
1576 /* When `malloc.c' is compiled with `rcheck' defined,
1577 it calls this function to report clobberage. */
1579 void
1580 botch (s)
1581 const char *s ATTRIBUTE_UNUSED;
1583 abort ();
1586 /* Return the logarithm of X, base 2, considering X unsigned,
1587 if X is a power of 2. Otherwise, returns -1.
1589 This should be used via the `exact_log2' macro. */
1592 exact_log2_wide (x)
1593 unsigned HOST_WIDE_INT x;
1595 int log = 0;
1596 /* Test for 0 or a power of 2. */
1597 if (x == 0 || x != (x & -x))
1598 return -1;
1599 while ((x >>= 1) != 0)
1600 log++;
1601 return log;
1604 /* Given X, an unsigned number, return the largest int Y such that 2**Y <= X.
1605 If X is 0, return -1.
1607 This should be used via the floor_log2 macro. */
1610 floor_log2_wide (x)
1611 unsigned HOST_WIDE_INT x;
1613 int log = -1;
1614 while (x != 0)
1615 log++,
1616 x >>= 1;
1617 return log;
1620 /* Handler for fatal signals, such as SIGSEGV. These are transformed
1621 into ICE messages, which is much more user friendly. */
1623 static void
1624 crash_signal (signo)
1625 int signo;
1627 internal_error ("internal error: %s", strsignal (signo));
1630 /* Strip off a legitimate source ending from the input string NAME of
1631 length LEN. Rather than having to know the names used by all of
1632 our front ends, we strip off an ending of a period followed by
1633 up to five characters. (Java uses ".class".) */
1635 void
1636 strip_off_ending (name, len)
1637 char *name;
1638 int len;
1640 int i;
1641 for (i = 2; i < 6 && len > i; i++)
1643 if (name[len - i] == '.')
1645 name[len - i] = '\0';
1646 break;
1651 /* Output a quoted string. */
1653 void
1654 output_quoted_string (asm_file, string)
1655 FILE *asm_file;
1656 const char *string;
1658 #ifdef OUTPUT_QUOTED_STRING
1659 OUTPUT_QUOTED_STRING (asm_file, string);
1660 #else
1661 char c;
1663 putc ('\"', asm_file);
1664 while ((c = *string++) != 0)
1666 if (ISPRINT (c))
1668 if (c == '\"' || c == '\\')
1669 putc ('\\', asm_file);
1670 putc (c, asm_file);
1672 else
1673 fprintf (asm_file, "\\%03o", c);
1675 putc ('\"', asm_file);
1676 #endif
1679 /* Output a file name in the form wanted by System V. */
1681 void
1682 output_file_directive (asm_file, input_name)
1683 FILE *asm_file;
1684 const char *input_name;
1686 int len = strlen (input_name);
1687 const char *na = input_name + len;
1689 /* NA gets INPUT_NAME sans directory names. */
1690 while (na > input_name)
1692 if (IS_DIR_SEPARATOR (na[-1]))
1693 break;
1694 na--;
1697 #ifdef ASM_OUTPUT_MAIN_SOURCE_FILENAME
1698 ASM_OUTPUT_MAIN_SOURCE_FILENAME (asm_file, na);
1699 #else
1700 #ifdef ASM_OUTPUT_SOURCE_FILENAME
1701 ASM_OUTPUT_SOURCE_FILENAME (asm_file, na);
1702 #else
1703 fprintf (asm_file, "\t.file\t");
1704 output_quoted_string (asm_file, na);
1705 fputc ('\n', asm_file);
1706 #endif
1707 #endif
1710 /* Routine to open a dump file. Return true if the dump file is enabled. */
1712 static int
1713 open_dump_file (index, decl)
1714 enum dump_file_index index;
1715 tree decl;
1717 char *dump_name;
1718 const char *open_arg;
1719 char seq[16];
1721 if (! dump_file[index].enabled)
1722 return 0;
1724 timevar_push (TV_DUMP);
1725 if (rtl_dump_file != NULL)
1726 fclose (rtl_dump_file);
1728 sprintf (seq, DUMPFILE_FORMAT, index);
1730 if (! dump_file[index].initialized)
1732 /* If we've not initialized the files, do so now. */
1733 if (graph_dump_format != no_graph
1734 && dump_file[index].graph_dump_p)
1736 dump_name = concat (seq, dump_file[index].extension, NULL);
1737 clean_graph_dump_file (dump_base_name, dump_name);
1738 free (dump_name);
1740 dump_file[index].initialized = 1;
1741 open_arg = "w";
1743 else
1744 open_arg = "a";
1746 dump_name = concat (dump_base_name, seq,
1747 dump_file[index].extension, NULL);
1749 rtl_dump_file = fopen (dump_name, open_arg);
1750 if (rtl_dump_file == NULL)
1751 fatal_io_error ("can't open %s", dump_name);
1753 free (dump_name);
1755 if (decl)
1756 fprintf (rtl_dump_file, "\n;; Function %s\n\n",
1757 (*lang_hooks.decl_printable_name) (decl, 2));
1759 timevar_pop (TV_DUMP);
1760 return 1;
1763 /* Routine to close a dump file. */
1765 static void
1766 close_dump_file (index, func, insns)
1767 enum dump_file_index index;
1768 void (*func) PARAMS ((FILE *, rtx));
1769 rtx insns;
1771 if (! rtl_dump_file)
1772 return;
1774 timevar_push (TV_DUMP);
1775 if (insns
1776 && graph_dump_format != no_graph
1777 && dump_file[index].graph_dump_p)
1779 char seq[16];
1780 char *suffix;
1782 sprintf (seq, DUMPFILE_FORMAT, index);
1783 suffix = concat (seq, dump_file[index].extension, NULL);
1784 print_rtl_graph_with_bb (dump_base_name, suffix, insns);
1785 free (suffix);
1788 if (func && insns)
1789 func (rtl_dump_file, insns);
1791 fflush (rtl_dump_file);
1792 fclose (rtl_dump_file);
1794 rtl_dump_file = NULL;
1795 timevar_pop (TV_DUMP);
1798 /* Do any final processing required for the declarations in VEC, of
1799 which there are LEN. We write out inline functions and variables
1800 that have been deferred until this point, but which are required.
1801 Returns non-zero if anything was put out. */
1804 wrapup_global_declarations (vec, len)
1805 tree *vec;
1806 int len;
1808 tree decl;
1809 int i;
1810 int reconsider;
1811 int output_something = 0;
1813 for (i = 0; i < len; i++)
1815 decl = vec[i];
1817 /* We're not deferring this any longer. */
1818 DECL_DEFER_OUTPUT (decl) = 0;
1820 if (TREE_CODE (decl) == VAR_DECL && DECL_SIZE (decl) == 0)
1821 (*lang_hooks.finish_incomplete_decl) (decl);
1824 /* Now emit any global variables or functions that we have been
1825 putting off. We need to loop in case one of the things emitted
1826 here references another one which comes earlier in the list. */
1829 reconsider = 0;
1830 for (i = 0; i < len; i++)
1832 decl = vec[i];
1834 if (TREE_ASM_WRITTEN (decl) || DECL_EXTERNAL (decl))
1835 continue;
1837 /* Don't write out static consts, unless we still need them.
1839 We also keep static consts if not optimizing (for debugging),
1840 unless the user specified -fno-keep-static-consts.
1841 ??? They might be better written into the debug information.
1842 This is possible when using DWARF.
1844 A language processor that wants static constants to be always
1845 written out (even if it is not used) is responsible for
1846 calling rest_of_decl_compilation itself. E.g. the C front-end
1847 calls rest_of_decl_compilation from finish_decl.
1848 One motivation for this is that is conventional in some
1849 environments to write things like:
1850 static const char rcsid[] = "... version string ...";
1851 intending to force the string to be in the executable.
1853 A language processor that would prefer to have unneeded
1854 static constants "optimized away" would just defer writing
1855 them out until here. E.g. C++ does this, because static
1856 constants are often defined in header files.
1858 ??? A tempting alternative (for both C and C++) would be
1859 to force a constant to be written if and only if it is
1860 defined in a main file, as opposed to an include file. */
1862 if (TREE_CODE (decl) == VAR_DECL && TREE_STATIC (decl))
1864 bool needed = 1;
1866 if (TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (decl)))
1867 /* needed */;
1868 else if (DECL_COMDAT (decl))
1869 needed = 0;
1870 else if (TREE_READONLY (decl) && !TREE_PUBLIC (decl)
1871 && (optimize || !flag_keep_static_consts
1872 || DECL_ARTIFICIAL (decl)))
1873 needed = 0;
1875 if (needed)
1877 reconsider = 1;
1878 rest_of_decl_compilation (decl, NULL, 1, 1);
1882 if (TREE_CODE (decl) == FUNCTION_DECL
1883 && DECL_INITIAL (decl) != 0
1884 && DECL_SAVED_INSNS (decl) != 0
1885 && (flag_keep_inline_functions
1886 || (TREE_PUBLIC (decl) && !DECL_COMDAT (decl))
1887 || TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (decl))))
1889 reconsider = 1;
1890 output_inline_function (decl);
1894 if (reconsider)
1895 output_something = 1;
1897 while (reconsider);
1899 return output_something;
1902 /* Issue appropriate warnings for the global declarations in VEC (of
1903 which there are LEN). Output debugging information for them. */
1905 void
1906 check_global_declarations (vec, len)
1907 tree *vec;
1908 int len;
1910 tree decl;
1911 int i;
1913 for (i = 0; i < len; i++)
1915 decl = vec[i];
1917 if (TREE_CODE (decl) == VAR_DECL && TREE_STATIC (decl)
1918 && ! TREE_ASM_WRITTEN (decl))
1919 /* Cancel the RTL for this decl so that, if debugging info
1920 output for global variables is still to come,
1921 this one will be omitted. */
1922 SET_DECL_RTL (decl, NULL_RTX);
1924 /* Warn about any function
1925 declared static but not defined.
1926 We don't warn about variables,
1927 because many programs have static variables
1928 that exist only to get some text into the object file. */
1929 if (TREE_CODE (decl) == FUNCTION_DECL
1930 && (warn_unused_function
1931 || TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (decl)))
1932 && DECL_INITIAL (decl) == 0
1933 && DECL_EXTERNAL (decl)
1934 && ! DECL_ARTIFICIAL (decl)
1935 && ! TREE_PUBLIC (decl))
1937 if (TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (decl)))
1938 pedwarn_with_decl (decl,
1939 "`%s' used but never defined");
1940 else
1941 warning_with_decl (decl,
1942 "`%s' declared `static' but never defined");
1943 /* This symbol is effectively an "extern" declaration now. */
1944 TREE_PUBLIC (decl) = 1;
1945 assemble_external (decl);
1948 /* Warn about static fns or vars defined but not used,
1949 but not about inline functions or static consts
1950 since defining those in header files is normal practice. */
1951 if (((warn_unused_function
1952 && TREE_CODE (decl) == FUNCTION_DECL && ! DECL_INLINE (decl))
1953 || (warn_unused_variable
1954 && TREE_CODE (decl) == VAR_DECL && ! TREE_READONLY (decl)))
1955 && ! DECL_IN_SYSTEM_HEADER (decl)
1956 && ! DECL_EXTERNAL (decl)
1957 && ! TREE_PUBLIC (decl)
1958 && ! TREE_USED (decl)
1959 && (TREE_CODE (decl) == FUNCTION_DECL || ! DECL_REGISTER (decl))
1960 /* The TREE_USED bit for file-scope decls
1961 is kept in the identifier, to handle multiple
1962 external decls in different scopes. */
1963 && ! TREE_USED (DECL_NAME (decl)))
1964 warning_with_decl (decl, "`%s' defined but not used");
1966 timevar_push (TV_SYMOUT);
1967 (*debug_hooks->global_decl) (decl);
1968 timevar_pop (TV_SYMOUT);
1972 /* Save the current INPUT_FILENAME and LINENO on the top entry in the
1973 INPUT_FILE_STACK. Push a new entry for FILE and LINE, and set the
1974 INPUT_FILENAME and LINENO accordingly. */
1976 void
1977 push_srcloc (file, line)
1978 const char *file;
1979 int line;
1981 struct file_stack *fs;
1983 if (input_file_stack)
1985 input_file_stack->name = input_filename;
1986 input_file_stack->line = lineno;
1989 fs = (struct file_stack *) xmalloc (sizeof (struct file_stack));
1990 fs->name = input_filename = file;
1991 fs->line = lineno = line;
1992 fs->indent_level = 0;
1993 fs->next = input_file_stack;
1994 input_file_stack = fs;
1995 input_file_stack_tick++;
1998 /* Pop the top entry off the stack of presently open source files.
1999 Restore the INPUT_FILENAME and LINENO from the new topmost entry on
2000 the stack. */
2002 void
2003 pop_srcloc ()
2005 struct file_stack *fs;
2007 fs = input_file_stack;
2008 input_file_stack = fs->next;
2009 free (fs);
2010 input_file_stack_tick++;
2011 /* The initial source file is never popped. */
2012 if (!input_file_stack)
2013 abort ();
2014 input_filename = input_file_stack->name;
2015 lineno = input_file_stack->line;
2018 /* Compile an entire translation unit. Write a file of assembly
2019 output and various debugging dumps. */
2021 static void
2022 compile_file ()
2024 tree globals;
2026 /* Initialize yet another pass. */
2028 init_final (main_input_filename);
2029 init_branch_prob (dump_base_name);
2031 timevar_push (TV_PARSE);
2033 /* Call the parser, which parses the entire file (calling
2034 rest_of_compilation for each function). */
2035 (*lang_hooks.parse_file) ();
2037 /* In case there were missing block closers,
2038 get us back to the global binding level. */
2039 (*lang_hooks.clear_binding_stack) ();
2041 /* Compilation is now finished except for writing
2042 what's left of the symbol table output. */
2043 timevar_pop (TV_PARSE);
2045 if (flag_syntax_only)
2046 return;
2048 globals = (*lang_hooks.decls.getdecls) ();
2050 /* Really define vars that have had only a tentative definition.
2051 Really output inline functions that must actually be callable
2052 and have not been output so far. */
2055 int len = list_length (globals);
2056 tree *vec = (tree *) xmalloc (sizeof (tree) * len);
2057 int i;
2058 tree decl;
2060 /* Process the decls in reverse order--earliest first.
2061 Put them into VEC from back to front, then take out from front. */
2063 for (i = 0, decl = globals; i < len; i++, decl = TREE_CHAIN (decl))
2064 vec[len - i - 1] = decl;
2066 wrapup_global_declarations (vec, len);
2068 /* This must occur after the loop to output deferred functions. Else
2069 the profiler initializer would not be emitted if all the functions
2070 in this compilation unit were deferred.
2072 output_func_start_profiler can not cause any additional functions or
2073 data to need to be output, so it need not be in the deferred function
2074 loop above. */
2075 output_func_start_profiler ();
2077 check_global_declarations (vec, len);
2079 /* Clean up. */
2080 free (vec);
2083 /* Write out any pending weak symbol declarations. */
2085 weak_finish ();
2087 /* Do dbx symbols. */
2088 timevar_push (TV_SYMOUT);
2090 #ifdef DWARF2_UNWIND_INFO
2091 if (dwarf2out_do_frame ())
2092 dwarf2out_frame_finish ();
2093 #endif
2095 (*debug_hooks->finish) (main_input_filename);
2096 timevar_pop (TV_SYMOUT);
2098 /* Output some stuff at end of file if nec. */
2100 dw2_output_indirect_constants ();
2102 end_final (dump_base_name);
2104 if (profile_arc_flag || flag_test_coverage || flag_branch_probabilities)
2106 timevar_push (TV_DUMP);
2107 open_dump_file (DFI_bp, NULL);
2109 end_branch_prob ();
2111 close_dump_file (DFI_bp, NULL, NULL_RTX);
2112 timevar_pop (TV_DUMP);
2115 #ifdef ASM_FILE_END
2116 ASM_FILE_END (asm_out_file);
2117 #endif
2119 /* Attach a special .ident directive to the end of the file to identify
2120 the version of GCC which compiled this code. The format of the .ident
2121 string is patterned after the ones produced by native SVR4 compilers. */
2122 #ifdef IDENT_ASM_OP
2123 if (!flag_no_ident)
2124 fprintf (asm_out_file, "%s\"GCC: (GNU) %s\"\n",
2125 IDENT_ASM_OP, version_string);
2126 #endif
2128 if (optimize > 0 && open_dump_file (DFI_combine, NULL))
2130 timevar_push (TV_DUMP);
2131 dump_combine_total_stats (rtl_dump_file);
2132 close_dump_file (DFI_combine, NULL, NULL_RTX);
2133 timevar_pop (TV_DUMP);
2137 /* This is called from various places for FUNCTION_DECL, VAR_DECL,
2138 and TYPE_DECL nodes.
2140 This does nothing for local (non-static) variables, unless the
2141 variable is a register variable with an ASMSPEC. In that case, or
2142 if the variable is not an automatic, it sets up the RTL and
2143 outputs any assembler code (label definition, storage allocation
2144 and initialization).
2146 DECL is the declaration. If ASMSPEC is nonzero, it specifies
2147 the assembler symbol name to be used. TOP_LEVEL is nonzero
2148 if this declaration is not within a function. */
2150 void
2151 rest_of_decl_compilation (decl, asmspec, top_level, at_end)
2152 tree decl;
2153 const char *asmspec;
2154 int top_level;
2155 int at_end;
2157 /* Declarations of variables, and of functions defined elsewhere. */
2159 /* The most obvious approach, to put an #ifndef around where
2160 this macro is used, doesn't work since it's inside a macro call. */
2161 #ifndef ASM_FINISH_DECLARE_OBJECT
2162 #define ASM_FINISH_DECLARE_OBJECT(FILE, DECL, TOP, END)
2163 #endif
2165 /* We deferred calling assemble_alias so that we could collect
2166 other attributes such as visibility. Emit the alias now. */
2168 tree alias;
2169 alias = lookup_attribute ("alias", DECL_ATTRIBUTES (decl));
2170 if (alias)
2172 alias = TREE_VALUE (TREE_VALUE (alias));
2173 alias = get_identifier (TREE_STRING_POINTER (alias));
2174 assemble_alias (decl, alias);
2178 /* Forward declarations for nested functions are not "external",
2179 but we need to treat them as if they were. */
2180 if (TREE_STATIC (decl) || DECL_EXTERNAL (decl)
2181 || TREE_CODE (decl) == FUNCTION_DECL)
2183 timevar_push (TV_VARCONST);
2185 if (asmspec)
2186 make_decl_rtl (decl, asmspec);
2188 /* Don't output anything when a tentative file-scope definition
2189 is seen. But at end of compilation, do output code for them. */
2190 if (at_end || !DECL_DEFER_OUTPUT (decl))
2191 assemble_variable (decl, top_level, at_end, 0);
2192 if (decl == last_assemble_variable_decl)
2194 ASM_FINISH_DECLARE_OBJECT (asm_out_file, decl,
2195 top_level, at_end);
2198 timevar_pop (TV_VARCONST);
2200 else if (DECL_REGISTER (decl) && asmspec != 0)
2202 if (decode_reg_name (asmspec) >= 0)
2204 SET_DECL_RTL (decl, NULL_RTX);
2205 make_decl_rtl (decl, asmspec);
2207 else
2209 error ("invalid register name `%s' for register variable", asmspec);
2210 DECL_REGISTER (decl) = 0;
2211 if (!top_level)
2212 expand_decl (decl);
2215 #if defined (DBX_DEBUGGING_INFO) || defined (XCOFF_DEBUGGING_INFO)
2216 else if ((write_symbols == DBX_DEBUG || write_symbols == XCOFF_DEBUG)
2217 && TREE_CODE (decl) == TYPE_DECL)
2219 timevar_push (TV_SYMOUT);
2220 dbxout_symbol (decl, 0);
2221 timevar_pop (TV_SYMOUT);
2223 #endif
2224 #ifdef SDB_DEBUGGING_INFO
2225 else if (write_symbols == SDB_DEBUG && top_level
2226 && TREE_CODE (decl) == TYPE_DECL)
2228 timevar_push (TV_SYMOUT);
2229 sdbout_symbol (decl, 0);
2230 timevar_pop (TV_SYMOUT);
2232 #endif
2235 /* Called after finishing a record, union or enumeral type. */
2237 void
2238 rest_of_type_compilation (type, toplev)
2239 #if defined(DBX_DEBUGGING_INFO) || defined(XCOFF_DEBUGGING_INFO) || defined (SDB_DEBUGGING_INFO)
2240 tree type;
2241 int toplev;
2242 #else
2243 tree type ATTRIBUTE_UNUSED;
2244 int toplev ATTRIBUTE_UNUSED;
2245 #endif
2247 timevar_push (TV_SYMOUT);
2248 #if defined (DBX_DEBUGGING_INFO) || defined (XCOFF_DEBUGGING_INFO)
2249 if (write_symbols == DBX_DEBUG || write_symbols == XCOFF_DEBUG)
2250 dbxout_symbol (TYPE_STUB_DECL (type), !toplev);
2251 #endif
2252 #ifdef SDB_DEBUGGING_INFO
2253 if (write_symbols == SDB_DEBUG)
2254 sdbout_symbol (TYPE_STUB_DECL (type), !toplev);
2255 #endif
2256 #ifdef DWARF2_DEBUGGING_INFO
2257 if ((write_symbols == DWARF2_DEBUG
2258 || write_symbols == VMS_AND_DWARF2_DEBUG)
2259 && toplev)
2260 dwarf2out_decl (TYPE_STUB_DECL (type));
2261 #endif
2262 timevar_pop (TV_SYMOUT);
2265 /* This is called from finish_function (within langhooks.parse_file)
2266 after each top-level definition is parsed.
2267 It is supposed to compile that function or variable
2268 and output the assembler code for it.
2269 After we return, the tree storage is freed. */
2271 void
2272 rest_of_compilation (decl)
2273 tree decl;
2275 rtx insns;
2276 int tem;
2277 int failure = 0;
2278 int rebuild_label_notes_after_reload;
2279 int register_life_up_to_date;
2281 timevar_push (TV_REST_OF_COMPILATION);
2283 /* Now that we're out of the frontend, we shouldn't have any more
2284 CONCATs anywhere. */
2285 generating_concat_p = 0;
2287 /* When processing delayed functions, prepare_function_start() won't
2288 have been run to re-initialize it. */
2289 cse_not_expected = ! optimize;
2291 /* First, make sure that NOTE_BLOCK is set correctly for each
2292 NOTE_INSN_BLOCK_BEG/NOTE_INSN_BLOCK_END note. */
2293 if (!cfun->x_whole_function_mode_p)
2294 identify_blocks ();
2296 /* In function-at-a-time mode, we do not attempt to keep the BLOCK
2297 tree in sensible shape. So, we just recalculate it here. */
2298 if (cfun->x_whole_function_mode_p)
2299 reorder_blocks ();
2301 init_flow ();
2303 /* If we are reconsidering an inline function
2304 at the end of compilation, skip the stuff for making it inline. */
2306 if (DECL_SAVED_INSNS (decl) == 0)
2308 int inlinable = 0;
2309 tree parent;
2310 const char *lose;
2312 /* If this is nested inside an inlined external function, pretend
2313 it was only declared. Since we cannot inline such functions,
2314 generating code for this one is not only not necessary but will
2315 confuse some debugging output writers. */
2316 for (parent = DECL_CONTEXT (current_function_decl);
2317 parent != NULL_TREE;
2318 parent = get_containing_scope (parent))
2319 if (TREE_CODE (parent) == FUNCTION_DECL
2320 && DECL_INLINE (parent) && DECL_EXTERNAL (parent))
2322 DECL_INITIAL (decl) = 0;
2323 goto exit_rest_of_compilation;
2326 /* If requested, consider whether to make this function inline. */
2327 if ((DECL_INLINE (decl) && !flag_no_inline)
2328 || flag_inline_functions)
2330 timevar_push (TV_INTEGRATION);
2331 lose = function_cannot_inline_p (decl);
2332 timevar_pop (TV_INTEGRATION);
2333 if (lose || ! optimize)
2335 if (warn_inline && DECL_INLINE (decl))
2336 warning_with_decl (decl, lose);
2337 DECL_ABSTRACT_ORIGIN (decl) = 0;
2338 /* Don't really compile an extern inline function.
2339 If we can't make it inline, pretend
2340 it was only declared. */
2341 if (DECL_EXTERNAL (decl))
2343 DECL_INITIAL (decl) = 0;
2344 goto exit_rest_of_compilation;
2347 else
2348 /* ??? Note that this has the effect of making it look
2349 like "inline" was specified for a function if we choose
2350 to inline it. This isn't quite right, but it's
2351 probably not worth the trouble to fix. */
2352 inlinable = DECL_INLINE (decl) = 1;
2355 insns = get_insns ();
2357 /* Dump the rtl code if we are dumping rtl. */
2359 if (open_dump_file (DFI_rtl, decl))
2361 if (DECL_SAVED_INSNS (decl))
2362 fprintf (rtl_dump_file, ";; (integrable)\n\n");
2363 close_dump_file (DFI_rtl, print_rtl, insns);
2366 /* Convert from NOTE_INSN_EH_REGION style notes, and do other
2367 sorts of eh initialization. Delay this until after the
2368 initial rtl dump so that we can see the original nesting. */
2369 convert_from_eh_region_ranges ();
2371 /* If function is inline, and we don't yet know whether to
2372 compile it by itself, defer decision till end of compilation.
2373 finish_compilation will call rest_of_compilation again
2374 for those functions that need to be output. Also defer those
2375 functions that we are supposed to defer. */
2377 if (inlinable
2378 || (DECL_INLINE (decl)
2379 && ((! TREE_PUBLIC (decl) && ! TREE_ADDRESSABLE (decl)
2380 && ! flag_keep_inline_functions)
2381 || DECL_EXTERNAL (decl))))
2382 DECL_DEFER_OUTPUT (decl) = 1;
2384 if (DECL_INLINE (decl))
2385 /* DWARF wants separate debugging info for abstract and
2386 concrete instances of all inline functions, including those
2387 declared inline but not inlined, and those inlined even
2388 though they weren't declared inline. Conveniently, that's
2389 what DECL_INLINE means at this point. */
2390 (*debug_hooks->deferred_inline_function) (decl);
2392 if (DECL_DEFER_OUTPUT (decl))
2394 /* If -Wreturn-type, we have to do a bit of compilation. We just
2395 want to call cleanup the cfg to figure out whether or not we can
2396 fall off the end of the function; we do the minimum amount of
2397 work necessary to make that safe. */
2398 if (warn_return_type)
2400 int saved_optimize = optimize;
2402 optimize = 0;
2403 rebuild_jump_labels (insns);
2404 find_exception_handler_labels ();
2405 find_basic_blocks (insns, max_reg_num (), rtl_dump_file);
2406 cleanup_cfg (CLEANUP_PRE_SIBCALL | CLEANUP_PRE_LOOP);
2407 optimize = saved_optimize;
2409 /* CFG is no longer maintained up-to-date. */
2410 free_bb_for_insn ();
2413 current_function_nothrow = nothrow_function_p ();
2414 if (current_function_nothrow)
2415 /* Now we know that this can't throw; set the flag for the benefit
2416 of other functions later in this translation unit. */
2417 TREE_NOTHROW (current_function_decl) = 1;
2419 timevar_push (TV_INTEGRATION);
2420 save_for_inline (decl);
2421 timevar_pop (TV_INTEGRATION);
2422 DECL_SAVED_INSNS (decl)->inlinable = inlinable;
2423 goto exit_rest_of_compilation;
2426 /* If specified extern inline but we aren't inlining it, we are
2427 done. This goes for anything that gets here with DECL_EXTERNAL
2428 set, not just things with DECL_INLINE. */
2429 if (DECL_EXTERNAL (decl))
2430 goto exit_rest_of_compilation;
2433 /* If we're emitting a nested function, make sure its parent gets
2434 emitted as well. Doing otherwise confuses debug info. */
2436 tree parent;
2437 for (parent = DECL_CONTEXT (current_function_decl);
2438 parent != NULL_TREE;
2439 parent = get_containing_scope (parent))
2440 if (TREE_CODE (parent) == FUNCTION_DECL)
2441 TREE_SYMBOL_REFERENCED (DECL_ASSEMBLER_NAME (parent)) = 1;
2444 /* We are now committed to emitting code for this function. Do any
2445 preparation, such as emitting abstract debug info for the inline
2446 before it gets mangled by optimization. */
2447 if (DECL_INLINE (decl))
2448 (*debug_hooks->outlining_inline_function) (decl);
2450 /* Remove any notes we don't need. That will make iterating
2451 over the instruction sequence faster, and allow the garbage
2452 collector to reclaim the memory used by the notes. */
2453 remove_unnecessary_notes ();
2454 reorder_blocks ();
2456 ggc_collect ();
2458 /* Initialize some variables used by the optimizers. */
2459 init_function_for_compilation ();
2461 if (! DECL_DEFER_OUTPUT (decl))
2462 TREE_ASM_WRITTEN (decl) = 1;
2464 /* Now that integrate will no longer see our rtl, we need not
2465 distinguish between the return value of this function and the
2466 return value of called functions. Also, we can remove all SETs
2467 of subregs of hard registers; they are only here because of
2468 integrate. Also, we can now initialize pseudos intended to
2469 carry magic hard reg data throughout the function. */
2470 rtx_equal_function_value_matters = 0;
2471 purge_hard_subreg_sets (get_insns ());
2473 /* Early return if there were errors. We can run afoul of our
2474 consistency checks, and there's not really much point in fixing them.
2475 Don't return yet if -Wreturn-type; we need to do cleanup_cfg. */
2476 if (((rtl_dump_and_exit || flag_syntax_only) && !warn_return_type)
2477 || errorcount || sorrycount)
2478 goto exit_rest_of_compilation;
2480 /* We may have potential sibling or tail recursion sites. Select one
2481 (of possibly multiple) methods of performing the call. */
2482 if (flag_optimize_sibling_calls)
2484 timevar_push (TV_JUMP);
2485 open_dump_file (DFI_sibling, decl);
2487 optimize_sibling_and_tail_recursive_calls ();
2489 close_dump_file (DFI_sibling, print_rtl, get_insns ());
2490 timevar_pop (TV_JUMP);
2493 /* Complete generation of exception handling code. */
2494 find_exception_handler_labels ();
2495 if (doing_eh (0))
2497 timevar_push (TV_JUMP);
2498 open_dump_file (DFI_eh, decl);
2500 finish_eh_generation ();
2502 close_dump_file (DFI_eh, print_rtl, get_insns ());
2503 timevar_pop (TV_JUMP);
2506 /* Delay emitting hard_reg_initial_value sets until after EH landing pad
2507 generation, which might create new sets. */
2508 emit_initial_value_sets ();
2510 #ifdef FINALIZE_PIC
2511 /* If we are doing position-independent code generation, now
2512 is the time to output special prologues and epilogues.
2513 We do not want to do this earlier, because it just clutters
2514 up inline functions with meaningless insns. */
2515 if (flag_pic)
2516 FINALIZE_PIC;
2517 #endif
2519 insns = get_insns ();
2521 /* Copy any shared structure that should not be shared. */
2522 unshare_all_rtl (current_function_decl, insns);
2524 #ifdef SETJMP_VIA_SAVE_AREA
2525 /* This must be performed before virtual register instantiation. */
2526 if (current_function_calls_alloca)
2527 optimize_save_area_alloca (insns);
2528 #endif
2530 /* Instantiate all virtual registers. */
2531 instantiate_virtual_regs (current_function_decl, insns);
2533 open_dump_file (DFI_jump, decl);
2535 /* Always do one jump optimization pass to ensure that JUMP_LABEL fields
2536 are initialized and to compute whether control can drop off the end
2537 of the function. */
2539 timevar_push (TV_JUMP);
2540 /* Turn NOTE_INSN_EXPECTED_VALUE into REG_BR_PROB. Do this
2541 before jump optimization switches branch directions. */
2542 expected_value_to_br_prob ();
2544 reg_scan (insns, max_reg_num (), 0);
2545 rebuild_jump_labels (insns);
2546 find_basic_blocks (insns, max_reg_num (), rtl_dump_file);
2547 if (rtl_dump_file)
2548 dump_flow_info (rtl_dump_file);
2549 cleanup_cfg ((optimize ? CLEANUP_EXPENSIVE : 0) | CLEANUP_PRE_LOOP
2550 | (flag_thread_jumps ? CLEANUP_THREADING : 0));
2552 /* CFG is no longer maintained up-to-date. */
2553 free_bb_for_insn ();
2554 copy_loop_headers (insns);
2555 purge_line_number_notes (insns);
2557 timevar_pop (TV_JUMP);
2558 close_dump_file (DFI_jump, print_rtl, insns);
2560 /* Now is when we stop if -fsyntax-only and -Wreturn-type. */
2561 if (rtl_dump_and_exit || flag_syntax_only || DECL_DEFER_OUTPUT (decl))
2563 goto exit_rest_of_compilation;
2566 /* Long term, this should probably move before the jump optimizer too,
2567 but I didn't want to disturb the rtl_dump_and_exit and related
2568 stuff at this time. */
2569 if (optimize > 0 && flag_ssa)
2571 /* Convert to SSA form. */
2573 timevar_push (TV_TO_SSA);
2574 open_dump_file (DFI_ssa, decl);
2576 find_basic_blocks (insns, max_reg_num (), rtl_dump_file);
2577 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2578 convert_to_ssa ();
2580 close_dump_file (DFI_ssa, print_rtl_with_bb, insns);
2581 timevar_pop (TV_TO_SSA);
2583 /* Perform sparse conditional constant propagation, if requested. */
2584 if (flag_ssa_ccp)
2586 timevar_push (TV_SSA_CCP);
2587 open_dump_file (DFI_ssa_ccp, decl);
2589 ssa_const_prop ();
2591 close_dump_file (DFI_ssa_ccp, print_rtl_with_bb, get_insns ());
2592 timevar_pop (TV_SSA_CCP);
2595 /* It would be useful to cleanup the CFG at this point, but block
2596 merging and possibly other transformations might leave a PHI
2597 node in the middle of a basic block, which is a strict no-no. */
2599 /* The SSA implementation uses basic block numbers in its phi
2600 nodes. Thus, changing the control-flow graph or the basic
2601 blocks, e.g., calling find_basic_blocks () or cleanup_cfg (),
2602 may cause problems. */
2604 if (flag_ssa_dce)
2606 /* Remove dead code. */
2608 timevar_push (TV_SSA_DCE);
2609 open_dump_file (DFI_ssa_dce, decl);
2611 insns = get_insns ();
2612 ssa_eliminate_dead_code();
2614 close_dump_file (DFI_ssa_dce, print_rtl_with_bb, insns);
2615 timevar_pop (TV_SSA_DCE);
2618 /* Convert from SSA form. */
2620 timevar_push (TV_FROM_SSA);
2621 open_dump_file (DFI_ussa, decl);
2623 convert_from_ssa ();
2624 /* New registers have been created. Rescan their usage. */
2625 reg_scan (insns, max_reg_num (), 1);
2627 close_dump_file (DFI_ussa, print_rtl_with_bb, insns);
2628 timevar_pop (TV_FROM_SSA);
2630 ggc_collect ();
2631 /* CFG is no longer maintained up-to-date. */
2632 free_bb_for_insn ();
2635 timevar_push (TV_JUMP);
2637 if (optimize > 0)
2639 open_dump_file (DFI_null, decl);
2640 find_basic_blocks (insns, max_reg_num (), rtl_dump_file);
2641 if (rtl_dump_file)
2642 dump_flow_info (rtl_dump_file);
2643 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2645 /* Try to identify useless null pointer tests and delete them. */
2646 if (flag_delete_null_pointer_checks)
2647 delete_null_pointer_checks (insns);
2649 timevar_push (TV_IFCVT);
2650 if_convert (0);
2651 timevar_pop (TV_IFCVT);
2652 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2653 close_dump_file (DFI_null, print_rtl_with_bb, insns);
2656 /* Jump optimization, and the removal of NULL pointer checks, may
2657 have reduced the number of instructions substantially. CSE, and
2658 future passes, allocate arrays whose dimensions involve the
2659 maximum instruction UID, so if we can reduce the maximum UID
2660 we'll save big on memory. */
2661 renumber_insns (rtl_dump_file);
2662 if (optimize)
2663 compute_bb_for_insn (get_max_uid ());
2664 timevar_pop (TV_JUMP);
2666 close_dump_file (DFI_jump, print_rtl_with_bb, insns);
2668 ggc_collect ();
2670 /* Perform common subexpression elimination.
2671 Nonzero value from `cse_main' means that jumps were simplified
2672 and some code may now be unreachable, so do
2673 jump optimization again. */
2675 if (optimize > 0)
2677 open_dump_file (DFI_cse, decl);
2678 if (rtl_dump_file)
2679 dump_flow_info (rtl_dump_file);
2680 timevar_push (TV_CSE);
2682 reg_scan (insns, max_reg_num (), 1);
2684 tem = cse_main (insns, max_reg_num (), 0, rtl_dump_file);
2685 if (tem)
2686 rebuild_jump_labels (insns);
2687 purge_all_dead_edges (0);
2689 delete_trivially_dead_insns (insns, max_reg_num ());
2691 /* If we are not running more CSE passes, then we are no longer
2692 expecting CSE to be run. But always rerun it in a cheap mode. */
2693 cse_not_expected = !flag_rerun_cse_after_loop && !flag_gcse;
2695 if (tem || optimize > 1)
2696 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2697 /* Try to identify useless null pointer tests and delete them. */
2698 if (flag_delete_null_pointer_checks || flag_thread_jumps)
2700 timevar_push (TV_JUMP);
2702 if (flag_delete_null_pointer_checks)
2703 delete_null_pointer_checks (insns);
2704 /* CFG is no longer maintained up-to-date. */
2705 timevar_pop (TV_JUMP);
2708 /* The second pass of jump optimization is likely to have
2709 removed a bunch more instructions. */
2710 renumber_insns (rtl_dump_file);
2711 compute_bb_for_insn (get_max_uid ());
2713 timevar_pop (TV_CSE);
2714 close_dump_file (DFI_cse, print_rtl_with_bb, insns);
2717 open_dump_file (DFI_addressof, decl);
2719 purge_addressof (insns);
2720 if (optimize)
2721 purge_all_dead_edges (0);
2722 reg_scan (insns, max_reg_num (), 1);
2724 close_dump_file (DFI_addressof, print_rtl, insns);
2726 ggc_collect ();
2728 /* Perform global cse. */
2730 if (optimize > 0 && flag_gcse)
2732 int save_csb, save_cfj;
2733 int tem2 = 0;
2735 timevar_push (TV_GCSE);
2736 open_dump_file (DFI_gcse, decl);
2738 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2739 tem = gcse_main (insns, rtl_dump_file);
2740 rebuild_jump_labels (insns);
2741 delete_trivially_dead_insns (insns, max_reg_num ());
2743 save_csb = flag_cse_skip_blocks;
2744 save_cfj = flag_cse_follow_jumps;
2745 flag_cse_skip_blocks = flag_cse_follow_jumps = 0;
2747 /* If -fexpensive-optimizations, re-run CSE to clean up things done
2748 by gcse. */
2749 if (flag_expensive_optimizations)
2751 timevar_push (TV_CSE);
2752 reg_scan (insns, max_reg_num (), 1);
2753 tem2 = cse_main (insns, max_reg_num (), 0, rtl_dump_file);
2754 purge_all_dead_edges (0);
2755 delete_trivially_dead_insns (insns, max_reg_num ());
2756 timevar_pop (TV_CSE);
2757 cse_not_expected = !flag_rerun_cse_after_loop;
2760 /* If gcse or cse altered any jumps, rerun jump optimizations to clean
2761 things up. Then possibly re-run CSE again. */
2762 while (tem || tem2)
2764 tem = tem2 = 0;
2765 timevar_push (TV_JUMP);
2766 rebuild_jump_labels (insns);
2767 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2768 timevar_pop (TV_JUMP);
2770 if (flag_expensive_optimizations)
2772 timevar_push (TV_CSE);
2773 reg_scan (insns, max_reg_num (), 1);
2774 tem2 = cse_main (insns, max_reg_num (), 0, rtl_dump_file);
2775 purge_all_dead_edges (0);
2776 delete_trivially_dead_insns (insns, max_reg_num ());
2777 timevar_pop (TV_CSE);
2781 close_dump_file (DFI_gcse, print_rtl_with_bb, insns);
2782 timevar_pop (TV_GCSE);
2784 ggc_collect ();
2785 flag_cse_skip_blocks = save_csb;
2786 flag_cse_follow_jumps = save_cfj;
2787 #ifdef ENABLE_CHECKING
2788 verify_flow_info ();
2789 #endif
2792 /* Move constant computations out of loops. */
2794 if (optimize > 0 && flag_loop_optimize)
2796 timevar_push (TV_LOOP);
2797 delete_dead_jumptables ();
2798 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_PRE_LOOP);
2799 open_dump_file (DFI_loop, decl);
2800 /* CFG is no longer maintained up-to-date. */
2801 free_bb_for_insn ();
2803 if (flag_rerun_loop_opt)
2805 cleanup_barriers ();
2807 /* We only want to perform unrolling once. */
2809 loop_optimize (insns, rtl_dump_file, 0);
2811 /* The first call to loop_optimize makes some instructions
2812 trivially dead. We delete those instructions now in the
2813 hope that doing so will make the heuristics in loop work
2814 better and possibly speed up compilation. */
2815 delete_trivially_dead_insns (insns, max_reg_num ());
2817 /* The regscan pass is currently necessary as the alias
2818 analysis code depends on this information. */
2819 reg_scan (insns, max_reg_num (), 1);
2821 cleanup_barriers ();
2822 loop_optimize (insns, rtl_dump_file,
2823 (flag_unroll_loops ? LOOP_UNROLL : 0) | LOOP_BCT
2824 | (flag_prefetch_loop_arrays ? LOOP_PREFETCH : 0));
2826 /* Loop can create trivially dead instructions. */
2827 delete_trivially_dead_insns (insns, max_reg_num ());
2828 close_dump_file (DFI_loop, print_rtl, insns);
2829 timevar_pop (TV_LOOP);
2831 ggc_collect ();
2834 /* Do control and data flow analysis; wrote some of the results to
2835 the dump file. */
2837 timevar_push (TV_FLOW);
2838 open_dump_file (DFI_cfg, decl);
2840 find_basic_blocks (insns, max_reg_num (), rtl_dump_file);
2841 if (rtl_dump_file)
2842 dump_flow_info (rtl_dump_file);
2843 cleanup_cfg ((optimize ? CLEANUP_EXPENSIVE : 0)
2844 | (flag_thread_jumps ? CLEANUP_THREADING : 0));
2846 /* It may make more sense to mark constant functions after dead code is
2847 eliminated by life_analyzis, but we need to do it early, as -fprofile-arcs
2848 may insert code making function non-constant, but we still must consider
2849 it as constant, otherwise -fbranch-probabilities will not read data back.
2851 life_analyzis rarely eliminates modification of external memory.
2853 if (optimize)
2854 mark_constant_function ();
2856 close_dump_file (DFI_cfg, print_rtl_with_bb, insns);
2858 /* Do branch profiling and static profile estimation passes. */
2859 if (optimize > 0 || profile_arc_flag || flag_test_coverage
2860 || flag_branch_probabilities)
2862 struct loops loops;
2864 timevar_push (TV_BRANCH_PROB);
2865 open_dump_file (DFI_bp, decl);
2866 if (profile_arc_flag || flag_test_coverage || flag_branch_probabilities)
2867 branch_prob ();
2869 /* Discover and record the loop depth at the head of each basic
2870 block. The loop infrastructure does the real job for us. */
2871 flow_loops_find (&loops, LOOP_TREE);
2873 /* Estimate using heuristics if no profiling info is available. */
2874 if (flag_guess_branch_prob)
2875 estimate_probability (&loops);
2877 if (rtl_dump_file)
2878 flow_loops_dump (&loops, rtl_dump_file, NULL, 0);
2880 flow_loops_free (&loops);
2881 close_dump_file (DFI_bp, print_rtl_with_bb, insns);
2882 timevar_pop (TV_BRANCH_PROB);
2885 if (optimize > 0)
2887 timevar_push (TV_CSE2);
2888 open_dump_file (DFI_cse2, decl);
2889 if (rtl_dump_file)
2890 dump_flow_info (rtl_dump_file);
2892 if (flag_rerun_cse_after_loop)
2894 timevar_push (TV_JUMP);
2896 reg_scan (insns, max_reg_num (), 0);
2898 timevar_push (TV_IFCVT);
2899 cleanup_cfg (CLEANUP_EXPENSIVE);
2900 if_convert (0);
2901 timevar_pop(TV_IFCVT);
2903 timevar_pop (TV_JUMP);
2904 /* CFG is no longer maintained up-to-date. */
2905 reg_scan (insns, max_reg_num (), 0);
2906 tem = cse_main (insns, max_reg_num (), 1, rtl_dump_file);
2907 purge_all_dead_edges (0);
2908 delete_trivially_dead_insns (insns, max_reg_num ());
2910 if (tem)
2912 timevar_push (TV_JUMP);
2913 rebuild_jump_labels (insns);
2914 cleanup_cfg (CLEANUP_EXPENSIVE);
2915 timevar_pop (TV_JUMP);
2919 close_dump_file (DFI_cse2, print_rtl_with_bb, insns);
2920 timevar_pop (TV_CSE2);
2922 ggc_collect ();
2925 cse_not_expected = 1;
2927 open_dump_file (DFI_life, decl);
2928 regclass_init ();
2930 check_function_return_warnings ();
2932 #ifdef ENABLE_CHECKING
2933 verify_flow_info ();
2934 #endif
2935 life_analysis (insns, rtl_dump_file, PROP_FINAL);
2936 if (optimize)
2937 cleanup_cfg ((optimize ? CLEANUP_EXPENSIVE : 0) | CLEANUP_UPDATE_LIFE
2938 | (flag_thread_jumps ? CLEANUP_THREADING : 0));
2939 timevar_pop (TV_FLOW);
2941 no_new_pseudos = 1;
2943 if (warn_uninitialized || extra_warnings)
2945 uninitialized_vars_warning (DECL_INITIAL (decl));
2946 if (extra_warnings)
2947 setjmp_args_warning ();
2950 if (optimize)
2952 clear_bb_flags ();
2953 if (initialize_uninitialized_subregs ())
2955 /* Insns were inserted, so things might look a bit different. */
2956 insns = get_insns ();
2957 update_life_info_in_dirty_blocks (UPDATE_LIFE_GLOBAL_RM_NOTES,
2958 PROP_LOG_LINKS | PROP_REG_INFO
2959 | PROP_DEATH_NOTES);
2963 close_dump_file (DFI_life, print_rtl_with_bb, insns);
2965 ggc_collect ();
2967 /* If -opt, try combining insns through substitution. */
2969 if (optimize > 0)
2971 int rebuild_jump_labels_after_combine = 0;
2973 timevar_push (TV_COMBINE);
2974 open_dump_file (DFI_combine, decl);
2976 rebuild_jump_labels_after_combine
2977 = combine_instructions (insns, max_reg_num ());
2979 /* Combining insns may have turned an indirect jump into a
2980 direct jump. Rebuid the JUMP_LABEL fields of jumping
2981 instructions. */
2982 if (rebuild_jump_labels_after_combine)
2984 timevar_push (TV_JUMP);
2985 rebuild_jump_labels (insns);
2986 timevar_pop (TV_JUMP);
2988 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_UPDATE_LIFE);
2991 close_dump_file (DFI_combine, print_rtl_with_bb, insns);
2992 timevar_pop (TV_COMBINE);
2994 ggc_collect ();
2997 /* Rerun if-conversion, as combine may have simplified things enough to
2998 now meet sequence length restrictions. */
2999 if (optimize > 0)
3001 timevar_push (TV_IFCVT);
3002 open_dump_file (DFI_ce, decl);
3004 no_new_pseudos = 0;
3005 if_convert (1);
3006 no_new_pseudos = 1;
3008 close_dump_file (DFI_ce, print_rtl_with_bb, insns);
3009 timevar_pop (TV_IFCVT);
3012 /* Register allocation pre-pass, to reduce number of moves
3013 necessary for two-address machines. */
3014 if (optimize > 0 && (flag_regmove || flag_expensive_optimizations))
3016 timevar_push (TV_REGMOVE);
3017 open_dump_file (DFI_regmove, decl);
3019 regmove_optimize (insns, max_reg_num (), rtl_dump_file);
3021 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_UPDATE_LIFE);
3022 close_dump_file (DFI_regmove, print_rtl_with_bb, insns);
3023 timevar_pop (TV_REGMOVE);
3025 ggc_collect ();
3028 /* Do unconditional splitting before register allocation to allow machine
3029 description to add extra information not needed previously. */
3030 split_all_insns (1);
3032 /* Any of the several passes since flow1 will have munged register
3033 lifetime data a bit. */
3034 register_life_up_to_date = 0;
3036 #ifdef OPTIMIZE_MODE_SWITCHING
3037 timevar_push (TV_MODE_SWITCH);
3039 no_new_pseudos = 0;
3040 optimize_mode_switching (NULL);
3041 no_new_pseudos = 1;
3043 timevar_pop (TV_MODE_SWITCH);
3044 #endif
3046 timevar_push (TV_SCHED);
3048 #ifdef INSN_SCHEDULING
3050 /* Print function header into sched dump now
3051 because doing the sched analysis makes some of the dump. */
3052 if (optimize > 0 && flag_schedule_insns)
3054 open_dump_file (DFI_sched, decl);
3056 /* Do control and data sched analysis,
3057 and write some of the results to dump file. */
3059 schedule_insns (rtl_dump_file);
3061 close_dump_file (DFI_sched, print_rtl_with_bb, insns);
3063 /* Register lifetime information was updated as part of verifying
3064 the schedule. */
3065 register_life_up_to_date = 1;
3067 #endif
3068 timevar_pop (TV_SCHED);
3070 ggc_collect ();
3072 /* Determine if the current function is a leaf before running reload
3073 since this can impact optimizations done by the prologue and
3074 epilogue thus changing register elimination offsets. */
3075 current_function_is_leaf = leaf_function_p ();
3077 timevar_push (TV_LOCAL_ALLOC);
3078 open_dump_file (DFI_lreg, decl);
3080 /* Allocate pseudo-regs that are used only within 1 basic block.
3082 RUN_JUMP_AFTER_RELOAD records whether or not we need to rerun the
3083 jump optimizer after register allocation and reloading are finished. */
3085 if (! register_life_up_to_date)
3086 recompute_reg_usage (insns, ! optimize_size);
3088 /* Allocate the reg_renumber array. */
3089 allocate_reg_info (max_regno, FALSE, TRUE);
3091 /* And the reg_equiv_memory_loc array. */
3092 reg_equiv_memory_loc = (rtx *) xcalloc (max_regno, sizeof (rtx));
3094 allocate_initial_values (reg_equiv_memory_loc);
3096 regclass (insns, max_reg_num (), rtl_dump_file);
3097 rebuild_label_notes_after_reload = local_alloc ();
3099 timevar_pop (TV_LOCAL_ALLOC);
3101 if (dump_file[DFI_lreg].enabled)
3103 timevar_push (TV_DUMP);
3105 dump_flow_info (rtl_dump_file);
3106 dump_local_alloc (rtl_dump_file);
3108 close_dump_file (DFI_lreg, print_rtl_with_bb, insns);
3109 timevar_pop (TV_DUMP);
3112 ggc_collect ();
3114 timevar_push (TV_GLOBAL_ALLOC);
3115 open_dump_file (DFI_greg, decl);
3117 /* If optimizing, allocate remaining pseudo-regs. Do the reload
3118 pass fixing up any insns that are invalid. */
3120 if (optimize)
3121 failure = global_alloc (rtl_dump_file);
3122 else
3124 build_insn_chain (insns);
3125 failure = reload (insns, 0);
3128 timevar_pop (TV_GLOBAL_ALLOC);
3130 if (dump_file[DFI_greg].enabled)
3132 timevar_push (TV_DUMP);
3134 dump_global_regs (rtl_dump_file);
3136 close_dump_file (DFI_greg, print_rtl_with_bb, insns);
3137 timevar_pop (TV_DUMP);
3140 if (failure)
3141 goto exit_rest_of_compilation;
3143 ggc_collect ();
3145 open_dump_file (DFI_postreload, decl);
3147 /* Do a very simple CSE pass over just the hard registers. */
3148 if (optimize > 0)
3150 timevar_push (TV_RELOAD_CSE_REGS);
3151 reload_cse_regs (insns);
3152 timevar_pop (TV_RELOAD_CSE_REGS);
3155 /* Register allocation and reloading may have turned an indirect jump into
3156 a direct jump. If so, we must rebuild the JUMP_LABEL fields of
3157 jumping instructions. */
3158 if (rebuild_label_notes_after_reload)
3160 timevar_push (TV_JUMP);
3162 rebuild_jump_labels (insns);
3163 purge_all_dead_edges (0);
3165 timevar_pop (TV_JUMP);
3168 close_dump_file (DFI_postreload, print_rtl_with_bb, insns);
3170 /* Re-create the death notes which were deleted during reload. */
3171 timevar_push (TV_FLOW2);
3172 open_dump_file (DFI_flow2, decl);
3174 #ifdef ENABLE_CHECKING
3175 verify_flow_info ();
3176 #endif
3178 /* If optimizing, then go ahead and split insns now. */
3179 if (optimize > 0)
3180 split_all_insns (0);
3182 cleanup_cfg (optimize ? CLEANUP_EXPENSIVE : 0);
3184 /* On some machines, the prologue and epilogue code, or parts thereof,
3185 can be represented as RTL. Doing so lets us schedule insns between
3186 it and the rest of the code and also allows delayed branch
3187 scheduling to operate in the epilogue. */
3188 thread_prologue_and_epilogue_insns (insns);
3190 if (optimize)
3192 life_analysis (insns, rtl_dump_file, PROP_FINAL);
3193 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_UPDATE_LIFE
3194 | (flag_crossjumping ? CLEANUP_CROSSJUMP : 0));
3196 /* This is kind of a heuristic. We need to run combine_stack_adjustments
3197 even for machines with possibly nonzero RETURN_POPS_ARGS
3198 and ACCUMULATE_OUTGOING_ARGS. We expect that only ports having
3199 push instructions will have popping returns. */
3200 #ifndef PUSH_ROUNDING
3201 if (!ACCUMULATE_OUTGOING_ARGS)
3202 #endif
3203 combine_stack_adjustments ();
3205 ggc_collect ();
3208 flow2_completed = 1;
3210 close_dump_file (DFI_flow2, print_rtl_with_bb, insns);
3211 timevar_pop (TV_FLOW2);
3213 #ifdef HAVE_peephole2
3214 if (optimize > 0 && flag_peephole2)
3216 timevar_push (TV_PEEPHOLE2);
3217 open_dump_file (DFI_peephole2, decl);
3219 peephole2_optimize (rtl_dump_file);
3221 close_dump_file (DFI_peephole2, print_rtl_with_bb, insns);
3222 timevar_pop (TV_PEEPHOLE2);
3224 #endif
3226 if (flag_rename_registers || flag_cprop_registers)
3228 timevar_push (TV_RENAME_REGISTERS);
3229 open_dump_file (DFI_rnreg, decl);
3231 if (flag_rename_registers)
3232 regrename_optimize ();
3233 if (flag_cprop_registers)
3234 copyprop_hardreg_forward ();
3236 close_dump_file (DFI_rnreg, print_rtl_with_bb, insns);
3237 timevar_pop (TV_RENAME_REGISTERS);
3240 if (optimize > 0)
3242 timevar_push (TV_IFCVT2);
3243 open_dump_file (DFI_ce2, decl);
3245 if_convert (1);
3247 close_dump_file (DFI_ce2, print_rtl_with_bb, insns);
3248 timevar_pop (TV_IFCVT2);
3250 #ifdef STACK_REGS
3251 if (optimize)
3252 split_all_insns (1);
3253 #endif
3255 #ifdef INSN_SCHEDULING
3256 if (optimize > 0 && flag_schedule_insns_after_reload)
3258 timevar_push (TV_SCHED2);
3259 open_dump_file (DFI_sched2, decl);
3261 /* Do control and data sched analysis again,
3262 and write some more of the results to dump file. */
3264 split_all_insns (1);
3266 schedule_insns (rtl_dump_file);
3268 close_dump_file (DFI_sched2, print_rtl_with_bb, insns);
3269 timevar_pop (TV_SCHED2);
3271 ggc_collect ();
3273 #endif
3275 #ifdef LEAF_REGISTERS
3276 current_function_uses_only_leaf_regs
3277 = optimize > 0 && only_leaf_regs_used () && leaf_function_p ();
3278 #endif
3280 #ifdef STACK_REGS
3281 timevar_push (TV_REG_STACK);
3282 open_dump_file (DFI_stack, decl);
3284 reg_to_stack (insns, rtl_dump_file);
3286 close_dump_file (DFI_stack, print_rtl_with_bb, insns);
3287 timevar_pop (TV_REG_STACK);
3289 ggc_collect ();
3290 #endif
3291 if (optimize > 0)
3293 timevar_push (TV_REORDER_BLOCKS);
3294 open_dump_file (DFI_bbro, decl);
3296 /* Last attempt to optimize CFG, as scheduling, peepholing
3297 and insn splitting possibly introduced more crossjumping
3298 oppurtuntities. */
3299 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_POST_REGSTACK
3300 | (flag_crossjumping ? CLEANUP_CROSSJUMP : 0));
3301 if (flag_reorder_blocks)
3303 reorder_basic_blocks ();
3304 cleanup_cfg (CLEANUP_EXPENSIVE | CLEANUP_POST_REGSTACK);
3307 close_dump_file (DFI_bbro, print_rtl_with_bb, insns);
3308 timevar_pop (TV_REORDER_BLOCKS);
3310 compute_alignments ();
3312 /* CFG is no longer maintained up-to-date. */
3313 free_bb_for_insn ();
3315 /* If a machine dependent reorganization is needed, call it. */
3316 #ifdef MACHINE_DEPENDENT_REORG
3317 timevar_push (TV_MACH_DEP);
3318 open_dump_file (DFI_mach, decl);
3320 MACHINE_DEPENDENT_REORG (insns);
3322 close_dump_file (DFI_mach, print_rtl, insns);
3323 timevar_pop (TV_MACH_DEP);
3325 ggc_collect ();
3326 #endif
3328 purge_line_number_notes (insns);
3329 cleanup_barriers ();
3331 /* If a scheduling pass for delayed branches is to be done,
3332 call the scheduling code. */
3334 #ifdef DELAY_SLOTS
3335 if (optimize > 0 && flag_delayed_branch)
3337 timevar_push (TV_DBR_SCHED);
3338 open_dump_file (DFI_dbr, decl);
3340 dbr_schedule (insns, rtl_dump_file);
3342 close_dump_file (DFI_dbr, print_rtl, insns);
3343 timevar_pop (TV_DBR_SCHED);
3345 ggc_collect ();
3347 #endif
3349 #if defined (HAVE_ATTR_length) && !defined (STACK_REGS)
3350 timevar_push (TV_SHORTEN_BRANCH);
3351 split_all_insns_noflow ();
3352 timevar_pop (TV_SHORTEN_BRANCH);
3353 #endif
3355 convert_to_eh_region_ranges ();
3357 /* Shorten branches. */
3358 timevar_push (TV_SHORTEN_BRANCH);
3359 shorten_branches (get_insns ());
3360 timevar_pop (TV_SHORTEN_BRANCH);
3362 current_function_nothrow = nothrow_function_p ();
3363 if (current_function_nothrow)
3364 /* Now we know that this can't throw; set the flag for the benefit
3365 of other functions later in this translation unit. */
3366 TREE_NOTHROW (current_function_decl) = 1;
3368 /* Now turn the rtl into assembler code. */
3370 timevar_push (TV_FINAL);
3372 rtx x;
3373 const char *fnname;
3375 /* Get the function's name, as described by its RTL. This may be
3376 different from the DECL_NAME name used in the source file. */
3378 x = DECL_RTL (decl);
3379 if (GET_CODE (x) != MEM)
3380 abort ();
3381 x = XEXP (x, 0);
3382 if (GET_CODE (x) != SYMBOL_REF)
3383 abort ();
3384 fnname = XSTR (x, 0);
3386 assemble_start_function (decl, fnname);
3387 final_start_function (insns, asm_out_file, optimize);
3388 final (insns, asm_out_file, optimize, 0);
3389 final_end_function ();
3391 #ifdef IA64_UNWIND_INFO
3392 /* ??? The IA-64 ".handlerdata" directive must be issued before
3393 the ".endp" directive that closes the procedure descriptor. */
3394 output_function_exception_table ();
3395 #endif
3397 assemble_end_function (decl, fnname);
3399 #ifndef IA64_UNWIND_INFO
3400 /* Otherwise, it feels unclean to switch sections in the middle. */
3401 output_function_exception_table ();
3402 #endif
3404 if (! quiet_flag)
3405 fflush (asm_out_file);
3407 /* Release all memory allocated by flow. */
3408 free_basic_block_vars (0);
3410 /* Release all memory held by regsets now. */
3411 regset_release_memory ();
3413 timevar_pop (TV_FINAL);
3415 ggc_collect ();
3417 /* Write DBX symbols if requested. */
3419 /* Note that for those inline functions where we don't initially
3420 know for certain that we will be generating an out-of-line copy,
3421 the first invocation of this routine (rest_of_compilation) will
3422 skip over this code by doing a `goto exit_rest_of_compilation;'.
3423 Later on, finish_compilation will call rest_of_compilation again
3424 for those inline functions that need to have out-of-line copies
3425 generated. During that call, we *will* be routed past here. */
3427 timevar_push (TV_SYMOUT);
3428 (*debug_hooks->function_decl) (decl);
3429 timevar_pop (TV_SYMOUT);
3431 exit_rest_of_compilation:
3433 /* In case the function was not output,
3434 don't leave any temporary anonymous types
3435 queued up for sdb output. */
3436 #ifdef SDB_DEBUGGING_INFO
3437 if (write_symbols == SDB_DEBUG)
3438 sdbout_types (NULL_TREE);
3439 #endif
3441 reload_completed = 0;
3442 flow2_completed = 0;
3443 no_new_pseudos = 0;
3445 timevar_push (TV_FINAL);
3447 /* Clear out the insn_length contents now that they are no
3448 longer valid. */
3449 init_insn_lengths ();
3451 /* Clear out the real_constant_chain before some of the rtx's
3452 it runs through become garbage. */
3453 clear_const_double_mem ();
3455 /* Show no temporary slots allocated. */
3456 init_temp_slots ();
3458 free_basic_block_vars (0);
3459 free_bb_for_insn ();
3461 timevar_pop (TV_FINAL);
3463 /* Make sure volatile mem refs aren't considered valid operands for
3464 arithmetic insns. We must call this here if this is a nested inline
3465 function, since the above code leaves us in the init_recog state
3466 (from final.c), and the function context push/pop code does not
3467 save/restore volatile_ok.
3469 ??? Maybe it isn't necessary for expand_start_function to call this
3470 anymore if we do it here? */
3472 init_recog_no_volatile ();
3474 /* We're done with this function. Free up memory if we can. */
3475 free_after_parsing (cfun);
3476 if (! DECL_DEFER_OUTPUT (decl))
3478 free_after_compilation (cfun);
3480 /* Clear integrate.c's pointer to the cfun structure we just
3481 destroyed. */
3482 DECL_SAVED_INSNS (decl) = 0;
3484 cfun = 0;
3486 ggc_collect ();
3488 timevar_pop (TV_REST_OF_COMPILATION);
3491 static void
3492 display_help ()
3494 int undoc;
3495 unsigned long i;
3496 const char *lang;
3498 printf (_(" -ffixed-<register> Mark <register> as being unavailable to the compiler\n"));
3499 printf (_(" -fcall-used-<register> Mark <register> as being corrupted by function calls\n"));
3500 printf (_(" -fcall-saved-<register> Mark <register> as being preserved across functions\n"));
3501 printf (_(" -finline-limit=<number> Limits the size of inlined functions to <number>\n"));
3502 printf (_(" -fmessage-length=<number> Limits diagnostics messages lengths to <number> characters per line. 0 suppresses line-wrapping\n"));
3503 printf (_(" -fdiagnostics-show-location=[once | every-line] Indicates how often source location information should be emitted, as prefix, at the beginning of diagnostics when line-wrapping\n"));
3505 for (i = ARRAY_SIZE (f_options); i--;)
3507 const char *description = f_options[i].description;
3509 if (description != NULL && * description != 0)
3510 printf (" -f%-21s %s\n",
3511 f_options[i].string, _(description));
3514 printf (_(" -O[number] Set optimization level to [number]\n"));
3515 printf (_(" -Os Optimize for space rather than speed\n"));
3516 for (i = LAST_PARAM; i--;)
3518 const char *description = compiler_params[i].help;
3519 const int length = 21-strlen(compiler_params[i].option);
3521 if (description != NULL && * description != 0)
3522 printf (" --param %s=<value>%.*s%s\n",
3523 compiler_params[i].option,
3524 length > 0 ? length : 1, " ",
3525 _(description));
3527 printf (_(" -pedantic Issue warnings needed by strict compliance to ISO C\n"));
3528 printf (_(" -pedantic-errors Like -pedantic except that errors are produced\n"));
3529 printf (_(" -w Suppress warnings\n"));
3530 printf (_(" -W Enable extra warnings\n"));
3532 for (i = ARRAY_SIZE (W_options); i--;)
3534 const char *description = W_options[i].description;
3536 if (description != NULL && * description != 0)
3537 printf (" -W%-21s %s\n",
3538 W_options[i].string, _(description));
3541 printf (_(" -Wunused Enable unused warnings\n"));
3542 printf (_(" -Wlarger-than-<number> Warn if an object is larger than <number> bytes\n"));
3543 printf (_(" -p Enable function profiling\n"));
3544 #if defined (BLOCK_PROFILER) || defined (FUNCTION_BLOCK_PROFILER)
3545 printf (_(" -a Enable block profiling \n"));
3546 #endif
3547 #if defined (BLOCK_PROFILER) || defined (FUNCTION_BLOCK_PROFILER) || defined FUNCTION_BLOCK_PROFILER_EXIT
3548 printf (_(" -ax Enable jump profiling \n"));
3549 #endif
3550 printf (_(" -o <file> Place output into <file> \n"));
3551 printf (_("\
3552 -G <number> Put global and static data smaller than <number>\n\
3553 bytes into a special section (on some targets)\n"));
3555 for (i = ARRAY_SIZE (debug_args); i--;)
3557 if (debug_args[i].description != NULL)
3558 printf (" -g%-21s %s\n",
3559 debug_args[i].arg, _(debug_args[i].description));
3562 printf (_(" -aux-info <file> Emit declaration info into <file>\n"));
3563 printf (_(" -quiet Do not display functions compiled or elapsed time\n"));
3564 printf (_(" -version Display the compiler's version\n"));
3565 printf (_(" -d[letters] Enable dumps from specific passes of the compiler\n"));
3566 printf (_(" -dumpbase <file> Base name to be used for dumps from specific passes\n"));
3567 #if defined INSN_SCHEDULING
3568 printf (_(" -fsched-verbose=<number> Set the verbosity level of the scheduler\n"));
3569 #endif
3570 printf (_(" --help Display this information\n"));
3572 undoc = 0;
3573 lang = "language";
3575 /* Display descriptions of language specific options.
3576 If there is no description, note that there is an undocumented option.
3577 If the description is empty, do not display anything. (This allows
3578 options to be deliberately undocumented, for whatever reason).
3579 If the option string is missing, then this is a marker, indicating
3580 that the description string is in fact the name of a language, whose
3581 language specific options are to follow. */
3583 if (ARRAY_SIZE (documented_lang_options) > 1)
3585 printf (_("\nLanguage specific options:\n"));
3587 for (i = 0; i < ARRAY_SIZE (documented_lang_options); i++)
3589 const char *description = documented_lang_options[i].description;
3590 const char *option = documented_lang_options[i].option;
3592 if (description == NULL)
3594 undoc = 1;
3596 if (extra_warnings)
3597 printf (_(" %-23.23s [undocumented]\n"), option);
3599 else if (*description == 0)
3600 continue;
3601 else if (option == NULL)
3603 if (undoc)
3604 printf
3605 (_("\nThere are undocumented %s specific options as well.\n"),
3606 lang);
3607 undoc = 0;
3609 printf (_("\n Options for %s:\n"), description);
3611 lang = description;
3613 else
3614 printf (" %-23.23s %s\n", option, _(description));
3618 if (undoc)
3619 printf (_("\nThere are undocumented %s specific options as well.\n"),
3620 lang);
3622 display_target_options ();
3625 static void
3626 display_target_options ()
3628 int undoc, i;
3629 static bool displayed = false;
3631 /* Avoid double printing for --help --target-help. */
3632 if (displayed)
3633 return;
3634 displayed = true;
3636 if (ARRAY_SIZE (target_switches) > 1
3637 #ifdef TARGET_OPTIONS
3638 || ARRAY_SIZE (target_options) > 1
3639 #endif
3642 int doc = 0;
3644 undoc = 0;
3646 printf (_("\nTarget specific options:\n"));
3648 for (i = ARRAY_SIZE (target_switches); i--;)
3650 const char *option = target_switches[i].name;
3651 const char *description = target_switches[i].description;
3653 if (option == NULL || *option == 0)
3654 continue;
3655 else if (description == NULL)
3657 undoc = 1;
3659 if (extra_warnings)
3660 printf (_(" -m%-23.23s [undocumented]\n"), option);
3662 else if (* description != 0)
3663 doc += printf (" -m%-23.23s %s\n", option, _(description));
3666 #ifdef TARGET_OPTIONS
3667 for (i = ARRAY_SIZE (target_options); i--;)
3669 const char *option = target_options[i].prefix;
3670 const char *description = target_options[i].description;
3672 if (option == NULL || *option == 0)
3673 continue;
3674 else if (description == NULL)
3676 undoc = 1;
3678 if (extra_warnings)
3679 printf (_(" -m%-23.23s [undocumented]\n"), option);
3681 else if (* description != 0)
3682 doc += printf (" -m%-23.23s %s\n", option, _(description));
3684 #endif
3685 if (undoc)
3687 if (doc)
3688 printf (_("\nThere are undocumented target specific options as well.\n"));
3689 else
3690 printf (_(" They exist, but they are not documented.\n"));
3695 /* Parse a -d... command line switch. */
3697 static void
3698 decode_d_option (arg)
3699 const char *arg;
3701 int i, c, matched;
3703 while (*arg)
3704 switch (c = *arg++)
3706 case 'a':
3707 for (i = 0; i < (int) DFI_MAX; ++i)
3708 dump_file[i].enabled = 1;
3709 break;
3710 case 'A':
3711 flag_debug_asm = 1;
3712 break;
3713 case 'p':
3714 flag_print_asm_name = 1;
3715 break;
3716 case 'P':
3717 flag_dump_rtl_in_asm = 1;
3718 flag_print_asm_name = 1;
3719 break;
3720 case 'v':
3721 graph_dump_format = vcg;
3722 break;
3723 case 'x':
3724 rtl_dump_and_exit = 1;
3725 break;
3726 case 'y':
3727 (*lang_hooks.set_yydebug) (1);
3728 break;
3729 case 'D': /* These are handled by the preprocessor. */
3730 case 'I':
3731 break;
3733 default:
3734 matched = 0;
3735 for (i = 0; i < (int) DFI_MAX; ++i)
3736 if (c == dump_file[i].debug_switch)
3738 dump_file[i].enabled = 1;
3739 matched = 1;
3742 if (! matched)
3743 warning ("unrecognized gcc debugging option: %c", c);
3744 break;
3748 /* Parse a -f... command line switch. ARG is the value after the -f.
3749 It is safe to access 'ARG - 2' to generate the full switch name.
3750 Return the number of strings consumed. */
3752 static int
3753 decode_f_option (arg)
3754 const char *arg;
3756 int j;
3757 const char *option_value = NULL;
3759 /* Search for the option in the table of binary f options. */
3760 for (j = ARRAY_SIZE (f_options); j--;)
3762 if (!strcmp (arg, f_options[j].string))
3764 *f_options[j].variable = f_options[j].on_value;
3765 return 1;
3768 if (arg[0] == 'n' && arg[1] == 'o' && arg[2] == '-'
3769 && ! strcmp (arg + 3, f_options[j].string))
3771 *f_options[j].variable = ! f_options[j].on_value;
3772 return 1;
3776 if (!strcmp (arg, "fast-math"))
3777 set_fast_math_flags ();
3778 else if (!strcmp (arg, "no-fast-math"))
3779 set_no_fast_math_flags ();
3780 else if ((option_value = skip_leading_substring (arg, "inline-limit-"))
3781 || (option_value = skip_leading_substring (arg, "inline-limit=")))
3783 int val =
3784 read_integral_parameter (option_value, arg - 2,
3785 MAX_INLINE_INSNS);
3786 set_param_value ("max-inline-insns", val);
3788 #ifdef INSN_SCHEDULING
3789 else if ((option_value = skip_leading_substring (arg, "sched-verbose=")))
3790 fix_sched_param ("verbose", option_value);
3791 #endif
3792 else if ((option_value = skip_leading_substring (arg, "fixed-")))
3793 fix_register (option_value, 1, 1);
3794 else if ((option_value = skip_leading_substring (arg, "call-used-")))
3795 fix_register (option_value, 0, 1);
3796 else if ((option_value = skip_leading_substring (arg, "call-saved-")))
3797 fix_register (option_value, 0, 0);
3798 else if ((option_value = skip_leading_substring (arg, "align-loops=")))
3799 align_loops = read_integral_parameter (option_value, arg - 2, align_loops);
3800 else if ((option_value = skip_leading_substring (arg, "align-functions=")))
3801 align_functions
3802 = read_integral_parameter (option_value, arg - 2, align_functions);
3803 else if ((option_value = skip_leading_substring (arg, "align-jumps=")))
3804 align_jumps = read_integral_parameter (option_value, arg - 2, align_jumps);
3805 else if ((option_value = skip_leading_substring (arg, "align-labels=")))
3806 align_labels
3807 = read_integral_parameter (option_value, arg - 2, align_labels);
3808 else if ((option_value
3809 = skip_leading_substring (arg, "stack-limit-register=")))
3811 int reg = decode_reg_name (option_value);
3812 if (reg < 0)
3813 error ("unrecognized register name `%s'", option_value);
3814 else
3815 stack_limit_rtx = gen_rtx_REG (Pmode, reg);
3817 else if ((option_value
3818 = skip_leading_substring (arg, "stack-limit-symbol=")))
3820 const char *nm;
3821 nm = ggc_strdup (option_value);
3822 stack_limit_rtx = gen_rtx_SYMBOL_REF (Pmode, nm);
3824 else if ((option_value
3825 = skip_leading_substring (arg, "message-length=")))
3826 output_set_maximum_length
3827 (&global_dc->buffer, read_integral_parameter
3828 (option_value, arg - 2, diagnostic_line_cutoff (global_dc)));
3829 else if ((option_value
3830 = skip_leading_substring (arg, "diagnostics-show-location=")))
3832 if (!strcmp (option_value, "once"))
3833 diagnostic_prefixing_rule (global_dc) = DIAGNOSTICS_SHOW_PREFIX_ONCE;
3834 else if (!strcmp (option_value, "every-line"))
3835 diagnostic_prefixing_rule (global_dc)
3836 = DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE;
3837 else
3838 error ("unrecognized option `%s'", arg - 2);
3840 else if (!strcmp (arg, "no-stack-limit"))
3841 stack_limit_rtx = NULL_RTX;
3842 else if (!strcmp (arg, "preprocessed"))
3843 /* Recognise this switch but do nothing. This prevents warnings
3844 about an unrecognized switch if cpplib has not been linked in. */
3846 else
3847 return 0;
3849 return 1;
3852 /* Parse a -W... command line switch. ARG is the value after the -W.
3853 It is safe to access 'ARG - 2' to generate the full switch name.
3854 Return the number of strings consumed. */
3856 static int
3857 decode_W_option (arg)
3858 const char *arg;
3860 const char *option_value = NULL;
3861 int j;
3863 /* Search for the option in the table of binary W options. */
3865 for (j = ARRAY_SIZE (W_options); j--;)
3867 if (!strcmp (arg, W_options[j].string))
3869 *W_options[j].variable = W_options[j].on_value;
3870 return 1;
3873 if (arg[0] == 'n' && arg[1] == 'o' && arg[2] == '-'
3874 && ! strcmp (arg + 3, W_options[j].string))
3876 *W_options[j].variable = ! W_options[j].on_value;
3877 return 1;
3881 if ((option_value = skip_leading_substring (arg, "id-clash-")))
3882 warning ("-Wid-clash-LEN is no longer supported");
3883 else if ((option_value = skip_leading_substring (arg, "larger-than-")))
3885 larger_than_size = read_integral_parameter (option_value, arg - 2, -1);
3887 warn_larger_than = larger_than_size != -1;
3889 else if (!strcmp (arg, "unused"))
3891 set_Wunused (1);
3893 else if (!strcmp (arg, "no-unused"))
3895 set_Wunused (0);
3897 else
3898 return 0;
3900 return 1;
3903 /* Parse a -g... command line switch. ARG is the value after the -g.
3904 It is safe to access 'ARG - 2' to generate the full switch name.
3905 Return the number of strings consumed. */
3907 static int
3908 decode_g_option (arg)
3909 const char *arg;
3911 static unsigned level=0;
3912 /* A lot of code assumes write_symbols == NO_DEBUG if the
3913 debugging level is 0 (thus -gstabs1 -gstabs0 would lose track
3914 of what debugging type has been selected). This records the
3915 selected type. It is an error to specify more than one
3916 debugging type. */
3917 static enum debug_info_type selected_debug_type = NO_DEBUG;
3918 /* Non-zero if debugging format has been explicitly set.
3919 -g and -ggdb don't explicitly set the debugging format so
3920 -gdwarf -g3 is equivalent to -gdwarf3. */
3921 static int type_explicitly_set_p = 0;
3922 /* Indexed by enum debug_info_type. */
3923 static const char *const debug_type_names[] =
3925 "none", "stabs", "coff", "dwarf-1", "dwarf-2", "xcoff", "vms"
3928 /* The maximum admissible debug level value. */
3929 static const unsigned max_debug_level = 3;
3931 /* Look up ARG in the table. */
3932 for (da = debug_args; da->arg; da++)
3934 const int da_len = strlen (da->arg);
3936 if (da_len == 0 || ! strncmp (arg, da->arg, da_len))
3938 enum debug_info_type type = da->debug_type;
3939 const char *p = arg + da_len;
3941 if (*p && ! ISDIGIT (*p))
3942 continue;
3944 /* A debug flag without a level defaults to level 2.
3945 Note we do not want to call read_integral_parameter
3946 for that case since it will call atoi which
3947 will return zero.
3949 ??? We may want to generalize the interface to
3950 read_integral_parameter to better handle this case
3951 if this case shows up often. */
3952 if (*p)
3953 level = read_integral_parameter (p, 0, max_debug_level + 1);
3954 else
3955 level = (level == 0) ? 2 : level;
3957 if (da_len > 1 && *p && !strncmp (arg, "dwarf", da_len))
3959 error ("use -gdwarf -g%d for DWARF v1, level %d",
3960 level, level);
3961 if (level == 2)
3962 error ("use -gdwarf-2 for DWARF v2");
3965 if (level > max_debug_level)
3967 warning ("\
3968 ignoring option `%s' due to invalid debug level specification",
3969 arg - 2);
3970 level = debug_info_level;
3973 if (type == NO_DEBUG)
3975 type = PREFERRED_DEBUGGING_TYPE;
3977 if (da_len > 1 && strncmp (arg, "gdb", da_len) == 0)
3979 #if defined (DWARF2_DEBUGGING_INFO) && !defined (LINKER_DOES_NOT_WORK_WITH_DWARF2)
3980 type = DWARF2_DEBUG;
3981 #else
3982 #ifdef DBX_DEBUGGING_INFO
3983 type = DBX_DEBUG;
3984 #endif
3985 #endif
3989 if (type == NO_DEBUG)
3990 warning ("`%s': unknown or unsupported -g option", arg - 2);
3992 /* Does it conflict with an already selected type? */
3993 if (type_explicitly_set_p
3994 /* -g/-ggdb don't conflict with anything. */
3995 && da->debug_type != NO_DEBUG
3996 && type != selected_debug_type)
3997 warning ("`%s' ignored, conflicts with `-g%s'",
3998 arg - 2, debug_type_names[(int) selected_debug_type]);
3999 else
4001 /* If the format has already been set, -g/-ggdb
4002 only change the debug level. */
4003 if (type_explicitly_set_p && da->debug_type == NO_DEBUG)
4004 /* Don't change debugging type. */
4006 else
4008 selected_debug_type = type;
4009 type_explicitly_set_p = da->debug_type != NO_DEBUG;
4012 write_symbols = (level == 0
4013 ? NO_DEBUG
4014 : selected_debug_type);
4015 use_gnu_debug_info_extensions = da->use_extensions_p;
4016 debug_info_level = (enum debug_info_level) level;
4019 break;
4023 if (! da->arg)
4024 return 0;
4026 return 1;
4029 /* Decode the first argument in the argv as a language-independent option.
4030 Return the number of strings consumed. */
4032 static unsigned int
4033 independent_decode_option (argc, argv)
4034 int argc;
4035 char **argv;
4037 char *arg = argv[0];
4039 if (arg[0] != '-' || arg[1] == 0)
4041 if (arg[0] == '+')
4042 return 0;
4044 filename = arg;
4046 return 1;
4049 arg++;
4051 if (!strcmp (arg, "-help"))
4053 display_help ();
4054 exit_after_options = 1;
4057 if (!strcmp (arg, "-target-help"))
4059 display_target_options ();
4060 exit_after_options = 1;
4063 if (!strcmp (arg, "-version"))
4065 print_version (stderr, "");
4066 exit_after_options = 1;
4069 /* Handle '--param <name>=<value>'. */
4070 if (strcmp (arg, "-param") == 0)
4072 char *equal;
4074 if (argc == 1)
4076 error ("-param option missing argument");
4077 return 1;
4080 /* Get the '<name>=<value>' parameter. */
4081 arg = argv[1];
4082 /* Look for the `='. */
4083 equal = strchr (arg, '=');
4084 if (!equal)
4085 error ("invalid --param option: %s", arg);
4086 else
4088 int val;
4090 /* Zero out the `=' sign so that we get two separate strings. */
4091 *equal = '\0';
4092 /* Figure out what value is specified. */
4093 val = read_integral_parameter (equal + 1, NULL, INVALID_PARAM_VAL);
4094 if (val != INVALID_PARAM_VAL)
4095 set_param_value (arg, val);
4096 else
4097 error ("invalid parameter value `%s'", equal + 1);
4100 return 2;
4103 if (*arg == 'Y')
4104 arg++;
4106 switch (*arg)
4108 default:
4109 return 0;
4111 case 'O':
4112 /* Already been treated in main (). Do nothing. */
4113 break;
4115 case 'm':
4116 set_target_switch (arg + 1);
4117 break;
4119 case 'f':
4120 return decode_f_option (arg + 1);
4122 case 'g':
4123 return decode_g_option (arg + 1);
4125 case 'd':
4126 if (!strcmp (arg, "dumpbase"))
4128 if (argc == 1)
4129 return 0;
4131 dump_base_name = argv[1];
4132 return 2;
4134 else
4135 decode_d_option (arg + 1);
4136 break;
4138 case 'p':
4139 if (!strcmp (arg, "pedantic"))
4140 pedantic = 1;
4141 else if (!strcmp (arg, "pedantic-errors"))
4142 flag_pedantic_errors = pedantic = 1;
4143 else if (arg[1] == 0)
4144 profile_flag = 1;
4145 else
4146 return 0;
4147 break;
4149 case 'q':
4150 if (!strcmp (arg, "quiet"))
4151 quiet_flag = 1;
4152 else
4153 return 0;
4154 break;
4156 case 'v':
4157 if (!strcmp (arg, "version"))
4158 version_flag = 1;
4159 else
4160 return 0;
4161 break;
4163 case 'w':
4164 if (arg[1] == 0)
4165 inhibit_warnings = 1;
4166 else
4167 return 0;
4168 break;
4170 case 'W':
4171 if (arg[1] == 0)
4173 extra_warnings = 1;
4174 /* We save the value of warn_uninitialized, since if they put
4175 -Wuninitialized on the command line, we need to generate a
4176 warning about not using it without also specifying -O. */
4177 if (warn_uninitialized != 1)
4178 warn_uninitialized = 2;
4180 else
4181 return decode_W_option (arg + 1);
4182 break;
4184 case 'a':
4185 if (!strncmp (arg, "aux-info", 8))
4187 if (arg[8] == '\0')
4189 if (argc == 1)
4190 return 0;
4192 aux_info_file_name = argv[1];
4193 flag_gen_aux_info = 1;
4194 return 2;
4196 else if (arg[8] == '=')
4198 aux_info_file_name = arg + 9;
4199 flag_gen_aux_info = 1;
4201 else
4202 return 0;
4204 else
4205 return 0;
4206 break;
4208 case 'o':
4209 if (arg[1] == 0)
4211 if (argc == 1)
4212 return 0;
4214 asm_file_name = argv[1];
4215 return 2;
4217 return 0;
4219 case 'G':
4221 int g_switch_val;
4222 int return_val;
4224 if (arg[1] == 0)
4226 if (argc == 1)
4227 return 0;
4229 g_switch_val = read_integral_parameter (argv[1], 0, -1);
4230 return_val = 2;
4232 else
4234 g_switch_val = read_integral_parameter (arg + 1, 0, -1);
4235 return_val = 1;
4238 if (g_switch_val == -1)
4239 return_val = 0;
4240 else
4242 g_switch_set = TRUE;
4243 g_switch_value = g_switch_val;
4246 return return_val;
4250 return 1;
4253 /* Decode -m switches. */
4254 /* Decode the switch -mNAME. */
4256 static void
4257 set_target_switch (name)
4258 const char *name;
4260 size_t j;
4261 int valid_target_option = 0;
4263 for (j = 0; j < ARRAY_SIZE (target_switches); j++)
4264 if (!strcmp (target_switches[j].name, name))
4266 if (target_switches[j].value < 0)
4267 target_flags &= ~-target_switches[j].value;
4268 else
4269 target_flags |= target_switches[j].value;
4270 valid_target_option = 1;
4273 #ifdef TARGET_OPTIONS
4274 if (!valid_target_option)
4275 for (j = 0; j < ARRAY_SIZE (target_options); j++)
4277 int len = strlen (target_options[j].prefix);
4278 if (!strncmp (target_options[j].prefix, name, len))
4280 *target_options[j].variable = name + len;
4281 valid_target_option = 1;
4284 #endif
4286 if (!valid_target_option)
4287 error ("invalid option `%s'", name);
4290 /* Print version information to FILE.
4291 Each line begins with INDENT (for the case where FILE is the
4292 assembler output file). */
4294 static void
4295 print_version (file, indent)
4296 FILE *file;
4297 const char *indent;
4299 #ifndef __VERSION__
4300 #define __VERSION__ "[?]"
4301 #endif
4302 fnotice (file,
4303 #ifdef __GNUC__
4304 "%s%s%s version %s (%s)\n%s\tcompiled by GNU C version %s.\n"
4305 #else
4306 "%s%s%s version %s (%s) compiled by CC.\n"
4307 #endif
4308 , indent, *indent != 0 ? " " : "",
4309 lang_hooks.name, version_string, TARGET_NAME,
4310 indent, __VERSION__);
4313 /* Print an option value and return the adjusted position in the line.
4314 ??? We don't handle error returns from fprintf (disk full); presumably
4315 other code will catch a disk full though. */
4317 static int
4318 print_single_switch (file, pos, max, indent, sep, term, type, name)
4319 FILE *file;
4320 int pos, max;
4321 const char *indent, *sep, *term, *type, *name;
4323 /* The ultrix fprintf returns 0 on success, so compute the result we want
4324 here since we need it for the following test. */
4325 int len = strlen (sep) + strlen (type) + strlen (name);
4327 if (pos != 0
4328 && pos + len > max)
4330 fprintf (file, "%s", term);
4331 pos = 0;
4333 if (pos == 0)
4335 fprintf (file, "%s", indent);
4336 pos = strlen (indent);
4338 fprintf (file, "%s%s%s", sep, type, name);
4339 pos += len;
4340 return pos;
4343 /* Print active target switches to FILE.
4344 POS is the current cursor position and MAX is the size of a "line".
4345 Each line begins with INDENT and ends with TERM.
4346 Each switch is separated from the next by SEP. */
4348 static void
4349 print_switch_values (file, pos, max, indent, sep, term)
4350 FILE *file;
4351 int pos, max;
4352 const char *indent, *sep, *term;
4354 size_t j;
4355 char **p;
4357 /* Print the options as passed. */
4359 pos = print_single_switch (file, pos, max, indent, *indent ? " " : "", term,
4360 _("options passed: "), "");
4362 for (p = &save_argv[1]; *p != NULL; p++)
4363 if (**p == '-')
4365 /* Ignore these. */
4366 if (strcmp (*p, "-o") == 0)
4368 if (p[1] != NULL)
4369 p++;
4370 continue;
4372 if (strcmp (*p, "-quiet") == 0)
4373 continue;
4374 if (strcmp (*p, "-version") == 0)
4375 continue;
4376 if ((*p)[1] == 'd')
4377 continue;
4379 pos = print_single_switch (file, pos, max, indent, sep, term, *p, "");
4381 if (pos > 0)
4382 fprintf (file, "%s", term);
4384 /* Print the -f and -m options that have been enabled.
4385 We don't handle language specific options but printing argv
4386 should suffice. */
4388 pos = print_single_switch (file, 0, max, indent, *indent ? " " : "", term,
4389 _("options enabled: "), "");
4391 for (j = 0; j < ARRAY_SIZE (f_options); j++)
4392 if (*f_options[j].variable == f_options[j].on_value)
4393 pos = print_single_switch (file, pos, max, indent, sep, term,
4394 "-f", f_options[j].string);
4396 /* Print target specific options. */
4398 for (j = 0; j < ARRAY_SIZE (target_switches); j++)
4399 if (target_switches[j].name[0] != '\0'
4400 && target_switches[j].value > 0
4401 && ((target_switches[j].value & target_flags)
4402 == target_switches[j].value))
4404 pos = print_single_switch (file, pos, max, indent, sep, term,
4405 "-m", target_switches[j].name);
4408 #ifdef TARGET_OPTIONS
4409 for (j = 0; j < ARRAY_SIZE (target_options); j++)
4410 if (*target_options[j].variable != NULL)
4412 char prefix[256];
4413 sprintf (prefix, "-m%s", target_options[j].prefix);
4414 pos = print_single_switch (file, pos, max, indent, sep, term,
4415 prefix, *target_options[j].variable);
4417 #endif
4419 fprintf (file, "%s", term);
4422 /* Open assembly code output file. Do this even if -fsyntax-only is
4423 on, because then the driver will have provided the name of a
4424 temporary file or bit bucket for us. NAME is the file specified on
4425 the command line, possibly NULL. */
4426 static void
4427 init_asm_output (name)
4428 const char *name;
4430 if (name == NULL && asm_file_name == 0)
4431 asm_out_file = stdout;
4432 else
4434 if (asm_file_name == 0)
4436 int len = strlen (dump_base_name);
4437 char *dumpname = (char *) xmalloc (len + 6);
4438 memcpy (dumpname, dump_base_name, len + 1);
4439 strip_off_ending (dumpname, len);
4440 strcat (dumpname, ".s");
4441 asm_file_name = dumpname;
4443 if (!strcmp (asm_file_name, "-"))
4444 asm_out_file = stdout;
4445 else
4446 asm_out_file = fopen (asm_file_name, "w");
4447 if (asm_out_file == 0)
4448 fatal_io_error ("can't open %s for writing", asm_file_name);
4451 #ifdef IO_BUFFER_SIZE
4452 setvbuf (asm_out_file, (char *) xmalloc (IO_BUFFER_SIZE),
4453 _IOFBF, IO_BUFFER_SIZE);
4454 #endif
4456 if (!flag_syntax_only)
4458 #ifdef ASM_FILE_START
4459 ASM_FILE_START (asm_out_file);
4460 #endif
4462 #ifdef ASM_COMMENT_START
4463 if (flag_verbose_asm)
4465 /* Print the list of options in effect. */
4466 print_version (asm_out_file, ASM_COMMENT_START);
4467 print_switch_values (asm_out_file, 0, MAX_LINE,
4468 ASM_COMMENT_START, " ", "\n");
4469 /* Add a blank line here so it appears in assembler output but not
4470 screen output. */
4471 fprintf (asm_out_file, "\n");
4473 #endif
4477 /* Initialization of the front end environment, before command line
4478 options are parsed. Signal handlers, internationalization etc.
4479 ARGV0 is main's argv[0]. */
4480 static void
4481 general_init (argv0)
4482 char *argv0;
4484 char *p;
4486 p = argv0 + strlen (argv0);
4487 while (p != argv0 && !IS_DIR_SEPARATOR (p[-1]))
4488 --p;
4489 progname = p;
4491 xmalloc_set_program_name (progname);
4493 gcc_init_libintl ();
4495 /* Trap fatal signals, e.g. SIGSEGV, and convert them to ICE messages. */
4496 #ifdef SIGSEGV
4497 signal (SIGSEGV, crash_signal);
4498 #endif
4499 #ifdef SIGILL
4500 signal (SIGILL, crash_signal);
4501 #endif
4502 #ifdef SIGBUS
4503 signal (SIGBUS, crash_signal);
4504 #endif
4505 #ifdef SIGABRT
4506 signal (SIGABRT, crash_signal);
4507 #endif
4508 #if defined SIGIOT && (!defined SIGABRT || SIGABRT != SIGIOT)
4509 signal (SIGIOT, crash_signal);
4510 #endif
4511 #ifdef SIGFPE
4512 signal (SIGFPE, crash_signal);
4513 #endif
4515 /* Initialize the diagnostics reporting machinery, so option parsing
4516 can give warnings and errors. */
4517 diagnostic_initialize (global_dc);
4520 /* Parse command line options and set default flag values, called
4521 after language-independent option-independent initialization. Do
4522 minimal options processing. Outputting diagnostics is OK, but GC
4523 and identifier hashtables etc. are not initialized yet. */
4524 static void
4525 parse_options_and_default_flags (argc, argv)
4526 int argc;
4527 char **argv;
4529 int i;
4531 /* Save in case md file wants to emit args as a comment. */
4532 save_argc = argc;
4533 save_argv = argv;
4535 /* Initialize register usage now so switches may override. */
4536 init_reg_sets ();
4538 /* Register the language-independent parameters. */
4539 add_params (lang_independent_params, LAST_PARAM);
4541 /* Perform language-specific options initialization. */
4542 (*lang_hooks.init_options) ();
4544 /* Scan to see what optimization level has been specified. That will
4545 determine the default value of many flags. */
4546 for (i = 1; i < argc; i++)
4548 if (!strcmp (argv[i], "-O"))
4550 optimize = 1;
4551 optimize_size = 0;
4553 else if (argv[i][0] == '-' && argv[i][1] == 'O')
4555 /* Handle -Os, -O2, -O3, -O69, ... */
4556 char *p = &argv[i][2];
4558 if ((p[0] == 's') && (p[1] == 0))
4560 optimize_size = 1;
4562 /* Optimizing for size forces optimize to be 2. */
4563 optimize = 2;
4565 else
4567 const int optimize_val = read_integral_parameter (p, p - 2, -1);
4568 if (optimize_val != -1)
4570 optimize = optimize_val;
4571 optimize_size = 0;
4577 if (!optimize)
4579 flag_merge_constants = 0;
4582 if (optimize >= 1)
4584 flag_defer_pop = 1;
4585 flag_thread_jumps = 1;
4586 #ifdef DELAY_SLOTS
4587 flag_delayed_branch = 1;
4588 #endif
4589 #ifdef CAN_DEBUG_WITHOUT_FP
4590 flag_omit_frame_pointer = 1;
4591 #endif
4592 flag_guess_branch_prob = 1;
4593 flag_cprop_registers = 1;
4594 flag_loop_optimize = 1;
4595 flag_crossjumping = 1;
4598 if (optimize >= 2)
4600 flag_optimize_sibling_calls = 1;
4601 flag_cse_follow_jumps = 1;
4602 flag_cse_skip_blocks = 1;
4603 flag_gcse = 1;
4604 flag_expensive_optimizations = 1;
4605 flag_strength_reduce = 1;
4606 flag_rerun_cse_after_loop = 1;
4607 flag_rerun_loop_opt = 1;
4608 flag_caller_saves = 1;
4609 flag_force_mem = 1;
4610 flag_peephole2 = 1;
4611 #ifdef INSN_SCHEDULING
4612 flag_schedule_insns = 1;
4613 flag_schedule_insns_after_reload = 1;
4614 #endif
4615 flag_regmove = 1;
4616 flag_strict_aliasing = 1;
4617 flag_delete_null_pointer_checks = 1;
4618 flag_reorder_blocks = 1;
4621 if (optimize >= 3)
4623 flag_inline_functions = 1;
4624 flag_rename_registers = 1;
4627 if (optimize < 2 || optimize_size)
4629 align_loops = 1;
4630 align_jumps = 1;
4631 align_labels = 1;
4632 align_functions = 1;
4635 /* Initialize whether `char' is signed. */
4636 flag_signed_char = DEFAULT_SIGNED_CHAR;
4637 #ifdef DEFAULT_SHORT_ENUMS
4638 /* Initialize how much space enums occupy, by default. */
4639 flag_short_enums = DEFAULT_SHORT_ENUMS;
4640 #endif
4642 /* Initialize target_flags before OPTIMIZATION_OPTIONS so the latter can
4643 modify it. */
4644 target_flags = 0;
4645 set_target_switch ("");
4647 /* Unwind tables are always present in an ABI-conformant IA-64
4648 object file, so the default should be ON. */
4649 #ifdef IA64_UNWIND_INFO
4650 flag_unwind_tables = IA64_UNWIND_INFO;
4651 #endif
4653 #ifdef OPTIMIZATION_OPTIONS
4654 /* Allow default optimizations to be specified on a per-machine basis. */
4655 OPTIMIZATION_OPTIONS (optimize, optimize_size);
4656 #endif
4658 /* Perform normal command line switch decoding. */
4659 for (i = 1; i < argc;)
4661 int lang_processed;
4662 int indep_processed;
4664 /* Give the language a chance to decode the option for itself. */
4665 lang_processed = (*lang_hooks.decode_option) (argc - i, argv + i);
4667 if (lang_processed >= 0)
4668 /* Now see if the option also has a language independent meaning.
4669 Some options are both language specific and language independent,
4670 eg --help. */
4671 indep_processed = independent_decode_option (argc - i, argv + i);
4672 else
4674 lang_processed = -lang_processed;
4675 indep_processed = 0;
4678 if (lang_processed || indep_processed)
4679 i += MAX (lang_processed, indep_processed);
4680 else
4682 const char *option = NULL;
4683 const char *lang = NULL;
4684 unsigned int j;
4686 /* It is possible that the command line switch is not valid for the
4687 current language, but it is valid for another language. In order
4688 to be compatible with previous versions of the compiler (which
4689 did not issue an error message in this case) we check for this
4690 possibility here. If we do find a match, then if extra_warnings
4691 is set we generate a warning message, otherwise we will just
4692 ignore the option. */
4693 for (j = 0; j < ARRAY_SIZE (documented_lang_options); j++)
4695 option = documented_lang_options[j].option;
4697 if (option == NULL)
4698 lang = documented_lang_options[j].description;
4699 else if (! strncmp (argv[i], option, strlen (option)))
4700 break;
4703 if (j != ARRAY_SIZE (documented_lang_options))
4705 if (extra_warnings)
4707 warning ("ignoring command line option '%s'", argv[i]);
4708 if (lang)
4709 warning
4710 ("(it is valid for %s but not the selected language)",
4711 lang);
4714 else if (argv[i][0] == '-' && argv[i][1] == 'g')
4715 warning ("`%s': unknown or unsupported -g option", &argv[i][2]);
4716 else
4717 error ("unrecognized option `%s'", argv[i]);
4719 i++;
4723 /* Set flag_no_inline before the post_options () hook. The C front
4724 ends use it to determine tree inlining defaults. FIXME: such
4725 code should be lang-independent when all front ends use tree
4726 inlining, in which case it, and this condition, should be moved
4727 to the top of process_options() instead. */
4728 if (optimize == 0)
4730 /* Inlining does not work if not optimizing,
4731 so force it not to be done. */
4732 flag_no_inline = 1;
4733 warn_inline = 0;
4735 /* The c_decode_option function and decode_option hook set
4736 this to `2' if -Wall is used, so we can avoid giving out
4737 lots of errors for people who don't realize what -Wall does. */
4738 if (warn_uninitialized == 1)
4739 warning ("-Wuninitialized is not supported without -O");
4742 /* All command line options have been parsed; allow the front end to
4743 perform consistency checks, etc. */
4744 (*lang_hooks.post_options) ();
4747 /* Process the options that have been parsed. */
4748 static void
4749 process_options ()
4751 #ifdef OVERRIDE_OPTIONS
4752 /* Some machines may reject certain combinations of options. */
4753 OVERRIDE_OPTIONS;
4754 #endif
4756 /* Set up the align_*_log variables, defaulting them to 1 if they
4757 were still unset. */
4758 if (align_loops <= 0) align_loops = 1;
4759 if (align_loops_max_skip > align_loops || !align_loops)
4760 align_loops_max_skip = align_loops - 1;
4761 align_loops_log = floor_log2 (align_loops * 2 - 1);
4762 if (align_jumps <= 0) align_jumps = 1;
4763 if (align_jumps_max_skip > align_jumps || !align_jumps)
4764 align_jumps_max_skip = align_jumps - 1;
4765 align_jumps_log = floor_log2 (align_jumps * 2 - 1);
4766 if (align_labels <= 0) align_labels = 1;
4767 align_labels_log = floor_log2 (align_labels * 2 - 1);
4768 if (align_labels_max_skip > align_labels || !align_labels)
4769 align_labels_max_skip = align_labels - 1;
4770 if (align_functions <= 0) align_functions = 1;
4771 align_functions_log = floor_log2 (align_functions * 2 - 1);
4773 /* Unrolling all loops implies that standard loop unrolling must also
4774 be done. */
4775 if (flag_unroll_all_loops)
4776 flag_unroll_loops = 1;
4777 /* Loop unrolling requires that strength_reduction be on also. Silently
4778 turn on strength reduction here if it isn't already on. Also, the loop
4779 unrolling code assumes that cse will be run after loop, so that must
4780 be turned on also. */
4781 if (flag_unroll_loops)
4783 flag_strength_reduce = 1;
4784 flag_rerun_cse_after_loop = 1;
4787 if (flag_non_call_exceptions)
4788 flag_asynchronous_unwind_tables = 1;
4789 if (flag_asynchronous_unwind_tables)
4790 flag_unwind_tables = 1;
4792 /* Warn about options that are not supported on this machine. */
4793 #ifndef INSN_SCHEDULING
4794 if (flag_schedule_insns || flag_schedule_insns_after_reload)
4795 warning ("instruction scheduling not supported on this target machine");
4796 #endif
4797 #ifndef DELAY_SLOTS
4798 if (flag_delayed_branch)
4799 warning ("this target machine does not have delayed branches");
4800 #endif
4802 /* Some operating systems do not allow profiling without a frame
4803 pointer. */
4804 if (!TARGET_ALLOWS_PROFILING_WITHOUT_FRAME_POINTER
4805 && profile_flag
4806 && flag_omit_frame_pointer)
4808 error ("profiling does not work without a frame pointer");
4809 flag_omit_frame_pointer = 0;
4812 user_label_prefix = USER_LABEL_PREFIX;
4813 if (flag_leading_underscore != -1)
4815 /* If the default prefix is more complicated than "" or "_",
4816 issue a warning and ignore this option. */
4817 if (user_label_prefix[0] == 0 ||
4818 (user_label_prefix[0] == '_' && user_label_prefix[1] == 0))
4820 user_label_prefix = flag_leading_underscore ? "_" : "";
4822 else
4823 warning ("-f%sleading-underscore not supported on this target machine",
4824 flag_leading_underscore ? "" : "no-");
4827 /* If we are in verbose mode, write out the version and maybe all the
4828 option flags in use. */
4829 if (version_flag)
4831 print_version (stderr, "");
4832 if (! quiet_flag)
4833 print_switch_values (stderr, 0, MAX_LINE, "", " ", "\n");
4836 if (! quiet_flag)
4837 time_report = 1;
4839 if (flag_syntax_only)
4841 write_symbols = NO_DEBUG;
4842 profile_flag = 0;
4845 /* Now we know write_symbols, set up the debug hooks based on it.
4846 By default we do nothing for debug output. */
4847 #if defined(DBX_DEBUGGING_INFO)
4848 if (write_symbols == DBX_DEBUG)
4849 debug_hooks = &dbx_debug_hooks;
4850 #endif
4851 #if defined(XCOFF_DEBUGGING_INFO)
4852 if (write_symbols == XCOFF_DEBUG)
4853 debug_hooks = &xcoff_debug_hooks;
4854 #endif
4855 #ifdef SDB_DEBUGGING_INFO
4856 if (write_symbols == SDB_DEBUG)
4857 debug_hooks = &sdb_debug_hooks;
4858 #endif
4859 #ifdef DWARF_DEBUGGING_INFO
4860 if (write_symbols == DWARF_DEBUG)
4861 debug_hooks = &dwarf_debug_hooks;
4862 #endif
4863 #ifdef DWARF2_DEBUGGING_INFO
4864 if (write_symbols == DWARF2_DEBUG)
4865 debug_hooks = &dwarf2_debug_hooks;
4866 #endif
4867 #ifdef VMS_DEBUGGING_INFO
4868 if (write_symbols == VMS_DEBUG || write_symbols == VMS_AND_DWARF2_DEBUG)
4869 debug_hooks = &vmsdbg_debug_hooks;
4870 #endif
4872 /* If auxiliary info generation is desired, open the output file.
4873 This goes in the same directory as the source file--unlike
4874 all the other output files. */
4875 if (flag_gen_aux_info)
4877 aux_info_file = fopen (aux_info_file_name, "w");
4878 if (aux_info_file == 0)
4879 fatal_io_error ("can't open %s", aux_info_file_name);
4882 if (! targetm.have_named_sections)
4884 if (flag_function_sections)
4886 warning ("-ffunction-sections not supported for this target");
4887 flag_function_sections = 0;
4889 if (flag_data_sections)
4891 warning ("-fdata-sections not supported for this target");
4892 flag_data_sections = 0;
4896 if (flag_function_sections && profile_flag)
4898 warning ("-ffunction-sections disabled; it makes profiling impossible");
4899 flag_function_sections = 0;
4902 #ifndef HAVE_prefetch
4903 if (flag_prefetch_loop_arrays)
4905 warning ("-fprefetch-loop-arrays not supported for this target");
4906 flag_prefetch_loop_arrays = 0;
4908 #else
4909 if (flag_prefetch_loop_arrays && !HAVE_prefetch)
4911 warning ("-fprefetch-loop-arrays not supported for this target (try -march switches)");
4912 flag_prefetch_loop_arrays = 0;
4914 #endif
4916 /* This combination of options isn't handled for i386 targets and doesn't
4917 make much sense anyway, so don't allow it. */
4918 if (flag_prefetch_loop_arrays && optimize_size)
4920 warning ("-fprefetch-loop-arrays is not supported with -Os");
4921 flag_prefetch_loop_arrays = 0;
4924 #ifndef OBJECT_FORMAT_ELF
4925 if (flag_function_sections && write_symbols != NO_DEBUG)
4926 warning ("-ffunction-sections may affect debugging on some targets");
4927 #endif
4930 /* Language-independent initialization, before language-dependent
4931 initialization. */
4932 static void
4933 lang_independent_init ()
4935 /* Initialize the garbage-collector, and string pools. */
4936 init_ggc ();
4937 ggc_add_rtx_root (&stack_limit_rtx, 1);
4938 ggc_add_tree_root (&current_function_decl, 1);
4939 ggc_add_tree_root (&current_function_func_begin_label, 1);
4941 init_stringpool ();
4942 init_obstacks ();
4944 init_emit_once (debug_info_level == DINFO_LEVEL_NORMAL
4945 || debug_info_level == DINFO_LEVEL_VERBOSE
4946 #ifdef VMS_DEBUGGING_INFO
4947 /* Enable line number info for traceback */
4948 || debug_info_level > DINFO_LEVEL_NONE
4949 #endif
4950 || flag_test_coverage
4951 || warn_notreached);
4952 init_regs ();
4953 init_alias_once ();
4954 init_stmt ();
4955 init_loop ();
4956 init_reload ();
4957 init_function_once ();
4958 init_stor_layout_once ();
4959 init_varasm_once ();
4960 init_EXPR_INSN_LIST_cache ();
4962 /* The following initialization functions need to generate rtl, so
4963 provide a dummy function context for them. */
4964 init_dummy_function_start ();
4965 init_expmed ();
4966 init_expr_once ();
4967 if (flag_caller_saves)
4968 init_caller_save ();
4969 expand_dummy_function_end ();
4972 /* Language-dependent initialization. Returns non-zero on success. */
4973 static int
4974 lang_dependent_init (name)
4975 const char *name;
4977 if (dump_base_name == 0)
4978 dump_base_name = name ? name : "gccdump";
4980 /* Front-end initialization. This hook can assume that GC,
4981 identifier hashes etc. are set up, but debug initialization is
4982 not done yet. This routine must return the original filename
4983 (e.g. foo.i -> foo.c) so can correctly initialize debug output. */
4984 name = (*lang_hooks.init) (name);
4985 if (name == NULL)
4986 return 0;
4988 /* Is this duplication necessary? */
4989 name = ggc_strdup (name);
4990 main_input_filename = input_filename = name;
4991 init_asm_output (name);
4993 /* These create various _DECL nodes, so need to be called after the
4994 front end is initialized. */
4995 init_eh ();
4996 init_optabs ();
4998 /* Put an entry on the input file stack for the main input file. */
4999 push_srcloc (input_filename, 0);
5001 /* If dbx symbol table desired, initialize writing it and output the
5002 predefined types. */
5003 timevar_push (TV_SYMOUT);
5005 #ifdef DWARF2_UNWIND_INFO
5006 if (dwarf2out_do_frame ())
5007 dwarf2out_frame_init ();
5008 #endif
5010 /* Now we have the correct original filename, we can initialize
5011 debug output. */
5012 (*debug_hooks->init) (name);
5014 timevar_pop (TV_SYMOUT);
5016 return 1;
5019 /* Clean up: close opened files, etc. */
5021 static void
5022 finalize ()
5024 /* Close the dump files. */
5025 if (flag_gen_aux_info)
5027 fclose (aux_info_file);
5028 if (errorcount)
5029 unlink (aux_info_file_name);
5032 /* Close non-debugging input and output files. Take special care to note
5033 whether fclose returns an error, since the pages might still be on the
5034 buffer chain while the file is open. */
5036 if (asm_out_file)
5038 if (ferror (asm_out_file) != 0)
5039 fatal_io_error ("error writing to %s", asm_file_name);
5040 if (fclose (asm_out_file) != 0)
5041 fatal_io_error ("error closing %s", asm_file_name);
5044 /* Do whatever is necessary to finish printing the graphs. */
5045 if (graph_dump_format != no_graph)
5047 int i;
5049 for (i = 0; i < (int) DFI_MAX; ++i)
5050 if (dump_file[i].initialized && dump_file[i].graph_dump_p)
5052 char seq[16];
5053 char *suffix;
5055 sprintf (seq, DUMPFILE_FORMAT, i);
5056 suffix = concat (seq, dump_file[i].extension, NULL);
5057 finish_graph_dump_file (dump_base_name, suffix);
5058 free (suffix);
5062 if (mem_report)
5064 ggc_print_statistics ();
5065 stringpool_statistics ();
5066 dump_tree_statistics ();
5069 /* Free up memory for the benefit of leak detectors. */
5070 free_reg_info ();
5072 /* Language-specific end of compilation actions. */
5073 (*lang_hooks.finish) ();
5076 /* Initialize the compiler, and compile the input file. */
5077 static void
5078 do_compile ()
5080 /* The bulk of command line switch processing. */
5081 process_options ();
5083 /* We cannot start timing until after options are processed since that
5084 says if we run timers or not. */
5085 init_timevar ();
5086 timevar_start (TV_TOTAL);
5088 /* Language-independent initialization. Also sets up GC, identifier
5089 hashes etc. */
5090 lang_independent_init ();
5092 /* Language-dependent initialization. Returns true on success. */
5093 if (lang_dependent_init (filename))
5094 compile_file ();
5096 finalize ();
5098 /* Stop timing and print the times. */
5099 timevar_stop (TV_TOTAL);
5100 timevar_print (stderr);
5103 /* Entry point of cc1, cc1plus, jc1, f771, etc.
5104 Decode command args, then call compile_file.
5105 Exit code is FATAL_EXIT_CODE if can't open files or if there were
5106 any errors, or SUCCESS_EXIT_CODE if compilation succeeded.
5108 It is not safe to call this function more than once. */
5111 toplev_main (argc, argv)
5112 int argc;
5113 char **argv;
5115 hex_init ();
5117 /* Initialization of GCC's environment, and diagnostics. */
5118 general_init (argv [0]);
5120 /* Parse the options and do minimal processing; basically just
5121 enough to default flags appropriately. */
5122 parse_options_and_default_flags (argc, argv);
5124 /* Exit early if we can (e.g. -help). */
5125 if (!exit_after_options)
5126 do_compile ();
5128 if (errorcount || sorrycount)
5129 return (FATAL_EXIT_CODE);
5131 return (SUCCESS_EXIT_CODE);