function-abi.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
class	predefined_function_abi
class	function_abi
class	function_abi_aggregator
struct	target_function_abi_info

Macros
#define	this_target_function_abi_info   (&default_target_function_abi_info)
#define	function_abis    (this_target_function_abi_info->x_function_abis)
#define	default_function_abi    (this_target_function_abi_info->x_function_abis[0])
#define	eh_edge_abi   default_function_abi

Functions
HARD_REG_SET	call_clobbers_in_region (unsigned int, const_hard_reg_set, machine_mode mode)
bool	call_clobbered_in_region_p (unsigned int abis, const_hard_reg_set mask, machine_mode mode, unsigned int regno)
const predefined_function_abi &	fntype_abi (const_tree)
function_abi	fndecl_abi (const_tree)
function_abi	insn_callee_abi (const rtx_insn *)
function_abi	expr_callee_abi (const_tree)

Variables
const size_t	NUM_ABI_IDS = 8
target_function_abi_info	default_target_function_abi_info

Macro Definition Documentation

default_function_abi

#define default_function_abi    (this_target_function_abi_info->x_function_abis[0])

Referenced by aggregate_value_p(), expr_callee_abi(), fntype_abi(), init_reg_sets_1(), init_set_costs(), insn_callee_abi(), prepare_function_start(), process_bb_lives(), and read_rtl_function_body().

eh_edge_abi

#define eh_edge_abi   default_function_abi

Referenced by default_dwarf_frame_reg_mode(), df_lr_confluence_n(), df_md_confluence_n(), df_rd_local_compute(), df_scan_start_dump(), process_bb_lives(), and process_bb_node_lives().

function_abis

#define function_abis    (this_target_function_abi_info->x_function_abis)

See the comment above x_function_abis for when these macros should be used.
At present, eh_edge_abi is always the default ABI, but that could change
in future if a target needs it to.   

Referenced by call_clobbers_in_region(), function_abi_aggregator::caller_save_regs(), and globalize_reg().

this_target_function_abi_info

#define this_target_function_abi_info   (&default_target_function_abi_info)

Function Documentation

call_clobbered_in_region_p()

bool call_clobbered_in_region_p ( unsigned int abis, const_hard_reg_set mask, machine_mode mode, unsigned int regno )

inline

Return true if (reg:MODE REGNO) might be clobbered by one of the
calls in a region described by ABIS and MASK, where:

* Bit ID of ABIS is set if the region contains a call with
  function_abi identifier ID.

* MASK contains all the registers that are fully or partially
  clobbered by calls in the region.

This is not quite as accurate as testing each individual call,
but it's a close and conservatively-correct approximation.
It's much better for some targets than:

  overlaps_hard_reg_set_p (MASK, MODE, REGNO).   

References call_clobbers_in_region(), and overlaps_hard_reg_set_p().

Referenced by call_clobbered_in_chain_p(), ira_need_caller_save_p(), and need_for_call_save_p().

call_clobbers_in_region()

HARD_REG_SET call_clobbers_in_region ( unsigned int abis, const_hard_reg_set mask, machine_mode mode )

extern

Return the set of registers that cannot be used to hold a value of
mode MODE across the calls in a region described by ABIS and MASK, where:

* Bit ID of ABIS is set if the region contains a call with
  function_abi identifier ID.

* MASK contains all the registers that are fully or partially
  clobbered by calls in the region.

This is not quite as accurate as testing each individual call,
but it's a close and conservatively-correct approximation.
It's much better for some targets than just using MASK.   

References CLEAR_HARD_REG_SET, and function_abis.

Referenced by call_clobbered_in_region_p(), and ira_need_caller_save_regs().

expr_callee_abi()

function_abi expr_callee_abi ( const_tree exp )

extern

Return the ABI of the function called by CALL_EXPR EXP.  Return the
default ABI for erroneous calls.   

References CALL_EXPR_FN, default_function_abi, error_mark_node, exp(), fndecl_abi(), fntype_abi(), gcc_assert, get_callee_fndecl(), POINTER_TYPE_P, TREE_CODE, and TREE_TYPE.

fndecl_abi()

function_abi fndecl_abi ( const_tree fndecl )

extern

Return the ABI of function decl FNDECL.   

References decl_binds_to_current_def_p(), fntype_abi(), gcc_assert, cgraph_node::rtl_info(), TREE_CODE, and TREE_TYPE.

Referenced by expr_callee_abi(), insn_callee_abi(), prepare_function_start(), and read_rtl_function_body_from_file_range().

fntype_abi()

const predefined_function_abi & fntype_abi ( const_tree type )

extern

Return the predefined ABI used by functions with type TYPE.   

References default_function_abi, FUNC_OR_METHOD_TYPE_P, gcc_assert, and targetm.

Referenced by aggregate_value_p(), expr_callee_abi(), and fndecl_abi().

insn_callee_abi()

function_abi insn_callee_abi ( const rtx_insn * insn )

extern

Return the ABI of the function called by INSN.   

References CALL_P, default_function_abi, fndecl_abi(), gcc_assert, get_call_fndecl(), and targetm.

Referenced by build_def_use(), calculate_gen_cands(), collect_fn_hard_reg_usage(), compute_hash_table_work(), copyprop_hardreg_forward_1(), cselib_process_insn(), dataflow_set_clear_at_call(), df_get_call_refs(), do_remat(), find_all_hard_reg_sets(), find_equiv_reg(), inherit_in_ebb(), invalidate_for_call(), mark_set_resources(), mark_target_live_regs(), old_insns_match_p(), process_bb_lives(), process_bb_node_lives(), record_dead_and_set_regs(), record_opr_changes(), reg_set_p(), reload_as_needed(), reload_combine(), reload_cse_move2add_invalidate(), save_call_clobbered_regs(), set_bb_regs(), setup_save_areas(), simplify_using_initial_values(), and update_equiv_regs_prescan().

Variable Documentation

default_target_function_abi_info

target_function_abi_info default_target_function_abi_info

extern

Information about fuunction binary interfaces.
   Copyright (C) 2019-2025 Free Software Foundation, Inc.

This file is part of GCC

GCC is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 3, or (at your option) any later
version.

GCC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with GCC; see the file COPYING3.  If not see
<http://www.gnu.org/licenses/>.   

NUM_ABI_IDS

const size_t NUM_ABI_IDS = 8

Information about function binary interfaces.
   Copyright (C) 2019-2025 Free Software Foundation, Inc.

This file is part of GCC

GCC is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 3, or (at your option) any later
version.

GCC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with GCC; see the file COPYING3.  If not see
<http://www.gnu.org/licenses/>.   

Most targets use the same ABI for all functions in a translation
unit, but some targets support interoperability between several ABIs.
Each such ABI has a unique 0-based identifier, with 0 always being
the default choice of ABI.

NUM_ABI_IDS is the maximum number of such ABIs that GCC can handle at once.
A bitfield with this number of bits can represent any combinaion of the
supported ABIs.   

Referenced by function_abi_aggregator::caller_save_regs(), globalize_reg(), inherit_in_ebb(), and need_for_call_save_p().