| /* Generic dominator tree walker |
| Copyright (C) 2003-2013 Free Software Foundation, Inc. |
| Contributed by Diego Novillo <dnovillo@redhat.com> |
| |
| 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/>. */ |
| |
| #include "config.h" |
| #include "system.h" |
| #include "coretypes.h" |
| #include "tm.h" |
| #include "basic-block.h" |
| #include "domwalk.h" |
| #include "sbitmap.h" |
| |
| /* This file implements a generic walker for dominator trees. |
| |
| To understand the dominator walker one must first have a grasp of dominators, |
| immediate dominators and the dominator tree. |
| |
| Dominators |
| A block B1 is said to dominate B2 if every path from the entry to B2 must |
| pass through B1. Given the dominance relationship, we can proceed to |
| compute immediate dominators. Note it is not important whether or not |
| our definition allows a block to dominate itself. |
| |
| Immediate Dominators: |
| Every block in the CFG has no more than one immediate dominator. The |
| immediate dominator of block BB must dominate BB and must not dominate |
| any other dominator of BB and must not be BB itself. |
| |
| Dominator tree: |
| If we then construct a tree where each node is a basic block and there |
| is an edge from each block's immediate dominator to the block itself, then |
| we have a dominator tree. |
| |
| |
| [ Note this walker can also walk the post-dominator tree, which is |
| defined in a similar manner. i.e., block B1 is said to post-dominate |
| block B2 if all paths from B2 to the exit block must pass through |
| B1. ] |
| |
| For example, given the CFG |
| |
| 1 |
| | |
| 2 |
| / \ |
| 3 4 |
| / \ |
| +---------->5 6 |
| | / \ / |
| | +--->8 7 |
| | | / | |
| | +--9 11 |
| | / | |
| +--- 10 ---> 12 |
| |
| |
| We have a dominator tree which looks like |
| |
| 1 |
| | |
| 2 |
| / \ |
| / \ |
| 3 4 |
| / / \ \ |
| | | | | |
| 5 6 7 12 |
| | | |
| 8 11 |
| | |
| 9 |
| | |
| 10 |
| |
| |
| |
| The dominator tree is the basis for a number of analysis, transformation |
| and optimization algorithms that operate on a semi-global basis. |
| |
| The dominator walker is a generic routine which visits blocks in the CFG |
| via a depth first search of the dominator tree. In the example above |
| the dominator walker might visit blocks in the following order |
| 1, 2, 3, 4, 5, 8, 9, 10, 6, 7, 11, 12. |
| |
| The dominator walker has a number of callbacks to perform actions |
| during the walk of the dominator tree. There are two callbacks |
| which walk statements, one before visiting the dominator children, |
| one after visiting the dominator children. There is a callback |
| before and after each statement walk callback. In addition, the |
| dominator walker manages allocation/deallocation of data structures |
| which are local to each block visited. |
| |
| The dominator walker is meant to provide a generic means to build a pass |
| which can analyze or transform/optimize a function based on walking |
| the dominator tree. One simply fills in the dominator walker data |
| structure with the appropriate callbacks and calls the walker. |
| |
| We currently use the dominator walker to prune the set of variables |
| which might need PHI nodes (which can greatly improve compile-time |
| performance in some cases). |
| |
| We also use the dominator walker to rewrite the function into SSA form |
| which reduces code duplication since the rewriting phase is inherently |
| a walk of the dominator tree. |
| |
| And (of course), we use the dominator walker to drive our dominator |
| optimizer, which is a semi-global optimizer. |
| |
| TODO: |
| |
| Walking statements is based on the block statement iterator abstraction, |
| which is currently an abstraction over walking tree statements. Thus |
| the dominator walker is currently only useful for trees. */ |
| |
| /* Recursively walk the dominator tree. |
| |
| WALK_DATA contains a set of callbacks to perform pass-specific |
| actions during the dominator walk as well as a stack of block local |
| data maintained during the dominator walk. |
| |
| BB is the basic block we are currently visiting. */ |
| |
| void |
| walk_dominator_tree (struct dom_walk_data *walk_data, basic_block bb) |
| { |
| void *bd = NULL; |
| basic_block dest; |
| basic_block *worklist = XNEWVEC (basic_block, n_basic_blocks * 2); |
| int sp = 0; |
| sbitmap visited = sbitmap_alloc (last_basic_block + 1); |
| bitmap_clear (visited); |
| bitmap_set_bit (visited, ENTRY_BLOCK_PTR->index); |
| |
| while (true) |
| { |
| /* Don't worry about unreachable blocks. */ |
| if (EDGE_COUNT (bb->preds) > 0 |
| || bb == ENTRY_BLOCK_PTR |
| || bb == EXIT_BLOCK_PTR) |
| { |
| /* Callback to initialize the local data structure. */ |
| if (walk_data->initialize_block_local_data) |
| { |
| bool recycled; |
| |
| /* First get some local data, reusing any local data |
| pointer we may have saved. */ |
| if (walk_data->free_block_data.length () > 0) |
| { |
| bd = walk_data->free_block_data.pop (); |
| recycled = 1; |
| } |
| else |
| { |
| bd = xcalloc (1, walk_data->block_local_data_size); |
| recycled = 0; |
| } |
| |
| /* Push the local data into the local data stack. */ |
| walk_data->block_data_stack.safe_push (bd); |
| |
| /* Call the initializer. */ |
| walk_data->initialize_block_local_data (walk_data, bb, |
| recycled); |
| |
| } |
| |
| /* Callback for operations to execute before we have walked the |
| dominator children, but before we walk statements. */ |
| if (walk_data->before_dom_children) |
| (*walk_data->before_dom_children) (walk_data, bb); |
| |
| bitmap_set_bit (visited, bb->index); |
| |
| /* Mark the current BB to be popped out of the recursion stack |
| once children are processed. */ |
| worklist[sp++] = bb; |
| worklist[sp++] = NULL; |
| |
| for (dest = first_dom_son (walk_data->dom_direction, bb); |
| dest; dest = next_dom_son (walk_data->dom_direction, dest)) |
| worklist[sp++] = dest; |
| } |
| /* NULL is used to mark pop operations in the recursion stack. */ |
| while (sp > 0 && !worklist[sp - 1]) |
| { |
| --sp; |
| bb = worklist[--sp]; |
| |
| /* Callback for operations to execute after we have walked the |
| dominator children, but before we walk statements. */ |
| if (walk_data->after_dom_children) |
| (*walk_data->after_dom_children) (walk_data, bb); |
| |
| if (walk_data->initialize_block_local_data) |
| { |
| /* And finally pop the record off the block local data stack. */ |
| bd = walk_data->block_data_stack.pop (); |
| /* And save the block data so that we can re-use it. */ |
| walk_data->free_block_data.safe_push (bd); |
| } |
| } |
| if (sp) |
| { |
| int spp; |
| spp = sp - 1; |
| if (walk_data->dom_direction == CDI_DOMINATORS) |
| /* Find the dominator son that has all its predecessors |
| visited and continue with that. */ |
| while (1) |
| { |
| edge_iterator ei; |
| edge e; |
| bool found = true; |
| bb = worklist[spp]; |
| FOR_EACH_EDGE (e, ei, bb->preds) |
| { |
| if (!dominated_by_p (CDI_DOMINATORS, e->src, e->dest) |
| && !bitmap_bit_p (visited, e->src->index)) |
| { |
| found = false; |
| break; |
| } |
| } |
| if (found) |
| break; |
| /* If we didn't find a dom child with all visited |
| predecessors just use the candidate we were checking. |
| This happens for candidates in irreducible loops. */ |
| if (!worklist[spp - 1]) |
| break; |
| --spp; |
| } |
| bb = worklist[spp]; |
| worklist[spp] = worklist[--sp]; |
| } |
| else |
| break; |
| } |
| free (worklist); |
| sbitmap_free (visited); |
| } |
| |
| void |
| init_walk_dominator_tree (struct dom_walk_data *walk_data) |
| { |
| walk_data->free_block_data.create (0); |
| walk_data->block_data_stack.create (0); |
| } |
| |
| void |
| fini_walk_dominator_tree (struct dom_walk_data *walk_data) |
| { |
| if (walk_data->initialize_block_local_data) |
| { |
| while (walk_data->free_block_data.length () > 0) |
| free (walk_data->free_block_data.pop ()); |
| } |
| |
| walk_data->free_block_data.release (); |
| walk_data->block_data_stack.release (); |
| } |