2 * Copyright (C) 1995-2008 University of Karlsruhe. All right reserved.
4 * This file is part of libFirm.
6 * This file may be distributed and/or modified under the terms of the
7 * GNU General Public License version 2 as published by the Free Software
8 * Foundation and appearing in the file LICENSE.GPL included in the
9 * packaging of this file.
11 * Licensees holding valid libFirm Professional Edition licenses may use
12 * this file in accordance with the libFirm Commercial License.
13 * Agreement provided with the Software.
15 * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
16 * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * @brief Compute and access out edges (also called def-use edges).
23 * @author Goetz Lindenmaier, Michael Beck
38 #include "irgraph_t.h"
46 /* Note: ir_node.out_valid and ir_graph.n_outs are only present when DEBUG_libfirm is defined */
47 /* Accesses to out_valid and n_outs are fenced out to avoid breakage
48 when compiling with neither DEBUG_libfirm or NDEBUG defined */
49 #endif /* defined DEBUG_libfirm */
51 /*--------------------------------------------------------------------*/
52 /** Accessing the out datastructures **/
53 /*--------------------------------------------------------------------*/
56 /** Clear the outs of a node */
57 static void reset_outs(ir_node *node, void *unused) {
64 int get_irn_outs_computed(const ir_node *node)
66 return node->out != NULL;
69 /* returns the number of successors of the node: */
70 int get_irn_n_outs(ir_node *node) {
71 assert(node && node->kind == k_ir_node);
73 /* assert(node->out_valid); */
74 #endif /* defined DEBUG_libfirm */
75 /* we misuse the first for the size info of the out array */
76 return node->out[0].pos;
79 /* Access successor n */
80 ir_node *get_irn_out(ir_node *def, int pos) {
81 assert(pos >= 0 && pos < get_irn_n_outs(def));
83 /* assert(def->out_valid); */
84 #endif /* defined DEBUG_libfirm */
85 return def->out[pos+1].use;
88 /* Access successor n */
89 ir_node *get_irn_out_ex(ir_node *def, int pos, int *in_pos) {
90 assert(pos >= 0 && pos < get_irn_n_outs(def));
92 /* assert(def->out_valid); */
93 #endif /* defined DEBUG_libfirm */
94 *in_pos = def->out[pos+1].pos;
95 return def->out[pos+1].use;
98 void set_irn_out(ir_node *def, int pos, ir_node *use, int in_pos) {
100 assert(pos >= 0 && pos < get_irn_n_outs(def));
102 def->out_valid = 1; /* assume that this function is used correctly */
103 #endif /* defined DEBUG_libfirm */
104 def->out[pos+1].use = use;
105 def->out[pos+1].pos = in_pos;
108 /* Return the number of control flow successors, ignore keep-alives. */
109 int get_Block_n_cfg_outs(ir_node *bl) {
110 int i, n_cfg_outs = 0;
111 assert(bl && is_Block(bl));
113 assert(bl->out_valid);
114 #endif /* defined DEBUG_libfirm */
115 for (i = 1; i <= bl->out[0].pos; ++i) {
116 ir_node *succ = bl->out[i].use;
117 if (get_irn_mode(succ) == mode_X && !is_End(succ))
118 n_cfg_outs += succ->out[0].pos;
123 /* Return the number of control flow successors, honor keep-alives. */
124 int get_Block_n_cfg_outs_ka(ir_node *bl) {
125 int i, n_cfg_outs = 0;
126 assert(bl && is_Block(bl));
128 assert(bl->out_valid);
129 #endif /* defined DEBUG_libfirm */
130 for (i = 1; i <= bl->out[0].pos; ++i) {
131 ir_node *succ = bl->out[i].use;
132 if (get_irn_mode(succ) == mode_X) {
135 /* ignore End if we are in the Endblock */
136 if (get_nodes_block(succ) == bl)
138 else /* count Keep-alive as one */
141 n_cfg_outs += succ->out[0].pos;
147 /* Access predecessor n, ignore keep-alives. */
148 ir_node *get_Block_cfg_out(ir_node *bl, int pos) {
150 assert(bl && is_Block(bl));
152 assert(bl->out_valid);
153 #endif /* defined DEBUG_libfirm */
154 for (i = 1; i <= bl->out[0].pos; ++i) {
155 ir_node *succ = bl->out[i].use;
156 if (get_irn_mode(succ) == mode_X && !is_End(succ)) {
157 int n_outs = succ->out[0].pos;
159 return succ->out[pos + 1].use;
167 /* Access predecessor n, honor keep-alives. */
168 ir_node *get_Block_cfg_out_ka(ir_node *bl, int pos) {
170 assert(bl && is_Block(bl));
172 assert (bl->out_valid);
173 #endif /* defined DEBUG_libfirm */
174 for (i = 1; i <= bl->out[0].pos; ++i) {
175 ir_node *succ = bl->out[i].use;
176 if (get_irn_mode(succ) == mode_X) {
178 ir_node *end_bl = get_nodes_block(succ);
180 /* ignore End if we are in the Endblock */
184 /* handle keep-alive here: return the Endblock instead of the End node */
189 n_outs = succ->out[0].pos;
191 return succ->out[pos + 1].use;
200 static void irg_out_walk_2(ir_node *node, irg_walk_func *pre,
201 irg_walk_func *post, void *env) {
206 assert(get_irn_visited(node) < get_irg_visited(current_ir_graph));
208 set_irn_visited(node, get_irg_visited(current_ir_graph));
210 if (pre) pre(node, env);
212 for (i = 0, n = get_irn_n_outs(node); i < n; ++i) {
213 succ = get_irn_out(node, i);
214 if (get_irn_visited(succ) < get_irg_visited(current_ir_graph))
215 irg_out_walk_2(succ, pre, post, env);
218 if (post) post(node, env);
221 void irg_out_walk(ir_node *node,
222 irg_walk_func *pre, irg_walk_func *post,
225 if (get_irg_outs_state(current_ir_graph) != outs_none) {
226 inc_irg_visited (current_ir_graph);
227 irg_out_walk_2(node, pre, post, env);
231 static void irg_out_block_walk2(ir_node *bl,
232 irg_walk_func *pre, irg_walk_func *post,
236 if (!Block_block_visited(bl)) {
237 mark_Block_block_visited(bl);
242 for (i = 0, n = get_Block_n_cfg_outs(bl); i < n; ++i) {
243 /* find the corresponding predecessor block. */
244 ir_node *pred = get_Block_cfg_out(bl, i);
246 irg_out_block_walk2(pred, pre, post, env);
254 /* Walks only over Block nodes in the graph. Has it's own visited
255 flag, so that it can be interleaved with the other walker. */
256 void irg_out_block_walk(ir_node *node,
257 irg_walk_func *pre, irg_walk_func *post,
260 assert(is_Block(node) || (get_irn_mode(node) == mode_X));
262 inc_irg_block_visited(current_ir_graph);
264 if (get_irn_mode(node) == mode_X) {
267 for (i = 0, n = get_irn_n_outs(node); i < n; ++i) {
268 ir_node *succ = get_irn_out(node, i);
269 if (get_irn_visited(succ) < get_irg_visited(current_ir_graph))
270 irg_out_walk_2(succ, pre, post, env);
274 irg_out_block_walk2(node, pre, post, env);
278 /*--------------------------------------------------------------------*/
279 /** Building and Removing the out datastructure **/
281 /** The outs of a graph are allocated in a single, large array. **/
282 /** This allows to allocate and deallocate the memory for the outs **/
283 /** on demand. The large array is separated into many small ones **/
284 /** for each node. Only a single field to reference the out array **/
285 /** is stored in each node and a field referencing the large out **/
286 /** array in irgraph. The 0 field of each out array contains the **/
287 /** size of this array. This saves memory in the irnodes themselves.**/
288 /** The construction does two passes over the graph. The first pass **/
289 /** counts the overall number of outs and the outs of each node. It **/
290 /** stores the outs of each node in the out reference of the node. **/
291 /** Then the large array is allocated. The second iteration chops **/
292 /** the large array into smaller parts, sets the out edges and **/
293 /** recounts the out edges. **/
294 /** Removes Tuple nodes! **/
295 /*--------------------------------------------------------------------*/
298 /** Returns the amount of out edges for not yet visited successors. */
299 static int _count_outs(ir_node *n) {
300 int start, i, res, irn_arity;
303 n->out = INT_TO_PTR(1); /* Space for array size. */
305 start = is_Block(n) ? 0 : -1;
306 irn_arity = get_irn_arity(n);
307 res = irn_arity - start + 1; /* --1 or --0; 1 for array size. */
309 for (i = start; i < irn_arity; ++i) {
310 /* Optimize Tuples. They annoy if walking the cfg. */
311 ir_node *pred = get_irn_n(n, i);
312 ir_node *skipped_pred = skip_Tuple(pred);
314 if (skipped_pred != pred) {
315 set_irn_n(n, i, skipped_pred);
318 /* count Def-Use edges for predecessors */
319 if (irn_not_visited(skipped_pred))
320 res += _count_outs(skipped_pred);
322 /*count my Def-Use edges */
323 skipped_pred->out = INT_TO_PTR(PTR_TO_INT(skipped_pred->out) + 1);
329 /** Returns the amount of out edges for not yet visited successors.
330 * This version handles some special nodes like irg_frame, irg_args etc.
332 static int count_outs(ir_graph *irg) {
336 inc_irg_visited(irg);
337 res = _count_outs(get_irg_end(irg));
339 /* Now handle anchored nodes. We need the out count of those
340 even if they are not visible. */
341 for (i = anchor_last - 1; i >= 0; --i) {
342 n = get_irg_anchor(irg, i);
343 if (irn_not_visited(n)) {
346 n->out = INT_TO_PTR(1);
354 * Enter memory for the outs to a node.
356 * @param use current node
357 * @param free current free address in the chunk allocated for the outs
359 * @return The next free address
361 static ir_def_use_edge *_set_out_edges(ir_node *use, ir_def_use_edge *free) {
362 int n_outs, start, i, irn_arity, pos;
364 mark_irn_visited(use);
366 /* Allocate my array */
367 n_outs = PTR_TO_INT(use->out);
371 #endif /* defined DEBUG_libfirm */
373 /* We count the successors again, the space will be sufficient.
374 We use this counter to remember the position for the next back
378 start = is_Block(use) ? 0 : -1;
379 irn_arity = get_irn_arity(use);
381 for (i = start; i < irn_arity; ++i) {
382 ir_node *def = get_irn_n(use, i);
385 if (irn_not_visited(def))
386 free = _set_out_edges(def, free);
388 /* Remember this Def-Use edge */
389 pos = def->out[0].pos + 1;
390 def->out[pos].use = use;
391 def->out[pos].pos = i;
393 /* increase the number of Def-Use edges so far */
394 def->out[0].pos = pos;
400 * Enter memory for the outs to a node. Handles special nodes
402 * @param irg the graph
403 * @param free current free address in the chunk allocated for the outs
405 * @return The next free address
407 static ir_def_use_edge *set_out_edges(ir_graph *irg, ir_def_use_edge *free) {
411 inc_irg_visited(irg);
412 free = _set_out_edges(get_irg_end(irg), free);
414 /* handle anchored nodes */
415 for (i = anchor_last - 1; i >= 0; --i) {
416 n = get_irg_anchor(irg, i);
417 if (irn_not_visited(n)) {
420 n_outs = PTR_TO_INT(n->out);
424 #endif /* defined DEBUG_libfirm */
434 * We want that the out of ProjX from Start contains the next block at
435 * position 0, the Start block at position 1. This is necessary for
436 * the out block walker.
438 static INLINE void fix_start_proj(ir_graph *irg) {
439 ir_node *startbl = get_irg_start_block(irg);
441 if (get_Block_n_cfg_outs(startbl)) {
442 ir_node *proj = get_irg_initial_exec(irg);
444 int block_pos, other_pos;
446 if (get_irn_n_outs(proj) == 2) {
447 if (get_irn_out_ex(proj, 0, &block_pos) == startbl) {
448 irn = get_irn_out_ex(proj, 1, &other_pos);
449 set_irn_out(proj, 0, irn, other_pos);
450 set_irn_out(proj, 1, startbl, block_pos);
453 assert(get_irg_phase_state(irg) == phase_backend);
458 /* compute the outs for a given graph */
459 void compute_irg_outs(ir_graph *irg) {
460 ir_graph *rem = current_ir_graph;
462 ir_def_use_edge *end = NULL; /* Only for debugging */
464 current_ir_graph = irg;
466 /* Update graph state */
467 assert(get_irg_phase_state(current_ir_graph) != phase_building);
469 if (current_ir_graph->outs_state != outs_none)
470 free_irg_outs(current_ir_graph);
472 /* This first iteration counts the overall number of out edges and the
473 number of out edges for each node. */
474 n_out_edges = count_outs(irg);
476 /* allocate memory for all out edges. */
477 irg->outs = xcalloc(n_out_edges, sizeof(irg->outs[0]));
479 irg->n_outs = n_out_edges;
480 #endif /* defined DEBUG_libfirm */
482 /* The second iteration splits the irg->outs array into smaller arrays
483 for each node and writes the back edges into this array. */
484 end = set_out_edges(irg, irg->outs);
486 /* Check how much memory we have used */
487 assert (end == (irg->outs + n_out_edges));
489 /* We want that the out of ProjX from Start contains the next block at
490 position 0, the Start block at position 1. This is necessary for
491 code placement (place_early() ONLY if started GCSE on graphs with dead blocks) */
494 current_ir_graph->outs_state = outs_consistent;
495 current_ir_graph = rem;
498 void assure_irg_outs(ir_graph *irg) {
499 if (get_irg_outs_state(irg) != outs_consistent)
500 compute_irg_outs(irg);
503 void compute_irp_outs(void) {
505 for (i = get_irp_n_irgs() -1; i >= 0; --i)
506 compute_irg_outs(get_irp_irg(i));
509 void free_irp_outs(void) {
511 for (i = get_irp_n_irgs() -1; i >= 0; --i)
512 free_irg_outs(get_irp_irg(i));
516 /*------------------------------------------------------------*
517 * This computes the outedges for in interprocedural graph. *
518 * There is one quirk: *
519 * The number of the outedges for each node is saved in *
520 * the first member of the ir_node** array. Maybe we should *
521 * change this to make it more portable... *
522 *------------------------------------------------------------*/
525 #ifdef INTERPROCEDURAL_VIEW
527 * Inits the number of outedges for each node
530 static void init_count(ir_node * node, void *env) {
532 node->out = (ir_node **) 1; /* 1 for the array size */
537 * Adjusts the out edge count for its predecessors
538 * and adds the current arity to the overall count,
539 * which is saved in "env"
541 static void node_arity_count(ir_node * node, void * env) {
542 int *anz = (int *) env, arity, n_outs, i, start;
545 arity = get_irn_arity(node);
546 start = (is_Block(node)) ? 0 : -1;
548 n_outs = 1 + arity + (-start); // ((is_Block(node)) ? 0 : 1); // Why + 1??
551 for(i = start; i < arity; i++) {
552 succ = get_irn_n(node, i);
553 succ->out = (ir_node **)INT_TO_PTR(PTR_TO_INT(succ->out) + 1);
558 * Inits all nodes for setting the outedges
559 * Returns the overall count of edges
561 int count_ip_outs(void) {
564 cg_walk(init_count, node_arity_count, &res);
569 static int dummy_count = 0, global_count; /* Only for debugging */
572 * For each node: Sets the pointer to array
573 * in which the outedges are written later.
574 * The current array start is transported in env
576 static void set_array_pointer(ir_node *node, void *env) {
578 ir_node ***free = (ir_node ***) env;
580 /* Allocate my array */
581 n_outs = PTR_TO_INT(node->out); /* We wrote the count here in count_ip_outs */
582 dummy_count += n_outs;
583 assert(dummy_count <= global_count && "More outedges than initially counted!");
585 *free = &((*free)[n_outs]);
586 /* We count the successors again, the space will be sufficient.
587 We use this counter to remember the position for the next back
589 node -> out[0] = (ir_node *) 0;
594 * Adds an outedge from the predecessor to the
597 static void set_out_pointer(ir_node * node, void *env) {
598 int i, arity = get_irn_arity(node);
600 int start = (!is_Block(node)) ? -1 : 0;
603 for (i = start; i < arity; ++i) {
604 succ = get_irn_n(node, i);
605 succ->out[get_irn_n_outs(succ)+1] = node;
606 succ->out[0] = INT_TO_PTR(get_irn_n_outs(succ) + 1);
612 * Sets the outedges for all nodes.
614 void set_ip_outs(void) {
615 ir_node **outedge_array = get_irp_ip_outedges();
616 cg_walk(set_array_pointer, set_out_pointer, (void *) &outedge_array);
622 * Counts the outedges, allocates memory to save the
623 * outedges and fills this outedge array in interprocedural
626 void compute_ip_outs(void) {
630 assert(get_irp_ip_view_state() == ip_view_valid &&
631 "Cannot construct outs for invalid ip view.");
633 if (irp->outs_state != outs_none) {
637 global_count = n_out_edges = count_ip_outs();
638 out_edges = xcalloc(n_out_edges, sizeof(out_edges[0]));
639 set_irp_ip_outedges(out_edges);
643 void free_ip_outs(void) {
644 ir_node **out_edges = get_irp_ip_outedges();
645 if (out_edges != NULL) {
647 set_irp_ip_outedges(NULL);
649 irp->outs_state = outs_none;
654 void free_irg_outs(ir_graph *irg) {
655 /* current_ir_graph->outs_state = outs_none; */
656 irg->outs_state = outs_none;
660 memset(irg->outs, 0, irg->n_outs);
661 #endif /* defined DEBUG_libfirm */
666 #endif /* defined DEBUG_libfirm */
670 /* when debugging, *always* reset all nodes' outs! irg->outs might
671 have been lying to us */
672 irg_walk_graph (irg, reset_outs, NULL, NULL);
673 #endif /* defined DEBUG_libfirm */
676 static void check_out_edges(ir_node *irn, void *env) {
680 int last = is_Block(irn) ? 0 : -1;
682 /* check forward: every input must have an out edge */
683 for (i = get_irn_arity(irn) - 1; i >= last; --i) {
684 ir_node *pred = get_irn_n(irn, i);
686 for (j = get_irn_n_outs(pred) - 1; j >= 0; --j) {
687 ir_node *user = get_irn_out_ex(pred, j, &pos);
689 if (user == irn && pos == i) {
694 ir_fprintf(stderr, "Missing out edge from %+F input %d to %+F", irn, i, pred);
699 /* checking backward */
700 for (i = get_irn_n_outs(irn) - 1; i >= 0; --i) {
701 ir_node *user = get_irn_out_ex(irn, i, &pos);
703 if (get_irn_n(user, pos) != irn) {
704 ir_fprintf(stderr, "Spurious out edge from %+F output %d to %+F", irn, i, user);
711 /* verify outs edges. */
712 void verify_outs(ir_graph *irg) {
714 irg_walk_graph(irg, NULL, check_out_edges, &errors);
716 panic("Out edges are corrupt");