1 /* Loop unroll-and-jam.
2 Copyright (C) 2017-2023 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it
7 under the terms of the GNU General Public License as published by the
8 Free Software Foundation; either version 3, or (at your option) any
11 GCC is distributed in the hope that it will be useful, but WITHOUT
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
22 #include "coretypes.h"
23 #include "tree-pass.h"
28 #include "fold-const.h"
31 #include "tree-ssa-loop-niter.h"
32 #include "tree-ssa-loop.h"
33 #include "tree-ssa-loop-manip.h"
35 #include "tree-scalar-evolution.h"
36 #include "gimple-iterator.h"
38 #include "tree-data-ref.h"
39 #include "tree-ssa-loop-ivopts.h"
40 #include "tree-vectorizer.h"
41 #include "tree-ssa-sccvn.h"
42 #include "tree-cfgcleanup.h"
44 /* Unroll and Jam transformation
46 This is a combination of two transformations, where the second
47 is not always valid. It's applicable if a loop nest has redundancies
48 over the iterations of an outer loop while not having that with
68 then fuse the two adjacent inner loops resulting from that:
76 As the order of evaluations of the body B changes this is valid
77 only in certain situations: all distance vectors need to be forward.
78 Additionally if there are multiple induction variables than just
79 a counting control IV (j above) we can also deal with some situations.
81 The validity is checked by unroll_jam_possible_p, and the data-dep
84 A trivial example where the fusion is wrong would be when
85 B(i,j) == x[j-1] = x[j];
93 } effect: move content to front by two elements
100 } effect: move content to front by one element
103 /* Modify the loop tree for the fact that all code once belonging
104 to the OLD loop or the outer loop of OLD now is inside LOOP. */
107 merge_loop_tree (class loop
*loop
, class loop
*old
)
115 /* Find its nodes. */
116 bbs
= XNEWVEC (basic_block
, n_basic_blocks_for_fn (cfun
));
117 n
= get_loop_body_with_size (loop
, bbs
, n_basic_blocks_for_fn (cfun
));
119 for (i
= 0; i
< n
; i
++)
121 /* If the block was direct child of OLD loop it's now part
122 of LOOP. If it was outside OLD, then it moved into LOOP
123 as well. This avoids changing the loop father for BBs
124 in inner loops of OLD. */
125 if (bbs
[i
]->loop_father
== old
126 || loop_depth (bbs
[i
]->loop_father
) < loop_depth (old
))
128 remove_bb_from_loops (bbs
[i
]);
129 add_bb_to_loop (bbs
[i
], loop
);
133 /* If we find a direct subloop of OLD, move it to LOOP. */
134 subloop
= bbs
[i
]->loop_father
;
135 if (loop_outer (subloop
) == old
&& subloop
->header
== bbs
[i
])
137 flow_loop_tree_node_remove (subloop
);
138 flow_loop_tree_node_add (loop
, subloop
);
142 /* Update the information about loop exit edges. */
143 for (i
= 0; i
< n
; i
++)
145 FOR_EACH_EDGE (e
, ei
, bbs
[i
]->succs
)
147 rescan_loop_exit (e
, false, false);
156 /* BB is part of the outer loop of an unroll-and-jam situation.
157 Check if any statements therein would prevent the transformation. */
160 bb_prevents_fusion_p (basic_block bb
)
162 gimple_stmt_iterator gsi
;
163 /* BB is duplicated by outer unrolling and then all N-1 first copies
164 move into the body of the fused inner loop. If BB exits the outer loop
165 the last copy still does so, and the first N-1 copies are cancelled
166 by loop unrolling, so also after fusion it's the exit block.
167 But there might be other reasons that prevent fusion:
168 * stores or unknown side-effects prevent fusion
170 * computations into SSA names: these aren't problematic. Their
171 result will be unused on the exit edges of the first N-1 copies
172 (those aren't taken after unrolling). If they are used on the
173 other edge (the one leading to the outer latch block) they are
174 loop-carried (on the outer loop) and the Nth copy of BB will
175 compute them again (i.e. the first N-1 copies will be dead). */
176 for (gsi
= gsi_start_bb (bb
); !gsi_end_p (gsi
); gsi_next (&gsi
))
178 gimple
*g
= gsi_stmt (gsi
);
179 if (gimple_vdef (g
) || gimple_has_side_effects (g
))
185 /* Given an inner loop LOOP (of some OUTER loop) determine if
186 we can safely fuse copies of it (generated by outer unrolling).
187 If so return true, otherwise return false. */
190 unroll_jam_possible_p (class loop
*outer
, class loop
*loop
)
194 class tree_niter_desc niter
;
196 /* When fusing the loops we skip the latch block
197 of the first one, so it mustn't have any effects to
199 if (!empty_block_p (loop
->latch
))
203 if (!(exit
= single_exit (loop
)))
206 /* We need a perfect nest. Quick check for adjacent inner loops. */
207 if (outer
->inner
!= loop
|| loop
->next
)
210 /* Prevent head-controlled inner loops, that we usually have.
211 The guard block would need to be accepted
212 (invariant condition either entering or skipping the loop),
213 without also accepting arbitrary control flow. When unswitching
214 ran before us (as with -O3) this won't be a problem because its
215 outer loop unswitching will have moved out the invariant condition.
217 If we do that we need to extend fuse_loops() to cope with this
218 by threading through the (still invariant) copied condition
219 between the two loop copies. */
220 if (!dominated_by_p (CDI_DOMINATORS
, outer
->latch
, loop
->header
))
223 /* The number of iterations of the inner loop must be loop invariant
224 with respect to the outer loop. */
225 if (!number_of_iterations_exit (loop
, single_exit (loop
), &niter
,
227 || niter
.cmp
== ERROR_MARK
228 || !integer_zerop (niter
.may_be_zero
)
229 || !expr_invariant_in_loop_p (outer
, niter
.niter
))
232 /* If the inner loop produces any values that are used inside the
233 outer loop (except the virtual op) then it can flow
234 back (perhaps indirectly) into the inner loop. This prevents
235 fusion: without fusion the value at the last iteration is used,
236 with fusion the value after the initial iteration is used.
238 If all uses are outside the outer loop this doesn't prevent fusion;
239 the value of the last iteration is still used (and the values from
240 all intermediate iterations are dead). */
242 for (psi
= gsi_start_phis (single_exit (loop
)->dest
);
243 !gsi_end_p (psi
); gsi_next (&psi
))
245 imm_use_iterator imm_iter
;
247 tree op
= gimple_phi_result (psi
.phi ());
248 if (virtual_operand_p (op
))
250 FOR_EACH_IMM_USE_FAST (use_p
, imm_iter
, op
)
252 gimple
*use_stmt
= USE_STMT (use_p
);
253 if (!is_gimple_debug (use_stmt
)
254 && flow_bb_inside_loop_p (outer
, gimple_bb (use_stmt
)))
259 /* And check blocks belonging to just outer loop. */
260 bbs
= XNEWVEC (basic_block
, n_basic_blocks_for_fn (cfun
));
261 n
= get_loop_body_with_size (outer
, bbs
, n_basic_blocks_for_fn (cfun
));
263 for (i
= 0; i
< n
; i
++)
264 if (bbs
[i
]->loop_father
== outer
265 && (bb_prevents_fusion_p (bbs
[i
])
266 /* Outer loop exits must come after the inner loop, otherwise
267 we'll put the outer loop exit into the fused inner loop. */
268 || (loop_exits_from_bb_p (outer
, bbs
[i
])
269 && !dominated_by_p (CDI_DOMINATORS
, bbs
[i
], exit
->src
))))
275 /* For now we can safely fuse copies of LOOP only if all
276 loop carried variables are inductions (or the virtual op).
278 We could handle reductions as well (the initial value in the second
279 body would be the after-iter value of the first body) if it's over
280 an associative and commutative operation. We wouldn't
281 be able to handle unknown cycles. */
282 for (psi
= gsi_start_phis (loop
->header
); !gsi_end_p (psi
); gsi_next (&psi
))
285 tree op
= gimple_phi_result (psi
.phi ());
287 if (virtual_operand_p (op
))
289 if (!simple_iv (loop
, loop
, op
, &iv
, true))
291 /* The inductions must be regular, loop invariant step and initial
293 if (!expr_invariant_in_loop_p (outer
, iv
.step
)
294 || !expr_invariant_in_loop_p (outer
, iv
.base
))
296 /* XXX With more effort we could also be able to deal with inductions
297 where the initial value is loop variant but a simple IV in the
298 outer loop. The initial value for the second body would be
299 the original initial value plus iv.base.step. The next value
300 for the fused loop would be the original next value of the first
301 copy, _not_ the next value of the second body. */
307 /* Fuse LOOP with all further neighbors. The loops are expected to
308 be in appropriate form. */
311 fuse_loops (class loop
*loop
)
313 class loop
*next
= loop
->next
;
319 remove_branch (single_pred_edge (loop
->latch
));
320 /* Make delete_basic_block not fiddle with the loop structure. */
321 basic_block oldlatch
= loop
->latch
;
323 delete_basic_block (oldlatch
);
324 e
= redirect_edge_and_branch (loop_latch_edge (next
),
326 loop
->latch
= e
->src
;
327 flush_pending_stmts (e
);
329 gcc_assert (EDGE_COUNT (next
->header
->preds
) == 1);
331 /* The PHI nodes of the second body (single-argument now)
332 need adjustments to use the right values: either directly
333 the value of the corresponding PHI in the first copy or
334 the one leaving the first body which unrolling did for us.
336 See also unroll_jam_possible_p() for further possibilities. */
337 gphi_iterator psi_first
, psi_second
;
338 e
= single_pred_edge (next
->header
);
339 for (psi_first
= gsi_start_phis (loop
->header
),
340 psi_second
= gsi_start_phis (next
->header
);
341 !gsi_end_p (psi_first
);
342 gsi_next (&psi_first
), gsi_next (&psi_second
))
344 gphi
*phi_first
= psi_first
.phi ();
345 gphi
*phi_second
= psi_second
.phi ();
346 tree firstop
= gimple_phi_result (phi_first
);
347 /* The virtual operand is correct already as it's
348 always live at exit, hence has a LCSSA node and outer
349 loop unrolling updated SSA form. */
350 if (virtual_operand_p (firstop
))
353 /* Due to unroll_jam_possible_p() we know that this is
354 an induction. The second body goes over the same
356 add_phi_arg (phi_second
, firstop
, e
,
357 gimple_location (phi_first
));
359 gcc_assert (gsi_end_p (psi_second
));
361 merge_loop_tree (loop
, next
);
362 gcc_assert (!next
->num_nodes
);
363 class loop
*ln
= next
->next
;
369 /* Return true if any of the access functions for dataref A
370 isn't invariant with respect to loop LOOP_NEST. */
372 any_access_function_variant_p (const struct data_reference
*a
,
373 const class loop
*loop_nest
)
375 vec
<tree
> fns
= DR_ACCESS_FNS (a
);
378 if (!evolution_function_is_invariant_p (t
, loop_nest
->num
))
384 /* Returns true if the distance in DDR can be determined and adjusts
385 the unroll factor in *UNROLL to make unrolling valid for that distance.
386 Otherwise return false. DDR is with respect to the outer loop of INNER.
388 If this data dep can lead to a removed memory reference, increment
389 *REMOVED and adjust *PROFIT_UNROLL to be the necessary unroll factor
390 for this to happen. */
393 adjust_unroll_factor (class loop
*inner
, struct data_dependence_relation
*ddr
,
394 unsigned *unroll
, unsigned *profit_unroll
,
398 if (DDR_ARE_DEPENDENT (ddr
) != chrec_known
)
400 if (DDR_NUM_DIST_VECTS (ddr
) == 0)
403 lambda_vector dist_v
;
404 FOR_EACH_VEC_ELT (DDR_DIST_VECTS (ddr
), i
, dist_v
)
406 /* A distance (a,b) is at worst transformed into (a/N,b) by the
407 unrolling (factor N), so the transformation is valid if
408 a >= N, or b > 0, or b is zero and a > 0. Otherwise the unroll
409 factor needs to be limited so that the first condition holds.
410 That may limit the factor down to zero in the worst case. */
411 lambda_int dist
= dist_v
[0];
414 else if (dist
>= (lambda_int
)*unroll
)
416 else if (lambda_vector_zerop (dist_v
+ 1, DDR_NB_LOOPS (ddr
) - 1))
418 /* We have (a,0) with a < N, so this will be transformed into
419 (0,0) after unrolling by N. This might potentially be a
420 problem, if it's not a read-read dependency. */
421 if (DR_IS_READ (DDR_A (ddr
)) && DR_IS_READ (DDR_B (ddr
)))
425 /* So, at least one is a write, and we might reduce the
426 distance vector to (0,0). This is still no problem
427 if both data-refs are affine with respect to the inner
428 loops. But if one of them is invariant with respect
429 to an inner loop our reordering implicit in loop fusion
430 corrupts the program, as our data dependences don't
431 capture this. E.g. for:
434 a[i][0] = a[i+1][0] + 2; // (1)
435 b[i][j] = b[i+1][j] + 2; // (2)
436 the distance vector for both statements is (-1,0),
437 but exchanging the order for (2) is okay, while
438 for (1) it is not. To see this, write out the original
439 accesses (assume m is 2):
441 0 0 0 r a[1][0] b[1][0]
442 1 0 0 w a[0][0] b[0][0]
443 2 0 1 r a[1][0] b[1][1]
444 3 0 1 w a[0][0] b[0][1]
445 4 1 0 r a[2][0] b[2][0]
446 5 1 0 w a[1][0] b[1][0]
447 after unroll-by-2 and fusion the accesses are done in
448 this order (from column a): 0,1, 4,5, 2,3, i.e. this:
450 0 0 0 r a[1][0] b[1][0]
451 1 0 0 w a[0][0] b[0][0]
452 4 1 0 r a[2][0] b[2][0]
453 5 1 0 w a[1][0] b[1][0]
454 2 0 1 r a[1][0] b[1][1]
455 3 0 1 w a[0][0] b[0][1]
456 Note how access 2 accesses the same element as access 5
457 for array 'a' but not for array 'b'. */
458 if (any_access_function_variant_p (DDR_A (ddr
), inner
)
459 && any_access_function_variant_p (DDR_B (ddr
), inner
))
462 /* And if any dataref of this pair is invariant with
463 respect to the inner loop, we have no chance than
464 to reduce the unroll factor. */
468 else if (lambda_vector_lexico_pos (dist_v
+ 1, DDR_NB_LOOPS (ddr
) - 1))
473 /* With a distance (a,0) it's always profitable to unroll-and-jam
474 (by a+1), because one memory reference will go away. With
475 (a,b) and b != 0 that's less clear. We will increase the
476 number of streams without lowering the number of mem refs.
477 So for now only handle the first situation. */
478 if (lambda_vector_zerop (dist_v
+ 1, DDR_NB_LOOPS (ddr
) - 1))
480 *profit_unroll
= MAX (*profit_unroll
, (unsigned)dist
+ 1);
490 /* Main entry point for the unroll-and-jam transformation
494 tree_loop_unroll_and_jam (void)
496 unsigned int todo
= 0;
498 gcc_assert (scev_initialized_p ());
500 /* Go through all innermost loops. */
501 for (auto loop
: loops_list (cfun
, LI_ONLY_INNERMOST
))
503 class loop
*outer
= loop_outer (loop
);
505 if (loop_depth (loop
) < 2
506 || optimize_loop_nest_for_size_p (outer
))
509 if (!unroll_jam_possible_p (outer
, loop
))
512 vec
<data_reference_p
> datarefs
= vNULL
;
513 vec
<ddr_p
> dependences
= vNULL
;
514 unsigned unroll_factor
, profit_unroll
, removed
;
515 class tree_niter_desc desc
;
518 auto_vec
<loop_p
, 3> loop_nest
;
519 if (!compute_data_dependences_for_loop (outer
, true, &loop_nest
,
520 &datarefs
, &dependences
))
522 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
523 fprintf (dump_file
, "Cannot analyze data dependencies\n");
524 free_data_refs (datarefs
);
525 free_dependence_relations (dependences
);
528 if (!datarefs
.length ())
531 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
532 dump_data_dependence_relations (dump_file
, dependences
);
534 unroll_factor
= (unsigned)-1;
538 /* Check all dependencies. */
540 struct data_dependence_relation
*ddr
;
541 FOR_EACH_VEC_ELT (dependences
, i
, ddr
)
543 struct data_reference
*dra
, *drb
;
545 /* If the refs are independend there's nothing to do. */
546 if (DDR_ARE_DEPENDENT (ddr
) == chrec_known
)
552 /* Nothing interesting for the self dependencies, except for WAW if
553 the access function is not affine or constant because we may end
554 up reordering writes to the same location. */
557 if (DR_IS_WRITE (dra
)
558 && !DR_ACCESS_FNS (dra
).is_empty ()
559 && DDR_ARE_DEPENDENT (ddr
) == chrec_dont_know
)
568 /* Now check the distance vector, for determining a sensible
569 outer unroll factor, and for validity of merging the inner
571 if (!adjust_unroll_factor (loop
, ddr
, &unroll_factor
, &profit_unroll
,
574 /* Couldn't get the distance vector. For two reads that's
575 harmless (we assume we should unroll). For at least
576 one write this means we can't check the dependence direction
577 and hence can't determine safety. */
579 if (DR_IS_WRITE (dra
) || DR_IS_WRITE (drb
))
587 /* We regard a user-specified minimum percentage of zero as a request
588 to ignore all profitability concerns and apply the transformation
590 if (!param_unroll_jam_min_percent
)
591 profit_unroll
= MAX(2, profit_unroll
);
592 else if (removed
* 100 / datarefs
.length ()
593 < (unsigned)param_unroll_jam_min_percent
)
595 if (unroll_factor
> profit_unroll
)
596 unroll_factor
= profit_unroll
;
597 if (unroll_factor
> (unsigned)param_unroll_jam_max_unroll
)
598 unroll_factor
= param_unroll_jam_max_unroll
;
599 unroll
= (unroll_factor
> 1
600 && can_unroll_loop_p (outer
, unroll_factor
, &desc
));
604 if (dump_enabled_p ())
605 dump_printf_loc (MSG_OPTIMIZED_LOCATIONS
| TDF_DETAILS
,
606 find_loop_location (outer
),
607 "applying unroll and jam with factor %d\n",
609 initialize_original_copy_tables ();
610 tree_unroll_loop (outer
, unroll_factor
, &desc
);
611 free_original_copy_tables ();
612 fuse_loops (outer
->inner
);
613 todo
|= TODO_cleanup_cfg
;
615 auto_bitmap exit_bbs
;
616 bitmap_set_bit (exit_bbs
, single_exit (outer
)->dest
->index
);
617 todo
|= do_rpo_vn (cfun
, loop_preheader_edge (outer
), exit_bbs
);
620 loop_nest
.release ();
621 free_dependence_relations (dependences
);
622 free_data_refs (datarefs
);
627 free_dominance_info (CDI_DOMINATORS
);
628 /* We need to cleanup the CFG first since otherwise SSA form can
629 be not up-to-date from the VN run. */
630 if (todo
& TODO_cleanup_cfg
)
633 todo
&= ~TODO_cleanup_cfg
;
635 rewrite_into_loop_closed_ssa (NULL
, 0);
641 /* Pass boilerplate */
645 const pass_data pass_data_loop_jam
=
647 GIMPLE_PASS
, /* type */
648 "unrolljam", /* name */
649 OPTGROUP_LOOP
, /* optinfo_flags */
650 TV_LOOP_JAM
, /* tv_id */
651 PROP_cfg
, /* properties_required */
652 0, /* properties_provided */
653 0, /* properties_destroyed */
654 0, /* todo_flags_start */
655 0, /* todo_flags_finish */
658 class pass_loop_jam
: public gimple_opt_pass
661 pass_loop_jam (gcc::context
*ctxt
)
662 : gimple_opt_pass (pass_data_loop_jam
, ctxt
)
665 /* opt_pass methods: */
666 bool gate (function
*) final override
{ return flag_unroll_jam
!= 0; }
667 unsigned int execute (function
*) final override
;
672 pass_loop_jam::execute (function
*fun
)
674 if (number_of_loops (fun
) <= 1)
677 return tree_loop_unroll_and_jam ();
683 make_pass_loop_jam (gcc::context
*ctxt
)
685 return new pass_loop_jam (ctxt
);