1 /* Gimple range phi analysis.
2 Copyright (C) 2023 Free Software Foundation, Inc.
3 Contributed by Andrew MacLeod <amacleod@redhat.com>.
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/>. */
23 #include "coretypes.h"
25 #include "insn-codes.h"
29 #include "gimple-pretty-print.h"
30 #include "gimple-range.h"
31 #include "gimple-range-cache.h"
32 #include "value-range-storage.h"
36 #include "gimple-iterator.h"
37 #include "gimple-walk.h"
40 // There can be only one running at a time.
41 static phi_analyzer
*phi_analysis_object
= NULL
;
43 // Initialize a PHI analyzer with range query Q.
46 phi_analysis_initialize (range_query
&q
)
48 gcc_checking_assert (!phi_analysis_object
);
49 phi_analysis_object
= new phi_analyzer (q
);
52 // Terminate the current PHI analyzer. if F is non-null, dump the tables
55 phi_analysis_finalize ()
57 gcc_checking_assert (phi_analysis_object
);
58 delete phi_analysis_object
;
59 phi_analysis_object
= NULL
;
62 // Return TRUE is there is a PHI analyzer operating.
64 phi_analysis_available_p ()
66 return phi_analysis_object
!= NULL
;
69 // Return the phi analyzer object.
71 phi_analyzer
&phi_analysis ()
73 gcc_checking_assert (phi_analysis_object
);
74 return *phi_analysis_object
;
77 // Initialize a phi_group from another group G.
79 phi_group::phi_group (const phi_group
&g
)
82 m_initial_value
= g
.m_initial_value
;
83 m_initial_edge
= g
.m_initial_edge
;
84 m_modifier
= g
.m_modifier
;
85 m_modifier_op
= g
.m_modifier_op
;
89 // Create a new phi_group with members BM, initialvalue INIT_VAL, modifier
90 // statement MOD, and resolve values using query Q.
91 // Calculate the range for the gropup if possible, otherwise set it to
94 phi_group::phi_group (bitmap bm
, tree init_val
, edge e
, gimple
*mod
,
97 // we dont expect a modifer and no inital value, so trap to have a look.
98 // perhaps they are dead cycles and we can just used UNDEFINED.
99 gcc_checking_assert (init_val
);
101 m_modifier_op
= is_modifier_p (mod
, bm
);
103 m_initial_value
= init_val
;
106 if (q
->range_on_edge (m_vr
, m_initial_edge
, m_initial_value
))
108 // No modifier means the initial range is the full range.
109 // Otherwise try to calculate a range.
110 if (!m_modifier_op
|| calculate_using_modifier (q
))
113 // Couldn't calculate a range, set to varying.
114 m_vr
.set_varying (TREE_TYPE (init_val
));
117 // Return 0 if S is not a modifier statment for group members BM.
118 // If it could be a modifier, return which operand position (1 or 2)
119 // the phi member occurs in.
121 phi_group::is_modifier_p (gimple
*s
, const bitmap bm
)
125 gimple_range_op_handler
handler (s
);
128 tree op1
= gimple_range_ssa_p (handler
.operand1 ());
129 tree op2
= gimple_range_ssa_p (handler
.operand2 ());
130 // Also disallow modifiers that have 2 ssa-names.
131 if (op1
&& !op2
&& bitmap_bit_p (bm
, SSA_NAME_VERSION (op1
)))
133 else if (op2
&& !op1
&& bitmap_bit_p (bm
, SSA_NAME_VERSION (op2
)))
139 // Calulcate the range of the phi group using range_query Q.
142 phi_group::calculate_using_modifier (range_query
*q
)
144 // Look at the modifier for any relation
145 relation_trio trio
= fold_relations (m_modifier
, q
);
146 relation_kind k
= VREL_VARYING
;
147 if (m_modifier_op
== 1)
149 else if (m_modifier_op
== 2)
154 // If we can resolve the range using relations, use that range.
155 if (refine_using_relation (k
, q
))
158 // If the initial value is undefined, do not calculate a range.
159 if (m_vr
.undefined_p ())
162 // Examine modifier and run X iterations to see if it convergences.
163 // The constructor initilaized m_vr to the initial value already.
165 for (unsigned x
= 0; x
< 10; x
++)
167 if (!fold_range (nv
, m_modifier
, m_vr
, q
))
169 // If they are equal, then we have convergence.
172 // Update range and try again.
175 // Never converged, so bail for now. we could examine the pattern
176 // from m_initial to m_vr as an extension Especially if we had a way
177 // to project the actual number of iterations (SCEV?)
179 // We can also try to identify "parallel" phis to get loop counts and
180 // determine the number of iterations of these parallel PHIs.
186 // IF the modifier statement has a relation K between the modifier and the
187 // PHI member in it, we can project a range based on that.
188 // Use range_query Q to resolve values.
189 // ie, a_2 = PHI <0, a_3> and a_3 = a_2 + 1
190 // if the relation a_3 > a_2 is present, the know the range is [0, +INF]
193 phi_group::refine_using_relation (relation_kind k
, range_query
*q
)
195 if (k
== VREL_VARYING
)
197 tree type
= TREE_TYPE (m_initial_value
);
198 // If the type wraps, then relations dont tell us much.
199 if (TYPE_OVERFLOW_WRAPS (type
))
207 // Value always decreases.
210 if (!q
->range_on_edge (ub
, m_initial_edge
, m_initial_value
))
212 if (ub
.undefined_p ())
214 lb
.set_varying (type
);
215 m_vr
.set (type
, lb
.lower_bound (), ub
.upper_bound ());
222 // Value always increases.
225 if (!q
->range_on_edge (lb
, m_initial_edge
, m_initial_value
))
227 if (lb
.undefined_p ())
229 ub
.set_varying (type
);
230 m_vr
.set (type
, lb
.lower_bound (), ub
.upper_bound ());
234 // If its always equal, then its simply the initial value.
235 // which is what m_vr has already been set to.
246 // Dump the information for a phi group to file F.
249 phi_group::dump (FILE *f
)
253 fprintf (f
, "PHI GROUP <");
255 EXECUTE_IF_SET_IN_BITMAP (m_group
, 0, i
, bi
)
257 print_generic_expr (f
, ssa_name (i
), TDF_SLIM
);
261 fprintf (f
, ">\n - Initial value : ");
264 if (TREE_CODE (m_initial_value
) == SSA_NAME
)
265 print_gimple_stmt (f
, SSA_NAME_DEF_STMT (m_initial_value
), 0, TDF_SLIM
);
267 print_generic_expr (f
, m_initial_value
, TDF_SLIM
);
268 fprintf (f
, " on edge %d->%d", m_initial_edge
->src
->index
,
269 m_initial_edge
->dest
->index
);
273 fprintf (f
, "\n - Modifier : ");
275 print_gimple_stmt (f
, m_modifier
, 0, TDF_SLIM
);
277 fprintf (f
, "NONE\n");
278 fprintf (f
, " - Range : ");
283 // -------------------------------------------------------------------------
285 // Construct a phi analyzer which uses range_query G to pick up values.
287 phi_analyzer::phi_analyzer (range_query
&g
) : m_global (g
)
290 m_work
.safe_grow (20);
293 // m_tab.safe_grow_cleared (num_ssa_names + 100);
294 bitmap_obstack_initialize (&m_bitmaps
);
295 m_simple
= BITMAP_ALLOC (&m_bitmaps
);
296 m_current
= BITMAP_ALLOC (&m_bitmaps
);
299 // Destruct a PHI analyzer.
301 phi_analyzer::~phi_analyzer ()
303 bitmap_obstack_release (&m_bitmaps
);
308 // Return the group, if any, that NAME is part of. Do no analysis.
311 phi_analyzer::group (tree name
) const
313 gcc_checking_assert (TREE_CODE (name
) == SSA_NAME
);
314 if (!is_a
<gphi
*> (SSA_NAME_DEF_STMT (name
)))
316 unsigned v
= SSA_NAME_VERSION (name
);
317 if (v
>= m_tab
.length ())
322 // Return the group NAME is associated with, if any. If name has not been
323 // procvessed yet, do the analysis to determine if it is part of a group
327 phi_analyzer::operator[] (tree name
)
329 gcc_checking_assert (TREE_CODE (name
) == SSA_NAME
);
331 // Initial support for irange only.
332 if (!irange::supports_p (TREE_TYPE (name
)))
334 if (!is_a
<gphi
*> (SSA_NAME_DEF_STMT (name
)))
337 unsigned v
= SSA_NAME_VERSION (name
);
338 // Already been processed and not part of a group.
339 if (bitmap_bit_p (m_simple
, v
))
342 if (v
>= m_tab
.length () || !m_tab
[v
])
344 process_phi (as_a
<gphi
*> (SSA_NAME_DEF_STMT (name
)));
345 if (bitmap_bit_p (m_simple
, v
))
347 // If m_simple bit isn't set, then process_phi allocated the table
348 // and should have a group.
349 gcc_checking_assert (v
< m_tab
.length ());
354 // Process phi node PHI to see if it it part of a group.
357 phi_analyzer::process_phi (gphi
*phi
)
359 gcc_checking_assert (!group (gimple_phi_result (phi
)));
362 // Start with the LHS of the PHI in the worklist.
365 m_work
.safe_push (gimple_phi_result (phi
));
366 bitmap_clear (m_current
);
368 // We can only have 2 externals: an initial value and a modifier.
369 // Any more than that and this fails to be a group.
370 unsigned m_num_extern
= 0;
374 while (m_work
.length () > 0)
376 tree phi_def
= m_work
.pop ();
377 gphi
*phi_stmt
= as_a
<gphi
*> (SSA_NAME_DEF_STMT (phi_def
));
378 // if the phi is already in a cycle, its a complex situation, so revert
385 bitmap_set_bit (m_current
, SSA_NAME_VERSION (phi_def
));
387 for (x
= 0; x
< gimple_phi_num_args (phi_stmt
); x
++)
389 tree arg
= gimple_phi_arg_def (phi_stmt
, x
);
392 enum tree_code code
= TREE_CODE (arg
);
393 if (code
== SSA_NAME
)
395 unsigned v
= SSA_NAME_VERSION (arg
);
396 // Already a member of this potential group.
397 if (bitmap_bit_p (m_current
, v
))
399 // Part of a different group ends cycle possibility.
400 if (group (arg
) || bitmap_bit_p (m_simple
, v
))
405 // Check if its a PHI to examine.
406 // *FIX* Will miss initial values that originate from a PHI.
407 gimple
*arg_stmt
= SSA_NAME_DEF_STMT (arg
);
408 if (arg_stmt
&& is_a
<gphi
*> (arg_stmt
))
410 m_work
.safe_push (arg
);
414 // Other non-ssa names that arent constants are not understood
415 // and terminate analysis.
416 else if (code
!= INTEGER_CST
&& code
!= REAL_CST
)
421 // More than 2 outside names/CONST is too complicated.
422 if (m_num_extern
>= 2)
428 m_external
[m_num_extern
] = arg
;
429 m_ext_edge
[m_num_extern
++] = gimple_phi_arg_edge (phi_stmt
, x
);
433 // If there are no names in the group, we're done.
434 if (bitmap_empty_p (m_current
))
442 signed init_idx
= -1;
443 // At this point all the PHIs have been added to the bitmap.
444 // the external list needs to be checked for initial values and modifiers.
445 for (x
= 0; x
< m_num_extern
; x
++)
447 tree name
= m_external
[x
];
448 if (TREE_CODE (name
) == SSA_NAME
449 && phi_group::is_modifier_p (SSA_NAME_DEF_STMT (name
), m_current
))
451 // Can't have multiple modifiers.
454 mod
= SSA_NAME_DEF_STMT (name
);
457 // Can't have 2 initializers either.
464 // Try to create a group based on m_current. If a result comes back
465 // with a range that isn't varying, create the group.
466 phi_group
cyc (m_current
, m_external
[init_idx
],
467 m_ext_edge
[init_idx
], mod
, &m_global
);
468 if (!cyc
.range ().varying_p ())
469 g
= new phi_group (cyc
);
472 // If this dpoesn;t form a group, all members are instead simple phis.
475 bitmap_ior_into (m_simple
, m_current
);
479 if (num_ssa_names
>= m_tab
.length ())
480 m_tab
.safe_grow_cleared (num_ssa_names
+ 100);
482 // Now set all entries in the group to this record.
485 EXECUTE_IF_SET_IN_BITMAP (m_current
, 0, i
, bi
)
487 // Can't be in more than one group.
488 gcc_checking_assert (m_tab
[i
] == NULL
);
491 // Allocate a new bitmap for the next time as the original one is now part
492 // of the new phi group.
493 m_current
= BITMAP_ALLOC (&m_bitmaps
);
497 phi_analyzer::dump (FILE *f
)
500 bitmap_clear (m_current
);
501 for (unsigned x
= 0; x
< m_tab
.length (); x
++)
503 if (bitmap_bit_p (m_simple
, x
))
505 if (bitmap_bit_p (m_current
, x
))
507 if (m_tab
[x
] == NULL
)
509 phi_group
*g
= m_tab
[x
];
510 bitmap_ior_into (m_current
, g
->group ());
514 fprintf (dump_file
, "\nPHI GROUPS:\n");