The basic data container for the call graph of a Module of IR. More...

#include "llvm/Analysis/CallGraph.h"

Public Types
using	iterator = FunctionMapTy::iterator

using	const_iterator = FunctionMapTy::const_iterator

Public Member Functions
	CallGraph (Module &M)

	CallGraph (CallGraph &&Arg)

	~CallGraph ()

void	print (raw_ostream &OS) const

void	dump () const

Module &	getModule () const
	Returns the module the call graph corresponds to.

bool	invalidate (Module &, const PreservedAnalyses &PA, ModuleAnalysisManager::Invalidator &)

iterator	begin ()

iterator	end ()

const_iterator	begin () const

const_iterator	end () const

const CallGraphNode *	operator[] (const Function *F) const
	Returns the call graph node for the provided function.

CallGraphNode *	operator[] (const Function *F)
	Returns the call graph node for the provided function.

CallGraphNode *	getExternalCallingNode () const
	Returns the `CallGraphNode` which is used to represent undetermined calls into the callgraph.

CallGraphNode *	getCallsExternalNode () const

void	ReplaceExternalCallEdge (CallGraphNode Old, CallGraphNode New)
	Old node has been deleted, and New is to be used in its place, update the ExternalCallingNode.

Function *	removeFunctionFromModule (CallGraphNode *CGN)
	Unlink the function from this module, returning it.

CallGraphNode *	getOrInsertFunction (const Function *F)
	Similar to operator[], but this will insert a new CallGraphNode for `F` if one does not already exist.

void	populateCallGraphNode (CallGraphNode *CGN)
	Populate `CGN` based on the calls inside the associated function.

void	addToCallGraph (Function *F)
	Add a function to the call graph, and link the node to all of the functions that it calls.

Detailed Description

The basic data container for the call graph of a Module of IR.

This class exposes both the interface to the call graph for a module of IR.

The core call graph itself can also be updated to reflect changes to the IR.

Definition at line 72 of file CallGraph.h.

Member Typedef Documentation

◆ const_iterator

using llvm::CallGraph::const_iterator = FunctionMapTy::const_iterator

Definition at line 98 of file CallGraph.h.

◆ iterator

using llvm::CallGraph::iterator = FunctionMapTy::iterator

Definition at line 97 of file CallGraph.h.

Constructor & Destructor Documentation

◆ CallGraph() [1/2]

CallGraph::CallGraph ( Module & M )

explicit

Definition at line 32 of file CallGraph.cpp.

References addToCallGraph(), F, and llvm::isDbgInfoIntrinsic().

◆ CallGraph() [2/2]

CallGraph::CallGraph ( CallGraph && Arg )

Definition at line 41 of file CallGraph.cpp.

References P.

◆ ~CallGraph()

CallGraph::~CallGraph ( )

Definition at line 54 of file CallGraph.cpp.

References I.

Member Function Documentation

◆ addToCallGraph()

void CallGraph::addToCallGraph ( Function * F )

Add a function to the call graph, and link the node to all of the functions that it calls.

Definition at line 75 of file CallGraph.cpp.

References llvm::CallGraphNode::addCalledFunction(), F, getOrInsertFunction(), and populateCallGraphNode().

Referenced by CallGraph(), and llvm::CallGraphUpdater::registerOutlinedFunction().

◆ begin() [1/2]

iterator llvm::CallGraph::begin ( )

inline

Definition at line 106 of file CallGraph.h.

Referenced by llvm::GraphTraits< CallGraph * >::nodes_begin(), llvm::GraphTraits< CallGraphDOTInfo * >::nodes_begin(), and llvm::GraphTraits< const CallGraph * >::nodes_begin().

◆ begin() [2/2]

const_iterator llvm::CallGraph::begin ( ) const

inline

Definition at line 108 of file CallGraph.h.

◆ dump()

LLVM_DUMP_METHOD void CallGraph::dump ( ) const

Definition at line 138 of file CallGraph.cpp.

References llvm::dbgs(), and print().

◆ end() [1/2]

iterator llvm::CallGraph::end ( )

inline

Definition at line 107 of file CallGraph.h.

Referenced by llvm::GraphTraits< CallGraph * >::nodes_end(), llvm::GraphTraits< CallGraphDOTInfo * >::nodes_end(), and llvm::GraphTraits< const CallGraph * >::nodes_end().

◆ end() [2/2]

const_iterator llvm::CallGraph::end ( ) const

inline

Definition at line 109 of file CallGraph.h.

◆ getCallsExternalNode()

CallGraphNode * llvm::CallGraph::getCallsExternalNode ( ) const

inline

Definition at line 129 of file CallGraph.h.

Referenced by llvm::DOTGraphTraits< CallGraphDOTInfo * >::getNodeLabel().

◆ getExternalCallingNode()

CallGraphNode * llvm::CallGraph::getExternalCallingNode ( ) const

inline

Returns the CallGraphNode which is used to represent undetermined calls into the callgraph.

Definition at line 127 of file CallGraph.h.

Referenced by llvm::CallGraphUpdater::finalize(), llvm::GraphTraits< CallGraph * >::getEntryNode(), llvm::GraphTraits< CallGraphDOTInfo * >::getEntryNode(), llvm::GraphTraits< const CallGraph * >::getEntryNode(), and llvm::DOTGraphTraits< CallGraphDOTInfo * >::getNodeLabel().

◆ getModule()

Module & llvm::CallGraph::getModule ( ) const

inline

Returns the module the call graph corresponds to.

Definition at line 101 of file CallGraph.h.

◆ getOrInsertFunction()

CallGraphNode * CallGraph::getOrInsertFunction ( const Function * F )

Similar to operator[], but this will insert a new CallGraphNode for F if one does not already exist.

Definition at line 170 of file CallGraph.cpp.

References assert(), and F.

Referenced by addToCallGraph(), llvm::CallGraphUpdater::finalize(), populateCallGraphNode(), llvm::CallGraphUpdater::reanalyzeFunction(), llvm::CallGraphNode::removeCallEdgeFor(), llvm::CallGraphNode::replaceCallEdge(), llvm::CallGraphUpdater::replaceCallSite(), and llvm::CallGraphUpdater::replaceFunctionWith().

◆ invalidate()

bool CallGraph::invalidate	(	Module &	,
		const PreservedAnalyses &	PA,
		ModuleAnalysisManager::Invalidator &
	)

Definition at line 67 of file CallGraph.cpp.

References llvm::PreservedAnalyses::getChecker().

◆ operator[]() [1/2]

CallGraphNode * llvm::CallGraph::operator[] ( const Function * F )

inline

Returns the call graph node for the provided function.

Definition at line 119 of file CallGraph.h.

References assert(), F, and I.

◆ operator[]() [2/2]

const CallGraphNode * llvm::CallGraph::operator[] ( const Function * F ) const

inline

Returns the call graph node for the provided function.

Definition at line 112 of file CallGraph.h.

References assert(), F, and I.

◆ populateCallGraphNode()

void CallGraph::populateCallGraphNode ( CallGraphNode * CGN )

Populate CGN based on the calls inside the associated function.

Definition at line 89 of file CallGraph.cpp.

References F, llvm::forEachCallbackFunction(), getOrInsertFunction(), I, and llvm::isDbgInfoIntrinsic().

Referenced by addToCallGraph(), and llvm::CallGraphUpdater::reanalyzeFunction().

◆ print()

void CallGraph::print ( raw_ostream & OS ) const

Definition at line 115 of file CallGraph.cpp.

References I, if(), LHS, OS, llvm::SmallVectorTemplateBase< T, bool >::push_back(), llvm::SmallVectorImpl< T >::reserve(), RHS, and llvm::sort().

Referenced by dump().

◆ removeFunctionFromModule()

Function * CallGraph::removeFunctionFromModule ( CallGraphNode * CGN )

Unlink the function from this module, returning it.

Because this removes the function from the module, the call graph node is destroyed. This is only valid if the function does not call any other functions (ie, there are no edges in it's CGN). The easiest way to do this is to dropAllReferences before calling this.

Definition at line 157 of file CallGraph.cpp.

References assert(), llvm::CallGraphNode::empty(), F, llvm::CallGraphNode::getFunction(), llvm::Module::getFunctionList(), and llvm::iplist_impl< IntrusiveListT, TraitsT >::remove().

Referenced by llvm::CallGraphUpdater::finalize().

◆ ReplaceExternalCallEdge()

void CallGraph::ReplaceExternalCallEdge	(	CallGraphNode *	Old,
		CallGraphNode *	New
	)

Old node has been deleted, and New is to be used in its place, update the ExternalCallingNode.

Definition at line 141 of file CallGraph.cpp.

Referenced by llvm::CallGraphUpdater::replaceFunctionWith().

The documentation for this class was generated from the following files:

include/llvm/Analysis/CallGraph.h
lib/Analysis/CallGraph.cpp

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ iterator

Constructor & Destructor Documentation

◆ CallGraph() [1/2]

◆ CallGraph() [2/2]

◆ ~CallGraph()

Member Function Documentation

◆ addToCallGraph()

◆ begin() [1/2]

◆ begin() [2/2]

◆ dump()

◆ end() [1/2]

◆ end() [2/2]

◆ getCallsExternalNode()

◆ getExternalCallingNode()

◆ getModule()

◆ getOrInsertFunction()

◆ invalidate()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ populateCallGraphNode()

◆ print()

◆ removeFunctionFromModule()

◆ ReplaceExternalCallEdge()