LLVM 19.0.0git
MachineDominators.h
Go to the documentation of this file.
1//==- llvm/CodeGen/MachineDominators.h - Machine Dom Calculation -*- C++ -*-==//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file defines classes mirroring those in llvm/Analysis/Dominators.h,
10// but for target-specific code rather than target-independent IR.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef LLVM_CODEGEN_MACHINEDOMINATORS_H
15#define LLVM_CODEGEN_MACHINEDOMINATORS_H
16
17#include "llvm/ADT/SmallSet.h"
25#include <cassert>
26#include <memory>
27
28namespace llvm {
29class AnalysisUsage;
30class MachineFunction;
31class Module;
32class raw_ostream;
33
34template <>
37 this->Roots.push_back(MBB);
38}
39
40extern template class DomTreeNodeBase<MachineBasicBlock>;
41extern template class DominatorTreeBase<MachineBasicBlock, false>; // DomTree
42extern template class DominatorTreeBase<MachineBasicBlock, true>; // PostDomTree
43
46
47//===-------------------------------------
48/// DominatorTree Class - Concrete subclass of DominatorTreeBase that is used to
49/// compute a normal dominator tree.
50///
52 /// Helper structure used to hold all the basic blocks
53 /// involved in the split of a critical edge.
54 struct CriticalEdge {
55 MachineBasicBlock *FromBB;
57 MachineBasicBlock *NewBB;
58 };
59
60 /// Pile up all the critical edges to be split.
61 /// The splitting of a critical edge is local and thus, it is possible
62 /// to apply several of those changes at the same time.
63 mutable SmallVector<CriticalEdge, 32> CriticalEdgesToSplit;
64
65 /// Remember all the basic blocks that are inserted during
66 /// edge splitting.
67 /// Invariant: NewBBs == all the basic blocks contained in the NewBB
68 /// field of all the elements of CriticalEdgesToSplit.
69 /// I.e., forall elt in CriticalEdgesToSplit, it exists BB in NewBBs
70 /// such as BB == elt.NewBB.
72
73 /// The DominatorTreeBase that is used to compute a normal dominator tree.
74 std::unique_ptr<MachineDomTree> DT;
75
76 /// Apply all the recorded critical edges to the DT.
77 /// This updates the underlying DT information in a way that uses
78 /// the fast query path of DT as much as possible.
79 ///
80 /// \post CriticalEdgesToSplit.empty().
81 void applySplitCriticalEdges() const;
82
83public:
84 static char ID; // Pass ID, replacement for typeid
85
88 calculate(MF);
89 }
90
92 if (!DT)
93 DT.reset(new MachineDomTree());
94 applySplitCriticalEdges();
95 return *DT;
96 }
97
98 void getAnalysisUsage(AnalysisUsage &AU) const override;
99
101 applySplitCriticalEdges();
102 return DT->getRoot();
103 }
104
106 applySplitCriticalEdges();
107 return DT->getRootNode();
108 }
109
110 bool runOnMachineFunction(MachineFunction &F) override;
111
112 void calculate(MachineFunction &F);
113
115 const MachineDomTreeNode *B) const {
116 applySplitCriticalEdges();
117 return DT->dominates(A, B);
118 }
119
122 applySplitCriticalEdges();
123 DT->getDescendants(A, Result);
124 }
125
126 bool dominates(const MachineBasicBlock *A, const MachineBasicBlock *B) const {
127 applySplitCriticalEdges();
128 return DT->dominates(A, B);
129 }
130
131 // dominates - Return true if A dominates B. This performs the
132 // special checks necessary if A and B are in the same basic block.
133 bool dominates(const MachineInstr *A, const MachineInstr *B) const {
134 applySplitCriticalEdges();
135 const MachineBasicBlock *BBA = A->getParent(), *BBB = B->getParent();
136 if (BBA != BBB) return DT->dominates(BBA, BBB);
137
138 // Loop through the basic block until we find A or B.
140 for (; &*I != A && &*I != B; ++I)
141 /*empty*/ ;
142
143 return &*I == A;
144 }
145
147 const MachineDomTreeNode *B) const {
148 applySplitCriticalEdges();
149 return DT->properlyDominates(A, B);
150 }
151
153 const MachineBasicBlock *B) const {
154 applySplitCriticalEdges();
155 return DT->properlyDominates(A, B);
156 }
157
158 /// findNearestCommonDominator - Find nearest common dominator basic block
159 /// for basic block A and B. If there is no such block then return NULL.
162 applySplitCriticalEdges();
163 return DT->findNearestCommonDominator(A, B);
164 }
165
167 applySplitCriticalEdges();
168 return DT->getNode(BB);
169 }
170
171 /// getNode - return the (Post)DominatorTree node for the specified basic
172 /// block. This is the same as using operator[] on this class.
173 ///
175 applySplitCriticalEdges();
176 return DT->getNode(BB);
177 }
178
179 /// addNewBlock - Add a new node to the dominator tree information. This
180 /// creates a new node as a child of DomBB dominator node,linking it into
181 /// the children list of the immediate dominator.
183 MachineBasicBlock *DomBB) {
184 applySplitCriticalEdges();
185 return DT->addNewBlock(BB, DomBB);
186 }
187
188 /// changeImmediateDominator - This method is used to update the dominator
189 /// tree information when a node's immediate dominator changes.
190 ///
192 MachineBasicBlock *NewIDom) {
193 applySplitCriticalEdges();
194 DT->changeImmediateDominator(N, NewIDom);
195 }
196
198 MachineDomTreeNode *NewIDom) {
199 applySplitCriticalEdges();
200 DT->changeImmediateDominator(N, NewIDom);
201 }
202
203 /// eraseNode - Removes a node from the dominator tree. Block must not
204 /// dominate any other blocks. Removes node from its immediate dominator's
205 /// children list. Deletes dominator node associated with basic block BB.
207 applySplitCriticalEdges();
208 DT->eraseNode(BB);
209 }
210
211 /// splitBlock - BB is split and now it has one successor. Update dominator
212 /// tree to reflect this change.
214 applySplitCriticalEdges();
215 DT->splitBlock(NewBB);
216 }
217
218 /// isReachableFromEntry - Return true if A is dominated by the entry
219 /// block of the function containing it.
221 applySplitCriticalEdges();
222 return DT->isReachableFromEntry(A);
223 }
224
225 void releaseMemory() override;
226
227 void verifyAnalysis() const override;
228
229 void print(raw_ostream &OS, const Module*) const override;
230
231 /// Record that the critical edge (FromBB, ToBB) has been
232 /// split with NewBB.
233 /// This is best to use this method instead of directly update the
234 /// underlying information, because this helps mitigating the
235 /// number of time the DT information is invalidated.
236 ///
237 /// \note Do not use this method with regular edges.
238 ///
239 /// \note To benefit from the compile time improvement incurred by this
240 /// method, the users of this method have to limit the queries to the DT
241 /// interface between two edges splitting. In other words, they have to
242 /// pack the splitting of critical edges as much as possible.
244 MachineBasicBlock *ToBB,
245 MachineBasicBlock *NewBB) {
246 bool Inserted = NewBBs.insert(NewBB).second;
247 (void)Inserted;
248 assert(Inserted &&
249 "A basic block inserted via edge splitting cannot appear twice");
250 CriticalEdgesToSplit.push_back({FromBB, ToBB, NewBB});
251 }
252};
253
254//===-------------------------------------
255/// DominatorTree GraphTraits specialization so the DominatorTree can be
256/// iterable by generic graph iterators.
257///
258
259template <class Node, class ChildIterator>
261 using NodeRef = Node *;
262 using ChildIteratorType = ChildIterator;
263
264 static NodeRef getEntryNode(NodeRef N) { return N; }
265 static ChildIteratorType child_begin(NodeRef N) { return N->begin(); }
266 static ChildIteratorType child_end(NodeRef N) { return N->end(); }
267};
268
269template <class T> struct GraphTraits;
270
271template <>
275};
276
277template <>
281};
282
286 return DT->getRootNode();
287 }
288};
289
290} // end namespace llvm
291
292#endif // LLVM_CODEGEN_MACHINEDOMINATORS_H
aarch64 promote const
MachineBasicBlock & MBB
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
Generic dominator tree construction - this file provides routines to construct immediate dominator in...
This file defines a set of templates that efficiently compute a dominator tree over a generic graph.
#define F(x, y, z)
Definition: MD5.cpp:55
#define I(x, y, z)
Definition: MD5.cpp:58
Machine Check Debug Module
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
raw_pwrite_stream & OS
This file defines the SmallSet class.
This file defines the SmallVector class.
Represent the analysis usage information of a pass.
Base class for the actual dominator tree node.
typename SmallVector< DomTreeNodeBase *, 4 >::const_iterator const_iterator
Core dominator tree base class.
void addRoot(NodeT *BB)
DominatorTree Class - Concrete subclass of DominatorTreeBase that is used to compute a normal dominat...
bool dominates(const MachineBasicBlock *A, const MachineBasicBlock *B) const
bool dominates(const MachineInstr *A, const MachineInstr *B) const
void changeImmediateDominator(MachineDomTreeNode *N, MachineDomTreeNode *NewIDom)
MachineBasicBlock * findNearestCommonDominator(MachineBasicBlock *A, MachineBasicBlock *B)
findNearestCommonDominator - Find nearest common dominator basic block for basic block A and B.
MachineDomTreeNode * addNewBlock(MachineBasicBlock *BB, MachineBasicBlock *DomBB)
addNewBlock - Add a new node to the dominator tree information.
bool isReachableFromEntry(const MachineBasicBlock *A)
isReachableFromEntry - Return true if A is dominated by the entry block of the function containing it...
MachineDomTreeNode * getRootNode() const
MachineDomTreeNode * getNode(MachineBasicBlock *BB) const
getNode - return the (Post)DominatorTree node for the specified basic block.
void eraseNode(MachineBasicBlock *BB)
eraseNode - Removes a node from the dominator tree.
void getAnalysisUsage(AnalysisUsage &AU) const override
getAnalysisUsage - This function should be overriden by passes that need analysis information to do t...
bool dominates(const MachineDomTreeNode *A, const MachineDomTreeNode *B) const
bool properlyDominates(const MachineBasicBlock *A, const MachineBasicBlock *B) const
void getDescendants(MachineBasicBlock *A, SmallVectorImpl< MachineBasicBlock * > &Result)
void splitBlock(MachineBasicBlock *NewBB)
splitBlock - BB is split and now it has one successor.
bool properlyDominates(const MachineDomTreeNode *A, const MachineDomTreeNode *B) const
MachineBasicBlock * getRoot() const
void changeImmediateDominator(MachineBasicBlock *N, MachineBasicBlock *NewIDom)
changeImmediateDominator - This method is used to update the dominator tree information when a node's...
MachineDominatorTree(MachineFunction &MF)
void recordSplitCriticalEdge(MachineBasicBlock *FromBB, MachineBasicBlock *ToBB, MachineBasicBlock *NewBB)
Record that the critical edge (FromBB, ToBB) has been split with NewBB.
MachineDomTreeNode * operator[](MachineBasicBlock *BB) const
MachineDomTree & getBase()
MachineFunctionPass - This class adapts the FunctionPass interface to allow convenient creation of pa...
Representation of each machine instruction.
Definition: MachineInstr.h:69
A Module instance is used to store all the information related to an LLVM module.
Definition: Module.h:65
SmallSet - This maintains a set of unique values, optimizing for the case when the set is small (less...
Definition: SmallSet.h:135
std::pair< const_iterator, bool > insert(const T &V)
insert - Insert an element into the set if it isn't already there.
Definition: SmallSet.h:179
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:586
void push_back(const T &Elt)
Definition: SmallVector.h:426
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1209
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:52
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
Printable print(const GCNRegPressure &RP, const GCNSubtarget *ST=nullptr)
DomTreeBase< MachineBasicBlock > MachineDomTree
DomTreeNodeBase< MachineBasicBlock > MachineDomTreeNode
#define N
static NodeRef getEntryNode(MachineDominatorTree *DT)
DominatorTree GraphTraits specialization so the DominatorTree can be iterable by generic graph iterat...
static ChildIteratorType child_end(NodeRef N)
static NodeRef getEntryNode(NodeRef N)
static ChildIteratorType child_begin(NodeRef N)