/* Manipulation of formal and actual parameters of functions and function
calls.
Copyright (C) 2017-2020 Free Software Foundation, Inc.
This file is part of GCC.
GCC is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 3, or (at your option) any later
version.
GCC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with GCC; see the file COPYING3. If not see
.
This file defines classes and other data structures that are used to manipulate
the prototype of a function, especially to create, remove or split its formal
parameters, but also to remove its return value, and also its call statements
correspondingly.
The most basic one is a vector of structures ipa_adjusted_param. It is simply
a description how the new parameters should look like after the transformation
in what way they relate to the previous ones (if in any). Such relation to an
old parameter can be an outright copy or an IPA-SRA replacement. If an old
parameter is not listed or otherwise mentioned, it is removed as unused or at
least unnecessary. Note that this most basic structure does not work for
modifying calls of functions with variable number of arguments.
Class ipa_param_adjustments is only a little more than a thin encapsulation of
a vector of ipa_param_adjustments. Along with this vector it contains an index
of the first potential vararg argument and a boolean flag whether the return
value should be removed or not. Moreover, the class contains method
modify_call which can transform a call statement so that it correctly calls a
modified function. These two data structures were designed to have a small
memory footprint because they are allocated for each clone of a call graph node
that has its prototype changed and live until the end of IPA clone
materialization and call redirection phase.
On the other hand, class ipa_param_body_adjustments can afford to allocate more
data because its life span is much smaller, it is allocated and destroyed in
the course of materialization of each single clone that needs it or only when a
particular pass needs to change a function it is operating on. This class has
various methods required to change function declaration and the body of the
function according to instructions given either by class ipa_param_adjustments
or only a vector of ipa_adjusted_params.
When these classes are used in the context of call graph clone materialization
and subsequent call statement redirection - which is the point at which we
modify arguments in call statements - they need to cooperate with each other in
order to handle what we refer to as transitive (IPA-SRA) splits. These are
situations when a formal parameter of one function is split into several
smaller ones and some of them are then passed on in a call to another function
because the formal parameter of this callee has also been split.
Consider a simple example:
struct S {int a, b, c;};
struct Z {int x; S s;};
foo (S s)
{
use (s.b);
}
bar (Z z)
{
use (z.s.a);
foo (z.s);
}
baz ()
{
bar (*global);
}
Both bar and foo would have their parameter split. Foo would receive one
replacement representing s.b. Function bar would see its parameter split into
one replacement representing z.s.a and another representing z.s.b which would
be passed on to foo. It would be a so called transitive split IPA-SRA
replacement, one which is passed in a call as an actual argument to another
IPA-SRA replacement in another function.
Note that the call chain the example can be arbitrarily long and recursive and
that any function in it can be cloned by another IPA pass and any number of
adjacent functions in the call chain can be inlined into each other. Call
redirection takes place only after bodies of the function have been modified by
all of the above.
Call redirection has to be able to find the right decl or SSA_NAME that
corresponds to the transitive split in the caller. The SSA names are assigned
right after clone materialization/ modification and cannot be "added"
afterwards. Moreover, if the caller has been inlined the SSA_NAMEs in question
no longer belong to PARM_DECLs but to VAR_DECLs, indistinguishable from any
others.
Therefore, when clone materialization finds a call statement which it knows is
a part of a transitive split, it will modify it into:
foo (DUMMY_Z_VAR.s, repl_for_a, repl_for_b, );
It will also store {DUMMY_S_VAR, 32} and {DUMMY_S_VAR, 64} representing offsets
of z.s.a and z.s.b (assuming a 32-bit int) into foo's cgraph node
clone->performed_splits vector (which is storing structures of type
ipa_param_performed_split also defined in this header file).
Call redirection will identify that expression DUMMY_Z_VAR.s is based on a
variable stored in performed_splits vector and learn that the following
arguments, already in SSA form, represent offsets 32 and 64 in a split original
parameter. It subtracts offset of DUMMY_Z_VAR.s from 32 and 64 and arrives at
offsets 0 and 32 within callee's original parameter. At this point it also
knows from the call graph that only the bit with offset 32 is needed and so
changes the call statement into final:
bar (repl_for_b, ); */
#ifndef IPA_PARAM_MANIPULATION_H
#define IPA_PARAM_MANIPULATION_H
/* Indices into ipa_param_prefixes to identify a human-readable prefix for newly
synthesized parameters. Keep in sync with the array. */
enum ipa_param_name_prefix_indices
{
IPA_PARAM_PREFIX_SYNTH,
IPA_PARAM_PREFIX_ISRA,
IPA_PARAM_PREFIX_SIMD,
IPA_PARAM_PREFIX_MASK,
IPA_PARAM_PREFIX_COUNT
};
/* We do not support manipulating functions with more than
1< *adj_params);
/* Structure to remember the split performed on a node so that edge redirection
(i.e. splitting arguments of call statements) know how split formal
parameters of the caller are represented. */
struct GTY(()) ipa_param_performed_split
{
/* The dummy VAR_DECL that was created instead of the split parameter that
sits in the call in the meantime between clone materialization and call
redirection. All entries in a vector of performed splits that correspond
to the same dumy decl must be grouped together. */
tree dummy_decl;
/* Offset into the original parameter. */
unsigned unit_offset;
};
/* Class used to record planned modifications to parameters of a function and
also to perform necessary modifications at the caller side at the gimple
level. Used to describe all cgraph node clones that have their parameters
changed, therefore the class should only have a small memory footprint. */
class GTY(()) ipa_param_adjustments
{
public:
/* Constructor from NEW_PARAMS showing how new parameters should look like
plus copying any pre-existing actual arguments starting from argument
with index ALWAYS_COPY_START (if non-negative, negative means do not copy
anything beyond what is described in NEW_PARAMS), and SKIP_RETURN, which
indicates that the function should return void after transformation. */
ipa_param_adjustments (vec *new_params,
int always_copy_start, bool skip_return)
: m_adj_params (new_params), m_always_copy_start (always_copy_start),
m_skip_return (skip_return)
{}
/* Modify a call statement arguments (and possibly remove the return value)
as described in the data fields of this class. */
gcall *modify_call (gcall *stmt,
vec *performed_splits,
tree callee_decl, bool update_references);
/* Return if the first parameter is left intact. */
bool first_param_intact_p ();
/* Build a function type corresponding to the modified call. */
tree build_new_function_type (tree old_type, bool type_is_original_p);
/* Build a declaration corresponding to the target of the modified call. */
tree adjust_decl (tree orig_decl);
/* Fill a vector marking which parameters are intact by the described
modifications. */
void get_surviving_params (vec *surviving_params);
/* Fill a vector with new indices of surviving original parameters. */
void get_updated_indices (vec *new_indices);
/* Return the original index for the given new parameter index. Return a
negative number if not available. */
int get_original_index (int newidx);
void dump (FILE *f);
void debug ();
/* How the known part of arguments should look like. */
vec *m_adj_params;
/* If non-negative, copy any arguments starting at this offset without any
modifications so that functions with variable number of arguments can be
modified. This number should be equal to the number of original forma
parameters. */
int m_always_copy_start;
/* If true, make the function not return any value. */
bool m_skip_return;
private:
ipa_param_adjustments () {}
void init (vec *cur_params);
int get_max_base_index ();
bool method2func_p (tree orig_type);
};
/* Structure used to map expressions accessing split or replaced parameters to
new PARM_DECLs. */
struct ipa_param_body_replacement
{
/* The old decl of the original parameter. */
tree base;
/* The new decl it should be replaced with. */
tree repl;
/* When modifying clones during IPA clone materialization, this is a dummy
decl used to mark calls in which we need to apply transitive splitting,
these dummy delcls are inserted as arguments to such calls and then
followed by all the replacements with offset info stored in
ipa_param_performed_split.
Users of ipa_param_body_adjustments that modify standalone functions
outside of IPA clone materialization can use this field for their internal
purposes. */
tree dummy;
/* The offset within BASE that REPL represents. */
unsigned unit_offset;
};
struct ipa_replace_map;
/* Class used when actually performing adjustments to formal parameters of a
function to map accesses that need to be replaced to replacements. The
class attempts to work in two very different sets of circumstances: as a
part of tree-inine.c's tree_function_versioning machinery to clone functions
(when M_ID is not NULL) and in s standalone fashion, modifying an existing
function in place (when M_ID is NULL). While a lot of stuff handled in a
unified way in both modes, there are many aspects of the processs that
requires distinct paths. */
class ipa_param_body_adjustments
{
public:
/* Constructor to use from within tree-inline. */
ipa_param_body_adjustments (ipa_param_adjustments *adjustments,
tree fndecl, tree old_fndecl,
struct copy_body_data *id, tree *vars,
vec *tree_map);
/* Constructor to use for modifying a function outside of tree-inline from an
instance of ipa_param_adjustments. */
ipa_param_body_adjustments (ipa_param_adjustments *adjustments,
tree fndecl);
/* Constructor to use for modifying a function outside of tree-inline from a
simple vector of desired parameter modification. */
ipa_param_body_adjustments (vec *adj_params,
tree fndecl);
/* The do-it-all function for modifying a function outside of
tree-inline. */
bool perform_cfun_body_modifications ();
/* Change the PARM_DECLs. */
void modify_formal_parameters ();
/* Register a replacement decl for the transformation done in APM. */
void register_replacement (ipa_adjusted_param *apm, tree replacement,
tree dummy = NULL_TREE);
/* Lookup a replacement for a given offset within a given parameter. */
tree lookup_replacement (tree base, unsigned unit_offset);
/* Lookup a replacement for an expression, if there is one. */
ipa_param_body_replacement *get_expr_replacement (tree expr,
bool ignore_default_def);
/* Lookup the new base for surviving names previously belonging to a
parameter. */
tree get_replacement_ssa_base (tree old_decl);
/* Modify a statement. */
bool modify_gimple_stmt (gimple **stmt, gimple_seq *extra_stmts);
/* Return the new chain of parameters. */
tree get_new_param_chain ();
/* Pointers to data structures defining how the function should be
modified. */
vec *m_adj_params;
ipa_param_adjustments *m_adjustments;
/* Vector of old parameter declarations that must have their debug bind
statements re-mapped and debug decls created. */
auto_vec m_reset_debug_decls;
/* Set to true if there are any IPA_PARAM_OP_SPLIT adjustments among stored
adjustments. */
bool m_split_modifications_p;
private:
void common_initialization (tree old_fndecl, tree *vars,
vec *tree_map);
tree carry_over_param (tree t);
unsigned get_base_index (ipa_adjusted_param *apm);
ipa_param_body_replacement *lookup_replacement_1 (tree base,
unsigned unit_offset);
tree replace_removed_params_ssa_names (tree old_name, gimple *stmt);
bool modify_expression (tree *expr_p, bool convert);
bool modify_assignment (gimple *stmt, gimple_seq *extra_stmts);
bool modify_call_stmt (gcall **stmt_p);
bool modify_cfun_body ();
void reset_debug_stmts ();
/* Declaration of the function that is being transformed. */
tree m_fndecl;
/* If non-NULL, the tree-inline master data structure guiding materialization
of the current clone. */
struct copy_body_data *m_id;
/* Vector of old parameter declarations (before changing them). */
auto_vec m_oparms;
/* Vector of parameter declarations the function will have after
transformation. */
auto_vec m_new_decls;
/* If the function type has non-NULL TYPE_ARG_TYPES, this is the vector of
these types after transformation, otherwise an empty one. */
auto_vec m_new_types;
/* Vector of structures telling how to replace old parameters in the
function body. TODO: Even though there usually be only few, but should we
use a hash? */
auto_vec m_replacements;
/* Vector for remapping SSA_BASES from old parameter declarations that are
being removed as a part of the transformation. Before a new VAR_DECL is
created, it holds the old PARM_DECL, once the variable is built it is
stored here. */
auto_vec m_removed_decls;
/* Hash to quickly lookup the item in m_removed_decls given the old decl. */
hash_map m_removed_map;
/* True iff the transformed function is a class method that is about to loose
its this pointer and must be converted to a normal function. */
bool m_method2func;
};
void push_function_arg_decls (vec *args, tree fndecl);
void push_function_arg_types (vec *types, tree fntype);
#endif /* IPA_PARAM_MANIPULATION_H */