1 /* Gimple Represented as Polyhedra.
2 Copyright (C) 2006-2023 Free Software Foundation, Inc.
3 Contributed by Sebastian Pop <sebastian.pop@inria.fr>.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
12 GCC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
21 /* This pass converts GIMPLE to GRAPHITE, performs some loop
22 transformations and then converts the resulting representation back
25 An early description of this pass can be found in the GCC Summit'06
26 paper "GRAPHITE: Polyhedral Analyses and Optimizations for GCC".
27 The wiki page http://gcc.gnu.org/wiki/Graphite contains pointers to
34 #include "coretypes.h"
36 #include "diagnostic-core.h"
38 #include "tree-pass.h"
39 #include "pretty-print.h"
47 #include "fold-const.h"
48 #include "gimple-iterator.h"
50 #include "tree-ssa-loop.h"
51 #include "tree-data-ref.h"
52 #include "tree-scalar-evolution.h"
54 #include "tree-parloops.h"
55 #include "tree-cfgcleanup.h"
56 #include "tree-vectorizer.h"
57 #include "tree-ssa-loop-manip.h"
59 #include "tree-into-ssa.h"
60 #include "tree-ssa-propagate.h"
63 /* Print global statistics to FILE. */
66 print_global_statistics (FILE* file
)
71 long n_conditions
= 0;
72 profile_count n_p_bbs
= profile_count::zero ();
73 profile_count n_p_loops
= profile_count::zero ();
74 profile_count n_p_stmts
= profile_count::zero ();
75 profile_count n_p_conditions
= profile_count::zero ();
79 FOR_ALL_BB_FN (bb
, cfun
)
81 gimple_stmt_iterator psi
;
84 if (bb
->count
.initialized_p ())
87 /* Ignore artificial surrounding loop. */
88 if (bb
== bb
->loop_father
->header
92 n_p_loops
+= bb
->count
;
95 if (EDGE_COUNT (bb
->succs
) > 1)
98 if (bb
->count
.initialized_p ())
99 n_p_conditions
+= bb
->count
;
102 for (psi
= gsi_start_bb (bb
); !gsi_end_p (psi
); gsi_next (&psi
))
105 if (bb
->count
.initialized_p ())
106 n_p_stmts
+= bb
->count
;
110 fprintf (file
, "\nGlobal statistics (");
111 fprintf (file
, "BBS:%ld, ", n_bbs
);
112 fprintf (file
, "LOOPS:%ld, ", n_loops
);
113 fprintf (file
, "CONDITIONS:%ld, ", n_conditions
);
114 fprintf (file
, "STMTS:%ld)\n", n_stmts
);
115 fprintf (file
, "Global profiling statistics (");
116 fprintf (file
, "BBS:");
118 fprintf (file
, ", LOOPS:");
119 n_p_loops
.dump (file
);
120 fprintf (file
, ", CONDITIONS:");
121 n_p_conditions
.dump (file
);
122 fprintf (file
, ", STMTS:");
123 n_p_stmts
.dump (file
);
124 fprintf (file
, ")\n\n");
127 /* Print statistics for SCOP to FILE. */
130 print_graphite_scop_statistics (FILE* file
, scop_p scop
)
135 long n_conditions
= 0;
136 profile_count n_p_bbs
= profile_count::zero ();
137 profile_count n_p_loops
= profile_count::zero ();
138 profile_count n_p_stmts
= profile_count::zero ();
139 profile_count n_p_conditions
= profile_count::zero ();
143 FOR_ALL_BB_FN (bb
, cfun
)
145 gimple_stmt_iterator psi
;
146 loop_p loop
= bb
->loop_father
;
148 if (!bb_in_sese_p (bb
, scop
->scop_info
->region
))
152 if (bb
->count
.initialized_p ())
153 n_p_bbs
+= bb
->count
;
155 if (EDGE_COUNT (bb
->succs
) > 1)
158 n_p_conditions
+= bb
->count
;
161 for (psi
= gsi_start_bb (bb
); !gsi_end_p (psi
); gsi_next (&psi
))
164 n_p_stmts
+= bb
->count
;
167 if (loop
->header
== bb
&& loop_in_sese_p (loop
, scop
->scop_info
->region
))
170 n_p_loops
+= bb
->count
;
174 fprintf (file
, "\nFunction Name: %s\n", current_function_name ());
176 edge scop_begin
= scop
->scop_info
->region
.entry
;
177 edge scop_end
= scop
->scop_info
->region
.exit
;
179 fprintf (file
, "\nSCoP (entry_edge (bb_%d, bb_%d), ",
180 scop_begin
->src
->index
, scop_begin
->dest
->index
);
181 fprintf (file
, "exit_edge (bb_%d, bb_%d))",
182 scop_end
->src
->index
, scop_end
->dest
->index
);
184 fprintf (file
, "\nSCoP statistics (");
185 fprintf (file
, "BBS:%ld, ", n_bbs
);
186 fprintf (file
, "LOOPS:%ld, ", n_loops
);
187 fprintf (file
, "CONDITIONS:%ld, ", n_conditions
);
188 fprintf (file
, "STMTS:%ld)\n", n_stmts
);
189 fprintf (file
, "SCoP profiling statistics (");
190 fprintf (file
, "BBS:");
192 fprintf (file
, ", LOOPS:");
193 n_p_loops
.dump (file
);
194 fprintf (file
, ", CONDITIONS:");
195 n_p_conditions
.dump (file
);
196 fprintf (file
, ", STMTS:");
197 n_p_stmts
.dump (file
);
198 fprintf (file
, ")\n\n");
201 /* Print statistics for SCOPS to FILE. */
204 print_graphite_statistics (FILE* file
, vec
<scop_p
> scops
)
209 FOR_EACH_VEC_ELT (scops
, i
, scop
)
210 print_graphite_scop_statistics (file
, scop
);
213 struct seir_cache_key
222 struct sese_scev_hash
: typed_noop_remove
<seir_cache_key
>
224 typedef seir_cache_key value_type
;
225 typedef seir_cache_key compare_type
;
226 static hashval_t
hash (const seir_cache_key
&key
) { return key
.hash
; }
228 equal (const seir_cache_key
&key1
, const seir_cache_key
&key2
)
230 return (key1
.hash
== key2
.hash
231 && key1
.entry_dest
== key2
.entry_dest
232 && key1
.exit_src
== key2
.exit_src
233 && key1
.loop_num
== key2
.loop_num
234 && operand_equal_p (key1
.expr
, key2
.expr
, 0));
236 static void mark_deleted (seir_cache_key
&key
) { key
.expr
= NULL_TREE
; }
237 static const bool empty_zero_p
= false;
238 static void mark_empty (seir_cache_key
&key
) { key
.entry_dest
= 0; }
239 static bool is_deleted (const seir_cache_key
&key
) { return !key
.expr
; }
240 static bool is_empty (const seir_cache_key
&key
) { return key
.entry_dest
== 0; }
243 static hash_map
<sese_scev_hash
, tree
> *seir_cache
;
245 /* Same as scalar_evolution_in_region but caches results so we avoid
246 re-computing evolutions during transform phase. */
249 cached_scalar_evolution_in_region (const sese_l
®ion
, loop_p loop
,
253 key
.entry_dest
= region
.entry
->dest
->index
;
254 key
.exit_src
= region
.exit
->src
->index
;
255 key
.loop_num
= loop
->num
;
257 inchash::hash
hstate (0);
258 hstate
.add_int (key
.entry_dest
);
259 hstate
.add_int (key
.exit_src
);
260 hstate
.add_int (key
.loop_num
);
261 inchash::add_expr (key
.expr
, hstate
);
262 key
.hash
= hstate
.end ();
265 tree
&chrec
= seir_cache
->get_or_insert (key
, &existed
);
267 chrec
= scalar_evolution_in_region (region
, loop
, expr
);
271 /* Deletes all scops in SCOPS. */
274 free_scops (vec
<scop_p
> scops
)
279 FOR_EACH_VEC_ELT (scops
, i
, scop
)
285 /* Transforms LOOP to the canonical loop closed SSA form. */
288 canonicalize_loop_closed_ssa (loop_p loop
, edge e
)
295 /* Make the loop-close PHI node BB contain only PHIs and have a
296 single predecessor. */
297 if (single_pred_p (bb
))
299 e
= split_block_after_labels (bb
);
304 basic_block close
= split_edge (e
);
305 e
= single_succ_edge (close
);
306 for (psi
= gsi_start_phis (bb
); !gsi_end_p (psi
); gsi_next (&psi
))
308 gphi
*phi
= psi
.phi ();
309 use_operand_p use_p
= PHI_ARG_DEF_PTR_FROM_EDGE (phi
, e
);
310 tree arg
= USE_FROM_PTR (use_p
);
312 /* Only add close phi nodes for SSA_NAMEs defined in LOOP. */
313 if (TREE_CODE (arg
) != SSA_NAME
314 || SSA_NAME_IS_DEFAULT_DEF (arg
)
315 || ! flow_bb_inside_loop_p (loop
,
316 gimple_bb (SSA_NAME_DEF_STMT (arg
))))
319 tree res
= copy_ssa_name (arg
);
320 gphi
*close_phi
= create_phi_node (res
, close
);
321 add_phi_arg (close_phi
, arg
, gimple_phi_arg_edge (close_phi
, 0),
323 SET_USE (use_p
, res
);
328 /* Eliminate duplicates. This relies on processing loops from
329 innermost to outer. */
330 for (psi
= gsi_start_phis (bb
); !gsi_end_p (psi
); gsi_next (&psi
))
332 gphi_iterator gsi
= psi
;
333 gphi
*phi
= psi
.phi ();
335 /* At this point, PHI should be a close phi in normal form. */
336 gcc_assert (gimple_phi_num_args (phi
) == 1);
338 /* Iterate over the next phis and remove duplicates. */
340 while (!gsi_end_p (gsi
))
341 if (gimple_phi_arg_def (phi
, 0) == gimple_phi_arg_def (gsi
.phi (), 0)
342 && may_propagate_copy (gimple_phi_result (gsi
.phi ()),
343 gimple_phi_result (phi
)))
345 replace_uses_by (gimple_phi_result (gsi
.phi ()),
346 gimple_phi_result (phi
));
347 remove_phi_node (&gsi
, true);
354 /* Converts the current loop closed SSA form to a canonical form
355 expected by the Graphite code generation.
357 The loop closed SSA form has the following invariant: a variable
358 defined in a loop that is used outside the loop appears only in the
359 phi nodes in the destination of the loop exit. These phi nodes are
360 called close phi nodes.
362 The canonical loop closed SSA form contains the extra invariants:
364 - when the loop contains only one exit, the close phi nodes contain
365 only one argument. That implies that the basic block that contains
366 the close phi nodes has only one predecessor, that is a basic block
369 - the basic block containing the close phi nodes does not contain
372 - there exist only one phi node per definition in the loop.
374 In addition to that we also make sure that loop exit edges are
375 first in the successor edge vector. This is to make RPO order
376 as computed by pre_and_rev_post_order_compute be consistent with
377 what initial schedule generation expects.
381 canonicalize_loop_form (void)
383 for (auto loop
: loops_list (cfun
, LI_FROM_INNERMOST
))
385 edge e
= single_exit (loop
);
386 if (!e
|| (e
->flags
& (EDGE_COMPLEX
|EDGE_FAKE
)))
389 canonicalize_loop_closed_ssa (loop
, e
);
391 /* If the exit is not first in the edge vector make it so. */
392 if (e
!= EDGE_SUCC (e
->src
, 0))
395 for (ei
= 0; EDGE_SUCC (e
->src
, ei
) != e
; ++ei
)
397 std::swap (EDGE_SUCC (e
->src
, ei
), EDGE_SUCC (e
->src
, 0));
401 /* We can end up releasing duplicate exit PHIs and also introduce
402 additional copies so the cached information isn't correct anymore. */
405 checking_verify_loop_closed_ssa (true);
408 isl_ctx
*the_isl_ctx
;
410 /* Perform a set of linear transforms on the loops of the current
414 graphite_transform_loops (void)
418 bool changed
= false;
419 vec
<scop_p
> scops
= vNULL
;
422 /* If a function is parallel it was most probably already run through graphite
423 once. No need to run again. */
424 if (parallelized_function_p (cfun
->decl
))
427 calculate_dominance_info (CDI_DOMINATORS
);
429 /* We rely on post-dominators during merging of SESE regions so those
430 have to be meaningful. */
431 connect_infinite_loops_to_exit ();
433 ctx
= isl_ctx_alloc ();
434 isl_options_set_on_error (ctx
, ISL_ON_ERROR_ABORT
);
437 sort_sibling_loops (cfun
);
438 canonicalize_loop_form ();
440 /* Print the loop structure. */
441 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
443 print_loops (dump_file
, 2);
444 print_loops (dump_file
, 3);
447 seir_cache
= new hash_map
<sese_scev_hash
, tree
>;
449 calculate_dominance_info (CDI_POST_DOMINATORS
);
450 build_scops (&scops
);
451 free_dominance_info (CDI_POST_DOMINATORS
);
453 /* Remove the fake exits before transform given they are not reflected
454 in loop structures we end up verifying. */
455 remove_fake_exit_edges ();
457 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
459 print_graphite_statistics (dump_file
, scops
);
460 print_global_statistics (dump_file
);
463 FOR_EACH_VEC_ELT (scops
, i
, scop
)
464 if (dbg_cnt (graphite_scop
))
466 scop
->isl_context
= ctx
;
467 if (!build_poly_scop (scop
))
470 if (!apply_poly_transforms (scop
))
474 if (graphite_regenerate_ast_isl (scop
)
475 && dump_enabled_p ())
477 dump_user_location_t loc
= find_loop_location
478 (scops
[i
]->scop_info
->region
.entry
->dest
->loop_father
);
479 dump_printf_loc (MSG_OPTIMIZED_LOCATIONS
, loc
,
480 "loop nest optimized\n");
489 mark_virtual_operands_for_renaming (cfun
);
490 update_ssa (TODO_update_ssa
);
491 checking_verify_ssa (true, true);
492 rewrite_into_loop_closed_ssa (NULL
, 0);
494 checking_verify_loop_structure ();
497 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
499 int num_no_dependency
= 0;
501 for (auto loop
: loops_list (cfun
, 0))
502 if (loop
->can_be_parallel
)
505 fprintf (dump_file
, "%d loops carried no dependency.\n",
515 /* FIXME: Graphite does not update profile meaningfully currently. */
516 cfun
->cfg
->full_profile
= false;
518 profile_status_for_fn (cfun
) = PROFILE_ABSENT
;
519 release_recorded_exits (cfun
);
520 tree_estimate_probability (false);
524 #else /* If isl is not available: #ifndef HAVE_isl. */
527 graphite_transform_loops (void)
529 sorry ("Graphite loop optimizations cannot be used (isl is not available).");
536 graphite_transforms (struct function
*fun
)
538 if (number_of_loops (fun
) <= 1)
541 graphite_transform_loops ();
547 gate_graphite_transforms (void)
549 /* Enable -fgraphite pass if any one of the graphite optimization flags
551 if (flag_graphite_identity
552 || flag_loop_parallelize_all
553 || flag_loop_nest_optimize
)
556 return flag_graphite
!= 0;
561 const pass_data pass_data_graphite
=
563 GIMPLE_PASS
, /* type */
564 "graphite0", /* name */
565 OPTGROUP_LOOP
, /* optinfo_flags */
566 TV_GRAPHITE
, /* tv_id */
567 ( PROP_cfg
| PROP_ssa
), /* properties_required */
568 0, /* properties_provided */
569 0, /* properties_destroyed */
570 0, /* todo_flags_start */
571 0, /* todo_flags_finish */
574 class pass_graphite
: public gimple_opt_pass
577 pass_graphite (gcc::context
*ctxt
)
578 : gimple_opt_pass (pass_data_graphite
, ctxt
)
581 /* opt_pass methods: */
582 bool gate (function
*) final override
{ return gate_graphite_transforms (); }
584 }; // class pass_graphite
589 make_pass_graphite (gcc::context
*ctxt
)
591 return new pass_graphite (ctxt
);
596 const pass_data pass_data_graphite_transforms
=
598 GIMPLE_PASS
, /* type */
599 "graphite", /* name */
600 OPTGROUP_LOOP
, /* optinfo_flags */
601 TV_GRAPHITE_TRANSFORMS
, /* tv_id */
602 ( PROP_cfg
| PROP_ssa
), /* properties_required */
603 0, /* properties_provided */
604 0, /* properties_destroyed */
605 0, /* todo_flags_start */
606 0, /* todo_flags_finish */
609 class pass_graphite_transforms
: public gimple_opt_pass
612 pass_graphite_transforms (gcc::context
*ctxt
)
613 : gimple_opt_pass (pass_data_graphite_transforms
, ctxt
)
616 /* opt_pass methods: */
617 bool gate (function
*) final override
{ return gate_graphite_transforms (); }
618 unsigned int execute (function
*fun
) final override
620 return graphite_transforms (fun
);
623 }; // class pass_graphite_transforms
628 make_pass_graphite_transforms (gcc::context
*ctxt
)
630 return new pass_graphite_transforms (ctxt
);