remove $Id$, it doesn't work with git anyway
[libfirm] / ir / be / bepeephole.h
1 /*
2  * Copyright (C) 1995-2008 University of Karlsruhe.  All right reserved.
3  *
4  * This file is part of libFirm.
5  *
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.
10  *
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.
14  *
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
17  * PURPOSE.
18  */
19
20 /**
21  * @file
22  * @brief       peephole optimisation framework
23  * @author      Matthias Braun
24  */
25 #ifndef BEPEEPHOLE_H
26 #define BEPEEPHOLE_H
27
28 #include "beirg.h"
29 #include "bearch.h"
30
31 extern ir_node **register_values;
32
33 static inline ir_node *be_peephole_get_value(unsigned register_idx)
34 {
35         return register_values[register_idx];
36 }
37
38 static inline ir_node *be_peephole_get_reg_value(const arch_register_t *reg)
39 {
40         unsigned register_idx = reg->global_index;
41         return be_peephole_get_value(register_idx);
42 }
43
44 /**
45  * Datatype of the generic op handler for optimisation.
46  */
47 typedef void (*peephole_opt_func) (ir_node *node);
48
49 /**
50  * Notify the peephole phase about a newly added node, so it can update its
51  * internal state.  This is not needed for the new node, when
52  * be_peephole_exchange() is used.
53  * Note: Contrary to normal exchange you mustn't remove the node from the
54  * schedule either before exchange. Exchange will do that for you.
55  */
56 void be_peephole_new_node(ir_node *nw);
57
58 /**
59  * When doing peephole optimisation use this function instead of plain
60  * exchange(), so it can update its internal state. */
61 void be_peephole_exchange(ir_node *old, ir_node *nw);
62
63 /**
64  * Tries to optimize a beIncSp node with its previous IncSP node.
65  * Must be run from a be_peephole_opt() context.
66  *
67  * @param node  a be_IncSP node
68  *
69  * @return the new IncSP node or node itself
70  */
71 ir_node *be_peephole_IncSP_IncSP(ir_node *node);
72
73 bool be_has_only_one_user(ir_node *node);
74
75 /**
76  * In a scheduled program with registers assigned,
77  * checks wether @p node can be moved before @p before without changing program
78  * semantics.
79  *
80  * Note: It is allowed to use this function without being in a peephole
81  * optimization phase.
82  */
83 bool be_can_move_before(ir_heights_t *heights, const ir_node *node,
84                         const ir_node *before);
85
86 /**
87  * Do peephole optimisations. It traverses the schedule of all blocks in
88  * backward direction. The register_values variable indicates which (live)
89  * values are stored in which register.
90  * The generic op handler is called for each node if it exists. That's where
91  * backend specific optimisations should be performed based on the
92  * register-liveness information.
93  */
94 void be_peephole_opt(ir_graph *irg);
95
96 #endif