#include "llvm/IR/MDBuilder.h"

Classes
struct	TBAAStructField

Public Member Functions
	MDBuilder (LLVMContext &context)

MDString *	createString (StringRef Str)
	Return the given string as metadata. More...

ConstantAsMetadata *	createConstant (Constant *C)
	Return the given constant as metadata. More...

MDNode *	createFPMath (float Accuracy)
	Return metadata with the given settings. More...

MDNode *	createBranchWeights (uint32_t TrueWeight, uint32_t FalseWeight)
	Return metadata containing two branch weights. More...

MDNode *	createBranchWeights (ArrayRef< uint32_t > Weights)
	Return metadata containing a number of branch weights. More...

MDNode *	createUnpredictable ()
	Return metadata specifying that a branch or switch is unpredictable. More...

MDNode *	createFunctionEntryCount (uint64_t Count, bool Synthetic, const DenseSet< GlobalValue::GUID > *Imports)
	Return metadata containing the entry `Count` for a function, a boolean indicating whether the counts were synthetized, and the GUIDs stored in `Imports` that need to be imported for sample PGO, to enable the same inlines as the profiled optimized binary. More...

MDNode *	createFunctionSectionPrefix (StringRef Prefix)
	Return metadata containing the section prefix for a function. More...

MDNode *	createRange (const APInt &Lo, const APInt &Hi)
	Return metadata describing the range [Lo, Hi). More...

MDNode *	createRange (Constant Lo, Constant Hi)
	Return metadata describing the range [Lo, Hi). More...

MDNode *	createCallees (ArrayRef< Function *> Callees)
	Return metadata indicating the possible callees of indirect calls. More...

MDNode *	createCallbackEncoding (unsigned CalleeArgNo, ArrayRef< int > Arguments, bool VarArgsArePassed)
	Return metadata describing a callback (see llvm::AbstractCallSite). More...

MDNode *	mergeCallbackEncodings (MDNode ExistingCallbacks, MDNode NewCB)
	Merge the new callback encoding `NewCB` into `ExistingCallbacks`. More...

MDNode *	createAnonymousTBAARoot ()
	Return metadata appropriate for a TBAA root node. More...

MDNode *	createAnonymousAliasScopeDomain (StringRef Name=StringRef())
	Return metadata appropriate for an alias scope domain node. More...

MDNode *	createAnonymousAliasScope (MDNode *Domain, StringRef Name=StringRef())
	Return metadata appropriate for an alias scope root node. More...

MDNode *	createTBAARoot (StringRef Name)
	Return metadata appropriate for a TBAA root node with the given name. More...

MDNode *	createAliasScopeDomain (StringRef Name)
	Return metadata appropriate for an alias scope domain node with the given name. More...

MDNode *	createAliasScope (StringRef Name, MDNode *Domain)
	Return metadata appropriate for an alias scope node with the given name. More...

MDNode *	createTBAANode (StringRef Name, MDNode *Parent, bool isConstant=false)
	Return metadata for a non-root TBAA node with the given name, parent in the TBAA tree, and value for 'pointsToConstantMemory'. More...

MDNode *	createTBAAStructNode (ArrayRef< TBAAStructField > Fields)
	Return metadata for a tbaa.struct node with the given struct field descriptions. More...

MDNode *	createTBAAStructTypeNode (StringRef Name, ArrayRef< std::pair< MDNode *, uint64_t >> Fields)
	Return metadata for a TBAA struct node in the type DAG with the given name, a list of pairs (offset, field type in the type DAG). More...

MDNode *	createTBAAScalarTypeNode (StringRef Name, MDNode *Parent, uint64_t Offset=0)
	Return metadata for a TBAA scalar type node with the given name, an offset and a parent in the TBAA type DAG. More...

MDNode *	createTBAAStructTagNode (MDNode BaseType, MDNode AccessType, uint64_t Offset, bool IsConstant=false)
	Return metadata for a TBAA tag node with the given base type, access type and offset relative to the base type. More...

MDNode *	createTBAATypeNode (MDNode Parent, uint64_t Size, Metadata Id, ArrayRef< TBAAStructField > Fields=ArrayRef< TBAAStructField >())
	Return metadata for a TBAA type node in the TBAA type DAG with the given parent type, size in bytes, type identifier and a list of fields. More...

MDNode *	createTBAAAccessTag (MDNode BaseType, MDNode AccessType, uint64_t Offset, uint64_t Size, bool IsImmutable=false)
	Return metadata for a TBAA access tag with the given base type, final access type, offset of the access relative to the base type, size of the access and flag indicating whether the accessed object can be considered immutable for the purposes of the TBAA analysis. More...

MDNode *	createMutableTBAAAccessTag (MDNode *Tag)
	Return mutable version of the given mutable or immutable TBAA access tag. More...

MDNode *	createIrrLoopHeaderWeight (uint64_t Weight)
	Return metadata containing an irreducible loop header weight. More...

Protected Member Functions
MDNode *	createAnonymousAARoot (StringRef Name=StringRef(), MDNode *Extra=nullptr)
	Return metadata appropriate for a AA root node (scope or TBAA). More...

Detailed Description

Definition at line 34 of file MDBuilder.h.

Constructor & Destructor Documentation

◆ MDBuilder()

llvm::MDBuilder::MDBuilder ( LLVMContext & context )

inline

Definition at line 38 of file MDBuilder.h.

References Arguments, C, createAnonymousAARoot(), createBranchWeights(), createCallbackEncoding(), createCallees(), createConstant(), createFPMath(), createFunctionEntryCount(), createFunctionSectionPrefix(), createRange(), createString(), createUnpredictable(), llvm::MipsISD::Hi, llvm::MipsISD::Lo, mergeCallbackEncodings(), Name, and llvm::cl::Prefix.

Member Function Documentation

◆ createAliasScope()

MDNode * MDBuilder::createAliasScope	(	StringRef	Name,
		MDNode *	Domain
	)

Return metadata appropriate for an alias scope node with the given name.

This may be identified (uniqued) with other scopes with the same name and domain.

Definition at line 195 of file MDBuilder.cpp.

References createString(), and llvm::MDNode::get().

Referenced by createAnonymousAliasScope().

◆ createAliasScopeDomain()

MDNode * MDBuilder::createAliasScopeDomain ( StringRef Name )

Return metadata appropriate for an alias scope domain node with the given name.

This may be identified (uniqued) with other roots with the same name.

Definition at line 191 of file MDBuilder.cpp.

References createString(), and llvm::MDNode::get().

Referenced by createAnonymousAliasScope().

◆ createAnonymousAARoot()

MDNode * MDBuilder::createAnonymousAARoot	(	StringRef	Name = `StringRef()`,
		MDNode *	Extra = `nullptr`
	)

protected

Return metadata appropriate for a AA root node (scope or TBAA).

Each returned node is distinct from all other metadata and will never be identified (uniqued) with anything else.

Definition at line 153 of file MDBuilder.cpp.

References llvm::AMDGPU::HSAMD::Kernel::Key::Args, createString(), llvm::NVPTXISD::Dummy, llvm::StringRef::empty(), llvm::MDNode::get(), llvm::MDNode::getTemporary(), llvm::None, and llvm::MDNode::replaceOperandWith().

Referenced by createAnonymousAliasScope(), createAnonymousAliasScopeDomain(), createAnonymousTBAARoot(), and MDBuilder().

◆ createAnonymousAliasScope()

MDNode* llvm::MDBuilder::createAnonymousAliasScope	(	MDNode *	Domain,
		StringRef	Name = `StringRef()`
	)

inline

Return metadata appropriate for an alias scope root node.

Each returned node is distinct from all other metadata and will never be identified (uniqued) with anything else.

Definition at line 136 of file MDBuilder.h.

References createAliasScope(), createAliasScopeDomain(), createAnonymousAARoot(), createTBAANode(), createTBAARoot(), isConstant(), and Name.

Referenced by llvm::LoopVersioning::prepareNoAliasMetadata().

◆ createAnonymousAliasScopeDomain()

MDNode* llvm::MDBuilder::createAnonymousAliasScopeDomain ( StringRef Name = StringRef() )

inline

Return metadata appropriate for an alias scope domain node.

Each returned node is distinct from all other metadata and will never be identified (uniqued) with anything else.

Definition at line 129 of file MDBuilder.h.

References createAnonymousAARoot(), and Name.

Referenced by llvm::LoopVersioning::prepareNoAliasMetadata().

◆ createAnonymousTBAARoot()

MDNode* llvm::MDBuilder::createAnonymousTBAARoot ( )

inline

Return metadata appropriate for a TBAA root node.

Each returned node is distinct from all other metadata and will never be identified (uniqued) with anything else.

Definition at line 122 of file MDBuilder.h.

References createAnonymousAARoot().

◆ createBranchWeights() [1/2]

MDNode * MDBuilder::createBranchWeights	(	uint32_t	TrueWeight,
		uint32_t	FalseWeight
	)

Return metadata containing two branch weights.

Definition at line 37 of file MDBuilder.cpp.

Referenced by getOrInsertGlobal(), INITIALIZE_PASS(), instrumentMaskedLoadOrStore(), MDBuilder(), RetagMask(), llvm::Instruction::setProfWeight(), SortCallTargets(), and TypeSizeToSizeIndex().

◆ createBranchWeights() [2/2]

MDNode * MDBuilder::createBranchWeights ( ArrayRef< uint32_t > Weights )

Return metadata containing a number of branch weights.

Definition at line 42 of file MDBuilder.cpp.

References assert(), createConstant(), createString(), llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt32Ty(), Int32Ty, and llvm::ArrayRef< T >::size().

◆ createCallbackEncoding()

MDNode * MDBuilder::createCallbackEncoding	(	unsigned	CalleeArgNo,
		ArrayRef< int >	Arguments,
		bool	VarArgsArePassed
	)

Return metadata describing a callback (see llvm::AbstractCallSite).

Definition at line 107 of file MDBuilder.cpp.

References createConstant(), llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt1Ty(), llvm::Type::getInt64Ty(), and llvm::SmallVectorTemplateBase< T >::push_back().

Referenced by MDBuilder().

◆ createCallees()

MDNode * MDBuilder::createCallees ( ArrayRef< Function *> Callees )

Return metadata indicating the possible callees of indirect calls.

Definition at line 100 of file MDBuilder.cpp.

References createConstant(), F(), llvm::MDNode::get(), and llvm::SmallVectorTemplateBase< T >::push_back().

Referenced by MDBuilder().

◆ createConstant()

ConstantAsMetadata * MDBuilder::createConstant ( Constant * C )

Return the given constant as metadata.

Definition at line 24 of file MDBuilder.cpp.

References llvm::ConstantAsMetadata::get().

Referenced by llvm::annotateValueSite(), createBranchWeights(), createCallbackEncoding(), createCallees(), createFPMath(), createFunctionEntryCount(), createIrrLoopHeaderWeight(), createRange(), createTBAAAccessTag(), createTBAANode(), createTBAAScalarTypeNode(), createTBAAStructNode(), createTBAAStructTagNode(), createTBAAStructTypeNode(), createTBAATypeNode(), MDBuilder(), llvm::CGProfilePass::run(), and llvm::CallInst::updateProfWeight().

◆ createFPMath()

MDNode * MDBuilder::createFPMath ( float Accuracy )

Return metadata with the given settings.

The special value 0.0 for the Accuracy parameter indicates the default (maximal precision) setting.

Definition at line 28 of file MDBuilder.cpp.

References assert(), createConstant(), llvm::ConstantFP::get(), llvm::MDNode::get(), and llvm::Type::getFloatTy().

Referenced by MDBuilder().

◆ createFunctionEntryCount()

MDNode * MDBuilder::createFunctionEntryCount	(	uint64_t	Count,
		bool	Synthetic,
		const DenseSet< GlobalValue::GUID > *	Imports
	)

Return metadata containing the entry Count for a function, a boolean indicating whether the counts were synthetized, and the GUIDs stored in Imports that need to be imported for sample PGO, to enable the same inlines as the profiled optimized binary.

Definition at line 59 of file MDBuilder.cpp.

References llvm::detail::DenseSetImpl< ValueT, DenseMap< ValueT, detail::DenseSetEmpty, ValueInfoT, detail::DenseSetPair< ValueT > >, ValueInfoT >::begin(), createConstant(), createString(), llvm::detail::DenseSetImpl< ValueT, DenseMap< ValueT, detail::DenseSetEmpty, ValueInfoT, detail::DenseSetPair< ValueT > >, ValueInfoT >::end(), llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt64Ty(), llvm::SmallVectorTemplateBase< T >::push_back(), and llvm::stable_sort().

Referenced by MDBuilder().

◆ createFunctionSectionPrefix()

MDNode * MDBuilder::createFunctionSectionPrefix ( StringRef Prefix )

Return metadata containing the section prefix for a function.

Definition at line 78 of file MDBuilder.cpp.

References createString(), and llvm::MDNode::get().

Referenced by MDBuilder(), and llvm::Function::setSectionPrefix().

◆ createIrrLoopHeaderWeight()

MDNode * MDBuilder::createIrrLoopHeaderWeight ( uint64_t Weight )

Return metadata containing an irreducible loop header weight.

Definition at line 305 of file MDBuilder.cpp.

References createConstant(), createString(), llvm::ConstantInt::get(), llvm::MDNode::get(), and llvm::Type::getInt64Ty().

Referenced by llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createMutableTBAAAccessTag()

MDNode * MDBuilder::createMutableTBAAAccessTag ( MDNode * Tag )

Return mutable version of the given mutable or immutable TBAA access tag.

Definition at line 278 of file MDBuilder.cpp.

References createTBAAAccessTag(), createTBAAStructTagNode(), llvm::MDNode::getNumOperands(), llvm::MDNode::getOperand(), Size, and llvm::Tag.

Referenced by stripNonValidDataFromBody(), and llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createRange() [1/2]

MDNode * MDBuilder::createRange	(	const APInt &	Lo,
		const APInt &	Hi
	)

Return metadata describing the range [Lo, Hi).

Definition at line 84 of file MDBuilder.cpp.

References assert(), llvm::IntegerType::get(), llvm::ConstantInt::get(), and llvm::APInt::getBitWidth().

Referenced by MDBuilder().

◆ createRange() [2/2]

MDNode * MDBuilder::createRange	(	Constant *	Lo,
		Constant *	Hi
	)

Return metadata describing the range [Lo, Hi).

Definition at line 91 of file MDBuilder.cpp.

References createConstant(), and llvm::MDNode::get().

◆ createString()

MDString * MDBuilder::createString ( StringRef Str )

Return the given string as metadata.

Definition at line 20 of file MDBuilder.cpp.

References llvm::MDString::get().

Referenced by llvm::annotateValueSite(), createAliasScope(), createAliasScopeDomain(), createAnonymousAARoot(), createBranchWeights(), createFunctionEntryCount(), createFunctionSectionPrefix(), createIrrLoopHeaderWeight(), createTBAANode(), createTBAARoot(), createTBAAScalarTypeNode(), createTBAAStructTypeNode(), and MDBuilder().

◆ createTBAAAccessTag()

MDNode * MDBuilder::createTBAAAccessTag	(	MDNode *	BaseType,
		MDNode *	AccessType,
		uint64_t	Offset,
		uint64_t	Size,
		bool	IsImmutable = `false`
	)

Return metadata for a TBAA access tag with the given base type, final access type, offset of the access relative to the base type, size of the access and flag indicating whether the accessed object can be considered immutable for the purposes of the TBAA analysis.

Definition at line 264 of file MDBuilder.cpp.

References createConstant(), llvm::ConstantInt::get(), llvm::MDNode::get(), and llvm::Type::getInt64Ty().

Referenced by createMutableTBAAAccessTag(), and llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createTBAANode()

MDNode * MDBuilder::createTBAANode	(	StringRef	Name,
		MDNode *	Parent,
		bool	isConstant = `false`
	)

Return metadata for a non-root TBAA node with the given name, parent in the TBAA tree, and value for 'pointsToConstantMemory'.

Definition at line 181 of file MDBuilder.cpp.

References createConstant(), createString(), llvm::ConstantInt::get(), llvm::MDNode::get(), and llvm::Type::getInt64Ty().

Referenced by createAnonymousAliasScope().

◆ createTBAARoot()

MDNode * MDBuilder::createTBAARoot ( StringRef Name )

Return metadata appropriate for a TBAA root node with the given name.

This may be identified (uniqued) with other roots with the same name.

Definition at line 175 of file MDBuilder.cpp.

References createString(), and llvm::MDNode::get().

Referenced by createAnonymousAliasScope().

◆ createTBAAScalarTypeNode()

MDNode * MDBuilder::createTBAAScalarTypeNode	(	StringRef	Name,
		MDNode *	Parent,
		uint64_t	Offset = `0`
	)

Return metadata for a TBAA scalar type node with the given name, an offset and a parent in the TBAA type DAG.

Definition at line 228 of file MDBuilder.cpp.

References createConstant(), createString(), llvm::ConstantInt::get(), llvm::MDNode::get(), and llvm::Type::getInt64Ty().

Referenced by llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createTBAAStructNode()

MDNode * MDBuilder::createTBAAStructNode ( ArrayRef< TBAAStructField > Fields )

Return metadata for a tbaa.struct node with the given struct field descriptions.

Definition at line 201 of file MDBuilder.cpp.

References createConstant(), llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt64Ty(), Size, and llvm::ArrayRef< T >::size().

Referenced by llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createTBAAStructTagNode()

MDNode * MDBuilder::createTBAAStructTagNode	(	MDNode *	BaseType,
		MDNode *	AccessType,
		uint64_t	Offset,
		bool	IsConstant = `false`
	)

Return metadata for a TBAA tag node with the given base type, access type and offset relative to the base type.

Definition at line 237 of file MDBuilder.cpp.

References createConstant(), llvm::ConstantInt::get(), llvm::MDNode::get(), and llvm::Type::getInt64Ty().

Referenced by createMutableTBAAAccessTag(), and llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createTBAAStructTypeNode()

MDNode * MDBuilder::createTBAAStructTypeNode	(	StringRef	Name,
		ArrayRef< std::pair< MDNode *, uint64_t >>	Fields
	)

Return metadata for a TBAA struct node in the type DAG with the given name, a list of pairs (offset, field type in the type DAG).

Definition at line 214 of file MDBuilder.cpp.

References createConstant(), createString(), llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt64Ty(), and second.

Referenced by llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createTBAATypeNode()

MDNode * MDBuilder::createTBAATypeNode	(	MDNode *	Parent,
		uint64_t	Size,
		Metadata *	Id,
		ArrayRef< TBAAStructField >	Fields = `ArrayRef<TBAAStructField>()`
	)

Return metadata for a TBAA type node in the TBAA type DAG with the given parent type, size in bytes, type identifier and a list of fields.

Definition at line 248 of file MDBuilder.cpp.

References createConstant(), E, llvm::ConstantInt::get(), llvm::MDNode::get(), llvm::Type::getInt64Ty(), I, and llvm::ArrayRef< T >::size().

Referenced by llvm::MDBuilder::TBAAStructField::TBAAStructField().

◆ createUnpredictable()

MDNode * MDBuilder::createUnpredictable ( )

Return metadata specifying that a branch or switch is unpredictable.

Definition at line 55 of file MDBuilder.cpp.

References llvm::MDNode::get(), and llvm::None.

Referenced by MDBuilder().

◆ mergeCallbackEncodings()

MDNode * MDBuilder::mergeCallbackEncodings	(	MDNode *	ExistingCallbacks,
		MDNode *	NewCB
	)

Merge the new callback encoding NewCB into ExistingCallbacks.

Definition at line 124 of file MDBuilder.cpp.

References assert(), llvm::MDNode::get(), llvm::MDNode::getNumOperands(), llvm::MDNode::getOperand(), and llvm::SmallVectorImpl< T >::resize().

Referenced by MDBuilder().

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

include/llvm/IR/MDBuilder.h
lib/IR/MDBuilder.cpp

Classes

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ MDBuilder()

Member Function Documentation

◆ createAliasScope()

◆ createAliasScopeDomain()

◆ createAnonymousAARoot()

◆ createAnonymousAliasScope()

◆ createAnonymousAliasScopeDomain()

◆ createAnonymousTBAARoot()

◆ createBranchWeights() [1/2]

◆ createBranchWeights() [2/2]

◆ createCallbackEncoding()

◆ createCallees()

◆ createConstant()

◆ createFPMath()

◆ createFunctionEntryCount()

◆ createFunctionSectionPrefix()

◆ createIrrLoopHeaderWeight()

◆ createMutableTBAAAccessTag()

◆ createRange() [1/2]

◆ createRange() [2/2]

◆ createString()

◆ createTBAAAccessTag()

◆ createTBAANode()

◆ createTBAARoot()

◆ createTBAAScalarTypeNode()

◆ createTBAAStructNode()

◆ createTBAAStructTagNode()

◆ createTBAAStructTypeNode()

◆ createTBAATypeNode()

◆ createUnpredictable()

◆ mergeCallbackEncodings()