Added stub for new be_introduce_copies...
[libfirm] / ir / be / beirgmod.h
1
2 /**
3  * IRG modifications for be routines.
4  * @date 4.5.2005
5  *
6  * Copyright (C) 2005 Universitaet Karlsruhe.
7  * Released under the GPL.
8  */
9
10 #ifndef _BEIRGMOD_H
11 #define _BEIRGMOD_H
12
13 #include "pset.h"
14
15 /*
16  * Forward type declaration.
17  */
18 typedef struct _dom_front_info_t dom_front_info_t;
19
20 /**
21  * Compute the dominance frontiers for a given graph.
22  * @param  irg The graphs.
23  * @return A pointer to the dominance frontier information.
24  */
25 dom_front_info_t *be_compute_dominance_frontiers(ir_graph *irg);
26
27 /**
28  * Get the dominance frontier of a block.
29  * @param info  A pointer to the dominance frontier information.
30  * @param block The block whose dominance frontier you want.
31  * @return A set containing the all blocks in the dominance frontier of @p block.
32  */
33 pset *be_get_dominance_frontier(dom_front_info_t *info, ir_node *block);
34
35 /**
36  * Free some dominance frontier information.
37  * @param info Some dominance frontier information.
38  */
39 void be_free_dominance_frontiers(dom_front_info_t *info);
40
41 /**
42  * Introduce several copies for one node.
43  *
44  * A copy in this context means, that you want to introduce several new
45  * abstract values (in Firm: nodes) for which you know, that they
46  * represent the same concrete value. This is the case if you
47  * - copy
48  * - spill and reload
49  * - rematerialize
50  * a value.
51  *
52  * This function reroutes all uses of the original value to the copies in the
53  * corresponding dominance subtrees and creates Phi functions if neccessary.
54  *
55  * @param info          Dominance frontier information.
56  * @param orig          The node for which you want to introduce copies.
57  * @param n                     The number of copies ypu introduce.
58  * @param copies        An array of nodes which are copies of @p orig.
59  */
60 void be_introduce_copies_ignore(dom_front_info_t *info, ir_node *orig,
61     int n, ir_node *copies[], pset *irgore_uses);
62
63 void be_introduce_copies(dom_front_info_t *info, ir_node *orig, int n, ir_node *copies[]);
64
65 void be_introduce_copies_for_set(dom_front_info_t *info, pset *origs, pset *copies);
66
67 /* obsolete
68 void be_introduce_copies_pset(dom_front_info_t *info, pset *nodes);
69 */
70
71 #endif