node_cmp_attr_Free() updated to use the new free attribute
[libfirm] / ir / ana / irdom.c
1 /*
2  * Project:     libFIRM
3  * File name:   ir/ana/irdom.c
4  * Purpose:     Construct and access dominator tree.
5  * Author:      Goetz Lindenmaier
6  * Modified by:
7  * Created:     2.2002
8  * CVS-ID:      $Id$
9  * Copyright:   (c) 2002-2003 Universität Karlsruhe
10  * Licence:     This file protected by GPL -  GNU GENERAL PUBLIC LICENSE.
11  */
12
13 #ifdef HAVE_CONFIG_H
14 #include "config.h"
15 #endif
16
17 #ifdef HAVE_STRING_H
18 #include <string.h>
19 #endif
20
21 #include "irouts.h"
22
23 #include "xmalloc.h"
24 #include "irgwalk.h"
25 #include "irdom_t.h"
26 #include "irgraph_t.h"   /* To access state field. */
27 #include "irnode_t.h"
28 #include "ircons_t.h"
29
30 #define get_dom_info(bl) (&(bl)->attr.block.dom)
31
32
33 /*--------------------------------------------------------------------*/
34 /** Accessing the dominator data structures                          **/
35 /*--------------------------------------------------------------------*/
36
37 ir_node *get_Block_idom(const ir_node *bl) {
38   assert(is_Block(bl));
39   if (get_Block_dom_depth(bl) == -1) {
40     /* This block is not reachable from Start */
41     return new_Bad();
42   }
43   return get_dom_info(bl)->idom;
44 }
45
46 void set_Block_idom(ir_node *bl, ir_node *n) {
47         dom_info *bli = get_dom_info(bl);
48
49   assert(get_irn_op(bl) == op_Block);
50
51         /* Set the immediate dominator of bl to n */
52         bli->idom = n;
53
54         /*
55          * If we don't set the root of the dominator tree
56          * Append bl to the dominates queue of n.
57          */
58         if(n != NULL) {
59                 dom_info *ni = get_dom_info(n);
60
61                 bli->next = ni->first;
62                 ni->first = bl;
63         }
64 }
65
66 int get_Block_pre_num(const ir_node *bl) {
67   assert(get_irn_op(bl) == op_Block);
68   return bl->attr.block.dom.pre_num;
69 }
70
71 void set_Block_pre_num(ir_node *bl, int num) {
72   assert(get_irn_op(bl) == op_Block);
73   bl->attr.block.dom.pre_num = num;
74 }
75
76 int get_Block_dom_depth(const ir_node *bl) {
77   assert(get_irn_op(bl) == op_Block);
78   return bl->attr.block.dom.dom_depth;
79 }
80
81 void set_Block_dom_depth(ir_node *bl, int depth) {
82   assert(get_irn_op(bl) == op_Block);
83   bl->attr.block.dom.dom_depth = depth;
84 }
85
86 unsigned get_Block_dom_tree_pre_num(const ir_node *bl)
87 {
88         assert(is_Block(bl));
89         return get_dom_info(bl)->tree_pre_num;
90 }
91
92 unsigned get_Block_dom_max_subtree_pre_num(const ir_node *bl)
93 {
94         assert(is_Block(bl));
95         return get_dom_info(bl)->max_subtree_pre_num;
96 }
97
98 int block_dominates(const ir_node *a, const ir_node *b)
99 {
100         const dom_info *ai, *bi;
101
102         assert(is_Block(a) && is_Block(b));
103         ai = get_dom_info(a);
104         bi = get_dom_info(b);
105         return bi->tree_pre_num - ai->tree_pre_num
106                 <= ai->max_subtree_pre_num - ai->tree_pre_num;
107 }
108
109 ir_node *get_Block_dominated_first(const ir_node *bl)
110 {
111         assert(is_Block(bl));
112         return get_dom_info(bl)->first;
113 }
114
115 ir_node *get_Block_dominated_next(const ir_node *bl)
116 {
117         assert(is_Block(bl));
118         return get_dom_info(bl)->next;
119 }
120
121 void dom_tree_walk(ir_node *bl, irg_walk_func *pre,
122                 irg_walk_func *post, void *env)
123 {
124         ir_node *p;
125
126         if(pre)
127                 pre(bl, env);
128
129         dominates_for_each(bl, p) {
130                 dom_tree_walk(p, pre, post, env);
131         }
132
133         if(post)
134                 post(bl, env);
135 }
136
137 void dom_tree_walk_irg(ir_graph *irg, irg_walk_func *pre,
138                 irg_walk_func *post, void *env)
139 {
140         /* The root of the dominator tree should be the start node. */
141         ir_node *root = get_irg_start_block(irg);
142
143   assert(irg->dom_state == dom_consistent
144                         && "The dominators of the irg must be consistent");
145         assert(root && "The start block of the graph is NULL?");
146         assert(get_dom_info(root)->idom == NULL
147                         && "The start node in the graph must be the root of the dominator tree");
148         dom_tree_walk(root, pre, post, env);
149 }
150
151 static void assign_tree_pre_order(ir_node *bl, void *data)
152 {
153         unsigned *num = data;
154         dom_info *bi = get_dom_info(bl);
155         bi->tree_pre_num = (*num)++;
156 }
157
158 static void assign_tree_pre_order_max(ir_node *bl, void *data)
159 {
160         dom_info *bi = get_dom_info(bl);
161         ir_node *p;
162         unsigned max = 0;
163
164         for(p = bi->first; p; p = get_dom_info(p)->next) {
165                 unsigned max_p = get_dom_info(p)->max_subtree_pre_num;
166                 max = max > max_p ? max : max_p;
167         }
168
169         bi->max_subtree_pre_num = max;
170 }
171
172 /*--------------------------------------------------------------------*/
173 /*  Building and Removing the dominator datastructure                 */
174 /*--------------------------------------------------------------------*/
175
176 static void count_and_init_blocks(ir_node *bl, void *env) {
177   int *n_blocks = (int *) env;
178   (*n_blocks) ++;
179
180         memset(get_dom_info(bl), 0, sizeof(dom_info));
181   set_Block_idom(bl, NULL);
182   set_Block_pre_num(bl, -1);
183   set_Block_dom_depth(bl, -1);
184 }
185
186 /* temporary type used while constructing the dominator tree. */
187 typedef struct tmp_dom_info {
188   ir_node *block;               /* backlink */
189
190   struct tmp_dom_info *semi;    /* semidominator */
191   struct tmp_dom_info *parent;
192   struct tmp_dom_info *label;   /* used for LINK and EVAL */
193   struct tmp_dom_info *ancestor;/* used for LINK and EVAL */
194   struct tmp_dom_info *dom;     /* After step 3, if the semidominator of w is
195                                    its immediate dominator, then w->dom is the
196                                    immediate dominator of w.  Otherwise w->dom
197                                    is a vertex v whose number is smaller than
198                                    w and whose immediate dominator is also w's
199                                    immediate dominator. After step 4, w->dom
200                                    is the immediate dominator of w.  */
201   struct tmp_dom_info *bucket;  /* set of vertices with same semidominator */
202 } tmp_dom_info;
203
204 /* Struct to pass info through walker. */
205 typedef struct {
206   tmp_dom_info *d;
207   int used;
208
209 } dom_env;
210
211
212 /* Walks Blocks along the out datastructure.  If recursion started with
213    Start block misses control dead blocks. */
214 static void init_tmp_dom_info(ir_node *bl, tmp_dom_info *parent,
215                               tmp_dom_info *tdi_list, int* used) {
216   tmp_dom_info *tdi;
217   int i;
218
219   assert(get_irn_op(bl) == op_Block);
220   if (get_irg_block_visited(current_ir_graph) == get_Block_block_visited(bl))
221     return;
222   mark_Block_block_visited(bl);
223   set_Block_pre_num(bl, *used);
224
225   tdi = &tdi_list[*used];
226   ++(*used);
227
228   tdi->semi = tdi;
229   tdi->label = tdi;
230   tdi->ancestor = NULL;
231   tdi->bucket = NULL;
232   tdi->parent = parent;
233   tdi->block = bl;
234
235   /* Iterate */
236   for(i = 0; i < get_Block_n_cfg_outs(bl); i++) {
237     ir_node *pred = get_Block_cfg_out(bl, i);
238     assert(get_irn_opcode(pred) == iro_Block);
239     init_tmp_dom_info(pred, tdi, tdi_list, used);
240   }
241 }
242
243 static void
244 dom_compress (tmp_dom_info *v)
245 {
246   assert (v->ancestor);
247   if (v->ancestor->ancestor) {
248     dom_compress (v->ancestor);
249     if (v->ancestor->label->semi < v->label->semi) {
250       v->label = v->ancestor->label;
251     }
252     v->ancestor = v->ancestor->ancestor;
253   }
254 }
255
256 /* if V is a root, return v, else return the vertex u, not being the
257    root, with minimum u->semi on the path from v to its root. */
258 INLINE static tmp_dom_info*
259 dom_eval (tmp_dom_info *v)
260 {
261   if (!v->ancestor) return v;
262   dom_compress (v);
263   return v->label;
264 }
265
266 /* make V W's ancestor */
267 INLINE static void
268 dom_link (tmp_dom_info *v, tmp_dom_info *w)
269 {
270   w->ancestor = v;
271 }
272
273 /* Computes the dominator trees.  Sets a flag in irg to "dom_consistent".
274    If the control flow of the graph is changed this flag must be set to
275    "dom_inconsistent".  */
276 void compute_doms(ir_graph *irg) {
277   ir_graph *rem = current_ir_graph;
278   int n_blocks, used, i, j;
279   tmp_dom_info *tdi_list;   /* Ein Golf? */
280
281   current_ir_graph = irg;
282
283   /* Update graph state */
284   assert(get_irg_phase_state(current_ir_graph) != phase_building);
285   current_ir_graph->dom_state = dom_consistent;
286
287   /* Count the number of blocks in the graph. */
288   n_blocks = 0;
289   irg_block_walk(get_irg_end(current_ir_graph), count_and_init_blocks, NULL, &n_blocks);
290
291   /* Memory for temporary information. */
292   tdi_list = xcalloc(n_blocks, sizeof(tdi_list[0]));
293
294   /* We need the out datastructure. */
295   if (current_ir_graph->outs_state != outs_consistent)
296     compute_outs(current_ir_graph);
297
298   /* this with a standard walker as passing the parent to the sons isn't
299      simple. */
300   used = 0;
301   inc_irg_block_visited(current_ir_graph);
302   init_tmp_dom_info(get_irg_start_block(current_ir_graph), NULL, tdi_list, &used);
303   /* If not all blocks are reachable from Start by out edges this assertion
304      fails.
305      assert(used == n_blocks && "Precondition for dom construction violated"); */
306   n_blocks = used;
307
308
309   for (i = n_blocks-1; i > 0; i--) {  /* Don't iterate the root, it's done. */
310     int irn_arity;
311     tmp_dom_info *w = &tdi_list[i];
312     tmp_dom_info *v;
313
314     /* Step 2 */
315     irn_arity = get_irn_arity(w->block);
316     for (j = 0;  j < irn_arity;  j++) {
317       ir_node *cf_op = get_Block_cfgpred(w->block, j);
318       ir_node *pred  = get_nodes_block(cf_op);
319       tmp_dom_info *u;
320
321       if ((is_Bad(cf_op)) || (is_Bad(pred)) ||
322           (get_Block_pre_num (pred) == -1))
323         continue;       /* control-dead */
324
325       u = dom_eval (&tdi_list[get_Block_pre_num(pred)]);
326       if (u->semi < w->semi) w->semi = u->semi;
327     }
328     /* Add w to w->semi's bucket.  w is in exactly one bucket, so
329        buckets can ben implemented as linked lists. */
330     w->bucket = w->semi->bucket;
331     w->semi->bucket = w;
332
333     dom_link (w->parent, w);
334
335     /* Step 3 */
336     while (w->parent->bucket) {
337       tmp_dom_info *u;
338       v = w->parent->bucket;
339       /* remove v from w->parent->bucket */
340       w->parent->bucket = v->bucket;
341       v->bucket = NULL;
342
343       u = dom_eval (v);
344       if (u->semi < v->semi)
345         v->dom = u;
346       else
347         v->dom = w->parent;
348     }
349   }
350   /* Step 4 */
351   tdi_list[0].dom = NULL;
352   set_Block_idom(tdi_list[0].block, NULL);
353   set_Block_dom_depth(tdi_list[0].block, 1);
354   for (i = 1;  i < n_blocks;  i++) {
355     tmp_dom_info *w = &tdi_list[i];
356
357     if (w->dom != w->semi) w->dom = w->dom->dom;
358     set_Block_idom(w->block, w->dom->block);
359     set_Block_dom_depth(w->block, get_Block_dom_depth(w->dom->block) + 1);
360   }
361
362   /* clean up */
363   /*  free(tdi_list); @@@ does not work !!?? */
364   current_ir_graph = rem;
365
366         /* Do a walk over the tree and assign the tree pre orders. */
367         {
368                 unsigned tree_pre_order = 0;
369                 dom_tree_walk_irg(irg, assign_tree_pre_order,
370                                 assign_tree_pre_order_max, &tree_pre_order);
371         }
372 }
373
374 void free_dom_and_peace(ir_graph *irg) {
375   /* Update graph state */
376   assert(get_irg_phase_state(current_ir_graph) != phase_building);
377   current_ir_graph->dom_state = dom_none;
378
379   /* With the implementation right now there is nothing to free,
380      but better call it anyways... */
381 }