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"
33 #include "irnodeset.h"
36 #include "bestatevent.h"
40 STAT_TAG_FILE = 0, /**< tag for source file name */
41 STAT_TAG_TIME = 1, /**< tag for time */
42 STAT_TAG_IRG = 2, /**< tag for function name (irg) */
43 STAT_TAG_CLS = 3, /**< tag for register class (or "<all>") */
47 extern FILE *be_stat_file;
48 extern const char *be_stat_tags[STAT_TAG_LAST];
51 #ifdef FIRM_STATISTICS
54 * Collects statistics information about register pressure.
55 * @param birg The be irg object containing the irg
57 void be_do_stat_reg_pressure(be_irg_t *birg);
60 * Collect statistics about amount of ready nodes per block
61 * @param block The block
62 * @param ready_set A set of ready nodes
64 void be_do_stat_sched_ready(ir_node *block, const ir_nodeset_t *ready_set);
67 * Pass information about a perm to the statistic module.
69 * @param class_name the name of the register class
70 * @param n_regs number of registers in the register class
71 * @param perm the perm node
72 * @param block the block containing the perm
73 * @param size the size of the perm
74 * @param real_size number of pairs with different registers
76 void be_do_stat_perm(const char *class_name, int n_regs, ir_node *perm, ir_node *block, int n, int real_size);
79 * Pass information about a cycle or chain in a perm to the statistic module.
81 * @param class_name the name of the register class
82 * @param perm the perm node
83 * @param block the block containing the perm
84 * @param is_chain 1 if chain, 0 if cycle
85 * @param size length of the cycle/chain
86 * @param n_ops the number of ops representing this cycle/chain after lowering
88 void be_do_stat_permcycle(const char *class_name, ir_node *perm, ir_node *block, int is_chain, int n_elems, int n_ops);
91 * Collects node statistics.
93 * @param irg the to do statistics for
94 * @param phase the phase to collect the statistic for
96 void be_do_stat_nodes(ir_graph *irg, const char *phase);
99 * Performs initialization for be node statistics.
101 void be_stat_init_irg(const arch_env_t *arch_env, ir_graph *irg);
103 void be_init_stat_file(const char *filename, const char *sourcefilename);
104 void be_close_stat_file(void);
108 #define be_stat_init_irg(arch_env, irg)
109 #define be_do_stat_nodes(irg, phase)
110 #define be_do_stat_reg_pressure(birg)
111 #define be_do_stat_sched_ready(block, ready_set)
112 #define be_do_stat_perm(class_name, n_regs, perm, block, n, real_size)
113 #define be_do_stat_permcycle(class_name, perm, block, is_chain, n_elems, n_ops)
115 #endif /* FIRM_STATISTICS */
118 * Gives a cost estimate for the program (based on execution frequencies)
119 * and backend op_estimated_cost
121 double be_estimate_irg_costs(ir_graph *irg, const arch_env_t *arch_env, ir_exec_freq *execfreqs);
123 #endif /* FIRM_BE_BESTAT_H_ */