OpenMP: Update documentation of metadirective implementation status.
[gcc.git] / gcc / targhooks.h
blob7d15f632c232e0f8059cb9f1adede120824fcaa2
1 /* Default target hook functions.
2 Copyright (C) 2003-2025 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 #ifndef GCC_TARGHOOKS_H
21 #define GCC_TARGHOOKS_H
23 extern bool default_legitimate_address_p (machine_mode, rtx, bool, code_helper);
25 extern void default_external_libcall (rtx);
26 extern rtx default_legitimize_address (rtx, rtx, machine_mode);
27 extern bool default_legitimize_address_displacement (rtx *, rtx *,
28 poly_int64, machine_mode);
29 extern bool default_const_not_ok_for_debug_p (rtx);
31 extern int default_unspec_may_trap_p (const_rtx, unsigned);
32 extern machine_mode default_promote_function_mode (const_tree, machine_mode,
33 int *, const_tree, int);
34 extern machine_mode default_promote_function_mode_always_promote
35 (const_tree, machine_mode, int *, const_tree, int);
37 extern machine_mode default_cc_modes_compatible (machine_mode,
38 machine_mode);
40 extern bool default_return_in_memory (const_tree, const_tree);
42 extern rtx default_expand_builtin_saveregs (void);
43 extern void default_setup_incoming_varargs (cumulative_args_t,
44 const function_arg_info &,
45 int *, int);
46 extern rtx default_builtin_setjmp_frame_value (void);
47 extern bool default_pretend_outgoing_varargs_named (cumulative_args_t);
49 extern scalar_int_mode default_eh_return_filter_mode (void);
50 extern scalar_int_mode default_libgcc_cmp_return_mode (void);
51 extern scalar_int_mode default_libgcc_shift_count_mode (void);
52 extern scalar_int_mode default_unwind_word_mode (void);
53 extern unsigned HOST_WIDE_INT default_shift_truncation_mask
54 (machine_mode);
55 extern unsigned int default_min_divisions_for_recip_mul (machine_mode);
56 extern bool default_preferred_div_as_shifts_over_mult
57 (const_tree);
58 extern int default_mode_rep_extended (scalar_int_mode, scalar_int_mode);
60 extern tree default_stack_protect_guard (void);
61 extern tree default_external_stack_protect_fail (void);
62 extern tree default_hidden_stack_protect_fail (void);
64 extern machine_mode default_mode_for_suffix (char);
66 extern tree default_cxx_guard_type (void);
67 extern tree default_cxx_get_cookie_size (tree);
68 extern tree default_cxx_adjust_cdtor_callabi_fntype (tree);
70 extern bool hook_pass_by_reference_must_pass_in_stack
71 (cumulative_args_t, const function_arg_info &);
72 extern bool hook_callee_copies_named
73 (cumulative_args_t ca, const function_arg_info &);
75 extern void default_print_operand (FILE *, rtx, int);
76 extern void default_print_operand_address (FILE *, machine_mode, rtx);
77 extern bool default_print_operand_punct_valid_p (unsigned char);
78 extern tree default_mangle_assembler_name (const char *);
80 extern machine_mode default_translate_mode_attribute (machine_mode);
81 extern bool default_scalar_mode_supported_p (scalar_mode);
82 extern bool default_libgcc_floating_mode_supported_p (scalar_float_mode);
83 extern opt_scalar_float_mode default_floatn_mode (int, bool);
84 extern bool default_floatn_builtin_p (int);
85 extern bool targhook_words_big_endian (void);
86 extern bool targhook_float_words_big_endian (void);
87 extern bool default_float_exceptions_rounding_supported_p (void);
88 extern bool default_decimal_float_supported_p (void);
89 extern bool default_fixed_point_supported_p (void);
91 extern bool default_has_ifunc_p (void);
93 extern bool default_predict_doloop_p (class loop *);
94 extern machine_mode default_preferred_doloop_mode (machine_mode);
95 extern const char * default_invalid_within_doloop (const rtx_insn *);
97 extern tree default_builtin_vectorized_function (unsigned int, tree, tree);
98 extern tree default_builtin_md_vectorized_function (tree, tree, tree);
100 extern int default_builtin_vectorization_cost (enum vect_cost_for_stmt, tree, int);
102 extern tree default_builtin_reciprocal (tree);
104 extern void default_emit_support_tinfos (emit_support_tinfos_callback);
106 extern HOST_WIDE_INT default_static_rtx_alignment (machine_mode);
107 extern HOST_WIDE_INT default_constant_alignment (const_tree, HOST_WIDE_INT);
108 extern HOST_WIDE_INT constant_alignment_word_strings (const_tree,
109 HOST_WIDE_INT);
110 extern HOST_WIDE_INT default_vector_alignment (const_tree);
112 extern poly_uint64 default_preferred_vector_alignment (const_tree);
113 extern bool default_builtin_vector_alignment_reachable (const_tree, bool);
114 extern bool
115 default_builtin_support_vector_misalignment (machine_mode mode,
116 const_tree,
117 int, bool);
118 extern machine_mode default_preferred_simd_mode (scalar_mode mode);
119 extern machine_mode default_split_reduction (machine_mode);
120 extern unsigned int default_autovectorize_vector_modes (vector_modes *, bool);
121 extern opt_machine_mode default_vectorize_related_mode (machine_mode,
122 scalar_mode,
123 poly_uint64);
124 extern opt_machine_mode default_get_mask_mode (machine_mode);
125 extern bool default_empty_mask_is_expensive (unsigned);
126 extern bool default_conditional_operation_is_expensive (unsigned);
127 extern vector_costs *default_vectorize_create_costs (vec_info *, bool);
129 /* OpenACC hooks. */
130 extern bool default_goacc_validate_dims (tree, int [], int, unsigned);
131 extern int default_goacc_dim_limit (int);
132 extern bool default_goacc_fork_join (gcall *, const int [], bool);
133 extern void default_goacc_reduction (gcall *);
135 /* These are here, and not in hooks.[ch], because not all users of
136 hooks.h include tm.h, and thus we don't have CUMULATIVE_ARGS. */
138 extern bool hook_bool_CUMULATIVE_ARGS_false (cumulative_args_t);
139 extern bool hook_bool_CUMULATIVE_ARGS_true (cumulative_args_t);
141 extern bool hook_bool_CUMULATIVE_ARGS_arg_info_false
142 (cumulative_args_t, const function_arg_info &);
143 extern bool hook_bool_CUMULATIVE_ARGS_arg_info_true
144 (cumulative_args_t, const function_arg_info &);
145 extern int hook_int_CUMULATIVE_ARGS_arg_info_0
146 (cumulative_args_t, const function_arg_info &);
147 extern void hook_void_CUMULATIVE_ARGS (cumulative_args_t);
148 extern void hook_void_CUMULATIVE_ARGS_tree (cumulative_args_t, tree);
149 extern void hook_void_CUMULATIVE_ARGS_rtx_tree (cumulative_args_t, rtx, tree);
150 extern const char *hook_invalid_arg_for_unprototyped_fn
151 (const_tree, const_tree, const_tree);
152 extern void default_function_arg_advance
153 (cumulative_args_t, const function_arg_info &);
154 extern bool default_push_argument (unsigned int);
155 extern HOST_WIDE_INT default_function_arg_offset (machine_mode, const_tree);
156 extern pad_direction default_function_arg_padding (machine_mode, const_tree);
157 extern rtx default_function_arg (cumulative_args_t, const function_arg_info &);
158 extern rtx default_function_incoming_arg (cumulative_args_t,
159 const function_arg_info &);
160 extern unsigned int default_function_arg_boundary (machine_mode,
161 const_tree);
162 extern unsigned int default_function_arg_round_boundary (machine_mode,
163 const_tree);
164 extern bool hook_bool_const_rtx_commutative_p (const_rtx, int);
165 extern rtx default_function_value (const_tree, const_tree, bool);
166 extern HARD_REG_SET default_zero_call_used_regs (HARD_REG_SET);
167 extern rtx default_libcall_value (machine_mode, const_rtx);
168 extern bool default_function_value_regno_p (const unsigned int);
169 extern rtx default_internal_arg_pointer (void);
170 extern rtx default_static_chain (const_tree, bool);
171 extern void default_trampoline_init (rtx, tree, rtx);
172 extern void default_emit_call_builtin___clear_cache (rtx, rtx);
173 extern poly_int64 default_return_pops_args (tree, tree, poly_int64);
174 extern reg_class_t default_ira_change_pseudo_allocno_class (int, reg_class_t,
175 reg_class_t);
176 extern bool default_lra_p (void);
177 extern int default_register_priority (int);
178 extern bool default_register_usage_leveling_p (void);
179 extern bool default_different_addr_displacement_p (void);
180 extern reg_class_t default_secondary_reload (bool, rtx, reg_class_t,
181 machine_mode,
182 secondary_reload_info *);
183 extern machine_mode default_secondary_memory_needed_mode (machine_mode);
184 extern void default_target_option_override (void);
185 extern void hook_void_bitmap (bitmap);
186 extern int default_reloc_rw_mask (void);
187 extern bool default_generate_pic_addr_diff_vec (void);
188 extern void default_asm_out_constructor (rtx, int);
189 extern void default_asm_out_destructor (rtx, int);
190 extern tree default_mangle_decl_assembler_name (tree, tree);
191 extern tree default_emutls_var_fields (tree, tree *);
192 extern tree default_emutls_var_init (tree, tree, tree);
193 extern unsigned int default_hard_regno_nregs (unsigned int, machine_mode);
194 extern bool default_hard_regno_scratch_ok (unsigned int);
195 extern bool default_mode_dependent_address_p (const_rtx, addr_space_t);
196 extern bool default_new_address_profitable_p (rtx, rtx_insn *, rtx);
197 extern bool default_target_option_valid_attribute_p (tree, tree, tree, int);
198 extern bool default_target_option_valid_version_attribute_p (tree, tree, tree, int);
199 extern bool default_target_option_pragma_parse (tree, tree);
200 extern bool default_target_can_inline_p (tree, tree);
201 extern bool default_update_ipa_fn_target_info (unsigned int &, const gimple *);
202 extern bool default_need_ipa_fn_target_info (const_tree, unsigned int &);
203 extern bool default_valid_pointer_mode (scalar_int_mode);
204 extern bool default_ref_may_alias_errno (class ao_ref *);
205 extern scalar_int_mode default_addr_space_pointer_mode (addr_space_t);
206 extern scalar_int_mode default_addr_space_address_mode (addr_space_t);
207 extern bool default_addr_space_valid_pointer_mode (scalar_int_mode,
208 addr_space_t);
209 extern bool default_addr_space_legitimate_address_p (machine_mode, rtx, bool,
210 addr_space_t, code_helper);
211 extern rtx default_addr_space_legitimize_address (rtx, rtx, machine_mode,
212 addr_space_t);
213 extern bool default_addr_space_subset_p (addr_space_t, addr_space_t);
214 extern bool default_addr_space_zero_address_valid (addr_space_t);
215 extern int default_addr_space_debug (addr_space_t);
216 extern void default_addr_space_diagnose_usage (addr_space_t, location_t);
217 extern rtx default_addr_space_convert (rtx, tree, tree);
218 extern unsigned int default_case_values_threshold (void);
219 extern bool default_have_conditional_execution (void);
220 extern bool default_have_ccmp (void);
222 extern bool default_libc_has_function (enum function_class, tree);
223 extern bool default_libc_has_fast_function (int fcode);
224 extern bool no_c99_libc_has_function (enum function_class, tree);
225 extern bool gnu_libc_has_function (enum function_class, tree);
226 extern bool bsd_libc_has_function (enum function_class, tree);
227 extern unsigned default_fortify_source_default_level (void);
228 extern unsigned default_libm_function_max_error (unsigned, machine_mode, bool);
229 extern unsigned glibc_linux_libm_function_max_error (unsigned, machine_mode,
230 bool);
232 extern tree default_builtin_tm_load_store (tree);
234 extern int default_memory_move_cost (machine_mode, reg_class_t, bool);
235 extern int default_register_move_cost (machine_mode, reg_class_t,
236 reg_class_t);
237 extern bool default_slow_unaligned_access (machine_mode, unsigned int);
238 extern HOST_WIDE_INT default_estimated_poly_value (poly_int64,
239 poly_value_estimate_kind);
241 extern bool default_use_by_pieces_infrastructure_p (unsigned HOST_WIDE_INT,
242 unsigned int,
243 enum by_pieces_operation,
244 bool);
245 extern int default_compare_by_pieces_branch_ratio (machine_mode);
247 extern void default_print_patchable_function_entry (FILE *,
248 unsigned HOST_WIDE_INT,
249 bool);
250 extern bool default_profile_before_prologue (void);
251 extern reg_class_t default_preferred_reload_class (rtx, reg_class_t);
252 extern reg_class_t default_preferred_output_reload_class (rtx, reg_class_t);
253 extern reg_class_t default_preferred_rename_class (reg_class_t rclass);
254 extern bool default_class_likely_spilled_p (reg_class_t);
255 extern unsigned char default_class_max_nregs (reg_class_t, machine_mode);
257 extern bool default_avoid_store_forwarding_p (vec<store_fwd_info>, rtx, int,
258 bool);
260 extern enum unwind_info_type default_debug_unwind_info (void);
262 extern void default_canonicalize_comparison (int *, rtx *, rtx *, bool);
264 extern section * default_function_section(tree decl, enum node_frequency freq,
265 bool startup, bool exit);
266 extern unsigned int default_dwarf_poly_indeterminate_value (unsigned int,
267 unsigned int *,
268 int *);
269 extern machine_mode default_dwarf_frame_reg_mode (int);
270 extern fixed_size_mode default_get_reg_raw_mode (int);
271 extern bool default_keep_leaf_when_profiled ();
273 extern void *default_get_pch_validity (size_t *);
274 extern const char *default_pch_valid_p (const void *, size_t);
276 extern void default_asm_output_ident_directive (const char*);
278 extern scalar_int_mode default_cstore_mode (enum insn_code);
279 extern bool default_member_type_forces_blk (const_tree, machine_mode);
280 extern void default_atomic_assign_expand_fenv (tree *, tree *, tree *);
281 extern tree build_va_arg_indirect_ref (tree);
282 extern tree std_gimplify_va_arg_expr (tree, tree, gimple_seq *, gimple_seq *);
283 extern bool can_use_doloop_if_innermost (const widest_int &,
284 const widest_int &,
285 unsigned int, bool);
287 extern bool default_optab_supported_p (int, machine_mode, machine_mode,
288 optimization_type);
289 extern unsigned int default_max_noce_ifcvt_seq_cost (edge);
290 extern bool default_noce_conversion_profitable_p (rtx_insn *,
291 struct noce_if_info *);
292 extern unsigned int default_min_arithmetic_precision (void);
294 extern enum flt_eval_method
295 default_excess_precision (enum excess_precision_type ATTRIBUTE_UNUSED);
296 extern bool default_bitint_type_info (int, struct bitint_info *);
297 extern machine_mode default_mode_for_floating_type (enum tree_index);
298 extern HOST_WIDE_INT default_stack_clash_protection_alloca_probe_range (void);
299 extern void default_select_early_remat_modes (sbitmap);
300 extern tree default_preferred_else_value (unsigned, tree, unsigned, tree *);
302 extern bool default_have_speculation_safe_value (bool);
303 extern bool speculation_safe_value_not_needed (bool);
304 extern rtx default_speculation_safe_value (machine_mode, rtx, rtx, rtx);
306 extern bool default_memtag_can_tag_addresses ();
307 extern uint8_t default_memtag_tag_size ();
308 extern uint8_t default_memtag_granule_size ();
309 extern rtx default_memtag_insert_random_tag (rtx, rtx);
310 extern rtx default_memtag_add_tag (rtx, poly_int64, uint8_t);
311 extern rtx default_memtag_set_tag (rtx, rtx, rtx);
312 extern rtx default_memtag_extract_tag (rtx, rtx);
313 extern rtx default_memtag_untagged_pointer (rtx, rtx);
315 #endif /* GCC_TARGHOOKS_H */