1 /* Target hook definitions for common hooks.
2 Copyright (C
) 2011-2022 Free Software Foundation
, Inc.
4 This program is free software
; you can redistribute it and
/or modify it
5 under the terms of the GNU General Public License as published by the
6 Free Software Foundation
; either version
3, or (at your option
) any
9 This program is distributed in the hope that it will be useful
,
10 but WITHOUT ANY WARRANTY
; without even the implied warranty of
11 MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program
; see the file COPYING3. If not see
16 <http
://www.gnu.org
/licenses
/>.
*/
18 /* See target
-hooks
-macros.h for details of macros that should be
19 provided by the including file
, and how to use them here.
*/
20 #include
"target-hooks-macros.h"
23 #define HOOK_TYPE
"Common Target Hook"
25 HOOK_VECTOR (TARGETM_COMMON_INITIALIZER
, gcc_targetm_common
)
28 #define HOOK_PREFIX
"TARGET_"
30 /* Handle target switch DECODED for options structures OPTS and
31 OPTS_SET
, at location LOC. Return true if the switch was valid.
*/
35 bool
, (struct gcc_options
*opts
, struct gcc_options
*opts_set
,
36 const struct cl_decoded_option
*decoded
,
38 default_target_handle_option
)
42 "Set target-dependent initial values of fields in @var{opts}.",
43 void
, (struct gcc_options
*opts
),
44 hook_void_gcc_optionsp
)
46 /* Set default optimizations for the target.
*/
48 (option_optimization_table
,
50 const struct default_options
*, empty_optimization_table
)
52 /* The initial value of target_flags.
*/
54 (default_target_flags
,
58 /* Determine the type of unwind info to emit for exceptions.
*/
62 enum unwind_info_type
, (struct gcc_options
*opts
),
63 default_except_unwind_info
)
66 (supports_split_stack
,
67 "Whether this target supports splitting the stack when the options\n\
68 described in @var{opts} have been passed. This is called\n\
69 after options have been parsed, so the target may reject splitting\n\
70 the stack in some configurations. The default version of this hook\n\
71 returns false. If @var{report} is true, this function may issue a warning\n\
72 or error; if @var{report} is false, it must simply return a value",
73 bool
, (bool report
, struct gcc_options
*opts
),
74 hook_bool_bool_gcc_optionsp_false
)
77 (get_valid_option_values
,
78 "The hook is used for options that have a non-trivial list of\n\
79 possible option values. OPTION_CODE is option code of opt_code\n\
80 enum type. PREFIX is used for bash completion and allows an implementation\n\
81 to return more specific completion based on the prefix. All string values\n\
82 should be allocated from heap memory and consumers should release them.\n\
83 The result will be pruned to cases with PREFIX if not NULL.",
84 vec
<const char
*>, (int option_code
, const char
*prefix
),
85 default_get_valid_option_values
)
87 /* Leave the boolean fields at the end.
*/
89 /* True if unwinding tables should be generated by default.
*/
91 (unwind_tables_default
,
95 /* True if arbitrary sections are supported.
*/
102 (always_strip_dotdot
,
103 "True if @file{..} components should always be removed from directory names\n\
104 computed relative to GCC's internal directories, false (default) if such\n\
105 components should be preserved and directory names containing them passed\n\
106 to other tools such as the linker.",
109 HOOK_VECTOR_END (C90_EMPTY_HACK
)