2 * Copyright (C) 1995-2007 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 Provides several statistic functions for the backend.
23 * @author Christian Wuerdig
26 #ifndef FIRM_BE_BESTAT_H
27 #define FIRM_BE_BESTAT_H
29 #include "firm_config.h"
31 #include "firm_types.h"
32 #include "irnodeset.h"
35 #include "bestatevent.h"
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>") */
46 extern FILE *be_stat_file;
47 extern const char *be_stat_tags[STAT_TAG_LAST];
50 #ifdef FIRM_STATISTICS
53 * Collects statistics information about register pressure.
54 * @param birg The be irg object containing the irg
56 void be_do_stat_reg_pressure(be_irg_t *birg);
59 * Collect statistics about amount of ready nodes per block
60 * @param block The block
61 * @param ready_set A set of ready nodes
63 void be_do_stat_sched_ready(ir_node *block, const ir_nodeset_t *ready_set);
66 * Pass information about a perm to the statistic module.
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
75 void be_do_stat_perm(const char *class_name, int n_regs, ir_node *perm, ir_node *block, int n, int real_size);
78 * Pass information about a cycle or chain in a perm to the statistic module.
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
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);
90 * Collects node statistics.
92 * @param irg the to do statistics for
93 * @param phase the phase to collect the statistic for
95 void be_do_stat_nodes(ir_graph *irg, const char *phase);
98 * Performs initialization for be node statistics.
100 void be_stat_init_irg(const arch_env_t *arch_env, ir_graph *irg);
102 void be_init_stat_file(const char *filename, const char *sourcefilename);
103 void be_close_stat_file(void);
105 #else /* ! FIRM_STATISTICS */
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)
114 #endif /* FIRM_STATISTICS */
117 * Gives a cost estimate for the program (based on execution frequencies)
118 * and backend op_estimated_cost
120 double be_estimate_irg_costs(ir_graph *irg, const arch_env_t *arch_env, ir_exec_freq *execfreqs);
122 #endif /* FIRM_BE_BESTAT_H */