1 // Implementation of private inline member functions for RTL SSA -*- C++ -*-
2 // Copyright (C) 2020-2022 Free Software Foundation, Inc.
4 // This file is part of GCC.
6 // GCC is free software; you can redistribute it and/or modify it under
7 // the terms of the GNU General Public License as published by the Free
8 // Software Foundation; either version 3, or (at your option) any later
11 // GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 // 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 // Construct a new access with the given resource () and kind () values.
23 inline access_info::access_info (resource_info resource, access_kind kind)
24 : m_regno (resource.regno),
26 m_is_artificial (false),
27 m_is_set_with_nondebug_insn_uses (false),
28 m_is_pre_post_modify (false),
29 m_is_call_clobber (false),
30 m_is_live_out_use (false),
31 m_includes_address_uses (false),
32 m_includes_read_writes (false),
33 m_includes_subregs (false),
34 m_includes_multiregs (false),
35 m_only_occurs_in_notes (false),
36 m_is_last_nondebug_insn_use (false),
37 m_is_in_debug_insn_or_phi (false),
38 m_has_been_superceded (false),
41 m_mode (resource.mode)
45 // Construct a use of RESOURCE in LOCATION. The resource's value is provided
46 // by DEF, or is completely undefined if DEF is null.
47 inline use_info::use_info (insn_or_phi location, resource_info resource,
49 : access_info (resource, access_kind::USE),
50 m_insn_or_phi (location),
51 m_last_use_or_prev_use (nullptr),
52 m_last_nondebug_insn_use_or_next_use (nullptr),
55 if (m_insn_or_phi.is_second ())
57 m_is_in_debug_insn_or_phi = true;
58 m_is_artificial = true;
62 insn_info *insn = m_insn_or_phi.known_first ();
63 m_is_in_debug_insn_or_phi = insn->is_debug_insn ();
64 m_is_artificial = insn->is_artificial ();
68 // Return the correct (uncached) value of m_is_last_nondebug_insn_use.
70 use_info::calculate_is_last_nondebug_insn_use () const
72 use_info *next = next_use ();
73 return is_in_nondebug_insn () && (!next || next->is_in_debug_insn_or_phi ());
76 // Accumulate any properties about REF that are also stored in use_infos.
77 // IS_FIRST is true if REF is the first access to resource () that we have
78 // recorded in this way, false if we have already recorded previous
81 use_info::record_reference (rtx_obj_reference ref, bool is_first)
85 m_includes_address_uses = ref.in_address ();
86 m_includes_read_writes = ref.is_write ();
87 m_includes_subregs = ref.in_subreg ();
88 m_includes_multiregs = ref.is_multireg ();
89 m_only_occurs_in_notes = ref.in_note ();
93 m_includes_address_uses |= ref.in_address ();
94 m_includes_read_writes |= ref.is_write ();
95 m_includes_subregs |= ref.in_subreg ();
96 m_includes_multiregs |= ref.is_multireg ();
97 m_only_occurs_in_notes &= ref.in_note ();
101 // Change the value of insn () to INSN.
103 use_info::set_insn (insn_info *insn)
105 m_insn_or_phi = insn;
106 m_is_artificial = insn->is_artificial ();
109 // Copy the overloaded prev link from OTHER.
111 use_info::copy_prev_from (use_info *other)
113 m_last_use_or_prev_use = other->m_last_use_or_prev_use;
116 // Copy the overloaded next link from OTHER.
118 use_info::copy_next_from (use_info *other)
120 m_last_nondebug_insn_use_or_next_use
121 = other->m_last_nondebug_insn_use_or_next_use;
122 m_is_last_nondebug_insn_use = calculate_is_last_nondebug_insn_use ();
125 // Record that this use is the first in the list and that the last use is LAST.
127 use_info::set_last_use (use_info *last_use)
129 m_last_use_or_prev_use.set_first (last_use);
132 // Record that this use is not the first in the list and that the previous
135 use_info::set_prev_use (use_info *prev_use)
137 m_last_use_or_prev_use.set_second (prev_use);
140 // Record that this use is the last use in the list. If USE is nonnull,
141 // record that USE is the last use in the list by a nondebug instruction,
142 // otherwise record that there are no uses by nondebug instructions
145 use_info::set_last_nondebug_insn_use (use_info *use)
147 m_last_nondebug_insn_use_or_next_use.set_first (use);
148 m_is_last_nondebug_insn_use = (use == this);
151 // Record that this use is not the last in the list and that the next
154 use_info::set_next_use (use_info *next_use)
156 m_last_nondebug_insn_use_or_next_use.set_second (next_use);
157 m_is_last_nondebug_insn_use = calculate_is_last_nondebug_insn_use ();
160 // Clear any information relating to the position of the use in its
161 // definition's list.
163 use_info::clear_use_links ()
165 m_last_use_or_prev_use = nullptr;
166 m_last_nondebug_insn_use_or_next_use = nullptr;
167 m_is_last_nondebug_insn_use = false;
170 // Return true if the use has any links to other uses. This is mostly
171 // for assert checking.
173 use_info::has_use_links ()
175 return (m_last_use_or_prev_use
176 || m_last_nondebug_insn_use_or_next_use
177 || m_is_last_nondebug_insn_use);
180 // Construct a definition of RESOURCE in INSN, giving it kind KIND.
181 inline def_info::def_info (insn_info *insn, resource_info resource,
183 : access_info (resource, kind),
185 m_last_def_or_prev_def (nullptr),
186 m_splay_root_or_next_def (nullptr)
188 m_is_artificial = insn->is_artificial ();
191 // Record any properties about REF that are also stored in def_infos.
192 // IS_FIRST is true if REF is the first access to resource () that we have
193 // recorded in this way, false if we have already recorded previous
196 def_info::record_reference (rtx_obj_reference ref, bool is_first)
200 m_is_pre_post_modify = ref.is_pre_post_modify ();
201 m_includes_read_writes = ref.is_read ();
202 m_includes_subregs = ref.in_subreg ();
203 m_includes_multiregs = ref.is_multireg ();
207 m_is_pre_post_modify |= ref.is_pre_post_modify ();
208 m_includes_read_writes |= ref.is_read ();
209 m_includes_subregs |= ref.in_subreg ();
210 m_includes_multiregs |= ref.is_multireg ();
214 // Return the last definition in the list. Only valid when is_first ()
217 def_info::last_def () const
219 return m_last_def_or_prev_def.known_first ();
222 // Return the root of the splay tree of definitions of resource (),
223 // or null if no splay tree has been created for this resource.
224 // Only valid when is_last () is true.
226 def_info::splay_root () const
228 return m_splay_root_or_next_def.known_first ();
231 // Copy the overloaded prev link from OTHER.
233 def_info::copy_prev_from (def_info *other)
235 m_last_def_or_prev_def
236 = other->m_last_def_or_prev_def;
239 // Copy the overloaded next link from OTHER.
241 def_info::copy_next_from (def_info *other)
243 m_splay_root_or_next_def = other->m_splay_root_or_next_def;
246 // Record that this definition is the first in the list and that the last
247 // definition is LAST.
249 def_info::set_last_def (def_info *last_def)
251 m_last_def_or_prev_def.set_first (last_def);
254 // Record that this definition is not the first in the list and that the
255 // previous definition is PREV.
257 def_info::set_prev_def (def_info *prev_def)
259 m_last_def_or_prev_def.set_second (prev_def);
262 // Record that this definition is the last in the list and that the root
263 // of the splay tree associated with resource () is ROOT.
265 def_info::set_splay_root (def_node *root)
267 m_splay_root_or_next_def = root;
270 // Record that this definition is not the last in the list and that the
271 // next definition is NEXT.
273 def_info::set_next_def (def_info *next_def)
275 m_splay_root_or_next_def = next_def;
278 // Clear the prev and next links
280 def_info::clear_def_links ()
282 m_last_def_or_prev_def = nullptr;
283 m_splay_root_or_next_def = nullptr;
286 // Return true if the definition has any links to other definitions.
287 // This is mostly for assert checking.
289 def_info::has_def_links ()
291 return m_last_def_or_prev_def || m_splay_root_or_next_def;
294 // Construct a clobber of register REGNO in insn INSN.
295 inline clobber_info::clobber_info (insn_info *insn, unsigned int regno)
296 : def_info (insn, { E_BLKmode, regno }, access_kind::CLOBBER),
303 // Set the containing group to GROUP, if it isn't already. The main
304 // use of this function is to update the new root of GROUP's splay tree.
306 clobber_info::update_group (clobber_group *group)
308 if (__builtin_expect (m_group != group, 0))
312 // Cconstruct a set_info for a store to RESOURCE in INSN, giving it
314 inline set_info::set_info (insn_info *insn, resource_info resource,
316 : def_info (insn, resource, kind),
317 m_first_use (nullptr)
321 // Cconstruct a set_info for a store to RESOURCE in INSN.
322 inline set_info::set_info (insn_info *insn, resource_info resource)
323 : set_info (insn, resource, access_kind::SET)
327 // Record that USE is the first use of this definition.
329 set_info::set_first_use (use_info *first_use)
331 m_first_use = first_use;
332 m_is_set_with_nondebug_insn_uses
333 = (first_use && first_use->is_in_nondebug_insn ());
336 // Construct a phi for RESOURCE in INSN, giving it identifier UID.
337 inline phi_info::phi_info (insn_info *insn, resource_info resource,
339 : set_info (insn, resource, access_kind::PHI),
342 m_prev_phi (nullptr),
347 // Turn the phi into a degenerate phi, with INPUT representing the
348 // value of the resource on all incoming edges.
350 phi_info::make_degenerate (use_info *input)
353 m_single_input = input;
356 // Set the inputs of the phi to INPUTS.
358 phi_info::set_inputs (use_array inputs)
360 m_num_inputs = inputs.size ();
361 if (inputs.size () == 1)
362 m_single_input = inputs[0];
364 m_inputs = access_array (inputs).begin ();
367 // Construct a definition splay tree node for FIRST_DEF, which is either
368 // the first clobber_info in a group or a standalone set_info.
369 inline def_node::def_node (clobber_or_set first_def)
370 : m_clobber_or_set (first_def),
375 // Construct a new group of clobber_infos that initially contains just CLOBBER.
376 inline clobber_group::clobber_group (clobber_info *clobber)
377 : def_node (clobber),
378 m_last_clobber (clobber),
379 m_clobber_tree (clobber)
381 clobber->m_group = this;
384 // Construct a node for the instruction with uid UID.
385 inline insn_info::order_node::order_node (int uid)
393 // Construct a note for instruction INSN, giving it abi_id () value ABI_ID.
394 inline insn_call_clobbers_note::insn_call_clobbers_note (unsigned int abi_id,
403 // Construct an instruction with the given bb () and rtl () values.
404 // If the instruction is real, COST_OR_UID is the value of cost (),
405 // otherwise it is the value of uid ().
406 inline insn_info::insn_info (bb_info *bb, rtx_insn *rtl, int cost_or_uid)
407 : m_prev_insn_or_last_debug_insn (nullptr),
408 m_next_nondebug_or_debug_insn (nullptr),
411 m_accesses (nullptr),
414 m_is_debug_insn (rtl && DEBUG_INSN_P (rtl)),
415 m_can_be_optimized (false),
417 m_has_pre_post_modify (false),
418 m_has_volatile_refs (false),
421 m_cost_or_uid (cost_or_uid),
422 m_first_note (nullptr)
426 // Copy any insn properties from PROPERTIES that are also stored in an
429 insn_info::set_properties (const rtx_properties &properties)
431 m_is_asm = properties.has_asm;
432 m_has_pre_post_modify = properties.has_pre_post_modify;
433 m_has_volatile_refs = properties.has_volatile_refs;
434 // Not strictly related to the properties we've been given, but it's
435 // a convenient location to do this.
436 m_can_be_optimized = (NONDEBUG_INSN_P (m_rtl)
437 & (GET_CODE (PATTERN (m_rtl)) != USE)
438 & (GET_CODE (PATTERN (m_rtl)) != CLOBBER));
441 // Change the list of instruction accesses to ACCESSES, which contains
442 // NUM_DEFS definitions followed by NUM_USES uses.
444 insn_info::set_accesses (access_info **accesses,
445 unsigned int num_defs, unsigned int num_uses)
447 m_accesses = accesses;
448 m_num_defs = num_defs;
449 gcc_assert (num_defs == m_num_defs);
450 m_num_uses = num_uses;
453 // Change defs () and uses () to DEFS and USES respectively, given that
454 // the existing m_accesses array has enough room for them.
456 insn_info::copy_accesses (access_array defs, access_array uses)
458 gcc_assert (defs.size () + uses.size () <= m_num_defs + m_num_uses);
459 memcpy (m_accesses, defs.begin (), defs.size_bytes ());
460 memcpy (m_accesses + defs.size (), uses.begin (), uses.size_bytes ());
461 m_num_defs = defs.size ();
462 gcc_assert (m_num_defs == defs.size ());
463 m_num_uses = uses.size ();
466 // If the instruction has an insn_info::order_node, return the node,
467 // otherwise return null.
468 inline insn_info::order_node *
469 insn_info::get_order_node () const
471 // The order_node always comes first.
472 if (insn_note *note = first_note ())
473 return note->dyn_cast<insn_info::order_node *> ();
477 // Like get_order_node (), but the node is known to exist.
478 inline insn_info::order_node *
479 insn_info::get_known_order_node () const
481 // The order_node always comes first.
482 return first_note ()->as_a<insn_info::order_node *> ();
485 // Copy the overloaded prev link from OTHER.
487 insn_info::copy_prev_from (insn_info *other)
489 m_prev_insn_or_last_debug_insn = other->m_prev_insn_or_last_debug_insn;
492 // Copy the overloaded next link from OTHER.
494 insn_info::copy_next_from (insn_info *other)
496 m_next_nondebug_or_debug_insn = other->m_next_nondebug_or_debug_insn;
499 // If this is a nondebug instruction, record that the previous nondebug
500 // instruction is PREV. (There might be intervening debug instructions.)
502 // If this is a debug instruction, record that the previous instruction
503 // is debug instruction PREV.
505 insn_info::set_prev_sametype_insn (insn_info *prev)
507 m_prev_insn_or_last_debug_insn.set_first (prev);
510 // Only valid for debug instructions. Record that this instruction starts
511 // a subsequence of debug instructions that ends with LAST.
513 insn_info::set_last_debug_insn (insn_info *last)
515 m_prev_insn_or_last_debug_insn.set_second (last);
518 // Record that the next instruction of any kind is NEXT.
520 insn_info::set_next_any_insn (insn_info *next)
522 if (next && next->is_debug_insn ())
523 m_next_nondebug_or_debug_insn.set_second (next);
525 m_next_nondebug_or_debug_insn.set_first (next);
528 // Clear the list links and point number for this instruction.
530 insn_info::clear_insn_links ()
532 m_prev_insn_or_last_debug_insn = nullptr;
533 m_next_nondebug_or_debug_insn = nullptr;
537 // Return true if the instruction contains any list information.
538 // This is used by assert checking.
540 insn_info::has_insn_links ()
542 return (m_prev_insn_or_last_debug_insn
543 || m_next_nondebug_or_debug_insn
547 // Construct a representation of basic block CFG_BB.
548 inline bb_info::bb_info (basic_block cfg_bb)
549 : m_prev_bb (nullptr),
553 m_head_insn (nullptr),
558 // Construct a tree of call clobbers for the given ABI.
559 inline ebb_call_clobbers_info::
560 ebb_call_clobbers_info (const predefined_function_abi *abi)
566 // Construct an EBB whose first block is FIRST_BB and whose last block
568 inline ebb_info::ebb_info (bb_info *first_bb, bb_info *last_bb)
569 : m_first_phi (nullptr),
570 m_phi_insn (nullptr),
571 m_first_bb (first_bb),
573 m_first_call_clobbers (nullptr)
577 // Record register definition DEF in last_access, pushing a definition
578 // to def_stack where appropriate.
580 function_info::build_info::record_reg_def (def_info *def)
582 unsigned int regno = def->regno ();
583 auto *prev_dominating_def = safe_as_a<def_info *> (last_access[regno + 1]);
584 if (!prev_dominating_def)
585 // Indicate that DEF is the first dominating definition of REGNO.
586 def_stack.safe_push (def);
587 else if (prev_dominating_def->bb () != def->bb ())
588 // Record that PREV_DOMINATING_DEF was the dominating definition
589 // of REGNO on entry to the current block.
590 def_stack.safe_push (prev_dominating_def);
591 last_access[regno + 1] = def;
594 // Set the contents of last_access for memory to DEF.
596 function_info::build_info::record_mem_def (def_info *def)
598 last_access[0] = def;
601 // Return the current value of live register REGNO, or null if the register's
602 // value is completedly undefined.
604 function_info::build_info::current_reg_value (unsigned int regno) const
606 return safe_dyn_cast<set_info *> (last_access[regno + 1]);
609 // Return the current value of memory.
611 function_info::build_info::current_mem_value () const
613 return as_a<set_info *> (last_access[0]);
616 // Allocate a T on the function's main obstack, passing ARGS
617 // to its constructor.
618 template<typename T, typename... Ts>
620 function_info::allocate (Ts... args)
622 static_assert (std::is_trivially_destructible<T>::value,
623 "destructor won't be called");
624 static_assert (alignof (T) <= obstack_alignment,
625 "too much alignment required");
626 void *addr = obstack_alloc (&m_obstack, sizeof (T));
627 return new (addr) T (std::forward<Ts> (args)...);
630 // Allocate a T on the function's temporary obstack, passing ARGS
631 // to its constructor.
632 template<typename T, typename... Ts>
634 function_info::allocate_temp (Ts... args)
636 static_assert (std::is_trivially_destructible<T>::value,
637 "destructor won't be called");
638 static_assert (alignof (T) <= obstack_alignment,
639 "too much alignment required");
640 void *addr = obstack_alloc (&m_temp_obstack, sizeof (T));
641 return new (addr) T (std::forward<Ts> (args)...);
644 // Add INSN to the end of the function's list of instructions.
646 function_info::append_insn (insn_info *insn)
648 gcc_checking_assert (!insn->has_insn_links ());
649 if (insn_info *after = m_last_insn)
650 add_insn_after (insn, after);
652 // The first instruction is for the entry block and is always a nondebug
654 m_first_insn = m_last_insn = m_last_nondebug_insn = insn;
657 // Start building a new list of uses and definitions for an instruction.
659 function_info::start_insn_accesses ()
661 gcc_checking_assert (m_temp_defs.is_empty ()
662 && m_temp_uses.is_empty ());
665 // Return a mode that encapsulates two distinct references to a register,
666 // one with mode MODE1 and one with mode MODE2. Treat BLKmode as a
667 // "don't know" wildcard.
669 combine_modes (machine_mode mode1, machine_mode mode2)
671 if (mode1 == E_BLKmode)
674 if (mode2 == E_BLKmode)
677 return wider_subreg_mode (mode1, mode2);
680 // PRINTER (PP, ARGS...) prints ARGS... to a pretty_printer PP. Use it
681 // to print ARGS... to FILE.
682 template<typename Printer, typename... Args>
684 dump_using (FILE *file, Printer printer, Args... args)
687 printer (&pp, args...);
689 fprintf (file, "%s", pp_formatted_text (&pp));