f48567aa728aaa6974641633d656bccd5429f460
[libfirm] / ir / be / bestat.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       Provides several statistic functions for the backend.
23  * @author      Christian Wuerdig
24  * @version     $Id$
25  */
26 #ifndef FIRM_BE_BESTAT_H
27 #define FIRM_BE_BESTAT_H
28
29 #include "firm_config.h"
30
31 #include "firm_types.h"
32 #include "irnodeset.h"
33
34 #include "beirg.h"
35 #include "bestatevent.h"
36 #include "bearch.h"
37
38 enum {
39         STAT_TAG_FILE = 0,  /**< tag for source file name */
40         STAT_TAG_TIME = 1,  /**< tag for time */
41         STAT_TAG_IRG  = 2,  /**< tag for function name (irg) */
42         STAT_TAG_CLS  = 3,  /**< tag for register class (or "<all>") */
43         STAT_TAG_LAST
44 };
45
46 extern FILE *be_stat_file;
47 extern const char *be_stat_tags[STAT_TAG_LAST];
48
49
50 #ifdef FIRM_STATISTICS
51
52 /**
53  * Collects statistics information about register pressure.
54  * @param birg The be irg object containing the irg
55  */
56 void be_do_stat_reg_pressure(be_irg_t *birg);
57
58 /**
59  * Collect statistics about amount of ready nodes per block
60  * @param block     The block
61  * @param ready_set A set of ready nodes
62  */
63 void be_do_stat_sched_ready(ir_node *block, const ir_nodeset_t *ready_set);
64
65 /**
66  * Pass information about a perm to the statistic module.
67  *
68  * @param class_name the name of the register class
69  * @param n_regs     number of registers in the register class
70  * @param perm       the perm node
71  * @param block      the block containing the perm
72  * @param size       the size of the perm
73  * @param real_size  number of pairs with different registers
74  */
75 void be_do_stat_perm(const char *class_name, int n_regs, ir_node *perm, ir_node *block, int n, int real_size);
76
77 /**
78  * Pass information about a cycle or chain in a perm to the statistic module.
79  *
80  * @param class_name the name of the register class
81  * @param perm       the perm node
82  * @param block      the block containing the perm
83  * @param is_chain   1 if chain, 0 if cycle
84  * @param size       length of the cycle/chain
85  * @param n_ops      the number of ops representing this cycle/chain after lowering
86  */
87 void be_do_stat_permcycle(const char *class_name, ir_node *perm, ir_node *block, int is_chain, int n_elems, int n_ops);
88
89 /**
90  * Collects node statistics.
91  *
92  * @param irg      the to do statistics for
93  * @param phase    the phase to collect the statistic for
94  */
95 void be_do_stat_nodes(ir_graph *irg, const char *phase);
96
97 /**
98  * Performs initialization for be node statistics.
99  */
100 void be_stat_init_irg(const arch_env_t *arch_env, ir_graph *irg);
101
102 void be_init_stat_file(const char *filename, const char *sourcefilename);
103 void be_close_stat_file(void);
104
105 #else /* ! FIRM_STATISTICS */
106
107 #define be_stat_init_irg(arch_env, irg)
108 #define be_do_stat_nodes(irg, phase)
109 #define be_do_stat_reg_pressure(birg)
110 #define be_do_stat_sched_ready(block, ready_set)
111 #define be_do_stat_perm(class_name, n_regs, perm, block, n, real_size)
112 #define be_do_stat_permcycle(class_name, perm, block, is_chain, n_elems, n_ops)
113
114 #endif /* FIRM_STATISTICS */
115
116 /**
117  * Gives a cost estimate for the program (based on execution frequencies)
118  * and backend op_estimated_cost
119  */
120 double be_estimate_irg_costs(ir_graph *irg, const arch_env_t *arch_env, ir_exec_freq *execfreqs);
121
122 #endif /* FIRM_BE_BESTAT_H */