]> git.ipfire.org Git - thirdparty/gcc.git/blame - gcc/ipa-prop.h
Use value_range_base::num_pairs instead of vrp_val_is* to check if a range
[thirdparty/gcc.git] / gcc / ipa-prop.h
CommitLineData
518dc859 1/* Interprocedural analyses.
a5544970 2 Copyright (C) 2005-2019 Free Software Foundation, Inc.
518dc859
RL
3
4This file is part of GCC.
5
6GCC is free software; you can redistribute it and/or modify it under
7the terms of the GNU General Public License as published by the Free
9dcd6f09 8Software Foundation; either version 3, or (at your option) any later
518dc859
RL
9version.
10
11GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12WARRANTY; without even the implied warranty of MERCHANTABILITY or
13FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14for more details.
15
16You should have received a copy of the GNU General Public License
9dcd6f09
NC
17along with GCC; see the file COPYING3. If not see
18<http://www.gnu.org/licenses/>. */
518dc859
RL
19
20#ifndef IPA_PROP_H
21#define IPA_PROP_H
22
518dc859 23/* The following definitions and interfaces are used by
133f9369
MJ
24 interprocedural analyses or parameters. */
25
4502fe8d
MJ
26#define IPA_UNDESCRIBED_USE -1
27
133f9369 28/* ipa-prop.c stuff (ipa-cp, indirect inlining): */
518dc859 29
be95e2b9 30/* A jump function for a callsite represents the values passed as actual
310bc633
MJ
31 arguments of the callsite. They were originally proposed in a paper called
32 "Interprocedural Constant Propagation", by David Callahan, Keith D Cooper,
33 Ken Kennedy, Linda Torczon in Comp86, pg 152-161. There are three main
34 types of values :
685b0d13
MJ
35
36 Pass-through - the caller's formal parameter is passed as an actual
37 argument, possibly one simple operation performed on it.
38 Constant - a constant (is_gimple_ip_invariant)is passed as an actual
39 argument.
40 Unknown - neither of the above.
41
b258210c
MJ
42 IPA_JF_ANCESTOR is a special pass-through jump function, which means that
43 the result is an address of a part of the object pointed to by the formal
44 parameter to which the function refers. It is mainly intended to represent
026c3cfd 45 getting addresses of ancestor fields in C++
b258210c
MJ
46 (e.g. &this_1(D)->D.1766.D.1756). Note that if the original pointer is
47 NULL, ancestor jump function must behave like a simple pass-through.
48
49 Other pass-through functions can either simply pass on an unchanged formal
50 parameter or can apply one simple binary operation to it (such jump
51 functions are called polynomial).
52
b258210c
MJ
53 Jump functions are computed in ipa-prop.c by function
54 update_call_notes_after_inlining. Some information can be lost and jump
55 functions degraded accordingly when inlining, see
56 update_call_notes_after_inlining in the same file. */
685b0d13 57
518dc859
RL
58enum jump_func_type
59{
133f9369 60 IPA_JF_UNKNOWN = 0, /* newly allocated and zeroed jump functions default */
b258210c 61 IPA_JF_CONST, /* represented by field costant */
b258210c
MJ
62 IPA_JF_PASS_THROUGH, /* represented by field pass_through */
63 IPA_JF_ANCESTOR /* represented by field ancestor */
518dc859
RL
64};
65
4502fe8d
MJ
66struct ipa_cst_ref_desc;
67
68/* Structure holding data required to describe a constant jump function. */
69struct GTY(()) ipa_constant_data
70{
71 /* THe value of the constant. */
72 tree value;
73 /* Pointer to the structure that describes the reference. */
74 struct ipa_cst_ref_desc GTY((skip)) *rdesc;
75};
76
685b0d13
MJ
77/* Structure holding data required to describe a pass-through jump function. */
78
fb3f88cc 79struct GTY(()) ipa_pass_through_data
685b0d13
MJ
80{
81 /* If an operation is to be performed on the original parameter, this is the
82 second (constant) operand. */
83 tree operand;
84 /* Number of the caller's formal parameter being passed. */
85 int formal_id;
86 /* Operation that is performed on the argument before it is passed on.
87 NOP_EXPR means no operation. Otherwise oper must be a simple binary
88 arithmetic operation where the caller's parameter is the first operand and
89 operand field from this structure is the second one. */
90 enum tree_code operation;
8b7773a4
MJ
91 /* When the passed value is a pointer, it is set to true only when we are
92 certain that no write to the object it points to has occurred since the
93 caller functions started execution, except for changes noted in the
94 aggregate part of the jump function (see description of
95 ipa_agg_jump_function). The flag is used only when the operation is
96 NOP_EXPR. */
b8f6e610 97 unsigned agg_preserved : 1;
685b0d13
MJ
98};
99
b258210c
MJ
100/* Structure holding data required to describe an ancestor pass-through
101 jump function. */
685b0d13 102
fb3f88cc 103struct GTY(()) ipa_ancestor_jf_data
685b0d13
MJ
104{
105 /* Offset of the field representing the ancestor. */
106 HOST_WIDE_INT offset;
685b0d13
MJ
107 /* Number of the caller's formal parameter being passed. */
108 int formal_id;
8b7773a4 109 /* Flag with the same meaning like agg_preserve in ipa_pass_through_data. */
b8f6e610 110 unsigned agg_preserved : 1;
685b0d13
MJ
111};
112
8b7773a4
MJ
113/* An element in an aggegate part of a jump function describing a known value
114 at a given offset. When it is part of a pass-through jump function with
115 agg_preserved set or an ancestor jump function with agg_preserved set, all
116 unlisted positions are assumed to be preserved but the value can be a type
117 node, which means that the particular piece (starting at offset and having
118 the size of the type) is clobbered with an unknown value. When
119 agg_preserved is false or the type of the containing jump function is
120 different, all unlisted parts are assumed to be unknown and all values must
688010ba 121 fulfill is_gimple_ip_invariant. */
8b7773a4 122
84562394 123struct GTY(()) ipa_agg_jf_item
8b7773a4
MJ
124{
125 /* The offset at which the known value is located within the aggregate. */
126 HOST_WIDE_INT offset;
127
128 /* The known constant or type if this is a clobber. */
129 tree value;
84562394 130};
8b7773a4 131
8b7773a4
MJ
132
133/* Aggregate jump function - i.e. description of contents of aggregates passed
134 either by reference or value. */
135
136struct GTY(()) ipa_agg_jump_function
3e293154 137{
8b7773a4 138 /* Description of the individual items. */
84562394 139 vec<ipa_agg_jf_item, va_gc> *items;
8b7773a4
MJ
140 /* True if the data was passed by reference (as opposed to by value). */
141 bool by_ref;
3e293154
MJ
142};
143
8b7773a4 144typedef struct ipa_agg_jump_function *ipa_agg_jump_function_p;
8b7773a4 145
209ca542 146/* Information about zero/non-zero bits. */
6c1dae73 147class GTY(()) ipa_bits
209ca542 148{
6c1dae73 149public:
209ca542
PK
150 /* The propagated value. */
151 widest_int value;
152 /* Mask corresponding to the value.
153 Similar to ccp_lattice_t, if xth bit of mask is 0,
154 implies xth bit of value is constant. */
155 widest_int mask;
209ca542
PK
156};
157
8bc5448f 158/* Info about value ranges. */
86cd0334 159
6c1dae73 160class GTY(()) ipa_vr
8bc5448f 161{
6c1dae73 162public:
8bc5448f
KV
163 /* The data fields below are valid only if known is true. */
164 bool known;
54994253 165 enum value_range_kind type;
8bc5448f
KV
166 wide_int min;
167 wide_int max;
168};
169
be95e2b9
MJ
170/* A jump function for a callsite represents the values passed as actual
171 arguments of the callsite. See enum jump_func_type for the various
518dc859 172 types of jump functions supported. */
84562394 173struct GTY (()) ipa_jump_func
518dc859 174{
8b7773a4
MJ
175 /* Aggregate contants description. See struct ipa_agg_jump_function and its
176 description. */
177 struct ipa_agg_jump_function agg;
178
86cd0334
MJ
179 /* Information about zero/non-zero bits. The pointed to structure is shared
180 betweed different jump functions. Use ipa_set_jfunc_bits to set this
181 field. */
99b1c316 182 class ipa_bits *bits;
209ca542 183
a5e14a42 184 /* Information about value range, containing valid data only when vr_known is
86cd0334
MJ
185 true. The pointed to structure is shared betweed different jump
186 functions. Use ipa_set_jfunc_vr to set this field. */
99b1c316 187 class value_range_base *m_vr;
8bc5448f 188
518dc859 189 enum jump_func_type type;
fb3f88cc
JH
190 /* Represents a value of a jump function. pass_through is used only in jump
191 function context. constant represents the actual constant in constant jump
192 functions and member_cst holds constant c++ member functions. */
193 union jump_func_value
194 {
4502fe8d 195 struct ipa_constant_data GTY ((tag ("IPA_JF_CONST"))) constant;
fb3f88cc
JH
196 struct ipa_pass_through_data GTY ((tag ("IPA_JF_PASS_THROUGH"))) pass_through;
197 struct ipa_ancestor_jf_data GTY ((tag ("IPA_JF_ANCESTOR"))) ancestor;
fb3f88cc 198 } GTY ((desc ("%1.type"))) value;
84562394 199};
606d9a09 200
518dc859 201
7b872d9e
MJ
202/* Return the constant stored in a constant jump functin JFUNC. */
203
204static inline tree
205ipa_get_jf_constant (struct ipa_jump_func *jfunc)
206{
207 gcc_checking_assert (jfunc->type == IPA_JF_CONST);
4502fe8d
MJ
208 return jfunc->value.constant.value;
209}
210
211static inline struct ipa_cst_ref_desc *
212ipa_get_jf_constant_rdesc (struct ipa_jump_func *jfunc)
213{
214 gcc_checking_assert (jfunc->type == IPA_JF_CONST);
215 return jfunc->value.constant.rdesc;
7b872d9e
MJ
216}
217
218/* Return the operand of a pass through jmp function JFUNC. */
219
220static inline tree
221ipa_get_jf_pass_through_operand (struct ipa_jump_func *jfunc)
222{
223 gcc_checking_assert (jfunc->type == IPA_JF_PASS_THROUGH);
224 return jfunc->value.pass_through.operand;
225}
226
227/* Return the number of the caller's formal parameter that a pass through jump
228 function JFUNC refers to. */
229
230static inline int
231ipa_get_jf_pass_through_formal_id (struct ipa_jump_func *jfunc)
232{
233 gcc_checking_assert (jfunc->type == IPA_JF_PASS_THROUGH);
234 return jfunc->value.pass_through.formal_id;
235}
236
237/* Return operation of a pass through jump function JFUNC. */
238
239static inline enum tree_code
240ipa_get_jf_pass_through_operation (struct ipa_jump_func *jfunc)
241{
242 gcc_checking_assert (jfunc->type == IPA_JF_PASS_THROUGH);
243 return jfunc->value.pass_through.operation;
244}
245
b8f6e610 246/* Return the agg_preserved flag of a pass through jump function JFUNC. */
8b7773a4
MJ
247
248static inline bool
249ipa_get_jf_pass_through_agg_preserved (struct ipa_jump_func *jfunc)
250{
251 gcc_checking_assert (jfunc->type == IPA_JF_PASS_THROUGH);
252 return jfunc->value.pass_through.agg_preserved;
253}
254
44210a96
MJ
255/* Return true if pass through jump function JFUNC preserves type
256 information. */
b8f6e610
MJ
257
258static inline bool
259ipa_get_jf_pass_through_type_preserved (struct ipa_jump_func *jfunc)
260{
261 gcc_checking_assert (jfunc->type == IPA_JF_PASS_THROUGH);
44210a96 262 return jfunc->value.pass_through.agg_preserved;
b8f6e610
MJ
263}
264
7b872d9e
MJ
265/* Return the offset of an ancestor jump function JFUNC. */
266
267static inline HOST_WIDE_INT
268ipa_get_jf_ancestor_offset (struct ipa_jump_func *jfunc)
269{
270 gcc_checking_assert (jfunc->type == IPA_JF_ANCESTOR);
271 return jfunc->value.ancestor.offset;
272}
273
7b872d9e
MJ
274/* Return the number of the caller's formal parameter that an ancestor jump
275 function JFUNC refers to. */
276
277static inline int
278ipa_get_jf_ancestor_formal_id (struct ipa_jump_func *jfunc)
279{
280 gcc_checking_assert (jfunc->type == IPA_JF_ANCESTOR);
281 return jfunc->value.ancestor.formal_id;
282}
283
b8f6e610 284/* Return the agg_preserved flag of an ancestor jump function JFUNC. */
7b872d9e 285
8b7773a4
MJ
286static inline bool
287ipa_get_jf_ancestor_agg_preserved (struct ipa_jump_func *jfunc)
7b872d9e 288{
8b7773a4
MJ
289 gcc_checking_assert (jfunc->type == IPA_JF_ANCESTOR);
290 return jfunc->value.ancestor.agg_preserved;
7b872d9e
MJ
291}
292
44210a96 293/* Return true if ancestor jump function JFUNC presrves type information. */
b8f6e610
MJ
294
295static inline bool
296ipa_get_jf_ancestor_type_preserved (struct ipa_jump_func *jfunc)
297{
298 gcc_checking_assert (jfunc->type == IPA_JF_ANCESTOR);
44210a96 299 return jfunc->value.ancestor.agg_preserved;
b8f6e610
MJ
300}
301
310bc633 302/* Summary describing a single formal parameter. */
b258210c 303
f65f1ae3 304struct GTY(()) ipa_param_descriptor
f8e2a1ed 305{
209ca542
PK
306 /* In analysis and modification phase, this is the PARAM_DECL of this
307 parameter, in IPA LTO phase, this is the type of the the described
308 parameter or NULL if not known. Do not read this field directly but
309 through ipa_get_param and ipa_get_type as appropriate. */
310 tree decl_or_type;
4502fe8d
MJ
311 /* If all uses of the parameter are described by ipa-prop structures, this
312 says how many there are. If any use could not be described by means of
313 ipa-prop structures, this is IPA_UNDESCRIBED_USE. */
314 int controlled_uses;
0e8853ee 315 unsigned int move_cost : 31;
339f49ec
JH
316 /* The parameter is used. */
317 unsigned used : 1;
f8e2a1ed
MJ
318};
319
dcd416e3
MJ
320/* ipa_node_params stores information related to formal parameters of functions
321 and some other information for interprocedural passes that operate on
322 parameters (such as ipa-cp). */
310bc633 323
6c1dae73 324class GTY((for_user)) ipa_node_params
518dc859 325{
6c1dae73 326public:
e806796d
ML
327 /* Default constructor. */
328 ipa_node_params ();
329
330 /* Default destructor. */
331 ~ipa_node_params ();
332
310bc633
MJ
333 /* Information about individual formal parameters that are gathered when
334 summaries are generated. */
f65f1ae3 335 vec<ipa_param_descriptor, va_gc> *descriptors;
310bc633
MJ
336 /* Pointer to an array of structures describing individual formal
337 parameters. */
99b1c316 338 class ipcp_param_lattices * GTY((skip)) lattices;
310bc633
MJ
339 /* Only for versioned nodes this field would not be NULL,
340 it points to the node that IPA cp cloned from. */
f65f1ae3 341 struct cgraph_node * GTY((skip)) ipcp_orig_node;
44210a96
MJ
342 /* If this node is an ipa-cp clone, these are the known constants that
343 describe what it has been specialized for. */
f65f1ae3 344 vec<tree> GTY((skip)) known_csts;
44210a96
MJ
345 /* If this node is an ipa-cp clone, these are the known polymorphic contexts
346 that describe what it has been specialized for. */
f65f1ae3 347 vec<ipa_polymorphic_call_context> GTY((skip)) known_contexts;
8aab5218
MJ
348 /* Whether the param uses analysis and jump function computation has already
349 been performed. */
350 unsigned analysis_done : 1;
310bc633 351 /* Whether the function is enqueued in ipa-cp propagation stack. */
448f65db 352 unsigned node_enqueued : 1;
310bc633
MJ
353 /* Whether we should create a specialized version based on values that are
354 known to be constant in all contexts. */
eb20b778
MJ
355 unsigned do_clone_for_all_contexts : 1;
356 /* Set if this is an IPA-CP clone for all contexts. */
357 unsigned is_all_contexts_clone : 1;
310bc633
MJ
358 /* Node has been completely replaced by clones and will be removed after
359 ipa-cp is finished. */
360 unsigned node_dead : 1;
af21714c
MJ
361 /* Node is involved in a recursion, potentionally indirect. */
362 unsigned node_within_scc : 1;
363 /* Node is calling a private function called only once. */
364 unsigned node_calling_single_call : 1;
7e729474
ML
365 /* False when there is something makes versioning impossible. */
366 unsigned versionable : 1;
518dc859
RL
367};
368
e806796d
ML
369inline
370ipa_node_params::ipa_node_params ()
371: descriptors (NULL), lattices (NULL), ipcp_orig_node (NULL),
372 known_csts (vNULL), known_contexts (vNULL), analysis_done (0),
373 node_enqueued (0), do_clone_for_all_contexts (0), is_all_contexts_clone (0),
374 node_dead (0), node_within_scc (0), node_calling_single_call (0),
375 versionable (0)
376{
377}
378
379inline
380ipa_node_params::~ipa_node_params ()
381{
382 free (lattices);
383 known_csts.release ();
384 known_contexts.release ();
385}
386
ff302741
PB
387/* Intermediate information that we get from alias analysis about a particular
388 parameter in a particular basic_block. When a parameter or the memory it
56b40062
MJ
389 references is marked modified, we use that information in all dominated
390 blocks without consulting alias analysis oracle. */
ff302741 391
56b40062 392struct ipa_param_aa_status
ff302741
PB
393{
394 /* Set when this structure contains meaningful information. If not, the
395 structure describing a dominating BB should be used instead. */
396 bool valid;
397
398 /* Whether we have seen something which might have modified the data in
399 question. PARM is for the parameter itself, REF is for data it points to
400 but using the alias type of individual accesses and PT is the same thing
401 but for computing aggregate pass-through functions using a very inclusive
402 ao_ref. */
403 bool parm_modified, ref_modified, pt_modified;
404};
405
406/* Information related to a given BB that used only when looking at function
407 body. */
408
409struct ipa_bb_info
410{
411 /* Call graph edges going out of this BB. */
412 vec<cgraph_edge *> cg_edges;
413 /* Alias analysis statuses of each formal parameter at this bb. */
56b40062 414 vec<ipa_param_aa_status> param_aa_statuses;
ff302741
PB
415};
416
417/* Structure with global information that is only used when looking at function
418 body. */
419
56b40062 420struct ipa_func_body_info
ff302741
PB
421{
422 /* The node that is being analyzed. */
423 cgraph_node *node;
424
425 /* Its info. */
99b1c316 426 class ipa_node_params *info;
ff302741
PB
427
428 /* Information about individual BBs. */
429 vec<ipa_bb_info> bb_infos;
430
431 /* Number of parameters. */
432 int param_count;
433
c628d1c3
MJ
434 /* Number of statements we are still allowed to walked by when analyzing this
435 function. */
436 unsigned int aa_walk_budget;
ff302741
PB
437};
438
dcd416e3
MJ
439/* ipa_node_params access functions. Please use these to access fields that
440 are or will be shared among various passes. */
441
dcd416e3 442/* Return the number of formal parameters. */
be95e2b9 443
dcd416e3 444static inline int
99b1c316 445ipa_get_param_count (class ipa_node_params *info)
dcd416e3 446{
f65f1ae3 447 return vec_safe_length (info->descriptors);
dcd416e3
MJ
448}
449
f8e2a1ed
MJ
450/* Return the declaration of Ith formal parameter of the function corresponding
451 to INFO. Note there is no setter function as this array is built just once
209ca542
PK
452 using ipa_initialize_node_params. This function should not be called in
453 WPA. */
be95e2b9 454
dcd416e3 455static inline tree
99b1c316 456ipa_get_param (class ipa_node_params *info, int i)
dcd416e3 457{
f65f1ae3 458 gcc_checking_assert (info->descriptors);
0e8853ee 459 gcc_checking_assert (!flag_wpa);
f65f1ae3 460 tree t = (*info->descriptors)[i].decl_or_type;
209ca542
PK
461 gcc_checking_assert (TREE_CODE (t) == PARM_DECL);
462 return t;
463}
464
465/* Return the type of Ith formal parameter of the function corresponding
466 to INFO if it is known or NULL if not. */
467
468static inline tree
99b1c316 469ipa_get_type (class ipa_node_params *info, int i)
209ca542 470{
e5cf5e11
PK
471 if (vec_safe_length (info->descriptors) <= (unsigned) i)
472 return NULL;
f65f1ae3 473 tree t = (*info->descriptors)[i].decl_or_type;
209ca542
PK
474 if (!t)
475 return NULL;
476 if (TYPE_P (t))
477 return t;
478 gcc_checking_assert (TREE_CODE (t) == PARM_DECL);
479 return TREE_TYPE (t);
339f49ec
JH
480}
481
0e8853ee
JH
482/* Return the move cost of Ith formal parameter of the function corresponding
483 to INFO. */
484
485static inline int
99b1c316 486ipa_get_param_move_cost (class ipa_node_params *info, int i)
0e8853ee 487{
f65f1ae3
MJ
488 gcc_checking_assert (info->descriptors);
489 return (*info->descriptors)[i].move_cost;
0e8853ee
JH
490}
491
310bc633
MJ
492/* Set the used flag corresponding to the Ith formal parameter of the function
493 associated with INFO to VAL. */
3949c4a7 494
310bc633 495static inline void
99b1c316 496ipa_set_param_used (class ipa_node_params *info, int i, bool val)
3949c4a7 497{
f65f1ae3
MJ
498 gcc_checking_assert (info->descriptors);
499 (*info->descriptors)[i].used = val;
3949c4a7
MJ
500}
501
4502fe8d
MJ
502/* Return how many uses described by ipa-prop a parameter has or
503 IPA_UNDESCRIBED_USE if there is a use that is not described by these
504 structures. */
505static inline int
99b1c316 506ipa_get_controlled_uses (class ipa_node_params *info, int i)
4502fe8d 507{
f65f1ae3
MJ
508 /* FIXME: introducing speculation causes out of bounds access here. */
509 if (vec_safe_length (info->descriptors) > (unsigned)i)
510 return (*info->descriptors)[i].controlled_uses;
5ce97055 511 return IPA_UNDESCRIBED_USE;
4502fe8d
MJ
512}
513
514/* Set the controlled counter of a given parameter. */
515
516static inline void
99b1c316 517ipa_set_controlled_uses (class ipa_node_params *info, int i, int val)
4502fe8d 518{
f65f1ae3
MJ
519 gcc_checking_assert (info->descriptors);
520 (*info->descriptors)[i].controlled_uses = val;
4502fe8d
MJ
521}
522
310bc633
MJ
523/* Return the used flag corresponding to the Ith formal parameter of the
524 function associated with INFO. */
3949c4a7
MJ
525
526static inline bool
99b1c316 527ipa_is_param_used (class ipa_node_params *info, int i)
3949c4a7 528{
f65f1ae3
MJ
529 gcc_checking_assert (info->descriptors);
530 return (*info->descriptors)[i].used;
3949c4a7
MJ
531}
532
2c9561b5
MJ
533/* Information about replacements done in aggregates for a given node (each
534 node has its linked list). */
535struct GTY(()) ipa_agg_replacement_value
536{
537 /* Next item in the linked list. */
538 struct ipa_agg_replacement_value *next;
539 /* Offset within the aggregate. */
540 HOST_WIDE_INT offset;
541 /* The constant value. */
542 tree value;
543 /* The paramter index. */
544 int index;
7b920a9a
MJ
545 /* Whether the value was passed by reference. */
546 bool by_ref;
2c9561b5
MJ
547};
548
04be694e
MJ
549/* Structure holding information for the transformation phase of IPA-CP. */
550
9d3e0adc 551struct GTY(()) ipcp_transformation
04be694e
MJ
552{
553 /* Linked list of known aggregate values. */
554 ipa_agg_replacement_value *agg_values;
209ca542 555 /* Known bits information. */
86cd0334 556 vec<ipa_bits *, va_gc> *bits;
8bc5448f
KV
557 /* Value range information. */
558 vec<ipa_vr, va_gc> *m_vr;
04be694e 559};
2c9561b5
MJ
560
561void ipa_set_node_agg_value_chain (struct cgraph_node *node,
562 struct ipa_agg_replacement_value *aggvals);
9d3e0adc 563void ipcp_transformation_initialize (void);
12e088ba 564void ipcp_free_transformation_sum (void);
2c9561b5 565
93c594a3
MJ
566/* ipa_edge_args stores information related to a callsite and particularly its
567 arguments. It can be accessed by the IPA_EDGE_REF macro. */
6fe906a3
MJ
568
569class GTY((for_user)) ipa_edge_args
518dc859 570{
6fe906a3
MJ
571 public:
572
573 /* Default constructor. */
574 ipa_edge_args () : jump_functions (NULL), polymorphic_call_contexts (NULL)
575 {}
576
577 /* Destructor. */
578 ~ipa_edge_args ()
579 {
580 vec_free (jump_functions);
581 vec_free (polymorphic_call_contexts);
582 }
583
584 /* Vectors of the callsite's jump function and polymorphic context
585 information of each parameter. */
84562394 586 vec<ipa_jump_func, va_gc> *jump_functions;
5ce97055 587 vec<ipa_polymorphic_call_context, va_gc> *polymorphic_call_contexts;
84562394 588};
518dc859 589
dcd416e3
MJ
590/* ipa_edge_args access functions. Please use these to access fields that
591 are or will be shared among various passes. */
592
dcd416e3 593/* Return the number of actual arguments. */
be95e2b9 594
dcd416e3 595static inline int
99b1c316 596ipa_get_cs_argument_count (class ipa_edge_args *args)
dcd416e3 597{
9771b263 598 return vec_safe_length (args->jump_functions);
dcd416e3
MJ
599}
600
601/* Returns a pointer to the jump function for the ith argument. Please note
602 there is no setter function as jump functions are all set up in
603 ipa_compute_jump_functions. */
be95e2b9 604
dcd416e3 605static inline struct ipa_jump_func *
99b1c316 606ipa_get_ith_jump_func (class ipa_edge_args *args, int i)
dcd416e3 607{
9771b263 608 return &(*args->jump_functions)[i];
dcd416e3
MJ
609}
610
5ce97055
JH
611/* Returns a pointer to the polymorphic call context for the ith argument.
612 NULL if contexts are not computed. */
99b1c316
MS
613static inline class ipa_polymorphic_call_context *
614ipa_get_ith_polymorhic_call_context (class ipa_edge_args *args, int i)
5ce97055
JH
615{
616 if (!args->polymorphic_call_contexts)
617 return NULL;
618 return &(*args->polymorphic_call_contexts)[i];
619}
620
9a1e784a 621/* Function summary for ipa_node_params. */
f65f1ae3 622class GTY((user)) ipa_node_params_t: public function_summary <ipa_node_params *>
dd912cb8
ML
623{
624public:
f65f1ae3
MJ
625 ipa_node_params_t (symbol_table *table, bool ggc):
626 function_summary<ipa_node_params *> (table, ggc) { }
771578a0 627
dd912cb8
ML
628 /* Hook that is called by summary when a node is duplicated. */
629 virtual void duplicate (cgraph_node *node,
630 cgraph_node *node2,
631 ipa_node_params *data,
632 ipa_node_params *data2);
633};
634
6fe906a3
MJ
635/* Summary to manange ipa_edge_args structures. */
636
637class GTY((user)) ipa_edge_args_sum_t : public call_summary <ipa_edge_args *>
638{
639 public:
640 ipa_edge_args_sum_t (symbol_table *table, bool ggc)
641 : call_summary<ipa_edge_args *> (table, ggc) { }
642
643 /* Hook that is called by summary when an edge is duplicated. */
644 virtual void remove (cgraph_edge *cs, ipa_edge_args *args);
645 /* Hook that is called by summary when an edge is duplicated. */
646 virtual void duplicate (cgraph_edge *src,
647 cgraph_edge *dst,
648 ipa_edge_args *old_args,
649 ipa_edge_args *new_args);
650};
651
dd912cb8 652/* Function summary where the parameter infos are actually stored. */
f65f1ae3 653extern GTY(()) ipa_node_params_t * ipa_node_params_sum;
6fe906a3
MJ
654/* Call summary to store information about edges such as jump functions. */
655extern GTY(()) ipa_edge_args_sum_t *ipa_edge_args_sum;
f65f1ae3 656
9d3e0adc
ML
657/* Function summary for IPA-CP transformation. */
658class ipcp_transformation_t
659: public function_summary<ipcp_transformation *>
660{
661public:
662 ipcp_transformation_t (symbol_table *table, bool ggc):
663 function_summary<ipcp_transformation *> (table, ggc) {}
664
665 ~ipcp_transformation_t () {}
666
667 static ipcp_transformation_t *create_ggc (symbol_table *symtab)
668 {
669 ipcp_transformation_t *summary
670 = new (ggc_cleared_alloc <ipcp_transformation_t> ())
671 ipcp_transformation_t (symtab, true);
672 return summary;
673 }
674};
675
676/* Function summary where the IPA CP transformations are actually stored. */
677extern GTY(()) function_summary <ipcp_transformation *> *ipcp_transformation_sum;
f65f1ae3 678
771578a0
MJ
679/* Return the associated parameter/argument info corresponding to the given
680 node/edge. */
99353fcf
ML
681#define IPA_NODE_REF(NODE) (ipa_node_params_sum->get_create (NODE))
682#define IPA_EDGE_REF(EDGE) (ipa_edge_args_sum->get_create (EDGE))
771578a0
MJ
683/* This macro checks validity of index returned by
684 ipa_get_param_decl_index function. */
685#define IS_VALID_JUMP_FUNC_INDEX(I) ((I) != -1)
686
687/* Creating and freeing ipa_node_params and ipa_edge_args. */
688void ipa_create_all_node_params (void);
689void ipa_create_all_edge_args (void);
86cd0334 690void ipa_check_create_edge_args (void);
771578a0
MJ
691void ipa_free_all_node_params (void);
692void ipa_free_all_edge_args (void);
e33c6cd6
MJ
693void ipa_free_all_structures_after_ipa_cp (void);
694void ipa_free_all_structures_after_iinln (void);
dd912cb8 695
771578a0 696void ipa_register_cgraph_hooks (void);
fd29c024 697int count_formal_params (tree fndecl);
771578a0
MJ
698
699/* This function ensures the array of node param infos is big enough to
be95e2b9
MJ
700 accommodate a structure for all nodes and reallocates it if not. */
701
771578a0
MJ
702static inline void
703ipa_check_create_node_params (void)
704{
dd912cb8 705 if (!ipa_node_params_sum)
f65f1ae3
MJ
706 ipa_node_params_sum
707 = (new (ggc_cleared_alloc <ipa_node_params_t> ())
708 ipa_node_params_t (symtab, true));
771578a0
MJ
709}
710
6fe906a3
MJ
711/* Returns true if edge summary contains a record for EDGE. The main purpose
712 of this function is that debug dumping function can check info availability
713 without causing allocations. */
be95e2b9 714
0eae6bab
MJ
715static inline bool
716ipa_edge_args_info_available_for_edge_p (struct cgraph_edge *edge)
717{
6fe906a3 718 return ipa_edge_args_sum->exists (edge);
0eae6bab
MJ
719}
720
9d3e0adc 721static inline ipcp_transformation *
04be694e
MJ
722ipcp_get_transformation_summary (cgraph_node *node)
723{
9d3e0adc 724 if (ipcp_transformation_sum == NULL)
04be694e 725 return NULL;
9d3e0adc
ML
726
727 return ipcp_transformation_sum->get (node);
04be694e
MJ
728}
729
2c9561b5
MJ
730/* Return the aggregate replacements for NODE, if there are any. */
731
732static inline struct ipa_agg_replacement_value *
04be694e 733ipa_get_agg_replacements_for_node (cgraph_node *node)
2c9561b5 734{
9d3e0adc 735 ipcp_transformation *ts = ipcp_get_transformation_summary (node);
04be694e 736 return ts ? ts->agg_values : NULL;
2c9561b5
MJ
737}
738
f8e2a1ed
MJ
739/* Function formal parameters related computations. */
740void ipa_initialize_node_params (struct cgraph_node *node);
f8e2a1ed 741bool ipa_propagate_indirect_call_infos (struct cgraph_edge *cs,
d52f5295 742 vec<cgraph_edge *> *new_edges);
518dc859 743
3949c4a7 744/* Indirect edge and binfo processing. */
d2d668fb 745tree ipa_get_indirect_edge_target (struct cgraph_edge *ie,
9771b263 746 vec<tree> ,
44210a96 747 vec<ipa_polymorphic_call_context>,
231b4916
JH
748 vec<ipa_agg_jump_function_p>,
749 bool *);
5ce97055
JH
750struct cgraph_edge *ipa_make_edge_direct_to_target (struct cgraph_edge *, tree,
751 bool speculative = false);
72972c22 752tree ipa_impossible_devirt_target (struct cgraph_edge *, tree);
86cd0334
MJ
753ipa_bits *ipa_get_ipa_bits_for_value (const widest_int &value,
754 const widest_int &mask);
755
3949c4a7 756
310bc633
MJ
757/* Functions related to both. */
758void ipa_analyze_node (struct cgraph_node *);
3949c4a7 759
8b7773a4 760/* Aggregate jump function related functions. */
91bb9f80
MJ
761tree ipa_find_agg_cst_for_param (struct ipa_agg_jump_function *agg, tree scalar,
762 HOST_WIDE_INT offset, bool by_ref,
763 bool *from_global_constant = NULL);
764bool ipa_load_from_parm_agg (struct ipa_func_body_info *fbi,
f65f1ae3 765 vec<ipa_param_descriptor, va_gc> *descriptors,
91bb9f80 766 gimple *stmt, tree op, int *index_p,
86003645 767 HOST_WIDE_INT *offset_p, poly_int64 *size_p,
91bb9f80 768 bool *by_ref, bool *guaranteed_unmodified = NULL);
8b7773a4 769
518dc859 770/* Debugging interface. */
ca30a539
JH
771void ipa_print_node_params (FILE *, struct cgraph_node *node);
772void ipa_print_all_params (FILE *);
3e293154
MJ
773void ipa_print_node_jump_functions (FILE *f, struct cgraph_node *node);
774void ipa_print_all_jump_functions (FILE * f);
310bc633
MJ
775void ipcp_verify_propagated_values (void);
776
2651e637
ML
777template <typename value>
778class ipcp_value;
779
fb0b2914
ML
780extern object_allocator<ipcp_value<tree> > ipcp_cst_values_pool;
781extern object_allocator<ipcp_value<ipa_polymorphic_call_context> >
2651e637
ML
782 ipcp_poly_ctx_values_pool;
783
784template <typename valtype>
99b1c316 785struct ipcp_value_source;
2651e637 786
fb0b2914 787extern object_allocator<ipcp_value_source<tree> > ipcp_sources_pool;
2651e637 788
99b1c316 789struct ipcp_agg_lattice;
2651e637 790
fb0b2914 791extern object_allocator<ipcp_agg_lattice> ipcp_agg_lattice_pool;
518dc859 792
2c9561b5
MJ
793void ipa_dump_agg_replacement_values (FILE *f,
794 struct ipa_agg_replacement_value *av);
f27c1867 795void ipa_prop_write_jump_functions (void);
fb3f88cc 796void ipa_prop_read_jump_functions (void);
04be694e
MJ
797void ipcp_write_transformation_summaries (void);
798void ipcp_read_transformation_summaries (void);
99b1c316
MS
799int ipa_get_param_decl_index (class ipa_node_params *, tree);
800tree ipa_value_from_jfunc (class ipa_node_params *info,
e5cf5e11 801 struct ipa_jump_func *jfunc, tree type);
2c9561b5 802unsigned int ipcp_transform_function (struct cgraph_node *node);
44210a96
MJ
803ipa_polymorphic_call_context ipa_context_from_jfunc (ipa_node_params *,
804 cgraph_edge *,
805 int,
806 ipa_jump_func *);
99b1c316 807void ipa_dump_param (FILE *, class ipa_node_params *info, int i);
c3431191 808void ipa_release_body_info (struct ipa_func_body_info *);
5d5f1e95 809tree ipa_get_callee_param_type (struct cgraph_edge *e, int i);
fb3f88cc 810
3f84bf08 811/* From tree-sra.c: */
f7ed3195 812tree build_ref_for_offset (location_t, tree, poly_int64, bool, tree,
e4b5cace 813 gimple_stmt_iterator *, bool);
3f84bf08 814
3edf64aa
DM
815/* In ipa-cp.c */
816void ipa_cp_c_finalize (void);
817
518dc859 818#endif /* IPA_PROP_H */