GCC Middle and Back End API Reference
|
#include "dominance.h"
Go to the source code of this file.
Data Structures | |
struct | control_flow_graph |
class | auto_flag< T > |
class | auto_edge_flag |
class | auto_bb_flag |
Enumerations | |
enum | profile_status_d { PROFILE_ABSENT , PROFILE_GUESSED , PROFILE_READ , PROFILE_LAST } |
Control flow graph manipulation code header file. Copyright (C) 2014-2024 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/>.
What sort of profiling information we have.
Enumerator | |
---|---|
PROFILE_ABSENT | |
PROFILE_GUESSED | |
PROFILE_READ | |
PROFILE_LAST |
|
extern |
Initialize the block_aux_obstack and if SIZE is nonzero, call alloc_aux_for_block for each basic block.
References alloc_aux_for_block(), block_aux_obstack, cfun, first_block_aux_obj, FOR_ALL_BB_FN, gcc_assert, gcc_obstack_init, ggc_alloc(), and initialized.
Referenced by compute_branch_probabilities(), estimate_bb_frequencies(), init_pre(), init_worklist(), one_code_hoisting_pass(), sanopt_optimize(), and vt_initialize().
Allocate a memory edge of SIZE as E->aux. The obstack must be first initialized by alloc_aux_for_edges.
References edge_aux_obstack, first_edge_aux_obj, gcc_assert, and ggc_alloc().
Referenced by alloc_aux_for_edges().
|
extern |
Initialize the edge_aux_obstack and if SIZE is nonzero, call alloc_aux_for_edge for each basic edge.
References alloc_aux_for_edge(), cfun, edge_aux_obstack, ENTRY_BLOCK_PTR_FOR_FN, EXIT_BLOCK_PTR_FOR_FN, first_edge_aux_obj, FOR_BB_BETWEEN, FOR_EACH_EDGE, gcc_assert, gcc_obstack_init, ggc_alloc(), initialized, and basic_block_def::succs.
Referenced by branch_prob(), and estimate_bb_frequencies().
|
extern |
Allocate memory for basic_block.
References basic_block_def::count, ggc_alloc(), and profile_count::uninitialized().
Referenced by create_basic_block_structure(), create_bb(), init_flow(), make_new_block(), and function_reader::parse_block().
|
extern |
Dumps a brief description of cfg to FILE.
References cfun, dump_bb_info(), FOR_EACH_BB_FN, and TDF_DETAILS.
Referenced by gimple_dump_cfg().
|
extern |
Create an edge connecting SRC and DST with FLAGS optionally using edge cache CACHE. Return the new edge, NULL if already exist.
References bitmap_bit_p, bitmap_set_bit, cfun, ENTRY_BLOCK_PTR_FOR_FN, EXIT_BLOCK_PTR_FOR_FN, find_edge(), ggc_alloc(), basic_block_def::index, make_edge(), NULL, and unchecked_make_edge().
Referenced by make_edges(), and make_label_edge().
Clear AUX pointers of all blocks.
References basic_block_def::aux, cfun, FOR_ALL_BB_FN, and NULL.
Referenced by compute_antinout_edge(), compute_available(), find_comparisons(), find_spanning_tree(), free_aux_for_blocks(), get_non_trapping(), gimple_lower_bitint(), if_convert(), reorder_loops(), tree_ssa_split_loops(), and tree_ssa_unswitch_loops().
Clear AUX pointers of all edges.
References cfun, ENTRY_BLOCK_PTR_FOR_FN, EXIT_BLOCK_PTR_FOR_FN, FOR_BB_BETWEEN, FOR_EACH_EDGE, NULL, and basic_block_def::succs.
Referenced by compute_antinout_edge(), compute_available(), compute_laterin(), compute_nearerout(), and free_aux_for_edges().
Clear all basic block flags that do not have to be preserved.
References BB_FLAGS_TO_PRESERVE, cfun, current_loops, basic_block_def::flags, FOR_ALL_BB_FN, ggc_alloc(), LOOPS_HAVE_MARKED_IRREDUCIBLE_REGIONS, and loops_state_satisfies_p().
Referenced by combine_instructions(), ira(), oacc_loop_discovery(), and try_optimize_cfg().
Sequentially order blocks and compact the arrays.
References cfun, df, df_compact_blocks(), ENTRY_BLOCK, ENTRY_BLOCK_PTR_FOR_FN, EXIT_BLOCK, EXIT_BLOCK_PTR_FOR_FN, FOR_EACH_BB_FN, gcc_assert, i, basic_block_def::index, last_basic_block_for_fn, n_basic_blocks_for_fn, NULL, NUM_FIXED_BLOCKS, and SET_BASIC_BLOCK_FOR_FN.
Referenced by cgraph_node::analyze(), branch_prob(), cleanup_cfg(), cleanup_tree_cfg_noloop(), and relink_block_chain().
References edge_def::dest, dump_edge_info(), ggc_alloc(), basic_block_def::index, edge_def::src, and TDF_DETAILS.
References debug, and ggc_alloc().
|
extern |
References debug_bb(), and dump_flags.
Referenced by debug_bb(), debug_bb_n(), debug_bb_n(), and debug_bb_slim().
|
extern |
Print BB with specified FLAGS.
References dump_bb(), and ggc_alloc().
|
extern |
References BASIC_BLOCK_FOR_FN, cfun, and debug_bb().
|
extern |
Print basic block numbered N with specified FLAGS.
References BASIC_BLOCK_FOR_FN, cfun, and debug_bb().
|
extern |
Dumps cfg related information about basic block BB to OUTF. If HEADER is true, dump things that appear before the instructions contained in BB. If FOOTER is true, dump things that appear after. Flags are the TDF_* masks as documented in dumpfile.h. NB: With TDF_DETAILS, it is assumed that cfun is available, so that maybe_hot_bb_p and probably_never_executed_bb_p don't ICE.
References alloca, BB_ALL_FLAGS, bb_loop_depth(), cfun, check_bb_profile(), basic_block_def::count, current_function_decl, DECL_STRUCT_FUNCTION, profile_count::dump(), dump_edge_info(), basic_block_def::flags, FOR_EACH_EDGE, fputc(), gcc_assert, ggc_alloc(), i, basic_block_def::index, profile_count::initialized_p(), maybe_hot_bb_p(), basic_block_def::next_bb, NULL, basic_block_def::preds, basic_block_def::prev_bb, probably_never_executed_bb_p(), basic_block_def::succs, and TDF_DETAILS.
Referenced by brief_dump_cfg(), dump_bb(), and print_rtl_with_bb().
|
extern |
References BUILTINS_LOCATION, cfun, EDGE_ALL_FLAGS, ENTRY_BLOCK, EXIT_BLOCK, fputc(), gcc_assert, ggc_alloc(), i, LOCATION_COLUMN, LOCATION_FILE, LOCATION_LINE, LOCATION_LOCUS, NULL, TDF_DETAILS, and TDF_SLIM.
Referenced by debug(), dump_basic_block_info(), dump_bb_info(), and verify_flow_info().
|
extern |
Remove block B from the basic block array.
References b, cfun, n_basic_blocks_for_fn, NULL, SET_BASIC_BLOCK_FOR_FN, and unlink_block().
Referenced by delete_basic_block(), and merge_blocks().
Free data allocated in block_aux_obstack and clear AUX pointers of all blocks.
References block_aux_obstack, clear_aux_for_blocks(), first_block_aux_obj, gcc_assert, ggc_alloc(), and NULL.
Referenced by compute_branch_probabilities(), delete_worklist(), estimate_bb_frequencies(), fini_pre(), one_code_hoisting_pass(), sanopt_optimize(), and vt_finalize().
Free data allocated in edge_aux_obstack and clear AUX pointers of all edges.
References clear_aux_for_edges(), edge_aux_obstack, first_edge_aux_obj, gcc_assert, ggc_alloc(), and NULL.
Referenced by branch_prob(), and estimate_bb_frequencies().
Free the memory associated with the CFG in FN.
References basic_block_info_for_fn, function::cfg, ENTRY_BLOCK_PTR_FOR_FN, FOR_EACH_EDGE, free_block(), free_edge(), gcc_assert, ggc_free(), n_edges_for_fn, basic_block_def::next_bb, NULL, vec_free(), control_flow_graph::x_dom_computed, and control_flow_graph::x_label_to_block_map.
Referenced by release_function_body().
Free the data structures to maintain mapping between blocks and its copies.
References bb_copy, bb_original, loop_copy, and NULL.
Referenced by copy_loop_before(), do_split_loop_on_cond(), back_jt_path_registry::duplicate_thread_path(), gen_parallel_loop(), gimple_duplicate_seme_region(), gimple_duplicate_sese_tail(), gimple_ssa_isolate_erroneous_paths(), ipa_tm_execute(), relink_block_chain(), split_loop(), split_paths(), tail_duplicate(), tree_loop_unroll_and_jam(), tree_predictive_commoning(), tree_ssa_prefetch_arrays(), tree_unswitch_single_loop(), try_peel_loop(), try_unroll_loop_completely(), fwd_jt_path_registry::update_cfg(), vect_do_peeling(), vect_loop_versioning(), version_loop_by_alias_check(), and version_loop_for_if_conversion().
|
extern |
Get the copy of basic block.
References BASIC_BLOCK_FOR_FN, bb_copy, cfun, gcc_assert, hash_map< KeyId, Value, Traits >::get(), basic_block_def::index, NULL, and original_copy_tables_initialized_p().
Referenced by apply_opt_in_copies(), copy_bbs(), do_split_loop_on_cond(), back_jt_path_registry::duplicate_thread_path(), fix_loop_bb_probability(), gimple_duplicate_seme_region(), gimple_duplicate_sese_tail(), loop_version(), back_jt_path_registry::rewire_first_differing_edge(), slpeel_tree_duplicate_loop_to_edge_cfg(), split_loop(), unroll_loop_constant_iterations(), and unroll_loop_runtime_iterations().
|
extern |
Get the original basic block.
References BASIC_BLOCK_FOR_FN, bb_original, cfun, gcc_assert, hash_map< KeyId, Value, Traits >::get(), basic_block_def::index, NULL, and original_copy_tables_initialized_p().
Referenced by add_phi_args_after_copy_edge(), apply_opt_in_copies(), back_jt_path_registry::duplicate_thread_path(), gimple_duplicate_seme_region(), gimple_duplicate_sese_tail(), relink_block_chain(), tree_unswitch_single_loop(), and vect_do_peeling().
Get the copy of LOOP.
References cfun, gcc_assert, hash_map< KeyId, Value, Traits >::get(), get_loop(), loop_copy, NULL, loop::num, and original_copy_tables_initialized_p().
Referenced by duplicate_block(), slpeel_tree_duplicate_loop_to_edge_cfg(), vect_do_peeling(), and vect_loop_versioning().
Control flow graph manipulation code for GNU compiler. Copyright (C) 1987-2024 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/>.
This file contains low level functions to manipulate the CFG and analyze it. All other modules should not transform the data structure directly and use abstraction instead. The file is supposed to be ordered bottom-up and should not contain any code dependent on a particular intermediate language (RTL or trees). Available functionality: - Initialization/deallocation init_flow, free_cfg - Low level basic block manipulation alloc_block, expunge_block - Edge manipulation make_edge, make_single_succ_edge, cached_make_edge, remove_edge - Low level edge redirection (without updating instruction chain) redirect_edge_succ, redirect_edge_succ_nodup, redirect_edge_pred - Dumping and debugging dump_flow_info, debug_flow_info, dump_edge_info - Allocation of AUX fields for basic blocks alloc_aux_for_blocks, free_aux_for_blocks, alloc_aux_for_block - clear_bb_flags - Consistency checking verify_flow_info - Dumping and debugging print_rtl_with_bb, dump_bb, debug_bb, debug_bb_n TODO: Document these "Available functionality" functions in the files that implement them.
Called once at initialization time.
References alloc_block(), BB_ALL_FLAGS, EDGE_ALL_FLAGS, ENTRY_BLOCK, ENTRY_BLOCK_PTR_FOR_FN, EXIT_BLOCK, EXIT_BLOCK_PTR_FOR_FN, ggc_alloc(), n_edges_for_fn, and profile_count::uninitialized().
Referenced by init_empty_tree_cfg_for_function().
Initialize the data structures to maintain mapping between blocks and its copies.
References bb_copy, bb_original, and loop_copy.
Referenced by cfg_layout_initialize(), copy_loop_before(), do_split_loop_on_cond(), back_jt_path_registry::duplicate_thread_path(), gen_parallel_loop(), gimple_duplicate_seme_region(), gimple_duplicate_sese_tail(), gimple_ssa_isolate_erroneous_paths(), ipa_tm_execute(), relink_block_chain(), split_loop(), split_paths(), tail_duplicate(), tree_loop_unroll_and_jam(), tree_predictive_commoning(), tree_ssa_prefetch_arrays(), tree_unswitch_single_loop(), try_peel_loop(), try_unroll_loop_completely(), fwd_jt_path_registry::update_cfg(), vect_do_peeling(), vect_loop_versioning(), version_loop_by_alias_check(), and version_loop_for_if_conversion().
|
extern |
Link block B to chain after AFTER.
References b, ggc_alloc(), and basic_block_def::next_bb.
Referenced by create_basic_block_structure(), create_bb(), gimple_find_sub_bbs(), gimple_move_block_after(), merge_blocks_move_predecessor_nojumps(), and function_reader::parse_block().
|
extern |
Create an edge connecting SRC and DEST with flags FLAGS. Return newly created edge or NULL if already exist.
References find_edge(), NULL, and unchecked_make_edge().
Referenced by add_test(), branch_fixup(), branch_prob(), cached_make_edge(), cfg_layout_split_edge(), rt_bb_visited::check(), combine_blocks(), connect_infinite_loops_to_exit(), connect_loops(), convert_if_conditions_to_switch(), copy_cfg_body(), copy_edges_for_bb(), create_cond_insert_point(), create_empty_if_region_on_edge(), create_empty_loop_on_edge(), create_parallel_loop(), tree_switch_conversion::switch_decision_tree::do_jump_if_equal(), do_split_loop_on_cond(), back_jt_path_registry::duplicate_thread_path(), edge_before_returns_twice_call(), tree_switch_conversion::jump_table_cluster::emit(), tree_switch_conversion::bit_test_cluster::emit(), tree_switch_conversion::switch_decision_tree::emit_cmp_and_jump_insns(), execute_sm_if_changed(), expand_complex_div_wide(), expand_gimple_tailcall(), expand_oacc_for(), expand_omp_atomic_pipeline(), expand_omp_for_generic(), expand_omp_for_init_counts(), expand_omp_for_init_vars(), expand_omp_for_ordered_loops(), expand_omp_for_static_chunk(), expand_omp_for_static_nochunk(), expand_omp_ordered_sink(), expand_omp_sections(), expand_omp_simd(), expand_omp_target(), expand_omp_taskloop_for_inner(), expand_omp_taskloop_for_outer(), expand_omp_taskreg(), expand_parallel_call(), expand_thunk(), expand_transaction(), extract_omp_for_update_vars(), find_bb_boundaries(), force_nonfallthru_and_redirect(), tree_switch_conversion::switch_conversion::gen_inbound_check(), gimple_divmod_fixed_value(), gimple_duplicate_sese_tail(), gimple_flow_call_edges_add(), gimple_gen_ic_func_profiler(), gimple_gen_time_profiler(), gimple_ic(), gimple_lower_bitint(), gimple_mod_pow2(), gimple_mod_subtract(), gimple_stringop_fixed_value(), handle_abnormal_edges(), tree_switch_conversion::bit_test_cluster::hoist_edge_and_branch_if_true(), hoist_guard(), init_lowered_empty_function(), input_cfg(), insert_check_and_trap(), insert_cond_bb(), rt_bb_visited::insert_exit_check_on_edge(), lv_adjust_loop_entry_edge(), make_cond_expr_edges(), make_edges(), make_edges(), make_edges_bb(), make_eh_dispatch_edges(), make_eh_edge(), make_gimple_asm_edges(), make_gimple_switch_edges(), make_goto_expr_edges(), make_single_succ_edge(), move_sese_in_condition(), move_sese_region_to_fn(), oacc_entry_exit_single_gang(), omp_make_gimple_edges(), optimize_mask_stores(), peep2_attempt(), rtl_flow_call_edges_add(), shrink_wrap_one_built_in_call_with_conds(), simd_clone_adjust(), slpeel_add_loop_guard(), split_bb_make_tm_edge(), tree_transform_and_unroll_loop(), ubsan_expand_null_ifn(), ubsan_expand_ptr_ifn(), unloop_loops(), unroll_loop_runtime_iterations(), vect_loop_versioning(), worker_single_copy(), and worker_single_simple().
|
extern |
Create an edge connecting SRC to DEST and set probability by knowing that it is the single edge leaving SRC.
References profile_probability::always(), and make_edge().
Referenced by add_noreturn_fake_exit_edges(), combine_blocks(), construct_exit_block(), construct_init_block(), copy_edges_for_bb(), create_cond_insert_point(), create_edge_and_update_destination_phis(), create_eh_forwarder_block(), create_parallel_loop(), dw2_build_landing_pads(), execute_sm_if_changed(), expand_complex_div_wide(), expand_gimple_cond(), expand_thunk(), fix_crossing_conditional_branches(), force_nonfallthru_and_redirect(), gimple_split_edge(), handle_simple_exit(), insert_cond_bb(), lower_resx(), move_sese_region_to_fn(), optimize_mask_stores(), rtl_split_edge(), simd_clone_adjust(), sjlj_emit_dispatch_table(), split_block_1(), split_function(), try_shrink_wrapping(), ubsan_expand_null_ifn(), and ubsan_expand_ptr_ifn().
Return true iff we have had a call to initialize_original_copy_tables without a corresponding call to free_original_copy_tables.
Referenced by copy_original_table_clear(), copy_original_table_set(), get_bb_copy(), get_bb_original(), get_loop_copy(), and relink_block_chain().
|
extern |
Redirect an edge's predecessor from one block to another.
References connect_src(), disconnect_src(), and ggc_alloc().
Referenced by destroy_loop(), expand_transaction(), force_nonfallthru_and_redirect(), tree_switch_conversion::bit_test_cluster::hoist_edge_and_branch_if_true(), slpeel_tree_duplicate_loop_to_edge_cfg(), and unsplit_eh().
|
extern |
Redirect an edge's successor from one block to another.
References connect_dest(), disconnect_dest(), execute_on_growing_pred(), execute_on_shrinking_pred(), and ggc_alloc().
Referenced by cfg_layout_redirect_edge_and_branch(), cleanup_empty_eh_merge_phis(), construct_exit_block(), construct_init_block(), dead_or_predicable(), dw2_fix_up_crossing_landing_pad(), tree_switch_conversion::switch_decision_tree::emit_case_nodes(), tree_switch_conversion::switch_decision_tree::emit_jump(), execute_sm_if_changed(), expand_complex_div_wide(), expand_gimple_cond(), expand_omp_simd(), find_if_case_1(), finish_eh_generation(), fix_crossing_conditional_branches(), gimple_find_sub_bbs(), handle_simple_exit(), redirect_edge_succ_nodup(), rtl_split_edge(), simd_clone_adjust(), sjlj_fix_up_crossing_landing_pad(), try_optimize_cfg(), try_redirect_by_replacing_jump(), and tree_switch_conversion::switch_decision_tree::try_switch_expansion().
This function will remove an edge from the flow graph.
References cfun, disconnect_dest(), disconnect_src(), execute_on_shrinking_pred(), free_edge(), and remove_predictions_associated_with_edge().
Referenced by remove_edge().
Reset the data structures to maintain mapping between blocks and its copies.
References bb_copy, bb_original, hash_map< KeyId, Value, Traits >::empty(), and loop_copy.
Referenced by vect_do_peeling().
|
extern |
Multiply all frequencies of basic blocks in array BBS of length NBBS by NUM/DEN, in profile_count arithmetic. More accurate than previous function but considerably slower.
References count, ggc_alloc(), and i.
Referenced by duplicate_loop_body_to_header_edge(), hoist_guard(), scale_loop_frequencies(), and vect_do_peeling().
|
extern |
Multiply all frequencies of basic blocks in array BBS of length NBBS by NUM/DEN, in profile_count arithmetic. More accurate than previous function but considerably slower.
References count, ggc_alloc(), i, and profile_count::zero().
Referenced by duplicate_loop_body_to_header_edge(), back_jt_path_registry::duplicate_thread_path(), and gimple_duplicate_sese_tail().
void scale_strictly_dominated_blocks | ( | basic_block | bb, |
profile_count | num, | ||
profile_count | den ) |
Scales the frequencies of all basic blocks that are strictly dominated by BB by NUM/DEN.
References profile_count::apply_scale(), CDI_DOMINATORS, basic_block_def::count, first_dom_son(), ggc_alloc(), next_dom_son(), loop::num, worklist, and profile_count::zero().
Referenced by fold_loop_internal_call().
|
extern |
Set copy for basic block. Do nothing when data structures are not initialized so passes not needing this don't need to care.
References bb_copy, copy_original_table_set(), and basic_block_def::index.
Referenced by duplicate_block().
|
extern |
Set original for basic block. Do nothing when data structures are not initialized so passes not needing this don't need to care.
References bb_original, copy_original_table_set(), ggc_alloc(), and basic_block_def::index.
Referenced by duplicate_block().
|
extern |
Set probability of E to NEW_PROB and rescale other edges from E->src so their sum remains the same.
References profile_probability::always(), dump_file, dump_flags, FOR_EACH_EDGE, ggc_alloc(), profile_probability::never(), NULL, and TDF_DETAILS.
Referenced by force_edge_cold(), scale_profile_for_vect_loop(), tree_transform_and_unroll_loop(), update_bb_profile_for_threading(), update_loop_exit_probability_scale_dom_bbs(), and update_profile_after_ch().
Set copy for LOOP to COPY. Do nothing when data structures are not initialized so passes not needing this don't need to care.
References copy_original_table_clear(), copy_original_table_set(), loop_copy, and loop::num.
Referenced by duplicate_loop(), duplicate_loop_body_to_header_edge(), back_jt_path_registry::duplicate_thread_path(), gimple_duplicate_seme_region(), gimple_duplicate_sese_tail(), loop_version(), fwd_jt_path_registry::thread_block_1(), and fwd_jt_path_registry::thread_through_loop_header().
|
extern |
Create an edge connecting SRC and DEST with flags FLAGS. Return newly created edge. Use this only if you are sure that this edge can't possibly already exist.
References cfun, connect_dest(), connect_src(), execute_on_growing_pred(), basic_block_def::flags, ggc_alloc(), n_edges_for_fn, and profile_probability::uninitialized().
Referenced by cached_make_edge(), function_reader::create_edges(), duplicate_block(), force_nonfallthru_and_redirect(), and make_edge().
|
extern |
Unlink block B from chain.
Referenced by expunge_block(), gimple_find_sub_bbs(), gimple_move_block_after(), and merge_blocks_move_predecessor_nojumps().
|
extern |
An edge originally destinating BB of COUNT has been proved to leave the block by TAKEN_EDGE. Update profile of BB such that edge E can be redirected to destination of TAKEN_EDGE. This function may leave the profile inconsistent in the case TAKEN_EDGE frequency or count is believed to be lower than COUNT respectively.
References profile_count::apply_scale(), basic_block_def::count, count, profile_probability::dump(), dump_file, gcc_assert, ggc_alloc(), profile_count::guessed(), basic_block_def::index, profile_count::initialized_p(), profile_probability::invert(), profile_count::nonzero_p(), set_edge_probability_and_rescale_others(), and profile_count::zero().
Referenced by back_jt_path_registry::duplicate_thread_path(), try_forward_edges(), and update_profile_after_ch().