mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2025-02-01 17:32:36 +00:00
4c7edb1240
LazyCallGraph. This is the start of the whole point of this different abstraction, but it is just the initial bits. Here is a run-down of what's going on here. I'm planning to incorporate some (or all) of this into comments going forward, hopefully with better editing and wording. =] The crux of the problem with the traditional way of building SCCs is that they are ephemeral. The new pass manager however really needs the ability to associate analysis passes and results of analysis passes with SCCs in order to expose these analysis passes to the SCC passes. Making this work is kind-of the whole point of the new pass manager. =] So, when we're building SCCs for the call graph, we actually want to build persistent nodes that stick around and can be reasoned about later. We'd also like the ability to walk the SCC graph in more complex ways than just the traditional postorder traversal of the current CGSCC walk. That means that in addition to being persistent, the SCCs need to be connected into a useful graph structure. However, we still want the SCCs to be formed lazily where possible. These constraints are quite hard to satisfy with the SCC iterator. Also, using that would bypass our ability to actually add data to the nodes of the call graph to facilite implementing the Tarjan walk. So I've re-implemented things in a more direct and embedded way. This immediately makes it easy to get the persistence and connectivity correct, and it also allows leveraging the existing nodes to simplify the algorithm. I've worked somewhat to make this implementation more closely follow the traditional paper's nomenclature and strategy, although it is still a bit obtuse because it isn't recursive, using an explicit stack and a tail call instead, and it is interruptable, resuming each time we need another SCC. The other tricky bit here, and what actually took almost all the time and trials and errors I spent building this, is exactly *what* graph structure to build for the SCCs. The naive thing to build is the call graph in its newly acyclic form. I wrote about 4 versions of this which did precisely this. Inevitably, when I experimented with them across various use cases, they became incredibly awkward. It was all implementable, but it felt like a complete wrong fit. Square peg, round hole. There were two overriding aspects that pushed me in a different direction: 1) We want to discover the SCC graph in a postorder fashion. That means the root node will be the *last* node we find. Using the call-SCC DAG as the graph structure of the SCCs results in an orphaned graph until we discover a root. 2) We will eventually want to walk the SCC graph in parallel, exploring distinct sub-graphs independently, and synchronizing at merge points. This again is not helped by the call-SCC DAG structure. The structure which, quite surprisingly, ended up being completely natural to use is the *inverse* of the call-SCC DAG. We add the leaf SCCs to the graph as "roots", and have edges to the caller SCCs. Once I switched to building this structure, everything just fell into place elegantly. Aside from general cleanups (there are FIXMEs and too few comments overall) that are still needed, the other missing piece of this is support for iterating across levels of the SCC graph. These will become useful for implementing #2, but they aren't an immediate priority. Once SCCs are in good shape, I'll be working on adding mutation support for incremental updates and adding the pass manager that this analysis enables. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@206581 91177308-0d34-0410-b5e6-96231b3b80d8
282 lines
10 KiB
C++
282 lines
10 KiB
C++
//===- LazyCallGraph.cpp - Analysis of a Module's call graph --------------===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "llvm/Analysis/LazyCallGraph.h"
|
|
#include "llvm/ADT/STLExtras.h"
|
|
#include "llvm/IR/CallSite.h"
|
|
#include "llvm/IR/InstVisitor.h"
|
|
#include "llvm/IR/Instructions.h"
|
|
#include "llvm/IR/PassManager.h"
|
|
#include "llvm/Support/raw_ostream.h"
|
|
|
|
using namespace llvm;
|
|
|
|
static void findCallees(
|
|
SmallVectorImpl<Constant *> &Worklist, SmallPtrSetImpl<Constant *> &Visited,
|
|
SmallVectorImpl<PointerUnion<Function *, LazyCallGraph::Node *>> &Callees,
|
|
SmallPtrSetImpl<Function *> &CalleeSet) {
|
|
while (!Worklist.empty()) {
|
|
Constant *C = Worklist.pop_back_val();
|
|
|
|
if (Function *F = dyn_cast<Function>(C)) {
|
|
// Note that we consider *any* function with a definition to be a viable
|
|
// edge. Even if the function's definition is subject to replacement by
|
|
// some other module (say, a weak definition) there may still be
|
|
// optimizations which essentially speculate based on the definition and
|
|
// a way to check that the specific definition is in fact the one being
|
|
// used. For example, this could be done by moving the weak definition to
|
|
// a strong (internal) definition and making the weak definition be an
|
|
// alias. Then a test of the address of the weak function against the new
|
|
// strong definition's address would be an effective way to determine the
|
|
// safety of optimizing a direct call edge.
|
|
if (!F->isDeclaration() && CalleeSet.insert(F))
|
|
Callees.push_back(F);
|
|
continue;
|
|
}
|
|
|
|
for (Value *Op : C->operand_values())
|
|
if (Visited.insert(cast<Constant>(Op)))
|
|
Worklist.push_back(cast<Constant>(Op));
|
|
}
|
|
}
|
|
|
|
LazyCallGraph::Node::Node(LazyCallGraph &G, Function &F)
|
|
: G(&G), F(F), DFSNumber(0), LowLink(0) {
|
|
SmallVector<Constant *, 16> Worklist;
|
|
SmallPtrSet<Constant *, 16> Visited;
|
|
// Find all the potential callees in this function. First walk the
|
|
// instructions and add every operand which is a constant to the worklist.
|
|
for (BasicBlock &BB : F)
|
|
for (Instruction &I : BB)
|
|
for (Value *Op : I.operand_values())
|
|
if (Constant *C = dyn_cast<Constant>(Op))
|
|
if (Visited.insert(C))
|
|
Worklist.push_back(C);
|
|
|
|
// We've collected all the constant (and thus potentially function or
|
|
// function containing) operands to all of the instructions in the function.
|
|
// Process them (recursively) collecting every function found.
|
|
findCallees(Worklist, Visited, Callees, CalleeSet);
|
|
}
|
|
|
|
LazyCallGraph::Node::Node(LazyCallGraph &G, const Node &OtherN)
|
|
: G(&G), F(OtherN.F), DFSNumber(0), LowLink(0), CalleeSet(OtherN.CalleeSet) {
|
|
// Loop over the other node's callees, adding the Function*s to our list
|
|
// directly, and recursing to add the Node*s.
|
|
Callees.reserve(OtherN.Callees.size());
|
|
for (const auto &OtherCallee : OtherN.Callees)
|
|
if (Function *Callee = OtherCallee.dyn_cast<Function *>())
|
|
Callees.push_back(Callee);
|
|
else
|
|
Callees.push_back(G.copyInto(*OtherCallee.get<Node *>()));
|
|
}
|
|
|
|
LazyCallGraph::LazyCallGraph(Module &M) {
|
|
for (Function &F : M)
|
|
if (!F.isDeclaration() && !F.hasLocalLinkage())
|
|
if (EntryNodeSet.insert(&F))
|
|
EntryNodes.push_back(&F);
|
|
|
|
// Now add entry nodes for functions reachable via initializers to globals.
|
|
SmallVector<Constant *, 16> Worklist;
|
|
SmallPtrSet<Constant *, 16> Visited;
|
|
for (GlobalVariable &GV : M.globals())
|
|
if (GV.hasInitializer())
|
|
if (Visited.insert(GV.getInitializer()))
|
|
Worklist.push_back(GV.getInitializer());
|
|
|
|
findCallees(Worklist, Visited, EntryNodes, EntryNodeSet);
|
|
|
|
for (auto &Entry : EntryNodes)
|
|
if (Function *F = Entry.dyn_cast<Function *>())
|
|
SCCEntryNodes.insert(F);
|
|
else
|
|
SCCEntryNodes.insert(&Entry.get<Node *>()->getFunction());
|
|
}
|
|
|
|
LazyCallGraph::LazyCallGraph(const LazyCallGraph &G)
|
|
: EntryNodeSet(G.EntryNodeSet) {
|
|
EntryNodes.reserve(G.EntryNodes.size());
|
|
for (const auto &EntryNode : G.EntryNodes)
|
|
if (Function *Callee = EntryNode.dyn_cast<Function *>())
|
|
EntryNodes.push_back(Callee);
|
|
else
|
|
EntryNodes.push_back(copyInto(*EntryNode.get<Node *>()));
|
|
|
|
// Just re-populate the SCCEntryNodes structure so we recompute the SCCs if
|
|
// needed.
|
|
for (auto &Entry : EntryNodes)
|
|
if (Function *F = Entry.dyn_cast<Function *>())
|
|
SCCEntryNodes.insert(F);
|
|
else
|
|
SCCEntryNodes.insert(&Entry.get<Node *>()->getFunction());
|
|
}
|
|
|
|
LazyCallGraph::LazyCallGraph(LazyCallGraph &&G)
|
|
: BPA(std::move(G.BPA)), EntryNodes(std::move(G.EntryNodes)),
|
|
EntryNodeSet(std::move(G.EntryNodeSet)), SCCBPA(std::move(G.SCCBPA)),
|
|
SCCMap(std::move(G.SCCMap)), LeafSCCs(std::move(G.LeafSCCs)),
|
|
DFSStack(std::move(G.DFSStack)),
|
|
SCCEntryNodes(std::move(G.SCCEntryNodes)) {
|
|
// Process all nodes updating the graph pointers.
|
|
SmallVector<Node *, 16> Worklist;
|
|
for (auto &Entry : EntryNodes)
|
|
if (Node *EntryN = Entry.dyn_cast<Node *>())
|
|
Worklist.push_back(EntryN);
|
|
|
|
while (!Worklist.empty()) {
|
|
Node *N = Worklist.pop_back_val();
|
|
N->G = this;
|
|
for (auto &Callee : N->Callees)
|
|
if (Node *CalleeN = Callee.dyn_cast<Node *>())
|
|
Worklist.push_back(CalleeN);
|
|
}
|
|
}
|
|
|
|
LazyCallGraph::Node *LazyCallGraph::insertInto(Function &F, Node *&MappedN) {
|
|
return new (MappedN = BPA.Allocate()) Node(*this, F);
|
|
}
|
|
|
|
LazyCallGraph::Node *LazyCallGraph::copyInto(const Node &OtherN) {
|
|
Node *&N = NodeMap[&OtherN.F];
|
|
if (N)
|
|
return N;
|
|
|
|
return new (N = BPA.Allocate()) Node(*this, OtherN);
|
|
}
|
|
|
|
LazyCallGraph::SCC *LazyCallGraph::getNextSCCInPostOrder() {
|
|
// When the stack is empty, there are no more SCCs to walk in this graph.
|
|
if (DFSStack.empty()) {
|
|
// If we've handled all candidate entry nodes to the SCC forest, we're done.
|
|
if (SCCEntryNodes.empty())
|
|
return nullptr;
|
|
|
|
Node *N = get(*SCCEntryNodes.pop_back_val());
|
|
DFSStack.push_back(std::make_pair(N, N->begin()));
|
|
}
|
|
|
|
Node *N = DFSStack.back().first;
|
|
if (N->DFSNumber == 0) {
|
|
// This node hasn't been visited before, assign it a DFS number and remove
|
|
// it from the entry set.
|
|
N->LowLink = N->DFSNumber = NextDFSNumber++;
|
|
SCCEntryNodes.remove(&N->getFunction());
|
|
}
|
|
|
|
for (auto I = DFSStack.back().second, E = N->end(); I != E; ++I) {
|
|
Node *ChildN = *I;
|
|
if (ChildN->DFSNumber == 0) {
|
|
// Mark that we should start at this child when next this node is the
|
|
// top of the stack. We don't start at the next child to ensure this
|
|
// child's lowlink is reflected.
|
|
// FIXME: I don't actually think this is required, and we could start
|
|
// at the next child.
|
|
DFSStack.back().second = I;
|
|
|
|
// Recurse onto this node via a tail call.
|
|
DFSStack.push_back(std::make_pair(ChildN, ChildN->begin()));
|
|
return LazyCallGraph::getNextSCCInPostOrder();
|
|
}
|
|
|
|
// Track the lowest link of the childen, if any are still in the stack.
|
|
if (ChildN->LowLink < N->LowLink && !SCCMap.count(&ChildN->getFunction()))
|
|
N->LowLink = ChildN->LowLink;
|
|
}
|
|
|
|
// The tail of the stack is the new SCC. Allocate the SCC and pop the stack
|
|
// into it.
|
|
SCC *NewSCC = new (SCCBPA.Allocate()) SCC();
|
|
|
|
// Because we don't follow the strict Tarjan recursive formulation, walk
|
|
// from the top of the stack down, propagating the lowest link and stopping
|
|
// when the DFS number is the lowest link.
|
|
int LowestLink = N->LowLink;
|
|
do {
|
|
Node *SCCN = DFSStack.pop_back_val().first;
|
|
SCCMap.insert(std::make_pair(&SCCN->getFunction(), NewSCC));
|
|
NewSCC->Nodes.push_back(SCCN);
|
|
LowestLink = std::min(LowestLink, SCCN->LowLink);
|
|
bool Inserted =
|
|
NewSCC->NodeSet.insert(&SCCN->getFunction());
|
|
(void)Inserted;
|
|
assert(Inserted && "Cannot have duplicates in the DFSStack!");
|
|
} while (!DFSStack.empty() && LowestLink <= DFSStack.back().first->DFSNumber);
|
|
assert(LowestLink == NewSCC->Nodes.back()->DFSNumber &&
|
|
"Cannot stop with a DFS number greater than the lowest link!");
|
|
|
|
// A final pass over all edges in the SCC (this remains linear as we only
|
|
// do this once when we build the SCC) to connect it to the parent sets of
|
|
// its children.
|
|
bool IsLeafSCC = true;
|
|
for (Node *SCCN : NewSCC->Nodes)
|
|
for (Node *SCCChildN : *SCCN) {
|
|
if (NewSCC->NodeSet.count(&SCCChildN->getFunction()))
|
|
continue;
|
|
SCC *ChildSCC = SCCMap.lookup(&SCCChildN->getFunction());
|
|
assert(ChildSCC &&
|
|
"Must have all child SCCs processed when building a new SCC!");
|
|
ChildSCC->ParentSCCs.insert(NewSCC);
|
|
IsLeafSCC = false;
|
|
}
|
|
|
|
// For the SCCs where we fine no child SCCs, add them to the leaf list.
|
|
if (IsLeafSCC)
|
|
LeafSCCs.push_back(NewSCC);
|
|
|
|
return NewSCC;
|
|
}
|
|
|
|
char LazyCallGraphAnalysis::PassID;
|
|
|
|
LazyCallGraphPrinterPass::LazyCallGraphPrinterPass(raw_ostream &OS) : OS(OS) {}
|
|
|
|
static void printNodes(raw_ostream &OS, LazyCallGraph::Node &N,
|
|
SmallPtrSetImpl<LazyCallGraph::Node *> &Printed) {
|
|
// Recurse depth first through the nodes.
|
|
for (LazyCallGraph::Node *ChildN : N)
|
|
if (Printed.insert(ChildN))
|
|
printNodes(OS, *ChildN, Printed);
|
|
|
|
OS << " Call edges in function: " << N.getFunction().getName() << "\n";
|
|
for (LazyCallGraph::iterator I = N.begin(), E = N.end(); I != E; ++I)
|
|
OS << " -> " << I->getFunction().getName() << "\n";
|
|
|
|
OS << "\n";
|
|
}
|
|
|
|
static void printSCC(raw_ostream &OS, LazyCallGraph::SCC &SCC) {
|
|
ptrdiff_t SCCSize = std::distance(SCC.begin(), SCC.end());
|
|
OS << " SCC with " << SCCSize << " functions:\n";
|
|
|
|
for (LazyCallGraph::Node *N : SCC)
|
|
OS << " " << N->getFunction().getName() << "\n";
|
|
|
|
OS << "\n";
|
|
}
|
|
|
|
PreservedAnalyses LazyCallGraphPrinterPass::run(Module *M,
|
|
ModuleAnalysisManager *AM) {
|
|
LazyCallGraph &G = AM->getResult<LazyCallGraphAnalysis>(M);
|
|
|
|
OS << "Printing the call graph for module: " << M->getModuleIdentifier()
|
|
<< "\n\n";
|
|
|
|
SmallPtrSet<LazyCallGraph::Node *, 16> Printed;
|
|
for (LazyCallGraph::Node *N : G)
|
|
if (Printed.insert(N))
|
|
printNodes(OS, *N, Printed);
|
|
|
|
for (LazyCallGraph::SCC *SCC : G.postorder_sccs())
|
|
printSCC(OS, *SCC);
|
|
|
|
return PreservedAnalyses::all();
|
|
|
|
}
|