2 * Copyright (C) 1995-2008 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 Driver for the chordal register allocator.
23 * @author Sebastian Hack
39 #include "lc_opts_enum.h"
43 #include "irgraph_t.h"
44 #include "irprintf_t.h"
55 #include "iredges_t.h"
58 #include "bechordal_t.h"
67 #include "bestatevent.h"
73 #include "bedump_minir.h"
75 #include "bespillslots.h"
79 #include "becopystat.h"
80 #include "becopyopt.h"
81 #include "bessadestr.h"
85 #include "bepbqpcoloring.h"
87 static be_ra_chordal_opts_t options = {
89 BE_CH_LOWER_PERM_SWAP,
95 typedef struct _post_spill_env_t {
96 be_chordal_env_t cenv;
98 const arch_register_class_t *cls;
99 double pre_spill_cost;
102 static const lc_opt_enum_int_items_t lower_perm_items[] = {
103 { "copy", BE_CH_LOWER_PERM_COPY },
104 { "swap", BE_CH_LOWER_PERM_SWAP },
108 static const lc_opt_enum_int_items_t lower_perm_stat_items[] = {
112 static const lc_opt_enum_int_items_t dump_items[] = {
113 { "none", BE_CH_DUMP_NONE },
114 { "spill", BE_CH_DUMP_SPILL },
115 { "live", BE_CH_DUMP_LIVE },
116 { "color", BE_CH_DUMP_COLOR },
117 { "copymin", BE_CH_DUMP_COPYMIN },
118 { "ssadestr", BE_CH_DUMP_SSADESTR },
119 { "tree", BE_CH_DUMP_TREE_INTV },
120 { "constr", BE_CH_DUMP_CONSTR },
121 { "lower", BE_CH_DUMP_LOWER },
122 { "spillslots", BE_CH_DUMP_SPILLSLOTS },
123 { "appel", BE_CH_DUMP_APPEL },
124 { "all", BE_CH_DUMP_ALL },
128 static const lc_opt_enum_int_items_t be_ch_vrfy_items[] = {
129 { "off", BE_CH_VRFY_OFF },
130 { "warn", BE_CH_VRFY_WARN },
131 { "assert", BE_CH_VRFY_ASSERT },
135 static lc_opt_enum_int_var_t lower_perm_var = {
136 &options.lower_perm_opt, lower_perm_items
139 static lc_opt_enum_int_var_t dump_var = {
140 &options.dump_flags, dump_items
143 static lc_opt_enum_int_var_t be_ch_vrfy_var = {
144 &options.vrfy_option, be_ch_vrfy_items
147 static char minir_file[256] = "";
149 static const lc_opt_table_entry_t be_chordal_options[] = {
150 LC_OPT_ENT_ENUM_PTR ("perm", "perm lowering options", &lower_perm_var),
151 LC_OPT_ENT_ENUM_MASK("dump", "select dump phases", &dump_var),
152 LC_OPT_ENT_ENUM_PTR ("verify", "verify options", &be_ch_vrfy_var),
153 LC_OPT_ENT_STR ("minirout", "dump MinIR to file", minir_file, sizeof(minir_file)),
157 static be_module_list_entry_t *colorings = NULL;
158 static const be_ra_chordal_coloring_t *selected_coloring = NULL;
160 void be_register_chordal_coloring(const char *name, be_ra_chordal_coloring_t *coloring)
162 if (selected_coloring == NULL)
163 selected_coloring = coloring;
165 be_add_module_to_list(&colorings, name, coloring);
168 static void be_ra_chordal_coloring(be_chordal_env_t *env)
170 assert(selected_coloring != NULL);
171 if (selected_coloring != NULL) {
172 selected_coloring->allocate(env);
176 static void dump(unsigned mask, ir_graph *irg,
177 const arch_register_class_t *cls,
180 if ((options.dump_flags & mask) == mask) {
183 snprintf(buf, sizeof(buf), "%s-%s", cls->name, suffix);
184 dump_ir_graph(irg, buf);
186 dump_ir_graph(irg, suffix);
192 * Checks for every reload if its user can perform the load on itself.
194 static void memory_operand_walker(ir_node *irn, void *env)
196 const ir_edge_t *edge, *ne;
202 if (! be_is_Reload(irn))
205 /* only use memory operands, if the reload is only used by 1 node */
206 if (get_irn_n_edges(irn) > 1)
209 spill = be_get_Reload_mem(irn);
210 block = get_nodes_block(irn);
212 foreach_out_edge_safe(irn, edge, ne) {
213 ir_node *src = get_edge_src_irn(edge);
214 int pos = get_edge_src_pos(edge);
216 assert(src && "outedges broken!");
218 if (get_nodes_block(src) == block && arch_possible_memory_operand(src, pos)) {
219 arch_perform_memory_operand(src, spill, pos);
223 /* kill the Reload */
224 if (get_irn_n_edges(irn) == 0) {
226 set_irn_n(irn, be_pos_Reload_mem, new_Bad());
227 set_irn_n(irn, be_pos_Reload_frame, new_Bad());
232 * Starts a walk for memory operands if supported by the backend.
234 void check_for_memory_operands(ir_graph *irg)
236 irg_walk_graph(irg, NULL, memory_operand_walker, NULL);
240 static be_node_stats_t last_node_stats;
243 * Perform things which need to be done per register class before spilling.
245 static void pre_spill(post_spill_env_t *pse, const arch_register_class_t *cls)
247 be_chordal_env_t *chordal_env = &pse->cenv;
248 be_irg_t *birg = pse->birg;
249 ir_graph *irg = be_get_birg_irg(birg);
252 chordal_env->cls = cls;
253 chordal_env->border_heads = pmap_create();
254 chordal_env->ignore_colors = bitset_malloc(chordal_env->cls->n_regs);
256 be_assure_liveness(irg);
257 be_liveness_assure_chk(be_get_irg_liveness(irg));
259 stat_ev_do(pse->pre_spill_cost = be_estimate_irg_costs(irg, birg->exec_freq));
261 /* put all ignore registers into the ignore register set. */
262 be_put_ignore_regs(irg, pse->cls, chordal_env->ignore_colors);
264 be_timer_push(T_RA_CONSTR);
265 be_pre_spill_prepare_constr(irg, chordal_env->cls);
266 be_timer_pop(T_RA_CONSTR);
268 dump(BE_CH_DUMP_CONSTR, birg->irg, pse->cls, "constr-pre");
272 * Perform things which need to be done per register class after spilling.
274 static void post_spill(post_spill_env_t *pse, int iteration)
276 be_chordal_env_t *chordal_env = &pse->cenv;
277 be_irg_t *birg = pse->birg;
278 ir_graph *irg = birg->irg;
279 int colors_n = arch_register_class_n_regs(chordal_env->cls);
281 = colors_n - be_put_ignore_regs(irg, chordal_env->cls, NULL);
283 /* some special classes contain only ignore regs, no work to be done */
284 if (allocatable_regs > 0) {
285 stat_ev_dbl("bechordal_spillcosts", be_estimate_irg_costs(irg, birg->exec_freq) - pse->pre_spill_cost);
288 If we have a backend provided spiller, post spill is
289 called in a loop after spilling for each register class.
290 But we only need to fix stack nodes once in this case.
292 be_timer_push(T_RA_SPILL_APPLY);
293 check_for_memory_operands(irg);
294 if (iteration == 0) {
295 be_abi_fix_stack_nodes(birg->abi);
297 be_timer_pop(T_RA_SPILL_APPLY);
300 /* verify schedule and register pressure */
301 be_timer_push(T_VERIFY);
302 if (chordal_env->opts->vrfy_option == BE_CH_VRFY_WARN) {
303 be_verify_schedule(birg);
304 be_verify_register_pressure(irg, pse->cls);
305 } else if (chordal_env->opts->vrfy_option == BE_CH_VRFY_ASSERT) {
306 assert(be_verify_schedule(birg) && "Schedule verification failed");
307 assert(be_verify_register_pressure(irg, pse->cls)
308 && "Register pressure verification failed");
310 be_timer_pop(T_VERIFY);
312 /* Color the graph. */
313 be_timer_push(T_RA_COLOR);
314 be_ra_chordal_coloring(chordal_env);
315 be_timer_pop(T_RA_COLOR);
317 dump(BE_CH_DUMP_CONSTR, irg, pse->cls, "color");
319 /* Create the ifg with the selected flavor */
320 be_timer_push(T_RA_IFG);
321 chordal_env->ifg = be_create_ifg(chordal_env);
322 be_timer_pop(T_RA_IFG);
326 be_node_stats_t node_stats;
328 be_ifg_stat(birg, chordal_env->ifg, &stat);
329 stat_ev_dbl("bechordal_ifg_nodes", stat.n_nodes);
330 stat_ev_dbl("bechordal_ifg_edges", stat.n_edges);
331 stat_ev_dbl("bechordal_ifg_comps", stat.n_comps);
333 be_collect_node_stats(&node_stats, birg);
334 be_subtract_node_stats(&node_stats, &last_node_stats);
336 stat_ev_dbl("bechordal_perms_before_coal",
337 node_stats[BE_STAT_PERMS]);
338 stat_ev_dbl("bechordal_copies_before_coal",
339 node_stats[BE_STAT_COPIES]);
342 be_timer_push(T_RA_COPYMIN);
343 if (minir_file[0] != '\0') {
346 if (strcmp(minir_file, "-") == 0) {
349 out = fopen(minir_file, "w");
351 panic("Cound't open minir output '%s'", minir_file);
355 be_export_minir(chordal_env->birg->main_env->arch_env, out, irg);
359 co_driver(chordal_env);
360 be_timer_pop(T_RA_COPYMIN);
362 dump(BE_CH_DUMP_COPYMIN, irg, pse->cls, "copymin");
364 /* ssa destruction */
365 be_timer_push(T_RA_SSA);
366 be_ssa_destruction(chordal_env);
367 be_timer_pop(T_RA_SSA);
369 dump(BE_CH_DUMP_SSADESTR, irg, pse->cls, "ssadestr");
371 if (chordal_env->opts->vrfy_option != BE_CH_VRFY_OFF) {
372 be_timer_push(T_VERIFY);
373 be_ssa_destruction_check(chordal_env);
374 be_timer_pop(T_VERIFY);
377 /* the ifg exists only if there are allocatable regs */
378 be_ifg_free(chordal_env->ifg);
381 /* free some always allocated data structures */
382 pmap_destroy(chordal_env->border_heads);
383 bitset_free(chordal_env->ignore_colors);
387 * Performs chordal register allocation for each register class on given irg.
389 * @param birg Backend irg object
390 * @return Structure containing timer for the single phases or NULL if no timing requested.
392 static void be_ra_chordal_main(be_irg_t *birg)
394 const arch_env_t *arch_env = birg->main_env->arch_env;
395 ir_graph *irg = birg->irg;
398 be_chordal_env_t chordal_env;
401 be_timer_push(T_RA_OTHER);
403 be_timer_push(T_RA_PROLOG);
405 be_assure_liveness(irg);
407 chordal_env.obst = &obst;
408 chordal_env.opts = &options;
409 chordal_env.irg = irg;
410 chordal_env.birg = birg;
411 chordal_env.border_heads = NULL;
412 chordal_env.ifg = NULL;
413 chordal_env.ignore_colors = NULL;
417 be_timer_pop(T_RA_PROLOG);
420 be_collect_node_stats(&last_node_stats, birg);
423 if (! arch_code_generator_has_spiller(birg->cg)) {
424 /* use one of the generic spiller */
426 /* Perform the following for each register class. */
427 for (j = 0, m = arch_env_get_n_reg_class(arch_env); j < m; ++j) {
428 post_spill_env_t pse;
429 const arch_register_class_t *cls
430 = arch_env_get_reg_class(arch_env, j);
432 if (arch_register_class_flags(cls) & arch_register_class_flag_manual_ra)
436 stat_ev_ctx_push_str("bechordal_cls", cls->name);
439 be_do_stat_reg_pressure(birg, cls);
442 memcpy(&pse.cenv, &chordal_env, sizeof(chordal_env));
444 pre_spill(&pse, cls);
446 be_timer_push(T_RA_SPILL);
447 be_do_spill(irg, cls);
448 be_timer_pop(T_RA_SPILL);
450 dump(BE_CH_DUMP_SPILL, irg, pse.cls, "spill");
455 be_node_stats_t node_stats;
457 be_collect_node_stats(&node_stats, birg);
458 be_subtract_node_stats(&node_stats, &last_node_stats);
459 be_emit_node_stats(&node_stats, "bechordal_");
461 be_copy_node_stats(&last_node_stats, &node_stats);
462 stat_ev_ctx_pop("bechordal_cls");
466 post_spill_env_t *pse;
468 /* the backend has its own spiller */
469 m = arch_env_get_n_reg_class(arch_env);
471 pse = ALLOCAN(post_spill_env_t, m);
473 for (j = 0; j < m; ++j) {
474 memcpy(&pse[j].cenv, &chordal_env, sizeof(chordal_env));
476 pre_spill(&pse[j], pse[j].cls);
479 be_timer_push(T_RA_SPILL);
480 arch_code_generator_spill(birg->cg, birg);
481 be_timer_pop(T_RA_SPILL);
482 dump(BE_CH_DUMP_SPILL, irg, NULL, "spill");
484 for (j = 0; j < m; ++j) {
485 post_spill(&pse[j], j);
489 be_timer_push(T_VERIFY);
490 if (chordal_env.opts->vrfy_option == BE_CH_VRFY_WARN) {
491 be_verify_register_allocation(birg);
492 } else if (chordal_env.opts->vrfy_option == BE_CH_VRFY_ASSERT) {
493 assert(be_verify_register_allocation(birg)
494 && "Register allocation invalid");
496 be_timer_pop(T_VERIFY);
498 be_timer_push(T_RA_EPILOG);
499 lower_nodes_after_ra(birg, options.lower_perm_opt & BE_CH_LOWER_PERM_COPY ? 1 : 0);
500 dump(BE_CH_DUMP_LOWER, irg, NULL, "belower-after-ra");
502 obstack_free(&obst, NULL);
503 be_liveness_invalidate(be_get_irg_liveness(irg));
504 be_timer_pop(T_RA_EPILOG);
506 be_timer_pop(T_RA_OTHER);
509 BE_REGISTER_MODULE_CONSTRUCTOR(be_init_chordal_main);
510 void be_init_chordal_main(void)
512 static be_ra_t be_ra_chordal_allocator = {
516 lc_opt_entry_t *be_grp = lc_opt_get_grp(firm_opt_get_root(), "be");
517 lc_opt_entry_t *ra_grp = lc_opt_get_grp(be_grp, "ra");
518 lc_opt_entry_t *chordal_grp = lc_opt_get_grp(ra_grp, "chordal");
520 be_register_allocator("chordal", &be_ra_chordal_allocator);
522 lc_opt_add_table(chordal_grp, be_chordal_options);
523 be_add_module_list_opt(chordal_grp, "coloring", "select coloring methode", &colorings, (void**) &selected_coloring);