GCC Middle and Back End API Reference
|
Variables | |
static struct cfg_hooks * | cfg_hooks |
void account_profile_record | ( | ) |
Work-horse for passes.c:check_profile_consistency. Do book-keeping of the CFG for the profile consistency checker. If AFTER_PASS is 0, do pre-pass accounting, or if AFTER_PASS is 1 then do post-pass accounting. Store the counting in RECORD.
bool block_ends_with_call_p | ( | ) |
Return 1 if BB ends with a call, possibly followed by some instructions that must stay with the call, 0 otherwise.
References cfg_hooks::flush_pending_stmts.
Referenced by find_traces_1_round().
bool block_ends_with_condjump_p | ( | ) |
Return 1 if BB ends with a conditional branch, 0 otherwise.
References cfg_hooks::cfg_hook_duplicate_loop_to_header_edge.
bool can_copy_bbs_p | ( | ) |
Checks whether all N blocks in BBS array can be copied.
In case we should redirect abnormal edge during duplication, fail.
References loop::header, loop::latch, and basic_block_def::loop_father.
Referenced by copy_loop_info().
bool can_duplicate_block_p | ( | ) |
Returns true if we can duplicate basic block BB.
References basic_block_def::count, basic_block_def::frequency, and redirect_edge_and_branch_force().
Referenced by dup_block_and_redirect(), lv_flush_pending_stmts(), and reorder_basic_blocks().
bool can_merge_blocks_p | ( | ) |
Checks whether we may merge blocks BB1 and BB2.
Referenced by cond_exec_find_if_block().
bool can_remove_branch_p | ( | ) |
Returns true if it is possible to remove the edge E by redirecting it to the destination of the other edge going from its source.
References edge_def::dest, edge_def::flags, redirect_edge_and_branch(), edge_def::src, and basic_block_def::succs.
bool cfg_hook_duplicate_loop_to_header_edge | ( | struct loop * | loop, |
edge | e, | ||
unsigned int | ndupl, | ||
sbitmap | wont_exit, | ||
edge | orig, | ||
vec< edge > * | to_remove, | ||
int | flags | ||
) |
Loop versioning uses the duplicate_loop_to_header_edge to create a new version of the loop basic-blocks, the parameters here are exactly the same as in duplicate_loop_to_header_edge or tree_duplicate_loop_to_header_edge; while in tree-ssa there is additional work to maintain ssa information that's why there is a need to call the tree_duplicate_loop_to_header_edge rather than duplicate_loop_to_header_edge when we are in tree mode.
void cfg_layout_rtl_register_cfg_hooks | ( | void | ) |
Initialization of functions specific to the rtl IR.
References gimple_cfg_hooks.
void copy_bbs | ( | basic_block * | bbs, |
unsigned | n, | ||
basic_block * | new_bbs, | ||
edge * | edges, | ||
unsigned | num_edges, | ||
edge * | new_edges, | ||
struct loop * | base, | ||
basic_block | after, | ||
bool | update_dominance | ||
) |
Duplicates N basic blocks stored in array BBS. Newly created basic blocks are placed into array NEW_BBS in the same order. Edges from basic blocks in BBS are also duplicated and copies of those that lead into BBS are redirected to appropriate newly created block. The function assigns bbs into loops (copy of basic block bb is assigned to bb->loop_father->copy loop, so this must be set up correctly in advance) If UPDATE_DOMINANCE is true then this function updates dominators locally (LOOPS structure that contains the information about dominators is passed to enable this), otherwise it does not update the dominator information and it assumed that the caller will do this, perhaps by destroying and recreating it instead of trying to do an incremental update like this function does when update_dominance is true. BASE is the superloop to that basic block belongs; if its header or latch is copied, we do not set the new blocks as header or latch. Created copies of N_EDGES edges in array EDGES are stored in array NEW_EDGES, also in the same order. Newly created basic blocks are put after the basic block AFTER in the instruction stream, and the order of the blocks in BBS array is preserved.
Duplicate bbs, update dominators, assign bbs to loops.
Duplicate.
Possibly set loop header.
Or latch.
Set dominators.
Redirect edges.
Clear information about duplicates.
Referenced by tm_memopt_clear_visited().
basic_block create_basic_block | ( | ) |
Creates a new basic block just after the basic block AFTER. HEAD and END are the first and the last statement belonging to the block. If both are NULL, an empty block is created.
Referenced by rtl_force_nonfallthru(), rtl_redirect_edge_and_branch_force(), and split_function().
basic_block create_empty_bb | ( | ) |
Creates an empty basic block just after basic block AFTER.
Referenced by expand_transaction(), factor_computed_gotos(), gimple_make_forwarder_block(), gimple_redirect_edge_and_branch(), and stmt_starts_bb_p().
enum ir_type current_ir_type | ( | void | ) |
Returns current ir type.
Referenced by cond_exec_find_if_block(), gimplify_build3(), and remove_branch().
DEBUG_FUNCTION void debug | ( | ) |
DEBUG_FUNCTION void debug_flow_info | ( | void | ) |
Like above, but dump to stderr. To be called from debuggers.
void delete_basic_block | ( | ) |
Deletes the basic block BB.
If we remove the header or the latch of a loop, mark the loop for removal by setting its header and latch to NULL.
Remove the edges into and out of this block. Note that there may indeed be edges in, if we are removing an unreachable loop.
Remove the basic block from the array.
Referenced by build_arrays(), and cond_exec_find_if_block().
void dump_bb | ( | ) |
Print out one basic block BB to file OUTF. INDENT is printed at the start of each new line. FLAGS are the TDF_* flags in dumpfile.h. This function takes care of the purely graph related information. The cfg hook for the active representation should dump representation-specific information.
Referenced by debug_regions(), and dump_bb_for_graph().
void dump_bb_for_graph | ( | ) |
Dumps basic block BB to pretty-printer PP, for use as a label of a DOT graph record-node. The implementation of this hook is expected to write the label to the stream that is attached to PP. Field separators between instructions are pipe characters printed verbatim. Instructions should be written with some characters escaped, using pp_write_text_as_dot_label_to_stream().
References dump_bb().
void dump_flow_info | ( | ) |
Dump the complete CFG to FILE. FLAGS are the TDF_* flags in dumpfile.h.
References dump_flow_info().
basic_block duplicate_block | ( | ) |
Duplicates basic block BB and redirects edge E to it. Returns the new basic block. The new basic block is placed after the basic block AFTER.
Since we are creating edges from a new block to successors of another block (which therefore are known to be disjoint), there is no need to actually check for duplicated edges.
Take care for overflows!
Add the new block to the copy of the loop of BB, or directly to the loop of BB if the loop is not being copied.
If we copied the loop header block but not the loop we have created a loop with multiple entries. Ditch the loop, add the new block to the outer loop and arrange for a fixup.
If we copied the loop latch block but not the loop, adjust loop state.
Referenced by lv_add_condition_to_bb().
bool empty_block_p | ( | ) |
Return true if BB contains only labels or non-executable instructions
void execute_on_growing_pred | ( | ) |
This function is called immediately after edge E is added to the edge vector E->dest->preds.
Referenced by disconnect_dest().
void execute_on_shrinking_pred | ( | ) |
This function is called immediately before edge E is removed from the edge vector E->dest->preds.
Referenced by make_single_succ_edge().
void extract_cond_bb_edges | ( | ) |
Conditional jumps are represented differently in trees and RTL, this hook takes a basic block that is known to have a cond jump at its end and extracts the taken and not taken edges out of it and store it in E1 and E2 respectively.
int flow_call_edges_add | ( | ) |
Add fake edges to the function exit for any non constant and non noreturn calls, volatile inline assembly in the bitmap of blocks specified by BLOCKS or to the whole CFG if BLOCKS is zero. Return the number of blocks that were split. The goal is to expose cases in which entering a basic block does not imply that all subsequent instructions must be executed.
References cfg_hooks::extract_cond_bb_edges.
Referenced by output_location().
basic_block force_nonfallthru | ( | ) |
Edge E is assumed to be fallthru edge. Emit needed jump instruction (and possibly create new basic block) to make edge non-fallthru. Return newly created BB or NULL if none.
|
read |
void gimple_register_cfg_hooks | ( | void | ) |
Initialization of functions specific to the tree IR.
References cfg_hooks.
Referenced by cgraph_process_new_functions().
void lv_add_condition_to_bb | ( | basic_block | first, |
basic_block | second, | ||
basic_block | new_block, | ||
void * | cond | ||
) |
Conditions in trees and RTL are different so we need a different handling when we add the condition to the versioning code.
References duplicate_block().
void lv_adjust_loop_header_phi | ( | basic_block | first, |
basic_block | second, | ||
basic_block | new_block, | ||
edge | e | ||
) |
Responsible for updating the ssa info (PHI nodes) on the new condition basic block that guards the versioned loop.
void lv_flush_pending_stmts | ( | ) |
This is used inside loop versioning when we want to insert stmts/insns on the edges, which have a different behavior in tree's and in RTL, so we made a CFG hook.
References can_duplicate_block_p(), edge_def::dest, edge_def::flags, and basic_block_def::flags.
edge make_forwarder_block | ( | basic_block | bb, |
bool(*)(edge) | redirect_edge_p, | ||
void(*)(basic_block) | new_bb_cbk | ||
) |
Split BB into entry part and the rest (the rest is the newly created block). Redirect those edges for that REDIRECT_EDGE_P returns true to the entry part. Returns the edge connecting the entry part to the rest.
Redirect back edges we want to keep.
If we redirected the loop latch edge, the JUMP block now acts like the new latch of the loop.
If we do not split a loop header, then both blocks belong to the same loop. In case we split loop header and do not redirect the latch edge to DUMMY, then DUMMY belongs to the outer loop, and BB becomes the new header. If latch is not recorded for the loop, we leave this updating on the caller (this may only happen during loop analysis).
In case we split loop latch, update it.
void merge_blocks | ( | ) |
Merges basic block B into basic block A.
If the block we merge into is a loop header do nothing unless ...
... we merge two loop headers, in which case we kill the inner loop.
If we merge a loop header into its predecessor, update the loop structure.
Normally there should only be one successor of A and that is B, but partway though the merge of blocks for conditional_execution we'll be merging a TEST block with THEN and ELSE successors. Free the whole lot of them and hope the caller knows what they're doing.
Adjust the edges out of B for the new owner.
If b was a latch, a now is.
B hasn't quite yet ceased to exist. Attempt to prevent mishap.
Referenced by cond_exec_find_if_block(), merge_blocks_move_predecessor_nojumps(), merge_blocks_move_successor_nojumps(), noce_find_if_block(), split_bbs_on_noreturn_calls(), and trivially_empty_bb_p().
bool move_block_after | ( | ) |
Moves block BB immediately after block AFTER. Returns false if the movement was impossible.
References loop::header, loop::latch, LOOPS_NEED_FIXUP, and loops_state_set().
void predict_edge | ( | ) |
References loop::header, loop::latch, basic_block_def::loop_father, LOOPS_NEED_FIXUP, and loops_state_set().
bool predicted_by_p | ( | ) |
References add_bb_to_loop(), loop::header, basic_block_def::loop_father, and remove_bb_from_loops().
edge redirect_edge_and_branch | ( | ) |
Redirect edge E to the given basic block DEST and update underlying program representation. Returns edge representing redirected branch (that may not be equivalent to E in the case of duplicate edges being removed) or NULL if edge is not easily redirectable for whatever reason.
If RET != E, then either the redirection failed, or the edge E was removed since RET already lead to the same destination.
Referenced by can_remove_branch_p(), find_clusters_1(), remove_conditions_and_labels(), split_function(), and stmt_starts_bb_p().
basic_block redirect_edge_and_branch_force | ( | ) |
Redirect the edge E to basic block DEST even if it requires creating of a new basic block; then it returns the newly created basic block. Aborts when redirection is impossible.
Referenced by can_duplicate_block_p().
edge redirect_edge_succ_nodup | ( | ) |
Like redirect_edge_succ but avoid possible duplicate edge.
FIXME: This should be called via a hook and only for IR_GIMPLE.
References add_bb_to_loop(), CDI_DOMINATORS, dom_info_available_p(), find_common_loop(), internal_error(), cfg_hooks::name, cfg_hooks::redirect_edge_and_branch_force, rescan_loop_exit(), set_immediate_dominator(), single_pred(), single_succ(), and edge_def::src.
void remove_branch | ( | ) |
Removes E, by redirecting it to the destination of the other edge going from its source. Can_remove_branch_p must be true for E, hence this operation cannot fail.
References current_ir_type(), IR_GIMPLE, redirect_edge_var_map_clear(), remove_edge_raw(), and rescan_loop_exit().
void remove_edge | ( | ) |
Removes edge E from cfg. Unlike remove_branch, it does not update IL.
This is probably not needed, but it doesn't hurt.
FIXME: This should be called via a remove_edge hook.
Referenced by build_arrays(), cond_exec_find_if_block(), find_edge(), gimple_expand_cfg(), move_stmt_r(), print_succ_bbs(), and remove_ctrl_stmt_and_useless_edges().
void rtl_register_cfg_hooks | ( | void | ) |
Initialization of functions specific to the rtl IR.
void set_cfg_hooks | ( | ) |
References gimple_cfg_hooks, IR_GIMPLE, IR_RTL_CFGRTL, and rtl_cfg_hooks.
edge split_block | ( | ) |
Splits basic block BB after the specified instruction I (but at least after the labels). If I is NULL, splits just after labels. The newly created edge is returned. The new basic block is created just after the old one.
Referenced by create_phi_for_local_result(), create_pre_exit(), and try_crossjump_to_edge().
edge split_block_after_labels | ( | ) |
Splits block BB just after labels. The newly created edge is returned.
Referenced by create_loop_fn(), create_single_entry_edge(), ipa_tm_diagnose_tm_safe(), and same_close_phi_node().
basic_block split_block_before_cond_jump | ( | ) |
Split a basic block if it ends with a conditional branch and if the other part of the block is not empty.
basic_block split_edge | ( | ) |
Splits edge E and returns the newly created basic block.
There are two cases: If the immediate dominator of e->dest is not e->src, it remains unchanged. If immediate dominator of e->dest is e->src, it may become ret, provided that all other predecessors of e->dest are dominated by e->dest.
If we split the latch edge of loop adjust the latch block.
References CDI_DOMINATORS, dominated_by_p(), get_immediate_dominator(), set_immediate_dominator(), single_pred(), single_succ(), single_succ_edge(), and edge_def::src.
Referenced by create_empty_if_region_on_edge(), create_if_region_on_edge(), create_loads_and_stores_for_name(), create_pre_exit(), create_preheader(), graphite_create_new_loop_guard(), rewrite_trees(), translate_clast_for_loop(), update_dominators_in_loop(), vect_create_cond_for_alias_checks(), and verify_loop_closed_ssa().
void tidy_fallthru_edge | ( | ) |
Try to make the edge fallthru.
References cfg_hooks::force_nonfallthru, internal_error(), cfg_hooks::name, and edge_def::src.
void tidy_fallthru_edges | ( | void | ) |
Fix up edges that now fall through, or rather should now fall through but previously required a jump around now deleted blocks. Simplify the search by only examining blocks numerically adjacent, since this is how they were created. ??? This routine is currently RTL specific.
We care about simple conditional or unconditional jumps with a single successor. If we had a conditional branch to the next instruction when CFG was built, then there will only be one out edge for the block which ended with the conditional branch (since we do not create duplicate edges). Furthermore, the edge will be marked as a fallthru because we merge the flags for the duplicate edges. So we do not want to check that the edge is not a FALLTHRU edge.
References add_bb_to_loop(), CDI_DOMINATORS, dom_info_available_p(), find_common_loop(), rescan_loop_exit(), set_immediate_dominator(), single_pred(), and single_succ().
DEBUG_FUNCTION void verify_flow_info | ( | void | ) |
Verify the CFG consistency. Currently it does following: checks edge and basic block list correctness and calls into IL dependent checking then.
Check bb chain & numbers.
Now check the basic blocks (boundaries etc.)
Complete edge checksumming for ENTRY and EXIT.
Clean up.
Referenced by cleanup_tree_cfg_1().
@verbatim
Hooks for cfg representation specific functions. Copyright (C) 2003-2013 Free Software Foundation, Inc. Contributed by Sebastian Pop s.pop @lap oste. net
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/.
A pointer to one of the hooks containers.
Referenced by gimple_register_cfg_hooks().