1 /* Command line option handling.
2 Copyright (C) 2002-2020 Free Software Foundation, Inc.
3 Contributed by Neil Booth.
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 3, or (at your option) any later
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
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
24 #include "coretypes.h"
28 #include "diagnostic.h"
29 #include "opts-diagnostic.h"
30 #include "insn-attr-common.h"
31 #include "common/common-target.h"
32 #include "spellcheck.h"
33 #include "opt-suggestions.h"
34 #include "diagnostic-color.h"
37 static void set_Wstrict_aliasing (struct gcc_options
*opts
, int onoff
);
39 /* Indexed by enum debug_info_type. */
40 const char *const debug_type_names
[] =
42 "none", "stabs", "dwarf-2", "xcoff", "vms"
45 /* Parse the -femit-struct-debug-detailed option value
46 and set the flag variables. */
48 #define MATCH( prefix, string ) \
49 ((strncmp (prefix, string, sizeof prefix - 1) == 0) \
50 ? ((string += sizeof prefix - 1), 1) : 0)
53 set_struct_debug_option (struct gcc_options
*opts
, location_t loc
,
56 /* various labels for comparison */
57 static const char dfn_lbl
[] = "dfn:", dir_lbl
[] = "dir:", ind_lbl
[] = "ind:";
58 static const char ord_lbl
[] = "ord:", gen_lbl
[] = "gen:";
59 static const char none_lbl
[] = "none", any_lbl
[] = "any";
60 static const char base_lbl
[] = "base", sys_lbl
[] = "sys";
62 enum debug_struct_file files
= DINFO_STRUCT_FILE_ANY
;
63 /* Default is to apply to as much as possible. */
64 enum debug_info_usage usage
= DINFO_USAGE_NUM_ENUMS
;
68 if (MATCH (dfn_lbl
, spec
))
69 usage
= DINFO_USAGE_DFN
;
70 else if (MATCH (dir_lbl
, spec
))
71 usage
= DINFO_USAGE_DIR_USE
;
72 else if (MATCH (ind_lbl
, spec
))
73 usage
= DINFO_USAGE_IND_USE
;
75 /* Generics or not? */
76 if (MATCH (ord_lbl
, spec
))
78 else if (MATCH (gen_lbl
, spec
))
81 /* What allowable environment? */
82 if (MATCH (none_lbl
, spec
))
83 files
= DINFO_STRUCT_FILE_NONE
;
84 else if (MATCH (any_lbl
, spec
))
85 files
= DINFO_STRUCT_FILE_ANY
;
86 else if (MATCH (sys_lbl
, spec
))
87 files
= DINFO_STRUCT_FILE_SYS
;
88 else if (MATCH (base_lbl
, spec
))
89 files
= DINFO_STRUCT_FILE_BASE
;
92 "argument %qs to %<-femit-struct-debug-detailed%> "
96 /* Effect the specification. */
97 if (usage
== DINFO_USAGE_NUM_ENUMS
)
101 opts
->x_debug_struct_ordinary
[DINFO_USAGE_DFN
] = files
;
102 opts
->x_debug_struct_ordinary
[DINFO_USAGE_DIR_USE
] = files
;
103 opts
->x_debug_struct_ordinary
[DINFO_USAGE_IND_USE
] = files
;
107 opts
->x_debug_struct_generic
[DINFO_USAGE_DFN
] = files
;
108 opts
->x_debug_struct_generic
[DINFO_USAGE_DIR_USE
] = files
;
109 opts
->x_debug_struct_generic
[DINFO_USAGE_IND_USE
] = files
;
115 opts
->x_debug_struct_ordinary
[usage
] = files
;
117 opts
->x_debug_struct_generic
[usage
] = files
;
121 set_struct_debug_option (opts
, loc
, spec
+1);
124 /* No more -femit-struct-debug-detailed specifications.
128 "argument %qs to %<-femit-struct-debug-detailed%> unknown",
130 if (opts
->x_debug_struct_ordinary
[DINFO_USAGE_DIR_USE
]
131 < opts
->x_debug_struct_ordinary
[DINFO_USAGE_IND_USE
]
132 || opts
->x_debug_struct_generic
[DINFO_USAGE_DIR_USE
]
133 < opts
->x_debug_struct_generic
[DINFO_USAGE_IND_USE
])
135 "%<-femit-struct-debug-detailed=dir:...%> must allow "
136 "at least as much as "
137 "%<-femit-struct-debug-detailed=ind:...%>");
141 /* Strip off a legitimate source ending from the input string NAME of
142 length LEN. Rather than having to know the names used by all of
143 our front ends, we strip off an ending of a period followed by
144 up to fource characters. (C++ uses ".cpp".) */
147 strip_off_ending (char *name
, int len
)
150 for (i
= 2; i
< 5 && len
> i
; i
++)
152 if (name
[len
- i
] == '.')
154 name
[len
- i
] = '\0';
160 /* Find the base name of a path, stripping off both directories and
161 a single final extension. */
163 base_of_path (const char *path
, const char **base_out
)
165 const char *base
= path
;
167 const char *p
= path
;
171 if (IS_DIR_SEPARATOR (c
))
186 /* What to print when a switch has no documentation. */
187 static const char undocumented_msg
[] = N_("This option lacks documentation.");
188 static const char use_diagnosed_msg
[] = N_("Uses of this option are diagnosed.");
190 typedef char *char_p
; /* For DEF_VEC_P. */
192 static void set_debug_level (enum debug_info_type type
, int extended
,
193 const char *arg
, struct gcc_options
*opts
,
194 struct gcc_options
*opts_set
,
196 static void set_fast_math_flags (struct gcc_options
*opts
, int set
);
197 static void decode_d_option (const char *arg
, struct gcc_options
*opts
,
198 location_t loc
, diagnostic_context
*dc
);
199 static void set_unsafe_math_optimizations_flags (struct gcc_options
*opts
,
201 static void enable_warning_as_error (const char *arg
, int value
,
202 unsigned int lang_mask
,
203 const struct cl_option_handlers
*handlers
,
204 struct gcc_options
*opts
,
205 struct gcc_options
*opts_set
,
207 diagnostic_context
*dc
);
209 /* Handle a back-end option; arguments and return value as for
213 target_handle_option (struct gcc_options
*opts
,
214 struct gcc_options
*opts_set
,
215 const struct cl_decoded_option
*decoded
,
216 unsigned int lang_mask ATTRIBUTE_UNUSED
, int kind
,
218 const struct cl_option_handlers
*handlers ATTRIBUTE_UNUSED
,
219 diagnostic_context
*dc
, void (*) (void))
221 gcc_assert (dc
== global_dc
);
222 gcc_assert (kind
== DK_UNSPECIFIED
);
223 return targetm_common
.handle_option (opts
, opts_set
, decoded
, loc
);
226 /* Add comma-separated strings to a char_p vector. */
229 add_comma_separated_to_vector (void **pvec
, const char *arg
)
235 vec
<char_p
> *v
= (vec
<char_p
> *) *pvec
;
237 vec_check_alloc (v
, 1);
239 /* We never free this string. */
252 v
->safe_push (token_start
);
255 if (*r
== '\\' && r
[1] == ',')
265 if (*token_start
!= '\0')
266 v
->safe_push (token_start
);
271 /* Initialize opts_obstack. */
274 init_opts_obstack (void)
276 gcc_obstack_init (&opts_obstack
);
279 /* Initialize OPTS and OPTS_SET before using them in parsing options. */
282 init_options_struct (struct gcc_options
*opts
, struct gcc_options
*opts_set
)
284 /* Ensure that opts_obstack has already been initialized by the time
285 that we initialize any gcc_options instances (PR jit/68446). */
286 gcc_assert (opts_obstack
.chunk_size
> 0);
288 *opts
= global_options_init
;
291 memset (opts_set
, 0, sizeof (*opts_set
));
293 /* Initialize whether `char' is signed. */
294 opts
->x_flag_signed_char
= DEFAULT_SIGNED_CHAR
;
295 /* Set this to a special "uninitialized" value. The actual default
296 is set after target options have been processed. */
297 opts
->x_flag_short_enums
= 2;
299 /* Initialize target_flags before default_options_optimization
300 so the latter can modify it. */
301 opts
->x_target_flags
= targetm_common
.default_target_flags
;
303 /* Some targets have ABI-specified unwind tables. */
304 opts
->x_flag_unwind_tables
= targetm_common
.unwind_tables_default
;
306 /* Some targets have other target-specific initialization. */
307 targetm_common
.option_init_struct (opts
);
310 /* If indicated by the optimization level LEVEL (-Os if SIZE is set,
311 -Ofast if FAST is set, -Og if DEBUG is set), apply the option DEFAULT_OPT
312 to OPTS and OPTS_SET, diagnostic context DC, location LOC, with language
313 mask LANG_MASK and option handlers HANDLERS. */
316 maybe_default_option (struct gcc_options
*opts
,
317 struct gcc_options
*opts_set
,
318 const struct default_options
*default_opt
,
319 int level
, bool size
, bool fast
, bool debug
,
320 unsigned int lang_mask
,
321 const struct cl_option_handlers
*handlers
,
323 diagnostic_context
*dc
)
325 const struct cl_option
*option
= &cl_options
[default_opt
->opt_index
];
329 gcc_assert (level
== 2);
331 gcc_assert (level
== 3);
333 gcc_assert (level
== 1);
335 switch (default_opt
->levels
)
341 case OPT_LEVELS_0_ONLY
:
342 enabled
= (level
== 0);
345 case OPT_LEVELS_1_PLUS
:
346 enabled
= (level
>= 1);
349 case OPT_LEVELS_1_PLUS_SPEED_ONLY
:
350 enabled
= (level
>= 1 && !size
&& !debug
);
353 case OPT_LEVELS_1_PLUS_NOT_DEBUG
:
354 enabled
= (level
>= 1 && !debug
);
357 case OPT_LEVELS_2_PLUS
:
358 enabled
= (level
>= 2);
361 case OPT_LEVELS_2_PLUS_SPEED_ONLY
:
362 enabled
= (level
>= 2 && !size
&& !debug
);
365 case OPT_LEVELS_3_PLUS
:
366 enabled
= (level
>= 3);
369 case OPT_LEVELS_3_PLUS_AND_SIZE
:
370 enabled
= (level
>= 3 || size
);
373 case OPT_LEVELS_SIZE
:
377 case OPT_LEVELS_FAST
:
381 case OPT_LEVELS_NONE
:
387 handle_generated_option (opts
, opts_set
, default_opt
->opt_index
,
388 default_opt
->arg
, default_opt
->value
,
389 lang_mask
, DK_UNSPECIFIED
, loc
,
391 else if (default_opt
->arg
== NULL
392 && !option
->cl_reject_negative
393 && !(option
->flags
& CL_PARAMS
))
394 handle_generated_option (opts
, opts_set
, default_opt
->opt_index
,
395 default_opt
->arg
, !default_opt
->value
,
396 lang_mask
, DK_UNSPECIFIED
, loc
,
400 /* As indicated by the optimization level LEVEL (-Os if SIZE is set,
401 -Ofast if FAST is set), apply the options in array DEFAULT_OPTS to
402 OPTS and OPTS_SET, diagnostic context DC, location LOC, with
403 language mask LANG_MASK and option handlers HANDLERS. */
406 maybe_default_options (struct gcc_options
*opts
,
407 struct gcc_options
*opts_set
,
408 const struct default_options
*default_opts
,
409 int level
, bool size
, bool fast
, bool debug
,
410 unsigned int lang_mask
,
411 const struct cl_option_handlers
*handlers
,
413 diagnostic_context
*dc
)
417 for (i
= 0; default_opts
[i
].levels
!= OPT_LEVELS_NONE
; i
++)
418 maybe_default_option (opts
, opts_set
, &default_opts
[i
],
419 level
, size
, fast
, debug
,
420 lang_mask
, handlers
, loc
, dc
);
423 /* Table of options enabled by default at different levels.
424 Please keep this list sorted by level and alphabetized within
425 each level; this makes it easier to keep the documentation
428 static const struct default_options default_options_table
[] =
430 /* -O1 and -Og optimizations. */
431 { OPT_LEVELS_1_PLUS
, OPT_fcombine_stack_adjustments
, NULL
, 1 },
432 { OPT_LEVELS_1_PLUS
, OPT_fcompare_elim
, NULL
, 1 },
433 { OPT_LEVELS_1_PLUS
, OPT_fcprop_registers
, NULL
, 1 },
434 { OPT_LEVELS_1_PLUS
, OPT_fdefer_pop
, NULL
, 1 },
435 { OPT_LEVELS_1_PLUS
, OPT_fforward_propagate
, NULL
, 1 },
436 { OPT_LEVELS_1_PLUS
, OPT_fguess_branch_probability
, NULL
, 1 },
437 { OPT_LEVELS_1_PLUS
, OPT_fipa_profile
, NULL
, 1 },
438 { OPT_LEVELS_1_PLUS
, OPT_fipa_pure_const
, NULL
, 1 },
439 { OPT_LEVELS_1_PLUS
, OPT_fipa_reference
, NULL
, 1 },
440 { OPT_LEVELS_1_PLUS
, OPT_fipa_reference_addressable
, NULL
, 1 },
441 { OPT_LEVELS_1_PLUS
, OPT_fmerge_constants
, NULL
, 1 },
442 { OPT_LEVELS_1_PLUS
, OPT_fomit_frame_pointer
, NULL
, 1 },
443 { OPT_LEVELS_1_PLUS
, OPT_freorder_blocks
, NULL
, 1 },
444 { OPT_LEVELS_1_PLUS
, OPT_fshrink_wrap
, NULL
, 1 },
445 { OPT_LEVELS_1_PLUS
, OPT_fsplit_wide_types
, NULL
, 1 },
446 { OPT_LEVELS_1_PLUS
, OPT_ftree_builtin_call_dce
, NULL
, 1 },
447 { OPT_LEVELS_1_PLUS
, OPT_ftree_ccp
, NULL
, 1 },
448 { OPT_LEVELS_1_PLUS
, OPT_ftree_ch
, NULL
, 1 },
449 { OPT_LEVELS_1_PLUS
, OPT_ftree_coalesce_vars
, NULL
, 1 },
450 { OPT_LEVELS_1_PLUS
, OPT_ftree_copy_prop
, NULL
, 1 },
451 { OPT_LEVELS_1_PLUS
, OPT_ftree_dce
, NULL
, 1 },
452 { OPT_LEVELS_1_PLUS
, OPT_ftree_dominator_opts
, NULL
, 1 },
453 { OPT_LEVELS_1_PLUS
, OPT_ftree_fre
, NULL
, 1 },
454 { OPT_LEVELS_1_PLUS
, OPT_ftree_sink
, NULL
, 1 },
455 { OPT_LEVELS_1_PLUS
, OPT_ftree_slsr
, NULL
, 1 },
456 { OPT_LEVELS_1_PLUS
, OPT_ftree_ter
, NULL
, 1 },
458 /* -O1 (and not -Og) optimizations. */
459 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fbranch_count_reg
, NULL
, 1 },
461 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fdelayed_branch
, NULL
, 1 },
463 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fdse
, NULL
, 1 },
464 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fif_conversion
, NULL
, 1 },
465 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fif_conversion2
, NULL
, 1 },
466 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_finline_functions_called_once
, NULL
, 1 },
467 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fmove_loop_invariants
, NULL
, 1 },
468 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_fssa_phiopt
, NULL
, 1 },
469 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_ftree_bit_ccp
, NULL
, 1 },
470 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_ftree_dse
, NULL
, 1 },
471 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_ftree_pta
, NULL
, 1 },
472 { OPT_LEVELS_1_PLUS_NOT_DEBUG
, OPT_ftree_sra
, NULL
, 1 },
474 /* -O2 and -Os optimizations. */
475 { OPT_LEVELS_2_PLUS
, OPT_fcaller_saves
, NULL
, 1 },
476 { OPT_LEVELS_2_PLUS
, OPT_fcode_hoisting
, NULL
, 1 },
477 { OPT_LEVELS_2_PLUS
, OPT_fcrossjumping
, NULL
, 1 },
478 { OPT_LEVELS_2_PLUS
, OPT_fcse_follow_jumps
, NULL
, 1 },
479 { OPT_LEVELS_2_PLUS
, OPT_fdevirtualize
, NULL
, 1 },
480 { OPT_LEVELS_2_PLUS
, OPT_fdevirtualize_speculatively
, NULL
, 1 },
481 { OPT_LEVELS_2_PLUS
, OPT_fexpensive_optimizations
, NULL
, 1 },
482 { OPT_LEVELS_2_PLUS
, OPT_fgcse
, NULL
, 1 },
483 { OPT_LEVELS_2_PLUS
, OPT_fhoist_adjacent_loads
, NULL
, 1 },
484 { OPT_LEVELS_2_PLUS
, OPT_findirect_inlining
, NULL
, 1 },
485 { OPT_LEVELS_2_PLUS
, OPT_finline_small_functions
, NULL
, 1 },
486 { OPT_LEVELS_2_PLUS
, OPT_fipa_bit_cp
, NULL
, 1 },
487 { OPT_LEVELS_2_PLUS
, OPT_fipa_cp
, NULL
, 1 },
488 { OPT_LEVELS_2_PLUS
, OPT_fipa_icf
, NULL
, 1 },
489 { OPT_LEVELS_2_PLUS
, OPT_fipa_ra
, NULL
, 1 },
490 { OPT_LEVELS_2_PLUS
, OPT_fipa_sra
, NULL
, 1 },
491 { OPT_LEVELS_2_PLUS
, OPT_fipa_vrp
, NULL
, 1 },
492 { OPT_LEVELS_2_PLUS
, OPT_fisolate_erroneous_paths_dereference
, NULL
, 1 },
493 { OPT_LEVELS_2_PLUS
, OPT_flra_remat
, NULL
, 1 },
494 { OPT_LEVELS_2_PLUS
, OPT_foptimize_sibling_calls
, NULL
, 1 },
495 { OPT_LEVELS_2_PLUS
, OPT_fpartial_inlining
, NULL
, 1 },
496 { OPT_LEVELS_2_PLUS
, OPT_fpeephole2
, NULL
, 1 },
497 { OPT_LEVELS_2_PLUS
, OPT_freorder_functions
, NULL
, 1 },
498 { OPT_LEVELS_2_PLUS
, OPT_frerun_cse_after_loop
, NULL
, 1 },
499 #ifdef INSN_SCHEDULING
500 { OPT_LEVELS_2_PLUS
, OPT_fschedule_insns2
, NULL
, 1 },
502 { OPT_LEVELS_2_PLUS
, OPT_fstrict_aliasing
, NULL
, 1 },
503 { OPT_LEVELS_2_PLUS
, OPT_fstore_merging
, NULL
, 1 },
504 { OPT_LEVELS_2_PLUS
, OPT_fthread_jumps
, NULL
, 1 },
505 { OPT_LEVELS_2_PLUS
, OPT_ftree_pre
, NULL
, 1 },
506 { OPT_LEVELS_2_PLUS
, OPT_ftree_switch_conversion
, NULL
, 1 },
507 { OPT_LEVELS_2_PLUS
, OPT_ftree_tail_merge
, NULL
, 1 },
508 { OPT_LEVELS_2_PLUS
, OPT_ftree_vrp
, NULL
, 1 },
509 { OPT_LEVELS_2_PLUS
, OPT_fvect_cost_model_
, NULL
, VECT_COST_MODEL_CHEAP
},
510 { OPT_LEVELS_2_PLUS
, OPT_finline_functions
, NULL
, 1 },
511 { OPT_LEVELS_2_PLUS
, OPT_ftree_loop_distribute_patterns
, NULL
, 1 },
513 /* -O2 and above optimizations, but not -Os or -Og. */
514 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_falign_functions
, NULL
, 1 },
515 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_falign_jumps
, NULL
, 1 },
516 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_falign_labels
, NULL
, 1 },
517 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_falign_loops
, NULL
, 1 },
518 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_foptimize_strlen
, NULL
, 1 },
519 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_freorder_blocks_algorithm_
, NULL
,
520 REORDER_BLOCKS_ALGORITHM_STC
},
521 #ifdef INSN_SCHEDULING
522 /* Only run the pre-regalloc scheduling pass if optimizing for speed. */
523 { OPT_LEVELS_2_PLUS_SPEED_ONLY
, OPT_fschedule_insns
, NULL
, 1 },
526 /* -O3 and -Os optimizations. */
528 /* -O3 optimizations. */
529 { OPT_LEVELS_3_PLUS
, OPT_fgcse_after_reload
, NULL
, 1 },
530 { OPT_LEVELS_3_PLUS
, OPT_fipa_cp_clone
, NULL
, 1 },
531 { OPT_LEVELS_3_PLUS
, OPT_floop_interchange
, NULL
, 1 },
532 { OPT_LEVELS_3_PLUS
, OPT_floop_unroll_and_jam
, NULL
, 1 },
533 { OPT_LEVELS_3_PLUS
, OPT_fpeel_loops
, NULL
, 1 },
534 { OPT_LEVELS_3_PLUS
, OPT_fpredictive_commoning
, NULL
, 1 },
535 { OPT_LEVELS_3_PLUS
, OPT_fsplit_loops
, NULL
, 1 },
536 { OPT_LEVELS_3_PLUS
, OPT_fsplit_paths
, NULL
, 1 },
537 { OPT_LEVELS_3_PLUS
, OPT_ftree_loop_distribution
, NULL
, 1 },
538 { OPT_LEVELS_3_PLUS
, OPT_ftree_loop_vectorize
, NULL
, 1 },
539 { OPT_LEVELS_3_PLUS
, OPT_ftree_partial_pre
, NULL
, 1 },
540 { OPT_LEVELS_3_PLUS
, OPT_ftree_slp_vectorize
, NULL
, 1 },
541 { OPT_LEVELS_3_PLUS
, OPT_funswitch_loops
, NULL
, 1 },
542 { OPT_LEVELS_3_PLUS
, OPT_fvect_cost_model_
, NULL
, VECT_COST_MODEL_DYNAMIC
},
543 { OPT_LEVELS_3_PLUS
, OPT_fversion_loops_for_strides
, NULL
, 1 },
545 /* -O3 parameters. */
546 { OPT_LEVELS_3_PLUS
, OPT__param_max_inline_insns_auto_
, NULL
, 30 },
547 { OPT_LEVELS_3_PLUS
, OPT__param_early_inlining_insns_
, NULL
, 14 },
548 { OPT_LEVELS_3_PLUS
, OPT__param_inline_heuristics_hint_percent_
, NULL
, 600 },
549 { OPT_LEVELS_3_PLUS
, OPT__param_inline_min_speedup_
, NULL
, 15 },
550 { OPT_LEVELS_3_PLUS
, OPT__param_max_inline_insns_single_
, NULL
, 200 },
552 /* -Ofast adds optimizations to -O3. */
553 { OPT_LEVELS_FAST
, OPT_ffast_math
, NULL
, 1 },
554 { OPT_LEVELS_FAST
, OPT_fallow_store_data_races
, NULL
, 1 },
556 { OPT_LEVELS_NONE
, 0, NULL
, 0 }
559 /* Default the options in OPTS and OPTS_SET based on the optimization
560 settings in DECODED_OPTIONS and DECODED_OPTIONS_COUNT. */
562 default_options_optimization (struct gcc_options
*opts
,
563 struct gcc_options
*opts_set
,
564 struct cl_decoded_option
*decoded_options
,
565 unsigned int decoded_options_count
,
567 unsigned int lang_mask
,
568 const struct cl_option_handlers
*handlers
,
569 diagnostic_context
*dc
)
573 bool openacc_mode
= false;
575 /* Scan to see what optimization level has been specified. That will
576 determine the default value of many flags. */
577 for (i
= 1; i
< decoded_options_count
; i
++)
579 struct cl_decoded_option
*opt
= &decoded_options
[i
];
580 switch (opt
->opt_index
)
583 if (*opt
->arg
== '\0')
585 opts
->x_optimize
= 1;
586 opts
->x_optimize_size
= 0;
587 opts
->x_optimize_fast
= 0;
588 opts
->x_optimize_debug
= 0;
592 const int optimize_val
= integral_argument (opt
->arg
);
593 if (optimize_val
== -1)
594 error_at (loc
, "argument to %<-O%> should be a non-negative "
595 "integer, %<g%>, %<s%> or %<fast%>");
598 opts
->x_optimize
= optimize_val
;
599 if ((unsigned int) opts
->x_optimize
> 255)
600 opts
->x_optimize
= 255;
601 opts
->x_optimize_size
= 0;
602 opts
->x_optimize_fast
= 0;
603 opts
->x_optimize_debug
= 0;
609 opts
->x_optimize_size
= 1;
611 /* Optimizing for size forces optimize to be 2. */
612 opts
->x_optimize
= 2;
613 opts
->x_optimize_fast
= 0;
614 opts
->x_optimize_debug
= 0;
618 /* -Ofast only adds flags to -O3. */
619 opts
->x_optimize_size
= 0;
620 opts
->x_optimize
= 3;
621 opts
->x_optimize_fast
= 1;
622 opts
->x_optimize_debug
= 0;
626 /* -Og selects optimization level 1. */
627 opts
->x_optimize_size
= 0;
628 opts
->x_optimize
= 1;
629 opts
->x_optimize_fast
= 0;
630 opts
->x_optimize_debug
= 1;
639 /* Ignore other options in this prescan. */
644 maybe_default_options (opts
, opts_set
, default_options_table
,
645 opts
->x_optimize
, opts
->x_optimize_size
,
646 opts
->x_optimize_fast
, opts
->x_optimize_debug
,
647 lang_mask
, handlers
, loc
, dc
);
649 /* -O2 param settings. */
650 opt2
= (opts
->x_optimize
>= 2);
653 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_ipa_pta
, true);
655 /* Track fields in field-sensitive alias analysis. */
657 SET_OPTION_IF_UNSET (opts
, opts_set
, param_max_fields_for_field_sensitive
,
660 if (opts
->x_optimize_size
)
661 /* We want to crossjump as much as possible. */
662 SET_OPTION_IF_UNSET (opts
, opts_set
, param_min_crossjump_insns
, 1);
664 /* Restrict the amount of work combine does at -Og while retaining
665 most of its useful transforms. */
666 if (opts
->x_optimize_debug
)
667 SET_OPTION_IF_UNSET (opts
, opts_set
, param_max_combine_insns
, 2);
669 /* Allow default optimizations to be specified on a per-machine basis. */
670 maybe_default_options (opts
, opts_set
,
671 targetm_common
.option_optimization_table
,
672 opts
->x_optimize
, opts
->x_optimize_size
,
673 opts
->x_optimize_fast
, opts
->x_optimize_debug
,
674 lang_mask
, handlers
, loc
, dc
);
677 /* Control IPA optimizations based on different live patching LEVEL. */
679 control_options_for_live_patching (struct gcc_options
*opts
,
680 struct gcc_options
*opts_set
,
681 enum live_patching_level level
,
684 gcc_assert (level
> LIVE_PATCHING_NONE
);
688 case LIVE_PATCHING_INLINE_ONLY_STATIC
:
689 if (opts_set
->x_flag_ipa_cp_clone
&& opts
->x_flag_ipa_cp_clone
)
691 "%<-fipa-cp-clone%> is incompatible with "
692 "%<-flive-patching=inline-only-static%>");
694 opts
->x_flag_ipa_cp_clone
= 0;
696 if (opts_set
->x_flag_ipa_sra
&& opts
->x_flag_ipa_sra
)
698 "%<-fipa-sra%> is incompatible with "
699 "%<-flive-patching=inline-only-static%>");
701 opts
->x_flag_ipa_sra
= 0;
703 if (opts_set
->x_flag_partial_inlining
&& opts
->x_flag_partial_inlining
)
705 "%<-fpartial-inlining%> is incompatible with "
706 "%<-flive-patching=inline-only-static%>");
708 opts
->x_flag_partial_inlining
= 0;
710 if (opts_set
->x_flag_ipa_cp
&& opts
->x_flag_ipa_cp
)
712 "%<-fipa-cp%> is incompatible with "
713 "%<-flive-patching=inline-only-static%>");
715 opts
->x_flag_ipa_cp
= 0;
718 case LIVE_PATCHING_INLINE_CLONE
:
719 /* live patching should disable whole-program optimization. */
720 if (opts_set
->x_flag_whole_program
&& opts
->x_flag_whole_program
)
722 "%<-fwhole-program%> is incompatible with "
723 "%<-flive-patching=inline-only-static|inline-clone%>");
725 opts
->x_flag_whole_program
= 0;
727 /* visibility change should be excluded by !flag_whole_program
728 && !in_lto_p && !flag_ipa_cp_clone && !flag_ipa_sra
729 && !flag_partial_inlining. */
731 if (opts_set
->x_flag_ipa_pta
&& opts
->x_flag_ipa_pta
)
733 "%<-fipa-pta%> is incompatible with "
734 "%<-flive-patching=inline-only-static|inline-clone%>");
736 opts
->x_flag_ipa_pta
= 0;
738 if (opts_set
->x_flag_ipa_reference
&& opts
->x_flag_ipa_reference
)
740 "%<-fipa-reference%> is incompatible with "
741 "%<-flive-patching=inline-only-static|inline-clone%>");
743 opts
->x_flag_ipa_reference
= 0;
745 if (opts_set
->x_flag_ipa_ra
&& opts
->x_flag_ipa_ra
)
747 "%<-fipa-ra%> is incompatible with "
748 "%<-flive-patching=inline-only-static|inline-clone%>");
750 opts
->x_flag_ipa_ra
= 0;
752 if (opts_set
->x_flag_ipa_icf
&& opts
->x_flag_ipa_icf
)
754 "%<-fipa-icf%> is incompatible with "
755 "%<-flive-patching=inline-only-static|inline-clone%>");
757 opts
->x_flag_ipa_icf
= 0;
759 if (opts_set
->x_flag_ipa_icf_functions
&& opts
->x_flag_ipa_icf_functions
)
761 "%<-fipa-icf-functions%> is incompatible with "
762 "%<-flive-patching=inline-only-static|inline-clone%>");
764 opts
->x_flag_ipa_icf_functions
= 0;
766 if (opts_set
->x_flag_ipa_icf_variables
&& opts
->x_flag_ipa_icf_variables
)
768 "%<-fipa-icf-variables%> is incompatible with "
769 "%<-flive-patching=inline-only-static|inline-clone%>");
771 opts
->x_flag_ipa_icf_variables
= 0;
773 if (opts_set
->x_flag_ipa_bit_cp
&& opts
->x_flag_ipa_bit_cp
)
775 "%<-fipa-bit-cp%> is incompatible with "
776 "%<-flive-patching=inline-only-static|inline-clone%>");
778 opts
->x_flag_ipa_bit_cp
= 0;
780 if (opts_set
->x_flag_ipa_vrp
&& opts
->x_flag_ipa_vrp
)
782 "%<-fipa-vrp%> is incompatible with "
783 "%<-flive-patching=inline-only-static|inline-clone%>");
785 opts
->x_flag_ipa_vrp
= 0;
787 if (opts_set
->x_flag_ipa_pure_const
&& opts
->x_flag_ipa_pure_const
)
789 "%<-fipa-pure-const%> is incompatible with "
790 "%<-flive-patching=inline-only-static|inline-clone%>");
792 opts
->x_flag_ipa_pure_const
= 0;
794 /* FIXME: disable unreachable code removal. */
796 /* discovery of functions/variables with no address taken. */
797 if (opts_set
->x_flag_ipa_reference_addressable
798 && opts
->x_flag_ipa_reference_addressable
)
800 "%<-fipa-reference-addressable%> is incompatible with "
801 "%<-flive-patching=inline-only-static|inline-clone%>");
803 opts
->x_flag_ipa_reference_addressable
= 0;
805 /* ipa stack alignment propagation. */
806 if (opts_set
->x_flag_ipa_stack_alignment
807 && opts
->x_flag_ipa_stack_alignment
)
809 "%<-fipa-stack-alignment%> is incompatible with "
810 "%<-flive-patching=inline-only-static|inline-clone%>");
812 opts
->x_flag_ipa_stack_alignment
= 0;
819 /* --help option argument if set. */
820 vec
<const char *> help_option_arguments
;
823 /* After all options at LOC have been read into OPTS and OPTS_SET,
824 finalize settings of those options and diagnose incompatible
827 finish_options (struct gcc_options
*opts
, struct gcc_options
*opts_set
,
830 enum unwind_info_type ui_except
;
832 if (opts
->x_dump_base_name
833 && ! opts
->x_dump_base_name_prefixed
)
835 const char *sep
= opts
->x_dump_base_name
;
838 if (IS_DIR_SEPARATOR (*sep
))
842 /* If dump_base_path contains subdirectories, don't prepend
844 else if (opts
->x_dump_dir_name
)
845 /* We have a DUMP_DIR_NAME, prepend that. */
846 opts
->x_dump_base_name
= opts_concat (opts
->x_dump_dir_name
,
847 opts
->x_dump_base_name
, NULL
);
849 /* It is definitely prefixed now. */
850 opts
->x_dump_base_name_prefixed
= true;
853 /* Handle related options for unit-at-a-time, toplevel-reorder, and
855 if (!opts
->x_flag_unit_at_a_time
)
857 if (opts
->x_flag_section_anchors
&& opts_set
->x_flag_section_anchors
)
858 error_at (loc
, "section anchors must be disabled when unit-at-a-time "
860 opts
->x_flag_section_anchors
= 0;
861 if (opts
->x_flag_toplevel_reorder
== 1)
862 error_at (loc
, "toplevel reorder must be disabled when unit-at-a-time "
864 opts
->x_flag_toplevel_reorder
= 0;
867 /* -fself-test depends on the state of the compiler prior to
868 compiling anything. Ideally it should be run on an empty source
869 file. However, in case we get run with actual source, assume
870 -fsyntax-only which will inhibit any compiler initialization
871 which may confuse the self tests. */
872 if (opts
->x_flag_self_test
)
873 opts
->x_flag_syntax_only
= 1;
875 if (opts
->x_flag_tm
&& opts
->x_flag_non_call_exceptions
)
876 sorry ("transactional memory is not supported with non-call exceptions");
878 /* Unless the user has asked for section anchors, we disable toplevel
879 reordering at -O0 to disable transformations that might be surprising
880 to end users and to get -fno-toplevel-reorder tested. */
881 if (!opts
->x_optimize
882 && opts
->x_flag_toplevel_reorder
== 2
883 && !(opts
->x_flag_section_anchors
&& opts_set
->x_flag_section_anchors
))
885 opts
->x_flag_toplevel_reorder
= 0;
886 opts
->x_flag_section_anchors
= 0;
888 if (!opts
->x_flag_toplevel_reorder
)
890 if (opts
->x_flag_section_anchors
&& opts_set
->x_flag_section_anchors
)
891 error_at (loc
, "section anchors must be disabled when toplevel reorder"
893 opts
->x_flag_section_anchors
= 0;
896 if (!opts
->x_flag_opts_finished
)
898 /* We initialize opts->x_flag_pie to -1 so that targets can set a
900 if (opts
->x_flag_pie
== -1)
902 /* We initialize opts->x_flag_pic to -1 so that we can tell if
903 -fpic, -fPIC, -fno-pic or -fno-PIC is used. */
904 if (opts
->x_flag_pic
== -1)
905 opts
->x_flag_pie
= DEFAULT_FLAG_PIE
;
907 opts
->x_flag_pie
= 0;
909 /* If -fPIE or -fpie is used, turn on PIC. */
910 if (opts
->x_flag_pie
)
911 opts
->x_flag_pic
= opts
->x_flag_pie
;
912 else if (opts
->x_flag_pic
== -1)
913 opts
->x_flag_pic
= 0;
914 if (opts
->x_flag_pic
&& !opts
->x_flag_pie
)
915 opts
->x_flag_shlib
= 1;
916 opts
->x_flag_opts_finished
= true;
919 /* We initialize opts->x_flag_stack_protect to -1 so that targets
920 can set a default value. */
921 if (opts
->x_flag_stack_protect
== -1)
922 opts
->x_flag_stack_protect
= DEFAULT_FLAG_SSP
;
924 if (opts
->x_optimize
== 0)
926 /* Inlining does not work if not optimizing,
927 so force it not to be done. */
928 opts
->x_warn_inline
= 0;
929 opts
->x_flag_no_inline
= 1;
932 /* The optimization to partition hot and cold basic blocks into separate
933 sections of the .o and executable files does not work (currently)
934 with exception handling. This is because there is no support for
935 generating unwind info. If opts->x_flag_exceptions is turned on
936 we need to turn off the partitioning optimization. */
938 ui_except
= targetm_common
.except_unwind_info (opts
);
940 if (opts
->x_flag_exceptions
941 && opts
->x_flag_reorder_blocks_and_partition
942 && (ui_except
== UI_SJLJ
|| ui_except
>= UI_TARGET
))
944 if (opts_set
->x_flag_reorder_blocks_and_partition
)
946 "%<-freorder-blocks-and-partition%> does not work "
947 "with exceptions on this architecture");
948 opts
->x_flag_reorder_blocks_and_partition
= 0;
949 opts
->x_flag_reorder_blocks
= 1;
952 /* If user requested unwind info, then turn off the partitioning
955 if (opts
->x_flag_unwind_tables
956 && !targetm_common
.unwind_tables_default
957 && opts
->x_flag_reorder_blocks_and_partition
958 && (ui_except
== UI_SJLJ
|| ui_except
>= UI_TARGET
))
960 if (opts_set
->x_flag_reorder_blocks_and_partition
)
962 "%<-freorder-blocks-and-partition%> does not support "
963 "unwind info on this architecture");
964 opts
->x_flag_reorder_blocks_and_partition
= 0;
965 opts
->x_flag_reorder_blocks
= 1;
968 /* If the target requested unwind info, then turn off the partitioning
969 optimization with a different message. Likewise, if the target does not
970 support named sections. */
972 if (opts
->x_flag_reorder_blocks_and_partition
973 && (!targetm_common
.have_named_sections
974 || (opts
->x_flag_unwind_tables
975 && targetm_common
.unwind_tables_default
976 && (ui_except
== UI_SJLJ
|| ui_except
>= UI_TARGET
))))
978 if (opts_set
->x_flag_reorder_blocks_and_partition
)
980 "%<-freorder-blocks-and-partition%> does not work "
981 "on this architecture");
982 opts
->x_flag_reorder_blocks_and_partition
= 0;
983 opts
->x_flag_reorder_blocks
= 1;
987 /* Pipelining of outer loops is only possible when general pipelining
988 capabilities are requested. */
989 if (!opts
->x_flag_sel_sched_pipelining
)
990 opts
->x_flag_sel_sched_pipelining_outer_loops
= 0;
992 if (opts
->x_flag_conserve_stack
)
994 SET_OPTION_IF_UNSET (opts
, opts_set
, param_large_stack_frame
, 100);
995 SET_OPTION_IF_UNSET (opts
, opts_set
, param_stack_frame_growth
, 40);
998 if (opts
->x_flag_lto
)
1001 opts
->x_flag_generate_lto
= 1;
1003 /* When generating IL, do not operate in whole-program mode.
1004 Otherwise, symbols will be privatized too early, causing link
1006 opts
->x_flag_whole_program
= 0;
1008 error_at (loc
, "LTO support has not been enabled in this configuration");
1010 if (!opts
->x_flag_fat_lto_objects
1011 && (!HAVE_LTO_PLUGIN
1012 || (opts_set
->x_flag_use_linker_plugin
1013 && !opts
->x_flag_use_linker_plugin
)))
1015 if (opts_set
->x_flag_fat_lto_objects
)
1016 error_at (loc
, "%<-fno-fat-lto-objects%> are supported only with "
1018 opts
->x_flag_fat_lto_objects
= 1;
1021 /* -gsplit-dwarf isn't compatible with LTO, see PR88389. */
1022 if (opts
->x_dwarf_split_debug_info
)
1024 inform (loc
, "%<-gsplit-dwarf%> is not supported with LTO,"
1026 opts
->x_dwarf_split_debug_info
= 0;
1030 /* We initialize opts->x_flag_split_stack to -1 so that targets can set a
1031 default value if they choose based on other options. */
1032 if (opts
->x_flag_split_stack
== -1)
1033 opts
->x_flag_split_stack
= 0;
1034 else if (opts
->x_flag_split_stack
)
1036 if (!targetm_common
.supports_split_stack (true, opts
))
1038 error_at (loc
, "%<-fsplit-stack%> is not supported by "
1039 "this compiler configuration");
1040 opts
->x_flag_split_stack
= 0;
1044 /* If stack splitting is turned on, and the user did not explicitly
1045 request function partitioning, turn off partitioning, as it
1046 confuses the linker when trying to handle partitioned split-stack
1047 code that calls a non-split-stack functions. But if partitioning
1048 was turned on explicitly just hope for the best. */
1049 if (opts
->x_flag_split_stack
1050 && opts
->x_flag_reorder_blocks_and_partition
)
1051 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_reorder_blocks_and_partition
, 0);
1053 if (opts
->x_flag_reorder_blocks_and_partition
)
1054 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_reorder_functions
, 1);
1056 /* The -gsplit-dwarf option requires -ggnu-pubnames. */
1057 if (opts
->x_dwarf_split_debug_info
)
1058 opts
->x_debug_generate_pub_sections
= 2;
1060 if ((opts
->x_flag_sanitize
1061 & (SANITIZE_USER_ADDRESS
| SANITIZE_KERNEL_ADDRESS
)) == 0)
1063 if (opts
->x_flag_sanitize
& SANITIZE_POINTER_COMPARE
)
1065 "%<-fsanitize=pointer-compare%> must be combined with "
1066 "%<-fsanitize=address%> or %<-fsanitize=kernel-address%>");
1067 if (opts
->x_flag_sanitize
& SANITIZE_POINTER_SUBTRACT
)
1069 "%<-fsanitize=pointer-subtract%> must be combined with "
1070 "%<-fsanitize=address%> or %<-fsanitize=kernel-address%>");
1073 /* Userspace and kernel ASan conflict with each other. */
1074 if ((opts
->x_flag_sanitize
& SANITIZE_USER_ADDRESS
)
1075 && (opts
->x_flag_sanitize
& SANITIZE_KERNEL_ADDRESS
))
1077 "%<-fsanitize=address%> is incompatible with "
1078 "%<-fsanitize=kernel-address%>");
1080 /* And with TSan. */
1081 if ((opts
->x_flag_sanitize
& SANITIZE_ADDRESS
)
1082 && (opts
->x_flag_sanitize
& SANITIZE_THREAD
))
1084 "%<-fsanitize=address%> and %<-fsanitize=kernel-address%> "
1085 "are incompatible with %<-fsanitize=thread%>");
1087 if ((opts
->x_flag_sanitize
& SANITIZE_LEAK
)
1088 && (opts
->x_flag_sanitize
& SANITIZE_THREAD
))
1090 "%<-fsanitize=leak%> is incompatible with %<-fsanitize=thread%>");
1092 /* Check error recovery for -fsanitize-recover option. */
1093 for (int i
= 0; sanitizer_opts
[i
].name
!= NULL
; ++i
)
1094 if ((opts
->x_flag_sanitize_recover
& sanitizer_opts
[i
].flag
)
1095 && !sanitizer_opts
[i
].can_recover
)
1096 error_at (loc
, "%<-fsanitize-recover=%s%> is not supported",
1097 sanitizer_opts
[i
].name
);
1099 /* When instrumenting the pointers, we don't want to remove
1100 the null pointer checks. */
1101 if (opts
->x_flag_sanitize
& (SANITIZE_NULL
| SANITIZE_NONNULL_ATTRIBUTE
1102 | SANITIZE_RETURNS_NONNULL_ATTRIBUTE
))
1103 opts
->x_flag_delete_null_pointer_checks
= 0;
1105 /* Aggressive compiler optimizations may cause false negatives. */
1106 if (opts
->x_flag_sanitize
& ~(SANITIZE_LEAK
| SANITIZE_UNREACHABLE
))
1107 opts
->x_flag_aggressive_loop_optimizations
= 0;
1109 /* Enable -fsanitize-address-use-after-scope if address sanitizer is
1111 if (opts
->x_flag_sanitize
& SANITIZE_USER_ADDRESS
)
1112 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_sanitize_address_use_after_scope
,
1115 /* Force -fstack-reuse=none in case -fsanitize-address-use-after-scope
1117 if (opts
->x_flag_sanitize_address_use_after_scope
)
1119 if (opts
->x_flag_stack_reuse
!= SR_NONE
1120 && opts_set
->x_flag_stack_reuse
!= SR_NONE
)
1122 "%<-fsanitize-address-use-after-scope%> requires "
1123 "%<-fstack-reuse=none%> option");
1125 opts
->x_flag_stack_reuse
= SR_NONE
;
1128 if ((opts
->x_flag_sanitize
& SANITIZE_USER_ADDRESS
) && opts
->x_flag_tm
)
1129 sorry ("transactional memory is not supported with %<-fsanitize=address%>");
1131 if ((opts
->x_flag_sanitize
& SANITIZE_KERNEL_ADDRESS
) && opts
->x_flag_tm
)
1132 sorry ("transactional memory is not supported with "
1133 "%<-fsanitize=kernel-address%>");
1135 /* Currently live patching is not support for LTO. */
1136 if (opts
->x_flag_live_patching
&& opts
->x_flag_lto
)
1137 sorry ("live patching is not supported with LTO");
1139 /* Currently vtable verification is not supported for LTO */
1140 if (opts
->x_flag_vtable_verify
&& opts
->x_flag_lto
)
1141 sorry ("vtable verification is not supported with LTO");
1143 /* Control IPA optimizations based on different -flive-patching level. */
1144 if (opts
->x_flag_live_patching
)
1145 control_options_for_live_patching (opts
, opts_set
,
1146 opts
->x_flag_live_patching
,
1149 /* Unrolling all loops implies that standard loop unrolling must also
1151 if (opts
->x_flag_unroll_all_loops
)
1152 opts
->x_flag_unroll_loops
= 1;
1154 /* Allow cunroll to grow size accordingly. */
1155 if (!opts_set
->x_flag_cunroll_grow_size
)
1156 opts
->x_flag_cunroll_grow_size
1157 = (opts
->x_flag_unroll_loops
1158 || opts
->x_flag_peel_loops
1159 || opts
->x_optimize
>= 3);
1162 #define LEFT_COLUMN 27
1164 /* Output ITEM, of length ITEM_WIDTH, in the left column,
1165 followed by word-wrapped HELP in a second column. */
1167 wrap_help (const char *help
,
1169 unsigned int item_width
,
1170 unsigned int columns
)
1172 unsigned int col_width
= LEFT_COLUMN
;
1173 unsigned int remaining
, room
, len
;
1175 remaining
= strlen (help
);
1179 room
= columns
- 3 - MAX (col_width
, item_width
);
1188 for (i
= 0; help
[i
]; i
++)
1190 if (i
>= room
&& len
!= remaining
)
1194 else if ((help
[i
] == '-' || help
[i
] == '/')
1195 && help
[i
+ 1] != ' '
1196 && i
> 0 && ISALPHA (help
[i
- 1]))
1201 printf (" %-*.*s %.*s\n", col_width
, item_width
, item
, len
, help
);
1203 while (help
[len
] == ' ')
1211 /* Data structure used to print list of valid option values. */
1213 class option_help_tuple
1216 option_help_tuple (int code
, vec
<const char *> values
):
1217 m_code (code
), m_values (values
)
1220 /* Code of an option. */
1223 /* List of possible values. */
1224 vec
<const char *> m_values
;
1227 /* Print help for a specific front-end, etc. */
1229 print_filtered_help (unsigned int include_flags
,
1230 unsigned int exclude_flags
,
1231 unsigned int any_flags
,
1232 unsigned int columns
,
1233 struct gcc_options
*opts
,
1234 unsigned int lang_mask
)
1239 bool displayed
= false;
1242 if (!opts
->x_help_printed
)
1243 opts
->x_help_printed
= XCNEWVAR (char, cl_options_count
);
1245 if (!opts
->x_help_enum_printed
)
1246 opts
->x_help_enum_printed
= XCNEWVAR (char, cl_enums_count
);
1248 auto_vec
<option_help_tuple
> help_tuples
;
1250 for (i
= 0; i
< cl_options_count
; i
++)
1252 const struct cl_option
*option
= cl_options
+ i
;
1257 if (include_flags
== 0
1258 || ((option
->flags
& include_flags
) != include_flags
))
1260 if ((option
->flags
& any_flags
) == 0)
1264 /* Skip unwanted switches. */
1265 if ((option
->flags
& exclude_flags
) != 0)
1268 /* The driver currently prints its own help text. */
1269 if ((option
->flags
& CL_DRIVER
) != 0
1270 && (option
->flags
& (((1U << cl_lang_count
) - 1)
1271 | CL_COMMON
| CL_TARGET
)) == 0)
1274 /* If an option contains a language specification,
1275 exclude it from common unless all languages are present. */
1276 if ((include_flags
& CL_COMMON
)
1277 && !(option
->flags
& CL_DRIVER
)
1278 && (option
->flags
& CL_LANG_ALL
)
1279 && (option
->flags
& CL_LANG_ALL
) != CL_LANG_ALL
)
1283 /* Skip switches that have already been printed. */
1284 if (opts
->x_help_printed
[i
])
1287 opts
->x_help_printed
[i
] = true;
1289 help
= option
->help
;
1292 if (exclude_flags
& CL_UNDOCUMENTED
)
1295 help
= undocumented_msg
;
1298 /* Get the translation. */
1301 if (option
->alias_target
< N_OPTS
1302 && cl_options
[option
->alias_target
].help
)
1304 const struct cl_option
*target
= cl_options
+ option
->alias_target
;
1305 if (option
->help
== NULL
)
1307 /* The option is undocumented but is an alias for an option that
1308 is documented. If the option has alias arguments, then its
1309 purpose is to provide certain arguments to the other option, so
1310 inform the reader of this. Otherwise, point the reader to the
1311 other option in preference to the former. */
1313 if (option
->alias_arg
)
1315 if (option
->neg_alias_arg
)
1316 snprintf (new_help
, sizeof new_help
,
1317 _("Same as %s%s (or, in negated form, %s%s)."),
1318 target
->opt_text
, option
->alias_arg
,
1319 target
->opt_text
, option
->neg_alias_arg
);
1321 snprintf (new_help
, sizeof new_help
,
1323 target
->opt_text
, option
->alias_arg
);
1326 snprintf (new_help
, sizeof new_help
,
1332 /* For documented options with aliases, mention the aliased
1333 option's name for reference. */
1334 snprintf (new_help
, sizeof new_help
,
1335 _("%s Same as %s."),
1336 help
, cl_options
[option
->alias_target
].opt_text
);
1342 if (option
->warn_message
)
1344 /* Mention that the use of the option will trigger a warning. */
1345 if (help
== new_help
)
1346 snprintf (new_help
+ strlen (new_help
),
1347 sizeof new_help
- strlen (new_help
),
1348 " %s", _(use_diagnosed_msg
));
1350 snprintf (new_help
, sizeof new_help
,
1351 "%s %s", help
, _(use_diagnosed_msg
));
1356 /* Find the gap between the name of the
1357 option and its descriptive text. */
1358 tab
= strchr (help
, '\t');
1367 opt
= option
->opt_text
;
1371 /* With the -Q option enabled we change the descriptive text associated
1372 with an option to be an indication of its current setting. */
1373 if (!opts
->x_quiet_flag
)
1375 void *flag_var
= option_flag_var (i
, opts
);
1377 if (len
< (LEFT_COLUMN
+ 2))
1378 strcpy (new_help
, "\t\t");
1380 strcpy (new_help
, "\t");
1382 /* Set to print whether the option is enabled or disabled,
1383 or, if it's an alias for another option, the name of
1384 the aliased option. */
1385 bool print_state
= false;
1387 if (flag_var
!= NULL
1388 && option
->var_type
!= CLVC_DEFER
)
1390 /* If OPTION is only available for a specific subset
1391 of languages other than this one, mention them. */
1392 bool avail_for_lang
= true;
1393 if (unsigned langset
= option
->flags
& CL_LANG_ALL
)
1395 if (!(langset
& lang_mask
))
1397 avail_for_lang
= false;
1398 strcat (new_help
, _("[available in "));
1399 for (unsigned i
= 0, n
= 0; (1U << i
) < CL_LANG_ALL
; ++i
)
1400 if (langset
& (1U << i
))
1403 strcat (new_help
, ", ");
1404 strcat (new_help
, lang_names
[i
]);
1406 strcat (new_help
, "]");
1409 if (!avail_for_lang
)
1410 ; /* Print nothing else if the option is not available
1411 in the current language. */
1412 else if (option
->flags
& CL_JOINED
)
1414 if (option
->var_type
== CLVC_STRING
)
1416 if (* (const char **) flag_var
!= NULL
)
1417 snprintf (new_help
+ strlen (new_help
),
1418 sizeof (new_help
) - strlen (new_help
),
1419 "%s", * (const char **) flag_var
);
1421 else if (option
->var_type
== CLVC_ENUM
)
1423 const struct cl_enum
*e
= &cl_enums
[option
->var_enum
];
1425 const char *arg
= NULL
;
1427 value
= e
->get (flag_var
);
1428 enum_value_to_arg (e
->values
, &arg
, value
, lang_mask
);
1430 arg
= _("[default]");
1431 snprintf (new_help
+ strlen (new_help
),
1432 sizeof (new_help
) - strlen (new_help
),
1437 if (option
->cl_host_wide_int
)
1438 sprintf (new_help
+ strlen (new_help
),
1439 _("%llu bytes"), (unsigned long long)
1440 *(unsigned HOST_WIDE_INT
*) flag_var
);
1442 sprintf (new_help
+ strlen (new_help
),
1443 "%i", * (int *) flag_var
);
1450 /* When there is no argument, print the option state only
1451 if the option takes no argument. */
1452 print_state
= !(option
->flags
& CL_JOINED
);
1456 if (option
->alias_target
< N_OPTS
1457 && option
->alias_target
!= OPT_SPECIAL_warn_removed
1458 && option
->alias_target
!= OPT_SPECIAL_ignore
1459 && option
->alias_target
!= OPT_SPECIAL_input_file
1460 && option
->alias_target
!= OPT_SPECIAL_program_name
1461 && option
->alias_target
!= OPT_SPECIAL_unknown
)
1463 const struct cl_option
*target
1464 = &cl_options
[option
->alias_target
];
1465 sprintf (new_help
+ strlen (new_help
), "%s%s",
1467 option
->alias_arg
? option
->alias_arg
: "");
1469 else if (option
->alias_target
== OPT_SPECIAL_ignore
)
1470 strcat (new_help
, ("[ignored]"));
1473 /* Print the state for an on/off option. */
1474 int ena
= option_enabled (i
, lang_mask
, opts
);
1476 strcat (new_help
, _("[enabled]"));
1478 strcat (new_help
, _("[disabled]"));
1485 if (option
->range_max
!= -1)
1488 snprintf (b
, sizeof (b
), "<%d,%d>", option
->range_min
,
1490 opt
= concat (opt
, b
, NULL
);
1494 wrap_help (help
, opt
, len
, columns
);
1497 if (option
->var_type
== CLVC_ENUM
1498 && opts
->x_help_enum_printed
[option
->var_enum
] != 2)
1499 opts
->x_help_enum_printed
[option
->var_enum
] = 1;
1502 vec
<const char *> option_values
1503 = targetm_common
.get_valid_option_values (i
, NULL
);
1504 if (!option_values
.is_empty ())
1505 help_tuples
.safe_push (option_help_tuple (i
, option_values
));
1511 unsigned int langs
= include_flags
& CL_LANG_ALL
;
1514 printf (_(" No options with the desired characteristics were found\n"));
1519 /* PR 31349: Tell the user how to see all of the
1520 options supported by a specific front end. */
1521 for (i
= 0; (1U << i
) < CL_LANG_ALL
; i
++)
1522 if ((1U << i
) & langs
)
1523 printf (_(" None found. Use --help=%s to show *all* the options supported by the %s front-end.\n"),
1524 lang_names
[i
], lang_names
[i
]);
1528 else if (! displayed
)
1529 printf (_(" All options with the desired characteristics have already been displayed\n"));
1533 /* Print details of enumerated option arguments, if those
1534 enumerations have help text headings provided. If no help text
1535 is provided, presume that the possible values are listed in the
1536 help text for the relevant options. */
1537 for (i
= 0; i
< cl_enums_count
; i
++)
1539 unsigned int j
, pos
;
1541 if (opts
->x_help_enum_printed
[i
] != 1)
1543 if (cl_enums
[i
].help
== NULL
)
1545 printf (" %s\n ", _(cl_enums
[i
].help
));
1547 for (j
= 0; cl_enums
[i
].values
[j
].arg
!= NULL
; j
++)
1549 unsigned int len
= strlen (cl_enums
[i
].values
[j
].arg
);
1551 if (pos
> 4 && pos
+ 1 + len
<= columns
)
1553 printf (" %s", cl_enums
[i
].values
[j
].arg
);
1563 printf ("%s", cl_enums
[i
].values
[j
].arg
);
1568 opts
->x_help_enum_printed
[i
] = 2;
1571 for (unsigned i
= 0; i
< help_tuples
.length (); i
++)
1573 const struct cl_option
*option
= cl_options
+ help_tuples
[i
].m_code
;
1574 printf (_(" Known valid arguments for %s option:\n "),
1576 for (unsigned j
= 0; j
< help_tuples
[i
].m_values
.length (); j
++)
1577 printf (" %s", help_tuples
[i
].m_values
[j
]);
1582 /* Display help for a specified type of option.
1583 The options must have ALL of the INCLUDE_FLAGS set
1584 ANY of the flags in the ANY_FLAGS set
1585 and NONE of the EXCLUDE_FLAGS set. The current option state is in
1586 OPTS; LANG_MASK is used for interpreting enumerated option state. */
1588 print_specific_help (unsigned int include_flags
,
1589 unsigned int exclude_flags
,
1590 unsigned int any_flags
,
1591 struct gcc_options
*opts
,
1592 unsigned int lang_mask
)
1594 unsigned int all_langs_mask
= (1U << cl_lang_count
) - 1;
1595 const char * description
= NULL
;
1596 const char * descrip_extra
= "";
1600 /* Sanity check: Make sure that we do not have more
1601 languages than we have bits available to enumerate them. */
1602 gcc_assert ((1U << cl_lang_count
) <= CL_MIN_OPTION_CLASS
);
1604 /* If we have not done so already, obtain
1605 the desired maximum width of the output. */
1606 if (opts
->x_help_columns
== 0)
1608 opts
->x_help_columns
= get_terminal_width ();
1609 if (opts
->x_help_columns
== INT_MAX
)
1610 /* Use a reasonable default. */
1611 opts
->x_help_columns
= 80;
1614 /* Decide upon the title for the options that we are going to display. */
1615 for (i
= 0, flag
= 1; flag
<= CL_MAX_OPTION_CLASS
; flag
<<= 1, i
++)
1617 switch (flag
& include_flags
)
1624 description
= _("The following options are target specific");
1627 description
= _("The following options control compiler warning messages");
1629 case CL_OPTIMIZATION
:
1630 description
= _("The following options control optimizations");
1633 description
= _("The following options are language-independent");
1636 description
= _("The following options control parameters");
1639 if (i
>= cl_lang_count
)
1641 if (exclude_flags
& all_langs_mask
)
1642 description
= _("The following options are specific to just the language ");
1644 description
= _("The following options are supported by the language ");
1645 descrip_extra
= lang_names
[i
];
1650 if (description
== NULL
)
1654 if (include_flags
& CL_UNDOCUMENTED
)
1655 description
= _("The following options are not documented");
1656 else if (include_flags
& CL_SEPARATE
)
1657 description
= _("The following options take separate arguments");
1658 else if (include_flags
& CL_JOINED
)
1659 description
= _("The following options take joined arguments");
1662 internal_error ("unrecognized %<include_flags 0x%x%> passed "
1663 "to %<print_specific_help%>",
1670 if (any_flags
& all_langs_mask
)
1671 description
= _("The following options are language-related");
1673 description
= _("The following options are language-independent");
1677 printf ("%s%s:\n", description
, descrip_extra
);
1678 print_filtered_help (include_flags
, exclude_flags
, any_flags
,
1679 opts
->x_help_columns
, opts
, lang_mask
);
1682 /* Enable FDO-related flags. */
1685 enable_fdo_optimizations (struct gcc_options
*opts
,
1686 struct gcc_options
*opts_set
,
1689 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_branch_probabilities
, value
);
1690 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_profile_values
, value
);
1691 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_unroll_loops
, value
);
1692 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_peel_loops
, value
);
1693 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_tracer
, value
);
1694 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_value_profile_transformations
,
1696 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_inline_functions
, value
);
1697 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_ipa_cp
, value
);
1700 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_ipa_cp_clone
, 1);
1701 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_ipa_bit_cp
, 1);
1703 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_predictive_commoning
, value
);
1704 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_split_loops
, value
);
1705 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_unswitch_loops
, value
);
1706 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_gcse_after_reload
, value
);
1707 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_tree_loop_vectorize
, value
);
1708 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_tree_slp_vectorize
, value
);
1709 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_version_loops_for_strides
, value
);
1710 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_vect_cost_model
,
1711 VECT_COST_MODEL_DYNAMIC
);
1712 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_tree_loop_distribute_patterns
,
1714 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_loop_interchange
, value
);
1715 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_unroll_jam
, value
);
1716 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_tree_loop_distribution
, value
);
1719 /* -f{,no-}sanitize{,-recover}= suboptions. */
1720 const struct sanitizer_opts_s sanitizer_opts
[] =
1722 #define SANITIZER_OPT(name, flags, recover) \
1723 { #name, flags, sizeof #name - 1, recover }
1724 SANITIZER_OPT (address
, (SANITIZE_ADDRESS
| SANITIZE_USER_ADDRESS
), true),
1725 SANITIZER_OPT (kernel
-address
, (SANITIZE_ADDRESS
| SANITIZE_KERNEL_ADDRESS
),
1727 SANITIZER_OPT (pointer
-compare
, SANITIZE_POINTER_COMPARE
, true),
1728 SANITIZER_OPT (pointer
-subtract
, SANITIZE_POINTER_SUBTRACT
, true),
1729 SANITIZER_OPT (thread
, SANITIZE_THREAD
, false),
1730 SANITIZER_OPT (leak
, SANITIZE_LEAK
, false),
1731 SANITIZER_OPT (shift
, SANITIZE_SHIFT
, true),
1732 SANITIZER_OPT (shift
-base
, SANITIZE_SHIFT_BASE
, true),
1733 SANITIZER_OPT (shift
-exponent
, SANITIZE_SHIFT_EXPONENT
, true),
1734 SANITIZER_OPT (integer
-divide
-by
-zero
, SANITIZE_DIVIDE
, true),
1735 SANITIZER_OPT (undefined
, SANITIZE_UNDEFINED
, true),
1736 SANITIZER_OPT (unreachable
, SANITIZE_UNREACHABLE
, false),
1737 SANITIZER_OPT (vla
-bound
, SANITIZE_VLA
, true),
1738 SANITIZER_OPT (return, SANITIZE_RETURN
, false),
1739 SANITIZER_OPT (null
, SANITIZE_NULL
, true),
1740 SANITIZER_OPT (signed-integer
-overflow
, SANITIZE_SI_OVERFLOW
, true),
1741 SANITIZER_OPT (bool, SANITIZE_BOOL
, true),
1742 SANITIZER_OPT (enum, SANITIZE_ENUM
, true),
1743 SANITIZER_OPT (float-divide
-by
-zero
, SANITIZE_FLOAT_DIVIDE
, true),
1744 SANITIZER_OPT (float-cast
-overflow
, SANITIZE_FLOAT_CAST
, true),
1745 SANITIZER_OPT (bounds
, SANITIZE_BOUNDS
, true),
1746 SANITIZER_OPT (bounds
-strict
, SANITIZE_BOUNDS
| SANITIZE_BOUNDS_STRICT
, true),
1747 SANITIZER_OPT (alignment
, SANITIZE_ALIGNMENT
, true),
1748 SANITIZER_OPT (nonnull
-attribute
, SANITIZE_NONNULL_ATTRIBUTE
, true),
1749 SANITIZER_OPT (returns
-nonnull
-attribute
, SANITIZE_RETURNS_NONNULL_ATTRIBUTE
,
1751 SANITIZER_OPT (object
-size
, SANITIZE_OBJECT_SIZE
, true),
1752 SANITIZER_OPT (vptr
, SANITIZE_VPTR
, true),
1753 SANITIZER_OPT (pointer
-overflow
, SANITIZE_POINTER_OVERFLOW
, true),
1754 SANITIZER_OPT (builtin
, SANITIZE_BUILTIN
, true),
1755 SANITIZER_OPT (all
, ~0U, true),
1756 #undef SANITIZER_OPT
1757 { NULL
, 0U, 0UL, false }
1760 /* -f{,no-}sanitize-coverage= suboptions. */
1761 const struct sanitizer_opts_s coverage_sanitizer_opts
[] =
1763 #define COVERAGE_SANITIZER_OPT(name, flags) \
1764 { #name, flags, sizeof #name - 1, true }
1765 COVERAGE_SANITIZER_OPT (trace
-pc
, SANITIZE_COV_TRACE_PC
),
1766 COVERAGE_SANITIZER_OPT (trace
-cmp
, SANITIZE_COV_TRACE_CMP
),
1767 #undef COVERAGE_SANITIZER_OPT
1768 { NULL
, 0U, 0UL, false }
1771 /* A struct for describing a run of chars within a string. */
1773 class string_fragment
1776 string_fragment (const char *start
, size_t len
)
1777 : m_start (start
), m_len (len
) {}
1779 const char *m_start
;
1783 /* Specialization of edit_distance_traits for string_fragment,
1784 for use by get_closest_sanitizer_option. */
1787 struct edit_distance_traits
<const string_fragment
&>
1789 static size_t get_length (const string_fragment
&fragment
)
1791 return fragment
.m_len
;
1794 static const char *get_string (const string_fragment
&fragment
)
1796 return fragment
.m_start
;
1800 /* Given ARG, an unrecognized sanitizer option, return the best
1801 matching sanitizer option, or NULL if there isn't one.
1802 OPTS is array of candidate sanitizer options.
1803 CODE is OPT_fsanitize_, OPT_fsanitize_recover_ or
1804 OPT_fsanitize_coverage_.
1805 VALUE is non-zero for the regular form of the option, zero
1806 for the "no-" form (e.g. "-fno-sanitize-recover="). */
1809 get_closest_sanitizer_option (const string_fragment
&arg
,
1810 const struct sanitizer_opts_s
*opts
,
1811 enum opt_code code
, int value
)
1813 best_match
<const string_fragment
&, const char*> bm (arg
);
1814 for (int i
= 0; opts
[i
].name
!= NULL
; ++i
)
1816 /* -fsanitize=all is not valid, so don't offer it. */
1817 if (code
== OPT_fsanitize_
1818 && opts
[i
].flag
== ~0U
1822 /* For -fsanitize-recover= (and not -fno-sanitize-recover=),
1823 don't offer the non-recoverable options. */
1824 if (code
== OPT_fsanitize_recover_
1825 && !opts
[i
].can_recover
1829 bm
.consider (opts
[i
].name
);
1831 return bm
.get_best_meaningful_candidate ();
1834 /* Parse comma separated sanitizer suboptions from P for option SCODE,
1835 adjust previous FLAGS and return new ones. If COMPLAIN is false,
1836 don't issue diagnostics. */
1839 parse_sanitizer_options (const char *p
, location_t loc
, int scode
,
1840 unsigned int flags
, int value
, bool complain
)
1842 enum opt_code code
= (enum opt_code
) scode
;
1844 const struct sanitizer_opts_s
*opts
;
1845 if (code
== OPT_fsanitize_coverage_
)
1846 opts
= coverage_sanitizer_opts
;
1848 opts
= sanitizer_opts
;
1854 const char *comma
= strchr (p
, ',');
1866 /* Check to see if the string matches an option class name. */
1867 for (i
= 0; opts
[i
].name
!= NULL
; ++i
)
1868 if (len
== opts
[i
].len
&& memcmp (p
, opts
[i
].name
, len
) == 0)
1870 /* Handle both -fsanitize and -fno-sanitize cases. */
1871 if (value
&& opts
[i
].flag
== ~0U)
1873 if (code
== OPT_fsanitize_
)
1876 error_at (loc
, "%<-fsanitize=all%> option is not valid");
1879 flags
|= ~(SANITIZE_THREAD
| SANITIZE_LEAK
1880 | SANITIZE_UNREACHABLE
| SANITIZE_RETURN
);
1884 /* Do not enable -fsanitize-recover=unreachable and
1885 -fsanitize-recover=return if -fsanitize-recover=undefined
1887 if (code
== OPT_fsanitize_recover_
1888 && opts
[i
].flag
== SANITIZE_UNDEFINED
)
1889 flags
|= (SANITIZE_UNDEFINED
1890 & ~(SANITIZE_UNREACHABLE
| SANITIZE_RETURN
));
1892 flags
|= opts
[i
].flag
;
1895 flags
&= ~opts
[i
].flag
;
1900 if (! found
&& complain
)
1903 = get_closest_sanitizer_option (string_fragment (p
, len
),
1907 if (code
== OPT_fsanitize_recover_
)
1908 suffix
= "-recover";
1909 else if (code
== OPT_fsanitize_coverage_
)
1910 suffix
= "-coverage";
1916 "unrecognized argument to %<-f%ssanitize%s=%> "
1917 "option: %q.*s; did you mean %qs?",
1919 suffix
, (int) len
, p
, hint
);
1922 "unrecognized argument to %<-f%ssanitize%s=%> option: "
1923 "%q.*s", value
? "" : "no-",
1924 suffix
, (int) len
, p
);
1934 /* Parse string values of no_sanitize attribute passed in VALUE.
1935 Values are separated with comma. */
1938 parse_no_sanitize_attribute (char *value
)
1940 unsigned int flags
= 0;
1942 char *q
= strtok (value
, ",");
1946 for (i
= 0; sanitizer_opts
[i
].name
!= NULL
; ++i
)
1947 if (strcmp (sanitizer_opts
[i
].name
, q
) == 0)
1949 flags
|= sanitizer_opts
[i
].flag
;
1950 if (sanitizer_opts
[i
].flag
== SANITIZE_UNDEFINED
)
1951 flags
|= SANITIZE_UNDEFINED_NONDEFAULT
;
1955 if (sanitizer_opts
[i
].name
== NULL
)
1956 warning (OPT_Wattributes
,
1957 "%qs attribute directive ignored", q
);
1959 q
= strtok (NULL
, ",");
1965 /* Parse -falign-NAME format for a FLAG value. Return individual
1966 parsed integer values into RESULT_VALUES array. If REPORT_ERROR is
1967 set, print error message at LOC location. */
1970 parse_and_check_align_values (const char *flag
,
1972 auto_vec
<unsigned> &result_values
,
1976 char *str
= xstrdup (flag
);
1977 for (char *p
= strtok (str
, ":"); p
; p
= strtok (NULL
, ":"))
1980 int v
= strtol (p
, &end
, 10);
1981 if (*end
!= '\0' || v
< 0)
1984 error_at (loc
, "invalid arguments for %<-falign-%s%> option: %qs",
1990 result_values
.safe_push ((unsigned)v
);
1995 /* Check that we have a correct number of values. */
1996 if (result_values
.is_empty () || result_values
.length () > 4)
1999 error_at (loc
, "invalid number of arguments for %<-falign-%s%> "
2000 "option: %qs", name
, flag
);
2004 for (unsigned i
= 0; i
< result_values
.length (); i
++)
2005 if (result_values
[i
] > MAX_CODE_ALIGN_VALUE
)
2008 error_at (loc
, "%<-falign-%s%> is not between 0 and %d",
2009 name
, MAX_CODE_ALIGN_VALUE
);
2016 /* Check that alignment value FLAG for -falign-NAME is valid at a given
2017 location LOC. OPT_STR points to the stored -falign-NAME=argument and
2018 OPT_FLAG points to the associated -falign-NAME on/off flag. */
2021 check_alignment_argument (location_t loc
, const char *flag
, const char *name
,
2022 int *opt_flag
, const char **opt_str
)
2024 auto_vec
<unsigned> align_result
;
2025 parse_and_check_align_values (flag
, name
, align_result
, true, loc
);
2027 if (align_result
.length() >= 1 && align_result
[0] == 0)
2034 /* Print help when OPT__help_ is set. */
2037 print_help (struct gcc_options
*opts
, unsigned int lang_mask
,
2038 const char *help_option_argument
)
2040 const char *a
= help_option_argument
;
2041 unsigned int include_flags
= 0;
2042 /* Note - by default we include undocumented options when listing
2043 specific classes. If you only want to see documented options
2044 then add ",^undocumented" to the --help= option. E.g.:
2046 --help=target,^undocumented */
2047 unsigned int exclude_flags
= 0;
2049 if (lang_mask
== CL_DRIVER
)
2052 /* Walk along the argument string, parsing each word in turn.
2054 arg = [^]{word}[,{arg}]
2055 word = {optimizers|target|warnings|undocumented|
2056 params|common|<language>} */
2066 { "optimizers", CL_OPTIMIZATION
},
2067 { "target", CL_TARGET
},
2068 { "warnings", CL_WARNING
},
2069 { "undocumented", CL_UNDOCUMENTED
},
2070 { "params", CL_PARAMS
},
2071 { "joined", CL_JOINED
},
2072 { "separate", CL_SEPARATE
},
2073 { "common", CL_COMMON
},
2076 unsigned int *pflags
;
2078 unsigned int lang_flag
, specific_flag
;
2087 error ("missing argument to %qs", "--help=^");
2090 pflags
= &exclude_flags
;
2093 pflags
= &include_flags
;
2095 comma
= strchr (a
, ',');
2106 /* Check to see if the string matches an option class name. */
2107 for (i
= 0, specific_flag
= 0; specifics
[i
].string
!= NULL
; i
++)
2108 if (strncasecmp (a
, specifics
[i
].string
, len
) == 0)
2110 specific_flag
= specifics
[i
].flag
;
2114 /* Check to see if the string matches a language name.
2115 Note - we rely upon the alpha-sorted nature of the entries in
2116 the lang_names array, specifically that shorter names appear
2117 before their longer variants. (i.e. C before C++). That way
2118 when we are attempting to match --help=c for example we will
2119 match with C first and not C++. */
2120 for (i
= 0, lang_flag
= 0; i
< cl_lang_count
; i
++)
2121 if (strncasecmp (a
, lang_names
[i
], len
) == 0)
2123 lang_flag
= 1U << i
;
2127 if (specific_flag
!= 0)
2130 *pflags
|= specific_flag
;
2133 /* The option's argument matches both the start of a
2134 language name and the start of an option class name.
2135 We have a special case for when the user has
2136 specified "--help=c", but otherwise we have to issue
2138 if (strncasecmp (a
, "c", len
) == 0)
2139 *pflags
|= lang_flag
;
2142 "%<--help%> argument %q.*s is ambiguous, "
2143 "please be more specific",
2147 else if (lang_flag
!= 0)
2148 *pflags
|= lang_flag
;
2151 "unrecognized argument to %<--help=%> option: %q.*s",
2159 /* We started using PerFunction/Optimization for parameters and
2160 a warning. We should exclude these from optimization options. */
2161 if (include_flags
& CL_OPTIMIZATION
)
2162 exclude_flags
|= CL_WARNING
;
2163 if (!(include_flags
& CL_PARAMS
))
2164 exclude_flags
|= CL_PARAMS
;
2167 print_specific_help (include_flags
, exclude_flags
, 0, opts
,
2171 /* Handle target- and language-independent options. Return zero to
2172 generate an "unknown option" message. Only options that need
2173 extra handling need to be listed here; if you simply want
2174 DECODED->value assigned to a variable, it happens automatically. */
2177 common_handle_option (struct gcc_options
*opts
,
2178 struct gcc_options
*opts_set
,
2179 const struct cl_decoded_option
*decoded
,
2180 unsigned int lang_mask
, int kind ATTRIBUTE_UNUSED
,
2182 const struct cl_option_handlers
*handlers
,
2183 diagnostic_context
*dc
,
2184 void (*target_option_override_hook
) (void))
2186 size_t scode
= decoded
->opt_index
;
2187 const char *arg
= decoded
->arg
;
2188 HOST_WIDE_INT value
= decoded
->value
;
2189 enum opt_code code
= (enum opt_code
) scode
;
2191 gcc_assert (decoded
->canonical_option_num_elements
<= 2);
2197 unsigned int all_langs_mask
= (1U << cl_lang_count
) - 1;
2198 unsigned int undoc_mask
;
2201 if (lang_mask
== CL_DRIVER
)
2204 undoc_mask
= ((opts
->x_verbose_flag
| opts
->x_extra_warnings
)
2207 target_option_override_hook ();
2208 /* First display any single language specific options. */
2209 for (i
= 0; i
< cl_lang_count
; i
++)
2211 (1U << i
, (all_langs_mask
& (~ (1U << i
))) | undoc_mask
, 0, opts
,
2213 /* Next display any multi language specific options. */
2214 print_specific_help (0, undoc_mask
, all_langs_mask
, opts
, lang_mask
);
2215 /* Then display any remaining, non-language options. */
2216 for (i
= CL_MIN_OPTION_CLASS
; i
<= CL_MAX_OPTION_CLASS
; i
<<= 1)
2218 print_specific_help (i
, undoc_mask
, 0, opts
, lang_mask
);
2219 opts
->x_exit_after_options
= true;
2223 case OPT__target_help
:
2224 if (lang_mask
== CL_DRIVER
)
2227 target_option_override_hook ();
2228 print_specific_help (CL_TARGET
, CL_UNDOCUMENTED
, 0, opts
, lang_mask
);
2229 opts
->x_exit_after_options
= true;
2234 help_option_arguments
.safe_push (arg
);
2235 opts
->x_exit_after_options
= true;
2240 if (lang_mask
== CL_DRIVER
)
2243 opts
->x_exit_after_options
= true;
2246 case OPT__completion_
:
2249 case OPT_fsanitize_
:
2250 opts
->x_flag_sanitize
2251 = parse_sanitizer_options (arg
, loc
, code
,
2252 opts
->x_flag_sanitize
, value
, true);
2254 /* Kernel ASan implies normal ASan but does not yet support
2256 if (opts
->x_flag_sanitize
& SANITIZE_KERNEL_ADDRESS
)
2258 SET_OPTION_IF_UNSET (opts
, opts_set
,
2259 param_asan_instrumentation_with_call_threshold
,
2261 SET_OPTION_IF_UNSET (opts
, opts_set
, param_asan_globals
, 0);
2262 SET_OPTION_IF_UNSET (opts
, opts_set
, param_asan_stack
, 0);
2263 SET_OPTION_IF_UNSET (opts
, opts_set
, param_asan_protect_allocas
, 0);
2264 SET_OPTION_IF_UNSET (opts
, opts_set
, param_asan_use_after_return
, 0);
2268 case OPT_fsanitize_recover_
:
2269 opts
->x_flag_sanitize_recover
2270 = parse_sanitizer_options (arg
, loc
, code
,
2271 opts
->x_flag_sanitize_recover
, value
, true);
2274 case OPT_fasan_shadow_offset_
:
2278 case OPT_fsanitize_address_use_after_scope
:
2279 opts
->x_flag_sanitize_address_use_after_scope
= value
;
2282 case OPT_fsanitize_recover
:
2284 opts
->x_flag_sanitize_recover
2285 |= (SANITIZE_UNDEFINED
| SANITIZE_UNDEFINED_NONDEFAULT
)
2286 & ~(SANITIZE_UNREACHABLE
| SANITIZE_RETURN
);
2288 opts
->x_flag_sanitize_recover
2289 &= ~(SANITIZE_UNDEFINED
| SANITIZE_UNDEFINED_NONDEFAULT
);
2292 case OPT_fsanitize_coverage_
:
2293 opts
->x_flag_sanitize_coverage
2294 = parse_sanitizer_options (arg
, loc
, code
,
2295 opts
->x_flag_sanitize_coverage
, value
, true);
2302 /* Currently handled in a prescan. */
2306 dc
->warning_as_error_requested
= value
;
2310 if (lang_mask
== CL_DRIVER
)
2313 enable_warning_as_error (arg
, value
, lang_mask
, handlers
,
2314 opts
, opts_set
, loc
, dc
);
2317 case OPT_Wfatal_errors
:
2318 dc
->fatal_errors
= value
;
2321 case OPT_Wstack_usage_
:
2322 opts
->x_flag_stack_usage_info
= value
!= -1;
2325 case OPT_Wstrict_aliasing
:
2326 set_Wstrict_aliasing (opts
, value
);
2329 case OPT_Wstrict_overflow
:
2330 opts
->x_warn_strict_overflow
= (value
2331 ? (int) WARN_STRICT_OVERFLOW_CONDITIONAL
2335 case OPT_Wsystem_headers
:
2336 dc
->dc_warn_system_headers
= value
;
2340 opts
->x_flag_gen_aux_info
= 1;
2344 decode_d_option (arg
, opts
, loc
, dc
);
2347 case OPT_fcall_used_
:
2348 case OPT_fcall_saved_
:
2356 case OPT_fdbg_cnt_list
:
2358 opts
->x_exit_after_options
= true;
2361 case OPT_fdebug_prefix_map_
:
2362 case OPT_ffile_prefix_map_
:
2366 case OPT_fcallgraph_info
:
2367 opts
->x_flag_callgraph_info
= CALLGRAPH_INFO_NAKED
;
2370 case OPT_fcallgraph_info_
:
2373 my_arg
= xstrdup (arg
);
2374 p
= strtok (my_arg
, ",");
2377 if (strcmp (p
, "su") == 0)
2379 opts
->x_flag_callgraph_info
|= CALLGRAPH_INFO_STACK_USAGE
;
2380 opts
->x_flag_stack_usage_info
= true;
2382 else if (strcmp (p
, "da") == 0)
2383 opts
->x_flag_callgraph_info
|= CALLGRAPH_INFO_DYNAMIC_ALLOC
;
2386 p
= strtok (NULL
, ",");
2392 case OPT_fdiagnostics_show_location_
:
2393 diagnostic_prefixing_rule (dc
) = (diagnostic_prefixing_rule_t
) value
;
2396 case OPT_fdiagnostics_show_caret
:
2397 dc
->show_caret
= value
;
2400 case OPT_fdiagnostics_show_labels
:
2401 dc
->show_labels_p
= value
;
2404 case OPT_fdiagnostics_show_line_numbers
:
2405 dc
->show_line_numbers_p
= value
;
2408 case OPT_fdiagnostics_color_
:
2409 diagnostic_color_init (dc
, value
);
2412 case OPT_fdiagnostics_urls_
:
2413 diagnostic_urls_init (dc
, value
);
2416 case OPT_fdiagnostics_format_
:
2417 diagnostic_output_format_init (dc
,
2418 (enum diagnostics_output_format
)value
);
2421 case OPT_fdiagnostics_parseable_fixits
:
2422 dc
->parseable_fixits_p
= value
;
2425 case OPT_fdiagnostics_column_unit_
:
2426 dc
->column_unit
= (enum diagnostics_column_unit
)value
;
2429 case OPT_fdiagnostics_column_origin_
:
2430 dc
->column_origin
= value
;
2433 case OPT_fdiagnostics_show_cwe
:
2434 dc
->show_cwe
= value
;
2437 case OPT_fdiagnostics_path_format_
:
2438 dc
->path_format
= (enum diagnostic_path_format
)value
;
2441 case OPT_fdiagnostics_show_path_depths
:
2442 dc
->show_path_depths
= value
;
2445 case OPT_fdiagnostics_show_option
:
2446 dc
->show_option_requested
= value
;
2449 case OPT_fdiagnostics_minimum_margin_width_
:
2450 dc
->min_margin_width
= value
;
2457 case OPT_ffast_math
:
2458 set_fast_math_flags (opts
, value
);
2461 case OPT_funsafe_math_optimizations
:
2462 set_unsafe_math_optimizations_flags (opts
, value
);
2469 case OPT_finline_limit_
:
2470 SET_OPTION_IF_UNSET (opts
, opts_set
, param_max_inline_insns_single
,
2472 SET_OPTION_IF_UNSET (opts
, opts_set
, param_max_inline_insns_auto
,
2476 case OPT_finstrument_functions_exclude_function_list_
:
2477 add_comma_separated_to_vector
2478 (&opts
->x_flag_instrument_functions_exclude_functions
, arg
);
2481 case OPT_finstrument_functions_exclude_file_list_
:
2482 add_comma_separated_to_vector
2483 (&opts
->x_flag_instrument_functions_exclude_files
, arg
);
2486 case OPT_fmessage_length_
:
2487 pp_set_line_maximum_length (dc
->printer
, value
);
2488 diagnostic_set_caret_max_width (dc
, value
);
2492 case OPT_fopt_info_
:
2500 #ifndef ACCEL_COMPILER
2501 case OPT_foffload_abi_
:
2502 error_at (loc
, "%<-foffload-abi%> option can be specified only for "
2503 "offload compiler");
2507 case OPT_fpack_struct_
:
2508 if (value
<= 0 || (value
& (value
- 1)) || value
> 16)
2510 "structure alignment must be a small power of two, not %wu",
2513 opts
->x_initial_max_fld_align
= value
;
2517 case OPT_fplugin_arg_
:
2521 case OPT_fprofile_use_
:
2522 opts
->x_profile_data_prefix
= xstrdup (arg
);
2523 opts
->x_flag_profile_use
= true;
2525 /* No break here - do -fprofile-use processing. */
2527 case OPT_fprofile_use
:
2528 enable_fdo_optimizations (opts
, opts_set
, value
);
2529 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_profile_reorder_functions
,
2531 /* Indirect call profiling should do all useful transformations
2532 speculative devirtualization does. */
2533 if (opts
->x_flag_value_profile_transformations
)
2534 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_devirtualize_speculatively
,
2538 case OPT_fauto_profile_
:
2539 opts
->x_auto_profile_file
= xstrdup (arg
);
2540 opts
->x_flag_auto_profile
= true;
2542 /* No break here - do -fauto-profile processing. */
2544 case OPT_fauto_profile
:
2545 enable_fdo_optimizations (opts
, opts_set
, value
);
2546 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_profile_correction
, value
);
2547 SET_OPTION_IF_UNSET (opts
, opts_set
,
2548 param_early_inliner_max_iterations
, 10);
2551 case OPT_fprofile_generate_
:
2552 opts
->x_profile_data_prefix
= xstrdup (arg
);
2554 /* No break here - do -fprofile-generate processing. */
2556 case OPT_fprofile_generate
:
2557 SET_OPTION_IF_UNSET (opts
, opts_set
, profile_arc_flag
, value
);
2558 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_profile_values
, value
);
2559 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_inline_functions
, value
);
2560 SET_OPTION_IF_UNSET (opts
, opts_set
, flag_ipa_bit_cp
, value
);
2563 case OPT_fpatchable_function_entry_
:
2565 char *patch_area_arg
= xstrdup (arg
);
2566 char *comma
= strchr (patch_area_arg
, ',');
2570 function_entry_patch_area_size
=
2571 integral_argument (patch_area_arg
);
2572 function_entry_patch_area_start
=
2573 integral_argument (comma
+ 1);
2577 function_entry_patch_area_size
=
2578 integral_argument (patch_area_arg
);
2579 function_entry_patch_area_start
= 0;
2581 if (function_entry_patch_area_size
< 0
2582 || function_entry_patch_area_size
> USHRT_MAX
2583 || function_entry_patch_area_start
< 0
2584 || function_entry_patch_area_start
> USHRT_MAX
2585 || function_entry_patch_area_size
2586 < function_entry_patch_area_start
)
2587 error ("invalid arguments for %<-fpatchable-function-entry%>");
2588 free (patch_area_arg
);
2592 case OPT_ftree_vectorize
:
2593 /* Automatically sets -ftree-loop-vectorize and
2594 -ftree-slp-vectorize. Nothing more to do here. */
2596 case OPT_fshow_column
:
2597 dc
->show_column
= value
;
2600 case OPT_frandom_seed
:
2601 /* The real switch is -fno-random-seed. */
2607 case OPT_frandom_seed_
:
2611 case OPT_fsched_verbose_
:
2612 #ifdef INSN_SCHEDULING
2613 /* Handled with Var in common.opt. */
2619 case OPT_fsched_stalled_insns_
:
2620 opts
->x_flag_sched_stalled_insns
= value
;
2621 if (opts
->x_flag_sched_stalled_insns
== 0)
2622 opts
->x_flag_sched_stalled_insns
= -1;
2625 case OPT_fsched_stalled_insns_dep_
:
2626 opts
->x_flag_sched_stalled_insns_dep
= value
;
2629 case OPT_fstack_check_
:
2630 if (!strcmp (arg
, "no"))
2631 opts
->x_flag_stack_check
= NO_STACK_CHECK
;
2632 else if (!strcmp (arg
, "generic"))
2633 /* This is the old stack checking method. */
2634 opts
->x_flag_stack_check
= STACK_CHECK_BUILTIN
2635 ? FULL_BUILTIN_STACK_CHECK
2636 : GENERIC_STACK_CHECK
;
2637 else if (!strcmp (arg
, "specific"))
2638 /* This is the new stack checking method. */
2639 opts
->x_flag_stack_check
= STACK_CHECK_BUILTIN
2640 ? FULL_BUILTIN_STACK_CHECK
2641 : STACK_CHECK_STATIC_BUILTIN
2642 ? STATIC_BUILTIN_STACK_CHECK
2643 : GENERIC_STACK_CHECK
;
2645 warning_at (loc
, 0, "unknown stack check parameter %qs", arg
);
2648 case OPT_fstack_limit
:
2649 /* The real switch is -fno-stack-limit. */
2655 case OPT_fstack_limit_register_
:
2656 case OPT_fstack_limit_symbol_
:
2660 case OPT_fstack_usage
:
2661 opts
->x_flag_stack_usage
= value
;
2662 opts
->x_flag_stack_usage_info
= value
!= 0;
2666 set_debug_level (NO_DEBUG
, DEFAULT_GDB_EXTENSIONS
, arg
, opts
, opts_set
,
2671 if (arg
&& strlen (arg
) != 0)
2673 error_at (loc
, "%<-gdwarf%s%> is ambiguous; "
2674 "use %<-gdwarf-%s%> for DWARF version "
2675 "or %<-gdwarf%> %<-g%s%> for debug level", arg
, arg
, arg
);
2679 value
= opts
->x_dwarf_version
;
2683 if (value
< 2 || value
> 5)
2684 error_at (loc
, "dwarf version %wu is not supported", value
);
2686 opts
->x_dwarf_version
= value
;
2687 set_debug_level (DWARF2_DEBUG
, false, "", opts
, opts_set
, loc
);
2691 set_debug_level (NO_DEBUG
, 2, arg
, opts
, opts_set
, loc
);
2696 set_debug_level (DBX_DEBUG
, code
== OPT_gstabs_
, arg
, opts
, opts_set
,
2701 set_debug_level (VMS_DEBUG
, false, arg
, opts
, opts_set
, loc
);
2706 set_debug_level (XCOFF_DEBUG
, code
== OPT_gxcoff_
, arg
, opts
, opts_set
,
2712 /* Handled completely via specs. */
2715 case OPT_pedantic_errors
:
2716 dc
->pedantic_errors
= 1;
2717 control_warning_option (OPT_Wpedantic
, DK_ERROR
, NULL
, value
,
2719 handlers
, opts
, opts_set
,
2724 opts
->x_flag_lto
= value
? "" : NULL
;
2728 if (strcmp (arg
, "none") != 0
2729 && strcmp (arg
, "jobserver") != 0
2730 && strcmp (arg
, "auto") != 0
2733 "unrecognized argument to %<-flto=%> option: %qs", arg
);
2737 dc
->dc_inhibit_warnings
= true;
2740 case OPT_fmax_errors_
:
2741 dc
->max_errors
= value
;
2744 case OPT_fuse_ld_bfd
:
2745 case OPT_fuse_ld_gold
:
2746 case OPT_fuse_ld_lld
:
2747 case OPT_fuse_linker_plugin
:
2748 /* No-op. Used by the driver and passed to us because it starts with f.*/
2753 opts
->x_flag_trapv
= 0;
2758 opts
->x_flag_wrapv
= 0;
2761 case OPT_fstrict_overflow
:
2762 opts
->x_flag_wrapv
= !value
;
2763 opts
->x_flag_wrapv_pointer
= !value
;
2765 opts
->x_flag_trapv
= 0;
2769 opts
->x_flag_ipa_icf_functions
= value
;
2770 opts
->x_flag_ipa_icf_variables
= value
;
2773 case OPT_falign_loops_
:
2774 check_alignment_argument (loc
, arg
, "loops",
2775 &opts
->x_flag_align_loops
,
2776 &opts
->x_str_align_loops
);
2779 case OPT_falign_jumps_
:
2780 check_alignment_argument (loc
, arg
, "jumps",
2781 &opts
->x_flag_align_jumps
,
2782 &opts
->x_str_align_jumps
);
2785 case OPT_falign_labels_
:
2786 check_alignment_argument (loc
, arg
, "labels",
2787 &opts
->x_flag_align_labels
,
2788 &opts
->x_str_align_labels
);
2791 case OPT_falign_functions_
:
2792 check_alignment_argument (loc
, arg
, "functions",
2793 &opts
->x_flag_align_functions
,
2794 &opts
->x_str_align_functions
);
2798 /* It is documented that we silently ignore silly values. */
2799 if (value
>= 1 && value
<= 100)
2800 dc
->tabstop
= value
;
2804 /* If the flag was handled in a standard way, assume the lack of
2805 processing here is intentional. */
2806 gcc_assert (option_flag_var (scode
, opts
));
2810 common_handle_option_auto (opts
, opts_set
, decoded
, lang_mask
, kind
,
2815 /* Used to set the level of strict aliasing warnings in OPTS,
2816 when no level is specified (i.e., when -Wstrict-aliasing, and not
2817 -Wstrict-aliasing=level was given).
2818 ONOFF is assumed to take value 1 when -Wstrict-aliasing is specified,
2819 and 0 otherwise. After calling this function, wstrict_aliasing will be
2820 set to the default value of -Wstrict_aliasing=level, currently 3. */
2822 set_Wstrict_aliasing (struct gcc_options
*opts
, int onoff
)
2824 gcc_assert (onoff
== 0 || onoff
== 1);
2826 opts
->x_warn_strict_aliasing
= 3;
2828 opts
->x_warn_strict_aliasing
= 0;
2831 /* The following routines are useful in setting all the flags that
2832 -ffast-math and -fno-fast-math imply. */
2834 set_fast_math_flags (struct gcc_options
*opts
, int set
)
2836 if (!opts
->frontend_set_flag_unsafe_math_optimizations
)
2838 opts
->x_flag_unsafe_math_optimizations
= set
;
2839 set_unsafe_math_optimizations_flags (opts
, set
);
2841 if (!opts
->frontend_set_flag_finite_math_only
)
2842 opts
->x_flag_finite_math_only
= set
;
2843 if (!opts
->frontend_set_flag_errno_math
)
2844 opts
->x_flag_errno_math
= !set
;
2847 if (opts
->frontend_set_flag_excess_precision
== EXCESS_PRECISION_DEFAULT
)
2848 opts
->x_flag_excess_precision
2849 = set
? EXCESS_PRECISION_FAST
: EXCESS_PRECISION_DEFAULT
;
2850 if (!opts
->frontend_set_flag_signaling_nans
)
2851 opts
->x_flag_signaling_nans
= 0;
2852 if (!opts
->frontend_set_flag_rounding_math
)
2853 opts
->x_flag_rounding_math
= 0;
2854 if (!opts
->frontend_set_flag_cx_limited_range
)
2855 opts
->x_flag_cx_limited_range
= 1;
2859 /* When -funsafe-math-optimizations is set the following
2860 flags are set as well. */
2862 set_unsafe_math_optimizations_flags (struct gcc_options
*opts
, int set
)
2864 if (!opts
->frontend_set_flag_trapping_math
)
2865 opts
->x_flag_trapping_math
= !set
;
2866 if (!opts
->frontend_set_flag_signed_zeros
)
2867 opts
->x_flag_signed_zeros
= !set
;
2868 if (!opts
->frontend_set_flag_associative_math
)
2869 opts
->x_flag_associative_math
= set
;
2870 if (!opts
->frontend_set_flag_reciprocal_math
)
2871 opts
->x_flag_reciprocal_math
= set
;
2874 /* Return true iff flags in OPTS are set as if -ffast-math. */
2876 fast_math_flags_set_p (const struct gcc_options
*opts
)
2878 return (!opts
->x_flag_trapping_math
2879 && opts
->x_flag_unsafe_math_optimizations
2880 && opts
->x_flag_finite_math_only
2881 && !opts
->x_flag_signed_zeros
2882 && !opts
->x_flag_errno_math
2883 && opts
->x_flag_excess_precision
== EXCESS_PRECISION_FAST
);
2886 /* Return true iff flags are set as if -ffast-math but using the flags stored
2887 in the struct cl_optimization structure. */
2889 fast_math_flags_struct_set_p (struct cl_optimization
*opt
)
2891 return (!opt
->x_flag_trapping_math
2892 && opt
->x_flag_unsafe_math_optimizations
2893 && opt
->x_flag_finite_math_only
2894 && !opt
->x_flag_signed_zeros
2895 && !opt
->x_flag_errno_math
);
2898 /* Handle a debug output -g switch for options OPTS
2899 (OPTS_SET->x_write_symbols storing whether a debug type was passed
2900 explicitly), location LOC. EXTENDED is true or false to support
2901 extended output (2 is special and means "-ggdb" was given). */
2903 set_debug_level (enum debug_info_type type
, int extended
, const char *arg
,
2904 struct gcc_options
*opts
, struct gcc_options
*opts_set
,
2907 opts
->x_use_gnu_debug_info_extensions
= extended
;
2909 if (type
== NO_DEBUG
)
2911 if (opts
->x_write_symbols
== NO_DEBUG
)
2913 opts
->x_write_symbols
= PREFERRED_DEBUGGING_TYPE
;
2917 #if defined DWARF2_DEBUGGING_INFO || defined DWARF2_LINENO_DEBUGGING_INFO
2918 opts
->x_write_symbols
= DWARF2_DEBUG
;
2919 #elif defined DBX_DEBUGGING_INFO
2920 opts
->x_write_symbols
= DBX_DEBUG
;
2924 if (opts
->x_write_symbols
== NO_DEBUG
)
2925 warning_at (loc
, 0, "target system does not support debug output");
2930 /* Does it conflict with an already selected type? */
2931 if (opts_set
->x_write_symbols
!= NO_DEBUG
2932 && opts
->x_write_symbols
!= NO_DEBUG
2933 && type
!= opts
->x_write_symbols
)
2934 error_at (loc
, "debug format %qs conflicts with prior selection",
2935 debug_type_names
[type
]);
2936 opts
->x_write_symbols
= type
;
2937 opts_set
->x_write_symbols
= type
;
2940 /* A debug flag without a level defaults to level 2.
2941 If off or at level 1, set it to level 2, but if already
2942 at level 3, don't lower it. */
2945 if (opts
->x_debug_info_level
< DINFO_LEVEL_NORMAL
)
2946 opts
->x_debug_info_level
= DINFO_LEVEL_NORMAL
;
2950 int argval
= integral_argument (arg
);
2952 error_at (loc
, "unrecognized debug output level %qs", arg
);
2953 else if (argval
> 3)
2954 error_at (loc
, "debug output level %qs is too high", arg
);
2956 opts
->x_debug_info_level
= (enum debug_info_levels
) argval
;
2960 /* Arrange to dump core on error for diagnostic context DC. (The
2961 regular error message is still printed first, except in the case of
2965 setup_core_dumping (diagnostic_context
*dc
)
2968 signal (SIGABRT
, SIG_DFL
);
2970 #if defined(HAVE_SETRLIMIT)
2973 if (getrlimit (RLIMIT_CORE
, &rlim
) != 0)
2974 fatal_error (input_location
, "getting core file size maximum limit: %m");
2975 rlim
.rlim_cur
= rlim
.rlim_max
;
2976 if (setrlimit (RLIMIT_CORE
, &rlim
) != 0)
2977 fatal_error (input_location
,
2978 "setting core file size limit to maximum: %m");
2981 diagnostic_abort_on_error (dc
);
2984 /* Parse a -d<ARG> command line switch for OPTS, location LOC,
2985 diagnostic context DC. */
2988 decode_d_option (const char *arg
, struct gcc_options
*opts
,
2989 location_t loc
, diagnostic_context
*dc
)
2997 opts
->x_flag_debug_asm
= 1;
3000 opts
->x_flag_print_asm_name
= 1;
3003 opts
->x_flag_dump_rtl_in_asm
= 1;
3004 opts
->x_flag_print_asm_name
= 1;
3007 opts
->x_rtl_dump_and_exit
= 1;
3009 case 'D': /* These are handled by the preprocessor. */
3016 setup_core_dumping (dc
);
3019 opts
->x_flag_dump_all_passed
= true;
3023 warning_at (loc
, 0, "unrecognized gcc debugging option: %c", c
);
3028 /* Enable (or disable if VALUE is 0) a warning option ARG (language
3029 mask LANG_MASK, option handlers HANDLERS) as an error for option
3030 structures OPTS and OPTS_SET, diagnostic context DC (possibly
3031 NULL), location LOC. This is used by -Werror=. */
3034 enable_warning_as_error (const char *arg
, int value
, unsigned int lang_mask
,
3035 const struct cl_option_handlers
*handlers
,
3036 struct gcc_options
*opts
,
3037 struct gcc_options
*opts_set
,
3038 location_t loc
, diagnostic_context
*dc
)
3043 new_option
= XNEWVEC (char, strlen (arg
) + 2);
3044 new_option
[0] = 'W';
3045 strcpy (new_option
+ 1, arg
);
3046 option_index
= find_opt (new_option
, lang_mask
);
3047 if (option_index
== OPT_SPECIAL_unknown
)
3050 const char *hint
= op
.suggest_option (new_option
);
3052 error_at (loc
, "%<-W%serror=%s%>: no option %<-%s%>;"
3053 " did you mean %<-%s%>?", value
? "" : "no-",
3054 arg
, new_option
, hint
);
3056 error_at (loc
, "%<-W%serror=%s%>: no option %<-%s%>",
3057 value
? "" : "no-", arg
, new_option
);
3059 else if (!(cl_options
[option_index
].flags
& CL_WARNING
))
3060 error_at (loc
, "%<-Werror=%s%>: %<-%s%> is not an option that "
3061 "controls warnings", arg
, new_option
);
3064 const diagnostic_t kind
= value
? DK_ERROR
: DK_WARNING
;
3065 const char *arg
= NULL
;
3067 if (cl_options
[option_index
].flags
& CL_JOINED
)
3068 arg
= new_option
+ cl_options
[option_index
].opt_len
;
3069 control_warning_option (option_index
, (int) kind
, arg
, value
,
3071 handlers
, opts
, opts_set
, dc
);
3076 /* Return malloced memory for the name of the option OPTION_INDEX
3077 which enabled a diagnostic (context CONTEXT), originally of type
3078 ORIG_DIAG_KIND but possibly converted to DIAG_KIND by options such
3082 option_name (diagnostic_context
*context
, int option_index
,
3083 diagnostic_t orig_diag_kind
, diagnostic_t diag_kind
)
3087 /* A warning classified as an error. */
3088 if ((orig_diag_kind
== DK_WARNING
|| orig_diag_kind
== DK_PEDWARN
)
3089 && diag_kind
== DK_ERROR
)
3090 return concat (cl_options
[OPT_Werror_
].opt_text
,
3091 /* Skip over "-W". */
3092 cl_options
[option_index
].opt_text
+ 2,
3094 /* A warning with option. */
3096 return xstrdup (cl_options
[option_index
].opt_text
);
3098 /* A warning without option classified as an error. */
3099 else if ((orig_diag_kind
== DK_WARNING
|| orig_diag_kind
== DK_PEDWARN
3100 || diag_kind
== DK_WARNING
)
3101 && context
->warning_as_error_requested
)
3102 return xstrdup (cl_options
[OPT_Werror
].opt_text
);
3107 /* Get the page within the documentation for this option. */
3110 get_option_html_page (int option_index
)
3112 const cl_option
*cl_opt
= &cl_options
[option_index
];
3114 /* Analyzer options are on their own page. */
3115 if (strstr(cl_opt
->opt_text
, "analyzer-"))
3116 return "gcc/Static-Analyzer-Options.html";
3119 if ((cl_opt
->flags
& CL_Fortran
) != 0
3120 /* If it is option common to both C/C++ and Fortran, it is documented
3121 in gcc/ rather than gfortran/ docs. */
3122 && (cl_opt
->flags
& CL_C
) == 0
3124 && (cl_opt
->flags
& CL_CXX
) == 0
3127 return "gfortran/Error-and-Warning-Options.html";
3130 return "gcc/Warning-Options.html";
3133 /* Return malloced memory for a URL describing the option OPTION_INDEX
3134 which enabled a diagnostic (context CONTEXT). */
3137 get_option_url (diagnostic_context
*, int option_index
)
3140 return concat (/* DOCUMENTATION_ROOT_URL should be supplied via -D by
3141 the Makefile (see --with-documentation-root-url), and
3142 should have a trailing slash. */
3143 DOCUMENTATION_ROOT_URL
,
3145 /* get_option_html_page will return something like
3146 "gcc/Warning-Options.html". */
3147 get_option_html_page (option_index
),
3149 /* Expect an anchor of the form "index-Wfoo" e.g.
3150 <a name="index-Wformat"></a>, and thus an id within
3151 the URL of "#index-Wformat". */
3152 "#index", cl_options
[option_index
].opt_text
,
3160 namespace selftest
{
3162 /* Verify that get_option_html_page works as expected. */
3165 test_get_option_html_page ()
3167 ASSERT_STREQ (get_option_html_page (OPT_Wcpp
), "gcc/Warning-Options.html");
3168 ASSERT_STREQ (get_option_html_page (OPT_Wanalyzer_double_free
),
3169 "gcc/Static-Analyzer-Options.html");
3171 ASSERT_STREQ (get_option_html_page (OPT_Wline_truncation
),
3172 "gfortran/Error-and-Warning-Options.html");
3176 /* Run all of the selftests within this file. */
3181 test_get_option_html_page ();
3184 } // namespace selftest
3186 #endif /* #if CHECKING_P */