1 /* Command line option handling.
2 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007
3 Free Software Foundation, Inc.
4 Contributed by Neil Booth.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING. If not, write to the Free
20 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
26 #include "coretypes.h"
32 #include "langhooks.h"
38 #include "diagnostic.h"
39 #include "tm_p.h" /* For OPTIMIZATION_OPTIONS. */
40 #include "insn-attr.h" /* For INSN_SCHEDULING. */
42 #include "tree-pass.h"
45 /* Value of the -G xx switch, and whether it was passed or not. */
46 unsigned HOST_WIDE_INT g_switch_value;
49 /* True if we should exit after parsing options. */
50 bool exit_after_options;
52 /* Print various extra warnings. -W/-Wextra. */
55 /* True to warn about any objects definitions whose size is larger
56 than N bytes. Also want about function definitions whose returned
57 values are larger than N bytes, where N is `larger_than_size'. */
58 bool warn_larger_than;
59 HOST_WIDE_INT larger_than_size;
61 /* Nonzero means warn about constructs which might not be
62 strict-aliasing safe. */
63 int warn_strict_aliasing;
65 /* Nonzero means warn about optimizations which rely on undefined
67 int warn_strict_overflow;
69 /* Hack for cooperation between set_Wunused and set_Wextra. */
70 static bool maybe_warn_unused_parameter;
72 /* Type(s) of debugging information we are producing (if any). See
73 flags.h for the definitions of the different possible types of
74 debugging information. */
75 enum debug_info_type write_symbols = NO_DEBUG;
77 /* Level of debugging information we are producing. See flags.h for
78 the definitions of the different possible levels. */
79 enum debug_info_level debug_info_level = DINFO_LEVEL_NONE;
81 /* A major contribution to object and executable size is debug
82 information size. A major contribution to debug information size
83 is struct descriptions replicated in several object files. The
84 following flags attempt to reduce this information. The basic
85 idea is to not emit struct debugging information in the current
86 compilation unit when that information will be generated by
87 another compilation unit.
89 Debug information for a struct defined in the current source
90 file should be generated in the object file. Likewise the
91 debug information for a struct defined in a header should be
92 generated in the object file of the corresponding source file.
93 Both of these case are handled when the base name of the file of
94 the struct definition matches the base name of the source file
95 of thet current compilation unit. This matching emits minimal
96 struct debugging information.
98 The base file name matching rule above will fail to emit debug
99 information for structs defined in system headers. So a second
100 category of files includes system headers in addition to files
103 The remaining types of files are library headers and application
104 headers. We cannot currently distinguish these two types. */
106 enum debug_struct_file
108 DINFO_STRUCT_FILE_NONE, /* Debug no structs. */
109 DINFO_STRUCT_FILE_BASE, /* Debug structs defined in files with the
110 same base name as the compilation unit. */
111 DINFO_STRUCT_FILE_SYS, /* Also debug structs defined in system
113 DINFO_STRUCT_FILE_ANY /* Debug structs defined in all files. */
116 /* Generic structs (e.g. templates not explicitly specialized)
117 may not have a compilation unit associated with them, and so
118 may need to be treated differently from ordinary structs.
120 Structs only handled by reference (indirectly), will also usually
121 not need as much debugging information. */
123 static enum debug_struct_file debug_struct_ordinary[DINFO_USAGE_NUM_ENUMS]
124 = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY };
125 static enum debug_struct_file debug_struct_generic[DINFO_USAGE_NUM_ENUMS]
126 = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY };
128 /* Parse the -femit-struct-debug-detailed option value
129 and set the flag variables. */
131 #define MATCH( prefix, string ) \
132 ((strncmp (prefix, string, sizeof prefix - 1) == 0) \
133 ? ((string += sizeof prefix - 1), 1) : 0)
136 set_struct_debug_option (const char *spec)
138 /* various labels for comparison */
139 static char dfn_lbl[] = "dfn:", dir_lbl[] = "dir:", ind_lbl[] = "ind:";
140 static char ord_lbl[] = "ord:", gen_lbl[] = "gen:";
141 static char none_lbl[] = "none", any_lbl[] = "any";
142 static char base_lbl[] = "base", sys_lbl[] = "sys";
144 enum debug_struct_file files = DINFO_STRUCT_FILE_ANY;
145 /* Default is to apply to as much as possible. */
146 enum debug_info_usage usage = DINFO_USAGE_NUM_ENUMS;
147 int ord = 1, gen = 1;
150 if (MATCH (dfn_lbl, spec))
151 usage = DINFO_USAGE_DFN;
152 else if (MATCH (dir_lbl, spec))
153 usage = DINFO_USAGE_DIR_USE;
154 else if (MATCH (ind_lbl, spec))
155 usage = DINFO_USAGE_IND_USE;
157 /* Generics or not? */
158 if (MATCH (ord_lbl, spec))
160 else if (MATCH (gen_lbl, spec))
163 /* What allowable environment? */
164 if (MATCH (none_lbl, spec))
165 files = DINFO_STRUCT_FILE_NONE;
166 else if (MATCH (any_lbl, spec))
167 files = DINFO_STRUCT_FILE_ANY;
168 else if (MATCH (sys_lbl, spec))
169 files = DINFO_STRUCT_FILE_SYS;
170 else if (MATCH (base_lbl, spec))
171 files = DINFO_STRUCT_FILE_BASE;
173 error ("argument %qs to %<-femit-struct-debug-detailed%> not recognized",
176 /* Effect the specification. */
177 if (usage == DINFO_USAGE_NUM_ENUMS)
181 debug_struct_ordinary[DINFO_USAGE_DFN] = files;
182 debug_struct_ordinary[DINFO_USAGE_DIR_USE] = files;
183 debug_struct_ordinary[DINFO_USAGE_IND_USE] = files;
187 debug_struct_generic[DINFO_USAGE_DFN] = files;
188 debug_struct_generic[DINFO_USAGE_DIR_USE] = files;
189 debug_struct_generic[DINFO_USAGE_IND_USE] = files;
195 debug_struct_ordinary[usage] = files;
197 debug_struct_generic[usage] = files;
201 set_struct_debug_option (spec+1);
204 /* No more -femit-struct-debug-detailed specifications.
207 error ("argument %qs to %<-femit-struct-debug-detailed%> unknown",
209 if (debug_struct_ordinary[DINFO_USAGE_DIR_USE]
210 < debug_struct_ordinary[DINFO_USAGE_IND_USE]
211 || debug_struct_generic[DINFO_USAGE_DIR_USE]
212 < debug_struct_generic[DINFO_USAGE_IND_USE])
213 error ("%<-femit-struct-debug-detailed=dir:...%> must allow at least"
214 " as much as %<-femit-struct-debug-detailed=ind:...%>");
218 /* Find the base name of a path, stripping off both directories and
219 a single final extension. */
221 base_of_path (const char *path, const char **base_out)
223 const char *base = path;
225 const char *p = path;
229 if (IS_DIR_SEPARATOR(c))
244 /* Match the base name of a file to the base name of a compilation unit. */
246 static const char *main_input_basename;
247 static int main_input_baselength;
250 matches_main_base (const char *path)
252 /* Cache the last query. */
253 static const char *last_path = NULL;
254 static int last_match = 0;
255 if (path != last_path)
258 int length = base_of_path (path, &base);
260 last_match = (length == main_input_baselength
261 && memcmp (base, main_input_basename, length) == 0);
266 #ifdef DEBUG_DEBUG_STRUCT
269 dump_struct_debug (tree type, enum debug_info_usage usage,
270 enum debug_struct_file criterion, int generic,
271 int matches, int result)
273 /* Find the type name. */
274 tree type_decl = TYPE_STUB_DECL (type);
276 const char *name = 0;
277 if (TREE_CODE (t) == TYPE_DECL)
280 name = IDENTIFIER_POINTER (t);
282 fprintf (stderr, " struct %d %s %s %s %s %d %p %s\n",
284 DECL_IN_SYSTEM_HEADER (type_decl) ? "sys" : "usr",
285 matches ? "bas" : "hdr",
286 generic ? "gen" : "ord",
287 usage == DINFO_USAGE_DFN ? ";" :
288 usage == DINFO_USAGE_DIR_USE ? "." : "*",
290 (void*) type_decl, name);
293 #define DUMP_GSTRUCT(type, usage, criterion, generic, matches, result) \
294 dump_struct_debug (type, usage, criterion, generic, matches, result)
298 #define DUMP_GSTRUCT(type, usage, criterion, generic, matches, result) \
305 should_emit_struct_debug (tree type, enum debug_info_usage usage)
307 enum debug_struct_file criterion;
309 bool generic = lang_hooks.types.generic_p (type);
312 criterion = debug_struct_generic[usage];
314 criterion = debug_struct_ordinary[usage];
316 if (criterion == DINFO_STRUCT_FILE_NONE)
317 return DUMP_GSTRUCT (type, usage, criterion, generic, false, false);
318 if (criterion == DINFO_STRUCT_FILE_ANY)
319 return DUMP_GSTRUCT (type, usage, criterion, generic, false, true);
321 type_decl = TYPE_STUB_DECL (type);
323 if (criterion == DINFO_STRUCT_FILE_SYS && DECL_IN_SYSTEM_HEADER (type_decl))
324 return DUMP_GSTRUCT (type, usage, criterion, generic, false, true);
326 if (matches_main_base (DECL_SOURCE_FILE (type_decl)))
327 return DUMP_GSTRUCT (type, usage, criterion, generic, true, true);
328 return DUMP_GSTRUCT (type, usage, criterion, generic, false, false);
331 /* Nonzero means use GNU-only extensions in the generated symbolic
332 debugging information. Currently, this only has an effect when
333 write_symbols is set to DBX_DEBUG, XCOFF_DEBUG, or DWARF_DEBUG. */
334 bool use_gnu_debug_info_extensions;
336 /* The default visibility for all symbols (unless overridden) */
337 enum symbol_visibility default_visibility = VISIBILITY_DEFAULT;
339 /* Disable unit-at-a-time for frontends that might be still broken in this
342 bool no_unit_at_a_time_default;
344 /* Global visibility options. */
345 struct visibility_flags visibility_options;
347 /* What to print when a switch has no documentation. */
348 static const char undocumented_msg[] = N_("This switch lacks documentation");
350 /* Used for bookkeeping on whether user set these flags so
351 -fprofile-use/-fprofile-generate does not use them. */
352 static bool profile_arc_flag_set, flag_profile_values_set;
353 static bool flag_unroll_loops_set, flag_tracer_set;
354 static bool flag_value_profile_transformations_set;
355 static bool flag_peel_loops_set, flag_branch_probabilities_set;
357 /* Input file names. */
358 const char **in_fnames;
359 unsigned num_in_fnames;
361 static int common_handle_option (size_t scode, const char *arg, int value,
362 unsigned int lang_mask);
363 static void handle_param (const char *);
364 static void set_Wextra (int);
365 static unsigned int handle_option (const char **argv, unsigned int lang_mask);
366 static char *write_langs (unsigned int lang_mask);
367 static void complain_wrong_lang (const char *, const struct cl_option *,
368 unsigned int lang_mask);
369 static void handle_options (unsigned int, const char **, unsigned int);
370 static void set_debug_level (enum debug_info_type type, int extended,
373 /* If ARG is a non-negative integer made up solely of digits, return its
374 value, otherwise return -1. */
376 integral_argument (const char *arg)
380 while (*p && ISDIGIT (*p))
389 /* Return a malloced slash-separated list of languages in MASK. */
391 write_langs (unsigned int mask)
393 unsigned int n = 0, len = 0;
394 const char *lang_name;
397 for (n = 0; (lang_name = lang_names[n]) != 0; n++)
398 if (mask & (1U << n))
399 len += strlen (lang_name) + 1;
401 result = XNEWVEC (char, len);
403 for (n = 0; (lang_name = lang_names[n]) != 0; n++)
404 if (mask & (1U << n))
408 strcpy (result + len, lang_name);
409 len += strlen (lang_name);
417 /* Complain that switch OPT_INDEX does not apply to this front end. */
419 complain_wrong_lang (const char *text, const struct cl_option *option,
420 unsigned int lang_mask)
422 char *ok_langs, *bad_lang;
424 ok_langs = write_langs (option->flags);
425 bad_lang = write_langs (lang_mask);
427 /* Eventually this should become a hard error IMO. */
428 warning (0, "command line option \"%s\" is valid for %s but not for %s",
429 text, ok_langs, bad_lang);
435 /* Handle the switch beginning at ARGV for the language indicated by
436 LANG_MASK. Returns the number of switches consumed. */
438 handle_option (const char **argv, unsigned int lang_mask)
441 const char *opt, *arg = 0;
444 unsigned int result = 0;
445 const struct cl_option *option;
449 opt_index = find_opt (opt + 1, lang_mask | CL_COMMON | CL_TARGET);
450 if (opt_index == cl_options_count
451 && (opt[1] == 'W' || opt[1] == 'f' || opt[1] == 'm')
452 && opt[2] == 'n' && opt[3] == 'o' && opt[4] == '-')
454 /* Drop the "no-" from negative switches. */
455 size_t len = strlen (opt) - 3;
457 dup = XNEWVEC (char, len + 1);
460 memcpy (dup + 2, opt + 5, len - 2 + 1);
463 opt_index = find_opt (opt + 1, lang_mask | CL_COMMON | CL_TARGET);
466 if (opt_index == cl_options_count)
469 option = &cl_options[opt_index];
471 /* Reject negative form of switches that don't take negatives as
473 if (!value && (option->flags & CL_REJECT_NEGATIVE))
476 /* We've recognized this switch. */
479 /* Check to see if the option is disabled for this configuration. */
480 if (option->flags & CL_DISABLED)
482 error ("command line option %qs"
483 " is not supported by this configuration", opt);
487 /* Sort out any argument the switch takes. */
488 if (option->flags & CL_JOINED)
490 /* Have arg point to the original switch. This is because
491 some code, such as disable_builtin_function, expects its
492 argument to be persistent until the program exits. */
493 arg = argv[0] + cl_options[opt_index].opt_len + 1;
495 arg += strlen ("no-");
497 if (*arg == '\0' && !(option->flags & CL_MISSING_OK))
499 if (option->flags & CL_SEPARATE)
505 /* Missing argument. */
509 else if (option->flags & CL_SEPARATE)
515 /* Now we've swallowed any potential argument, complain if this
516 is a switch for a different front end. */
517 if (!(option->flags & (lang_mask | CL_COMMON | CL_TARGET)))
519 complain_wrong_lang (argv[0], option, lang_mask);
522 else if ((option->flags & CL_TARGET)
523 && (option->flags & CL_LANG_ALL)
524 && !(option->flags & lang_mask))
526 /* Complain for target flag language mismatches if any languages
528 complain_wrong_lang (argv[0], option, lang_mask);
532 if (arg == NULL && (option->flags & (CL_JOINED | CL_SEPARATE)))
534 if (!lang_hooks.missing_argument (opt, opt_index))
535 error ("missing argument to \"%s\"", opt);
539 /* If the switch takes an integer, convert it. */
540 if (arg && (option->flags & CL_UINTEGER))
542 value = integral_argument (arg);
545 error ("argument to \"%s\" should be a non-negative integer",
551 if (option->flag_var)
552 switch (option->var_type)
555 *(int *) option->flag_var = value;
559 *(int *) option->flag_var = (value
561 : !option->var_value);
566 if ((value != 0) == (option->var_type == CLVC_BIT_SET))
567 *(int *) option->flag_var |= option->var_value;
569 *(int *) option->flag_var &= ~option->var_value;
570 if (option->flag_var == &target_flags)
571 target_flags_explicit |= option->var_value;
575 *(const char **) option->flag_var = arg;
579 if (option->flags & lang_mask)
580 if (lang_hooks.handle_option (opt_index, arg, value) == 0)
583 if (result && (option->flags & CL_COMMON))
584 if (common_handle_option (opt_index, arg, value, lang_mask) == 0)
587 if (result && (option->flags & CL_TARGET))
588 if (!targetm.handle_option (opt_index, arg, value))
597 /* Handle FILENAME from the command line. */
599 add_input_filename (const char *filename)
602 in_fnames = xrealloc (in_fnames, num_in_fnames * sizeof (in_fnames[0]));
603 in_fnames[num_in_fnames - 1] = filename;
606 /* Decode and handle the vector of command line options. LANG_MASK
607 contains has a single bit set representing the current
610 handle_options (unsigned int argc, const char **argv, unsigned int lang_mask)
614 for (i = 1; i < argc; i += n)
616 const char *opt = argv[i];
618 /* Interpret "-" or a non-switch as a file name. */
619 if (opt[0] != '-' || opt[1] == '\0')
621 if (main_input_filename == NULL)
623 main_input_filename = opt;
624 main_input_baselength
625 = base_of_path (main_input_filename, &main_input_basename);
627 add_input_filename (opt);
632 n = handle_option (argv + i, lang_mask);
637 error ("unrecognized command line option \"%s\"", opt);
642 /* Parse command line options and set default flag values. Do minimal
643 options processing. */
645 decode_options (unsigned int argc, const char **argv)
647 unsigned int i, lang_mask;
649 /* Perform language-specific options initialization. */
650 lang_mask = lang_hooks.init_options (argc, argv);
652 lang_hooks.initialize_diagnostics (global_dc);
654 /* Scan to see what optimization level has been specified. That will
655 determine the default value of many flags. */
656 for (i = 1; i < argc; i++)
658 if (!strcmp (argv[i], "-O"))
663 else if (argv[i][0] == '-' && argv[i][1] == 'O')
665 /* Handle -Os, -O2, -O3, -O69, ... */
666 const char *p = &argv[i][2];
668 if ((p[0] == 's') && (p[1] == 0))
672 /* Optimizing for size forces optimize to be 2. */
677 const int optimize_val = read_integral_parameter (p, p - 2, -1);
678 if (optimize_val != -1)
680 optimize = optimize_val;
689 flag_merge_constants = 0;
696 flag_delayed_branch = 1;
698 #ifdef CAN_DEBUG_WITHOUT_FP
699 flag_omit_frame_pointer = 1;
701 flag_guess_branch_prob = 1;
702 flag_cprop_registers = 1;
703 flag_if_conversion = 1;
704 flag_if_conversion2 = 1;
705 flag_ipa_pure_const = 1;
706 flag_ipa_reference = 1;
707 flag_split_wide_types = 1;
714 flag_tree_copyrename = 1;
716 flag_tree_copy_prop = 1;
718 flag_tree_salias = 1;
719 if (!no_unit_at_a_time_default)
720 flag_unit_at_a_time = 1;
724 /* Loop header copying usually increases size of the code. This used
725 not to be true, since quite often it is possible to verify that
726 the condition is satisfied in the first iteration and therefore
727 to eliminate it. Jump threading handles these cases now. */
734 flag_thread_jumps = 1;
735 flag_crossjumping = 1;
736 flag_optimize_sibling_calls = 1;
737 flag_forward_propagate = 1;
738 flag_cse_follow_jumps = 1;
740 flag_expensive_optimizations = 1;
741 flag_ipa_type_escape = 1;
742 flag_rerun_cse_after_loop = 1;
743 flag_caller_saves = 1;
745 #ifdef INSN_SCHEDULING
746 flag_schedule_insns = 1;
747 flag_schedule_insns_after_reload = 1;
750 flag_strict_aliasing = 1;
751 flag_strict_overflow = 1;
752 flag_delete_null_pointer_checks = 1;
753 flag_reorder_blocks = 1;
754 flag_reorder_functions = 1;
755 flag_tree_store_ccp = 1;
756 flag_tree_store_copy_prop = 1;
761 /* PRE tends to generate bigger code. */
765 /* Allow more virtual operators to increase alias precision. */
766 set_param_value ("max-aliased-vops", 500);
771 flag_predictive_commoning = 1;
772 flag_inline_functions = 1;
773 flag_unswitch_loops = 1;
774 flag_gcse_after_reload = 1;
776 /* Allow even more virtual operators. */
777 set_param_value ("max-aliased-vops", 1000);
778 set_param_value ("avg-aliased-vops", 3);
781 if (optimize < 2 || optimize_size)
788 /* Don't reorder blocks when optimizing for size because extra
789 jump insns may be created; also barrier may create extra padding.
791 More correctly we should have a block reordering mode that tried
792 to minimize the combined size of all the jumps. This would more
793 or less automatically remove extra jumps, but would also try to
794 use more short jumps instead of long jumps. */
795 flag_reorder_blocks = 0;
796 flag_reorder_blocks_and_partition = 0;
801 /* Inlining of functions reducing size is a good idea regardless
802 of them being declared inline. */
803 flag_inline_functions = 1;
805 /* We want to crossjump as much as possible. */
806 set_param_value ("min-crossjump-insns", 1);
809 /* Initialize whether `char' is signed. */
810 flag_signed_char = DEFAULT_SIGNED_CHAR;
811 /* Set this to a special "uninitialized" value. The actual default is set
812 after target options have been processed. */
813 flag_short_enums = 2;
815 /* Initialize target_flags before OPTIMIZATION_OPTIONS so the latter can
817 target_flags = targetm.default_target_flags;
819 /* Some tagets have ABI-specified unwind tables. */
820 flag_unwind_tables = targetm.unwind_tables_default;
822 #ifdef OPTIMIZATION_OPTIONS
823 /* Allow default optimizations to be specified on a per-machine basis. */
824 OPTIMIZATION_OPTIONS (optimize, optimize_size);
827 handle_options (argc, argv, lang_mask);
831 if (flag_pic && !flag_pie)
834 if (flag_no_inline == 2)
837 flag_really_no_inline = flag_no_inline;
839 /* Set flag_no_inline before the post_options () hook. The C front
840 ends use it to determine tree inlining defaults. FIXME: such
841 code should be lang-independent when all front ends use tree
842 inlining, in which case it, and this condition, should be moved
843 to the top of process_options() instead. */
846 /* Inlining does not work if not optimizing,
847 so force it not to be done. */
851 /* The c_decode_option function and decode_option hook set
852 this to `2' if -Wall is used, so we can avoid giving out
853 lots of errors for people who don't realize what -Wall does. */
854 if (warn_uninitialized == 1)
855 warning (OPT_Wuninitialized,
856 "-Wuninitialized is not supported without -O");
859 if (flag_really_no_inline == 2)
860 flag_really_no_inline = flag_no_inline;
862 /* The optimization to partition hot and cold basic blocks into separate
863 sections of the .o and executable files does not work (currently)
864 with exception handling. This is because there is no support for
865 generating unwind info. If flag_exceptions is turned on we need to
866 turn off the partitioning optimization. */
868 if (flag_exceptions && flag_reorder_blocks_and_partition)
871 ("-freorder-blocks-and-partition does not work with exceptions");
872 flag_reorder_blocks_and_partition = 0;
873 flag_reorder_blocks = 1;
876 /* If user requested unwind info, then turn off the partitioning
879 if (flag_unwind_tables && ! targetm.unwind_tables_default
880 && flag_reorder_blocks_and_partition)
882 inform ("-freorder-blocks-and-partition does not support unwind info");
883 flag_reorder_blocks_and_partition = 0;
884 flag_reorder_blocks = 1;
887 /* If the target requested unwind info, then turn off the partitioning
888 optimization with a different message. Likewise, if the target does not
889 support named sections. */
891 if (flag_reorder_blocks_and_partition
892 && (!targetm.have_named_sections
893 || (flag_unwind_tables && targetm.unwind_tables_default)))
896 ("-freorder-blocks-and-partition does not work on this architecture");
897 flag_reorder_blocks_and_partition = 0;
898 flag_reorder_blocks = 1;
902 #define LEFT_COLUMN 27
904 /* Output ITEM, of length ITEM_WIDTH, in the left column,
905 followed by word-wrapped HELP in a second column. */
907 wrap_help (const char *help,
909 unsigned int item_width,
910 unsigned int columns)
912 unsigned int col_width = LEFT_COLUMN;
913 unsigned int remaining, room, len;
915 remaining = strlen (help);
919 room = columns - 3 - MAX (col_width, item_width);
928 for (i = 0; help[i]; i++)
930 if (i >= room && len != remaining)
934 else if ((help[i] == '-' || help[i] == '/')
935 && help[i + 1] != ' '
936 && i > 0 && ISALPHA (help[i - 1]))
941 printf( " %-*.*s %.*s\n", col_width, item_width, item, len, help);
943 while (help[len] == ' ')
951 /* Print help for a specific front-end, etc. */
953 print_filtered_help (unsigned int include_flags,
954 unsigned int exclude_flags,
955 unsigned int any_flags,
956 unsigned int columns)
960 static char *printed = NULL;
962 bool displayed = false;
964 if (include_flags == CL_PARAMS)
966 for (i = 0; i < LAST_PARAM; i++)
968 const char *param = compiler_params[i].option;
970 help = compiler_params[i].help;
971 if (help == NULL || *help == '\0')
973 if (exclude_flags & CL_UNDOCUMENTED)
975 help = undocumented_msg;
978 /* Get the translation. */
981 wrap_help (help, param, strlen (param), columns);
988 printed = xcalloc (1, cl_options_count);
990 for (i = 0; i < cl_options_count; i++)
992 static char new_help[128];
993 const struct cl_option *option = cl_options + i;
998 if (include_flags == 0
999 || ((option->flags & include_flags) != include_flags))
1001 if ((option->flags & any_flags) == 0)
1005 /* Skip unwanted switches. */
1006 if ((option->flags & exclude_flags) != 0)
1010 /* Skip switches that have already been printed. */
1016 help = option->help;
1019 if (exclude_flags & CL_UNDOCUMENTED)
1021 help = undocumented_msg;
1024 /* Get the translation. */
1027 /* Find the gap between the name of the
1028 option and its descriptive text. */
1029 tab = strchr (help, '\t');
1038 opt = option->opt_text;
1042 /* With the -Q option enabled we change the descriptive text associated
1043 with an option to be an indication of its current setting. */
1046 if (len < (LEFT_COLUMN + 2))
1047 strcpy (new_help, "\t\t");
1049 strcpy (new_help, "\t");
1051 if (option->flag_var != NULL)
1053 if (option->flags & CL_JOINED)
1055 if (option->var_type == CLVC_STRING)
1057 if (* (const char **) option->flag_var != NULL)
1058 snprintf (new_help + strlen (new_help),
1059 sizeof (new_help) - strlen (new_help),
1060 * (const char **) option->flag_var);
1063 sprintf (new_help + strlen (new_help),
1064 "%#x", * (int *) option->flag_var);
1067 strcat (new_help, option_enabled (i)
1068 ? _("[enabled]") : _("[disabled]"));
1074 wrap_help (help, opt, len, columns);
1079 printf (_(" No options with the desired characteristics were found\n"));
1080 else if (! displayed)
1081 printf (_(" All options with the desired characteristics have already been displayed\n"));
1086 /* Display help for a specified type of option.
1087 The options must have ALL of the INCLUDE_FLAGS set
1088 ANY of the flags in the ANY_FLAGS set
1089 and NONE of the EXCLUDE_FLAGS set. */
1091 print_specific_help (unsigned int include_flags,
1092 unsigned int exclude_flags,
1093 unsigned int any_flags)
1095 unsigned int all_langs_mask = (1U << cl_lang_count) - 1;
1096 const char * description = NULL;
1097 const char * descrip_extra = "";
1100 static unsigned int columns = 0;
1102 /* Sanity check: Make sure that we do not have more
1103 languages than we have bits available to enumerate them. */
1104 gcc_assert ((1U << cl_lang_count) < CL_MIN_OPTION_CLASS);
1106 /* If we have not done so already, obtain
1107 the desired maximum width of the output. */
1112 GET_ENVIRONMENT (p, "COLUMNS");
1115 int value = atoi (p);
1122 /* Use a reasonable default. */
1126 /* Decide upon the title for the options that we are going to display. */
1127 for (i = 0, flag = 1; flag <= CL_MAX_OPTION_CLASS; flag <<= 1, i ++)
1129 switch (flag & include_flags)
1135 description = _("The following options are target specific");
1138 description = _("The following options control compiler warning messages");
1140 case CL_OPTIMIZATION:
1141 description = _("The following options control optimizations");
1144 description = _("The following options are language-independent");
1147 description = _("The --param option recognizes the following as parameters");
1150 if (i >= cl_lang_count)
1152 if ((exclude_flags & ((1U << cl_lang_count) - 1)) != 0)
1154 description = _("The following options are specific to the language ");
1155 descrip_extra = lang_names [i];
1158 description = _("The following options are supported by the language ");
1159 descrip_extra = lang_names [i];
1164 if (description == NULL)
1168 if (include_flags == CL_UNDOCUMENTED)
1169 description = _("The following options are not documented");
1172 internal_error ("unrecognized include_flags 0x%x passed to print_specific_help",
1179 if (any_flags & all_langs_mask)
1180 description = _("The following options are language-related");
1182 description = _("The following options are language-independent");
1186 printf ("%s%s:\n", description, descrip_extra);
1187 print_filtered_help (include_flags, exclude_flags, any_flags, columns);
1190 /* Handle target- and language-independent options. Return zero to
1191 generate an "unknown option" message. Only options that need
1192 extra handling need to be listed here; if you simply want
1193 VALUE assigned to a variable, it happens automatically. */
1196 common_handle_option (size_t scode, const char *arg, int value,
1197 unsigned int lang_mask)
1199 enum opt_code code = (enum opt_code) scode;
1210 unsigned int all_langs_mask = (1U << cl_lang_count) - 1;
1211 unsigned int undoc_mask;
1214 undoc_mask = extra_warnings ? 0 : CL_UNDOCUMENTED;
1215 /* First display any single language specific options. */
1216 for (i = 0; i < cl_lang_count; i++)
1218 (1U << i, (all_langs_mask & (~ (1U << i))) | undoc_mask, 0);
1219 /* Next display any multi language specific options. */
1220 print_specific_help (0, undoc_mask, all_langs_mask);
1221 /* Then display any remaining, non-language options. */
1222 for (i = CL_MIN_OPTION_CLASS; i <= CL_MAX_OPTION_CLASS; i <<= 1)
1223 print_specific_help (i, undoc_mask, 0);
1224 exit_after_options = true;
1228 case OPT_ftarget_help:
1229 case OPT__target_help:
1230 print_specific_help (CL_TARGET, CL_UNDOCUMENTED, 0);
1231 exit_after_options = true;
1237 const char * a = arg;
1238 unsigned int include_flags = 0;
1239 /* Note - by default we include undocumented options when listing
1240 specific classes. If you only want to see documented options
1241 then add ",^undocumented" to the --help= option. e.g.:
1243 --help=target,^undocumented */
1244 unsigned int exclude_flags = 0;
1246 /* Walk along the argument string, parsing each word in turn.
1248 arg = [^]{word}[,{arg}]
1249 word = {optimizers|target|warnings|undocumented|
1250 params|common|<language>} */
1255 const char * string;
1260 { "optimizers", CL_OPTIMIZATION },
1261 { "target", CL_TARGET },
1262 { "warnings", CL_WARNING },
1263 { "undocumented", CL_UNDOCUMENTED },
1264 { "params", CL_PARAMS },
1265 { "joined", CL_JOINED },
1266 { "separate", CL_SEPARATE },
1267 { "common", CL_COMMON },
1270 unsigned int * pflags;
1278 pflags = & exclude_flags;
1281 pflags = & include_flags;
1283 comma = strchr (a, ',');
1289 for (i = 0; specifics[i].string != NULL; i++)
1290 if (strncasecmp (a, specifics[i].string, len) == 0)
1292 * pflags |= specifics[i].flag;
1296 if (specifics[i].string == NULL)
1298 /* Check to see if the string matches a language name. */
1299 for (i = 0; i < cl_lang_count; i++)
1300 if (strncasecmp (a, lang_names[i], len) == 0)
1302 * pflags |= 1U << i;
1306 if (i == cl_lang_count)
1308 "warning: unrecognized argument to --help= switch: %.*s\n",
1318 print_specific_help (include_flags, exclude_flags, 0);
1319 exit_after_options = true;
1324 print_version (stderr, "");
1325 exit_after_options = true;
1329 g_switch_value = value;
1330 g_switch_set = true;
1335 /* Currently handled in a prescan. */
1339 /* For backward compatibility, -W is the same as -Wextra. */
1344 enable_warning_as_error (arg, value, lang_mask);
1351 case OPT_Wlarger_than_:
1352 larger_than_size = value;
1353 warn_larger_than = value != -1;
1356 case OPT_Wstrict_aliasing:
1357 set_Wstrict_aliasing (value);
1360 case OPT_Wstrict_aliasing_:
1361 warn_strict_aliasing = value;
1364 case OPT_Wstrict_overflow:
1365 warn_strict_overflow = (value
1366 ? (int) WARN_STRICT_OVERFLOW_CONDITIONAL
1370 case OPT_Wstrict_overflow_:
1371 warn_strict_overflow = value;
1375 set_Wunused (value);
1380 aux_info_file_name = arg;
1381 flag_gen_aux_info = 1;
1385 aux_base_name = arg;
1388 case OPT_auxbase_strip:
1390 char *tmp = xstrdup (arg);
1391 strip_off_ending (tmp, strlen (tmp));
1393 aux_base_name = tmp;
1398 decode_d_option (arg);
1402 dump_base_name = arg;
1405 case OPT_falign_functions_:
1406 align_functions = value;
1409 case OPT_falign_jumps_:
1410 align_jumps = value;
1413 case OPT_falign_labels_:
1414 align_labels = value;
1417 case OPT_falign_loops_:
1418 align_loops = value;
1421 case OPT_fbranch_probabilities:
1422 flag_branch_probabilities_set = true;
1425 case OPT_fcall_used_:
1426 fix_register (arg, 0, 1);
1429 case OPT_fcall_saved_:
1430 fix_register (arg, 0, 0);
1434 dbg_cnt_process_opt (arg);
1437 case OPT_fdbg_cnt_list:
1438 dbg_cnt_list_all_counters ();
1441 case OPT_fdiagnostics_show_location_:
1442 if (!strcmp (arg, "once"))
1443 diagnostic_prefixing_rule (global_dc) = DIAGNOSTICS_SHOW_PREFIX_ONCE;
1444 else if (!strcmp (arg, "every-line"))
1445 diagnostic_prefixing_rule (global_dc)
1446 = DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE;
1451 case OPT_fdiagnostics_show_option:
1452 global_dc->show_option_requested = true;
1456 if (!dump_switch_p (arg))
1460 case OPT_ffast_math:
1461 set_fast_math_flags (value);
1465 fix_register (arg, 1, 1);
1468 case OPT_finline_limit_:
1469 case OPT_finline_limit_eq:
1470 set_param_value ("max-inline-insns-single", value / 2);
1471 set_param_value ("max-inline-insns-auto", value / 2);
1474 case OPT_fmessage_length_:
1475 pp_set_line_maximum_length (global_dc->printer, value);
1478 case OPT_fpack_struct_:
1479 if (value <= 0 || (value & (value - 1)) || value > 16)
1480 error ("structure alignment must be a small power of two, not %d", value);
1483 initial_max_fld_align = value;
1484 maximum_field_alignment = value * BITS_PER_UNIT;
1488 case OPT_fpeel_loops:
1489 flag_peel_loops_set = true;
1492 case OPT_fprofile_arcs:
1493 profile_arc_flag_set = true;
1496 case OPT_fprofile_use:
1497 if (!flag_branch_probabilities_set)
1498 flag_branch_probabilities = value;
1499 if (!flag_profile_values_set)
1500 flag_profile_values = value;
1501 if (!flag_unroll_loops_set)
1502 flag_unroll_loops = value;
1503 if (!flag_peel_loops_set)
1504 flag_peel_loops = value;
1505 if (!flag_tracer_set)
1506 flag_tracer = value;
1507 if (!flag_value_profile_transformations_set)
1508 flag_value_profile_transformations = value;
1511 case OPT_fprofile_generate:
1512 if (!profile_arc_flag_set)
1513 profile_arc_flag = value;
1514 if (!flag_profile_values_set)
1515 flag_profile_values = value;
1516 if (!flag_value_profile_transformations_set)
1517 flag_value_profile_transformations = value;
1520 case OPT_fprofile_values:
1521 flag_profile_values_set = true;
1524 case OPT_fvisibility_:
1526 if (!strcmp(arg, "default"))
1527 default_visibility = VISIBILITY_DEFAULT;
1528 else if (!strcmp(arg, "internal"))
1529 default_visibility = VISIBILITY_INTERNAL;
1530 else if (!strcmp(arg, "hidden"))
1531 default_visibility = VISIBILITY_HIDDEN;
1532 else if (!strcmp(arg, "protected"))
1533 default_visibility = VISIBILITY_PROTECTED;
1535 error ("unrecognized visibility value \"%s\"", arg);
1540 flag_value_profile_transformations_set = true;
1543 case OPT_frandom_seed:
1544 /* The real switch is -fno-random-seed. */
1547 set_random_seed (NULL);
1550 case OPT_frandom_seed_:
1551 set_random_seed (arg);
1554 case OPT_fsched_verbose_:
1555 #ifdef INSN_SCHEDULING
1556 fix_sched_param ("verbose", arg);
1562 case OPT_fsched_stalled_insns_:
1563 flag_sched_stalled_insns = value;
1564 if (flag_sched_stalled_insns == 0)
1565 flag_sched_stalled_insns = -1;
1568 case OPT_fsched_stalled_insns_dep_:
1569 flag_sched_stalled_insns_dep = value;
1572 case OPT_fstack_limit:
1573 /* The real switch is -fno-stack-limit. */
1576 stack_limit_rtx = NULL_RTX;
1579 case OPT_fstack_limit_register_:
1581 int reg = decode_reg_name (arg);
1583 error ("unrecognized register name \"%s\"", arg);
1585 stack_limit_rtx = gen_rtx_REG (Pmode, reg);
1589 case OPT_fstack_limit_symbol_:
1590 stack_limit_rtx = gen_rtx_SYMBOL_REF (Pmode, ggc_strdup (arg));
1593 case OPT_ftree_vectorizer_verbose_:
1594 vect_set_verbosity_level (arg);
1597 case OPT_ftls_model_:
1598 if (!strcmp (arg, "global-dynamic"))
1599 flag_tls_default = TLS_MODEL_GLOBAL_DYNAMIC;
1600 else if (!strcmp (arg, "local-dynamic"))
1601 flag_tls_default = TLS_MODEL_LOCAL_DYNAMIC;
1602 else if (!strcmp (arg, "initial-exec"))
1603 flag_tls_default = TLS_MODEL_INITIAL_EXEC;
1604 else if (!strcmp (arg, "local-exec"))
1605 flag_tls_default = TLS_MODEL_LOCAL_EXEC;
1607 warning (0, "unknown tls-model \"%s\"", arg);
1611 flag_tracer_set = true;
1614 case OPT_funroll_loops:
1615 flag_unroll_loops_set = true;
1619 set_debug_level (NO_DEBUG, DEFAULT_GDB_EXTENSIONS, arg);
1623 set_debug_level (SDB_DEBUG, false, arg);
1627 set_debug_level (DWARF2_DEBUG, false, arg);
1631 set_debug_level (NO_DEBUG, 2, arg);
1636 set_debug_level (DBX_DEBUG, code == OPT_gstabs_, arg);
1640 set_debug_level (VMS_DEBUG, false, arg);
1645 set_debug_level (XCOFF_DEBUG, code == OPT_gxcoff_, arg);
1649 asm_file_name = arg;
1652 case OPT_pedantic_errors:
1653 flag_pedantic_errors = pedantic = 1;
1656 case OPT_floop_optimize:
1657 case OPT_frerun_loop_opt:
1658 case OPT_fstrength_reduce:
1659 /* These are no-ops, preserved for backward compatibility. */
1663 /* If the flag was handled in a standard way, assume the lack of
1664 processing here is intentional. */
1665 gcc_assert (cl_options[scode].flag_var);
1672 /* Handle --param NAME=VALUE. */
1674 handle_param (const char *carg)
1679 arg = xstrdup (carg);
1680 equal = strchr (arg, '=');
1682 error ("%s: --param arguments should be of the form NAME=VALUE", arg);
1685 value = integral_argument (equal + 1);
1687 error ("invalid --param value %qs", equal + 1);
1691 set_param_value (arg, value);
1698 /* Handle -W and -Wextra. */
1700 set_Wextra (int setting)
1702 extra_warnings = setting;
1703 warn_unused_parameter = (setting && maybe_warn_unused_parameter);
1705 /* We save the value of warn_uninitialized, since if they put
1706 -Wuninitialized on the command line, we need to generate a
1707 warning about not using it without also specifying -O. */
1709 warn_uninitialized = 0;
1710 else if (warn_uninitialized != 1)
1711 warn_uninitialized = 2;
1714 /* Initialize unused warning flags. */
1716 set_Wunused (int setting)
1718 warn_unused_function = setting;
1719 warn_unused_label = setting;
1720 /* Unused function parameter warnings are reported when either
1721 ``-Wextra -Wunused'' or ``-Wunused-parameter'' is specified.
1722 Thus, if -Wextra has already been seen, set warn_unused_parameter;
1723 otherwise set maybe_warn_extra_parameter, which will be picked up
1725 maybe_warn_unused_parameter = setting;
1726 warn_unused_parameter = (setting && extra_warnings);
1727 warn_unused_variable = setting;
1728 warn_unused_value = setting;
1731 /* Used to set the level of strict aliasing warnings,
1732 when no level is specified (i.e., when -Wstrict-aliasing, and not
1733 -Wstrict-aliasing=level was given).
1734 ONOFF is assumed to take value 1 when -Wstrict-aliasing is specified,
1735 and 0 otherwise. After calling this function, wstrict_aliasing will be
1736 set to the default value of -Wstrict_aliasing=level, currently 3. */
1738 set_Wstrict_aliasing (int onoff)
1740 gcc_assert (onoff == 0 || onoff == 1);
1742 warn_strict_aliasing = 3;
1745 /* The following routines are useful in setting all the flags that
1746 -ffast-math and -fno-fast-math imply. */
1748 set_fast_math_flags (int set)
1750 flag_trapping_math = !set;
1751 flag_unsafe_math_optimizations = set;
1752 flag_finite_math_only = set;
1753 flag_signed_zeros = !set;
1754 flag_errno_math = !set;
1757 flag_signaling_nans = 0;
1758 flag_rounding_math = 0;
1759 flag_cx_limited_range = 1;
1763 /* Return true iff flags are set as if -ffast-math. */
1765 fast_math_flags_set_p (void)
1767 return (!flag_trapping_math
1768 && flag_unsafe_math_optimizations
1769 && flag_finite_math_only
1770 && !flag_signed_zeros
1771 && !flag_errno_math);
1774 /* Handle a debug output -g switch. EXTENDED is true or false to support
1775 extended output (2 is special and means "-ggdb" was given). */
1777 set_debug_level (enum debug_info_type type, int extended, const char *arg)
1779 static bool type_explicit;
1781 use_gnu_debug_info_extensions = extended;
1783 if (type == NO_DEBUG)
1785 if (write_symbols == NO_DEBUG)
1787 write_symbols = PREFERRED_DEBUGGING_TYPE;
1791 #ifdef DWARF2_DEBUGGING_INFO
1792 write_symbols = DWARF2_DEBUG;
1793 #elif defined DBX_DEBUGGING_INFO
1794 write_symbols = DBX_DEBUG;
1798 if (write_symbols == NO_DEBUG)
1799 warning (0, "target system does not support debug output");
1804 /* Does it conflict with an already selected type? */
1805 if (type_explicit && write_symbols != NO_DEBUG && type != write_symbols)
1806 error ("debug format \"%s\" conflicts with prior selection",
1807 debug_type_names[type]);
1808 write_symbols = type;
1809 type_explicit = true;
1812 /* A debug flag without a level defaults to level 2. */
1815 if (!debug_info_level)
1816 debug_info_level = 2;
1820 debug_info_level = integral_argument (arg);
1821 if (debug_info_level == (unsigned int) -1)
1822 error ("unrecognised debug output level \"%s\"", arg);
1823 else if (debug_info_level > 3)
1824 error ("debug output level %s is too high", arg);
1828 /* Return 1 if OPTION is enabled, 0 if it is disabled, or -1 if it isn't
1829 a simple on-off switch. */
1832 option_enabled (int opt_idx)
1834 const struct cl_option *option = &(cl_options[opt_idx]);
1836 if (option->flag_var)
1837 switch (option->var_type)
1840 return *(int *) option->flag_var != 0;
1843 return *(int *) option->flag_var == option->var_value;
1845 case CLVC_BIT_CLEAR:
1846 return (*(int *) option->flag_var & option->var_value) == 0;
1849 return (*(int *) option->flag_var & option->var_value) != 0;
1857 /* Fill STATE with the current state of option OPTION. Return true if
1858 there is some state to store. */
1861 get_option_state (int option, struct cl_option_state *state)
1863 if (cl_options[option].flag_var == 0)
1866 switch (cl_options[option].var_type)
1870 state->data = cl_options[option].flag_var;
1871 state->size = sizeof (int);
1874 case CLVC_BIT_CLEAR:
1876 state->ch = option_enabled (option);
1877 state->data = &state->ch;
1882 state->data = *(const char **) cl_options[option].flag_var;
1883 if (state->data == 0)
1885 state->size = strlen (state->data) + 1;
1891 /* Enable a warning option as an error. This is used by -Werror= and
1892 also by legacy Werror-implicit-function-declaration. */
1895 enable_warning_as_error (const char *arg, int value, unsigned int lang_mask)
1900 new_option = XNEWVEC (char, strlen (arg) + 2);
1901 new_option[0] = 'W';
1902 strcpy (new_option + 1, arg);
1903 option_index = find_opt (new_option, lang_mask);
1904 if (option_index == N_OPTS)
1906 error ("-Werror=%s: No option -%s", arg, new_option);
1910 int kind = value ? DK_ERROR : DK_WARNING;
1911 diagnostic_classify_diagnostic (global_dc, option_index, kind);
1913 /* -Werror=foo implies -Wfoo. */
1914 if (cl_options[option_index].var_type == CLVC_BOOLEAN
1915 && cl_options[option_index].flag_var
1916 && kind == DK_ERROR)
1917 *(int *) cl_options[option_index].flag_var = 1;