LLVM  8.0.1
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Static Protected Attributes | Friends | List of all members
llvm::GlobalValue Class Reference

#include "llvm/IR/GlobalValue.h"

Inheritance diagram for llvm::GlobalValue:
Inheritance graph
[legend]
Collaboration diagram for llvm::GlobalValue:
Collaboration graph
[legend]

Public Types

enum  LinkageTypes {
  ExternalLinkage = 0, AvailableExternallyLinkage, LinkOnceAnyLinkage, LinkOnceODRLinkage,
  WeakAnyLinkage, WeakODRLinkage, AppendingLinkage, InternalLinkage,
  PrivateLinkage, ExternalWeakLinkage, CommonLinkage
}
 An enumeration for the kinds of linkage for global values. More...
 
enum  VisibilityTypes { DefaultVisibility = 0, HiddenVisibility, ProtectedVisibility }
 An enumeration for the kinds of visibility of global values. More...
 
enum  DLLStorageClassTypes { DefaultStorageClass = 0, DLLImportStorageClass = 1, DLLExportStorageClass = 2 }
 Storage classes of global values for PE targets. More...
 
enum  ThreadLocalMode {
  NotThreadLocal = 0, GeneralDynamicTLSModel, LocalDynamicTLSModel, InitialExecTLSModel,
  LocalExecTLSModel
}
 
enum  UnnamedAddr { UnnamedAddr::None, UnnamedAddr::Local, UnnamedAddr::Global }
 
using GUID = uint64_t
 Declare a type to represent a global unique identifier for a global value. More...
 
- Public Types inherited from llvm::User
using op_iterator = Use *
 
using const_op_iterator = const Use *
 
using op_range = iterator_range< op_iterator >
 
using const_op_range = iterator_range< const_op_iterator >
 
- Public Types inherited from llvm::Value
enum  ValueTy
 Concrete subclass of this. More...
 
using use_iterator = use_iterator_impl< Use >
 
using const_use_iterator = use_iterator_impl< const Use >
 
using user_iterator = user_iterator_impl< User >
 
using const_user_iterator = user_iterator_impl< const User >
 

Public Member Functions

 GlobalValue (const GlobalValue &)=delete
 
unsigned getAlignment () const
 
unsigned getAddressSpace () const
 
bool hasGlobalUnnamedAddr () const
 
bool hasAtLeastLocalUnnamedAddr () const
 Returns true if this value's address is not significant in this module. More...
 
UnnamedAddr getUnnamedAddr () const
 
void setUnnamedAddr (UnnamedAddr Val)
 
bool hasComdat () const
 
const ComdatgetComdat () const
 
ComdatgetComdat ()
 
VisibilityTypes getVisibility () const
 
bool hasDefaultVisibility () const
 
bool hasHiddenVisibility () const
 
bool hasProtectedVisibility () const
 
void setVisibility (VisibilityTypes V)
 
bool isThreadLocal () const
 If the value is "Thread Local", its value isn't shared by the threads. More...
 
void setThreadLocal (bool Val)
 
void setThreadLocalMode (ThreadLocalMode Val)
 
ThreadLocalMode getThreadLocalMode () const
 
DLLStorageClassTypes getDLLStorageClass () const
 
bool hasDLLImportStorageClass () const
 
bool hasDLLExportStorageClass () const
 
void setDLLStorageClass (DLLStorageClassTypes C)
 
bool hasSection () const
 
StringRef getSection () const
 
PointerTypegetType () const
 Global values are always pointers. More...
 
TypegetValueType () const
 
void setDSOLocal (bool Local)
 
bool isDSOLocal () const
 
bool isDefinitionExact () const
 Return true if the currently visible definition of this global (if any) is exactly the definition we will see at runtime. More...
 
bool hasExactDefinition () const
 Return true if this global has an exact defintion. More...
 
bool isInterposable () const
 Return true if this global's definition can be substituted with an arbitrary definition at link time. More...
 
bool hasExternalLinkage () const
 
bool hasAvailableExternallyLinkage () const
 
bool hasLinkOnceLinkage () const
 
bool hasLinkOnceODRLinkage () const
 
bool hasWeakLinkage () const
 
bool hasWeakAnyLinkage () const
 
bool hasWeakODRLinkage () const
 
bool hasAppendingLinkage () const
 
bool hasInternalLinkage () const
 
bool hasPrivateLinkage () const
 
bool hasLocalLinkage () const
 
bool hasExternalWeakLinkage () const
 
bool hasCommonLinkage () const
 
bool hasValidDeclarationLinkage () const
 
void setLinkage (LinkageTypes LT)
 
LinkageTypes getLinkage () const
 
bool isDiscardableIfUnused () const
 
bool isWeakForLinker () const
 
std::string getGlobalIdentifier () const
 Return the modified name for this global value suitable to be used as the key for a global lookup (e.g. More...
 
GUID getGUID () const
 Return a 64-bit global unique ID constructed from global value name (i.e. More...
 
bool isDeclaration () const
 Return true if the primary definition of this global value is outside of the current translation unit. More...
 
bool isDeclarationForLinker () const
 
bool isStrongDefinitionForLinker () const
 Returns true if this global's definition will be the one chosen by the linker. More...
 
bool canIncreaseAlignment () const
 
const GlobalObjectgetBaseObject () const
 
GlobalObjectgetBaseObject ()
 
bool isAbsoluteSymbolRef () const
 Returns whether this is a reference to an absolute symbol. More...
 
Optional< ConstantRangegetAbsoluteSymbolRange () const
 If this is an absolute symbol reference, returns the range of the symbol, otherwise returns None. More...
 
void removeFromParent ()
 This method unlinks 'this' from the containing module, but does not delete it. More...
 
void eraseFromParent ()
 This method unlinks 'this' from the containing module and deletes it. More...
 
ModulegetParent ()
 Get the module that this global value is contained inside of... More...
 
const ModulegetParent () const
 
bool canBeOmittedFromSymbolTable () const
 True if GV can be left out of the object symbol table. More...
 
Materialization

Materialization is used to construct functions only as they're needed.

This is useful to reduce memory usage in LLVM or parsing work done by the BitcodeReader to load the Module.

bool isMaterializable () const
 If this function's Module is being lazily streamed in functions from disk or some other source, this method can be used to check to see if the function has been read in yet or not. More...
 
Error materialize ()
 Make sure this GlobalValue is fully read. More...
 
- Public Member Functions inherited from llvm::Constant
void operator= (const Constant &)=delete
 
 Constant (const Constant &)=delete
 
bool isNullValue () const
 Return true if this is the value that would be returned by getNullValue. More...
 
bool isOneValue () const
 Returns true if the value is one. More...
 
bool isAllOnesValue () const
 Return true if this is the value that would be returned by getAllOnesValue. More...
 
bool isNegativeZeroValue () const
 Return true if the value is what would be returned by getZeroValueForNegation. More...
 
bool isZeroValue () const
 Return true if the value is negative zero or null value. More...
 
bool isNotMinSignedValue () const
 Return true if the value is not the smallest signed value. More...
 
bool isMinSignedValue () const
 Return true if the value is the smallest signed value. More...
 
bool isFiniteNonZeroFP () const
 Return true if this is a finite and non-zero floating-point scalar constant or a vector constant with all finite and non-zero elements. More...
 
bool isNormalFP () const
 Return true if this is a normal (as opposed to denormal) floating-point scalar constant or a vector constant with all normal elements. More...
 
bool hasExactInverseFP () const
 Return true if this scalar has an exact multiplicative inverse or this vector has an exact multiplicative inverse for each element in the vector. More...
 
bool isNaN () const
 Return true if this is a floating-point NaN constant or a vector floating-point constant with all NaN elements. More...
 
bool containsUndefElement () const
 Return true if this is a vector constant that includes any undefined elements. More...
 
bool canTrap () const
 Return true if evaluation of this constant could trap. More...
 
bool isThreadDependent () const
 Return true if the value can vary between threads. More...
 
bool isDLLImportDependent () const
 Return true if the value is dependent on a dllimport variable. More...
 
bool isConstantUsed () const
 Return true if the constant has users other than constant expressions and other dangling things. More...
 
bool needsRelocation () const
 This method classifies the entry according to whether or not it may generate a relocation entry. More...
 
ConstantgetAggregateElement (unsigned Elt) const
 For aggregates (struct/array/vector) return the constant that corresponds to the specified element if possible, or null if not. More...
 
ConstantgetAggregateElement (Constant *Elt) const
 
ConstantgetSplatValue () const
 If this is a splat vector constant, meaning that all of the elements have the same value, return that value. More...
 
const APIntgetUniqueInteger () const
 If C is a constant integer then return its value, otherwise C must be a vector of constant integers, all equal, and the common value is returned. More...
 
void destroyConstant ()
 Called if some element of this constant is no longer valid. More...
 
void handleOperandChange (Value *, Value *)
 This method is a special form of User::replaceUsesOfWith (which does not work on constants) that does work on constants. More...
 
void removeDeadConstantUsers () const
 If there are any dead constant users dangling off of this constant, remove them. More...
 
const ConstantstripPointerCasts () const
 
ConstantstripPointerCasts ()
 
- Public Member Functions inherited from llvm::User
 User (const User &)=delete
 
void operator delete (void *Usr)
 Free memory allocated for User and Use objects. More...
 
void operator delete (void *Usr, unsigned)
 Placement delete - required by std, called if the ctor throws. More...
 
void operator delete (void *Usr, unsigned, bool)
 Placement delete - required by std, called if the ctor throws. More...
 
const UsegetOperandList () const
 
UsegetOperandList ()
 
ValuegetOperand (unsigned i) const
 
void setOperand (unsigned i, Value *Val)
 
const UsegetOperandUse (unsigned i) const
 
UsegetOperandUse (unsigned i)
 
unsigned getNumOperands () const
 
ArrayRef< const uint8_t > getDescriptor () const
 Returns the descriptor co-allocated with this User instance. More...
 
MutableArrayRef< uint8_t > getDescriptor ()
 Returns the descriptor co-allocated with this User instance. More...
 
void setGlobalVariableNumOperands (unsigned NumOps)
 Set the number of operands on a GlobalVariable. More...
 
void setNumHungOffUseOperands (unsigned NumOps)
 Subclasses with hung off uses need to manage the operand count themselves. More...
 
op_iterator op_begin ()
 
const_op_iterator op_begin () const
 
op_iterator op_end ()
 
const_op_iterator op_end () const
 
op_range operands ()
 
const_op_range operands () const
 
value_op_iterator value_op_begin ()
 
value_op_iterator value_op_end ()
 
iterator_range< value_op_iteratoroperand_values ()
 
const_value_op_iterator value_op_begin () const
 
const_value_op_iterator value_op_end () const
 
iterator_range< const_value_op_iteratoroperand_values () const
 
void dropAllReferences ()
 Drop all references to operands. More...
 
void replaceUsesOfWith (Value *From, Value *To)
 Replace uses of one Value with another. More...
 
- Public Member Functions inherited from llvm::Value
 Value (const Value &)=delete
 
Valueoperator= (const Value &)=delete
 
void deleteValue ()
 Delete a pointer to a generic Value. More...
 
void dump () const
 Support for debugging, callable in GDB: V->dump() More...
 
TypegetType () const
 All values are typed, get the type of this value. More...
 
LLVMContextgetContext () const
 All values hold a context through their type. More...
 
bool hasName () const
 
ValueNamegetValueName () const
 
void setValueName (ValueName *VN)
 
StringRef getName () const
 Return a constant reference to the value's name. More...
 
void setName (const Twine &Name)
 Change the name of the value. More...
 
void takeName (Value *V)
 Transfer the name from V to this value. More...
 
void replaceAllUsesWith (Value *V)
 Change all uses of this to point to a new Value. More...
 
void replaceNonMetadataUsesWith (Value *V)
 Change non-metadata uses of this to point to a new Value. More...
 
void replaceUsesOutsideBlock (Value *V, BasicBlock *BB)
 replaceUsesOutsideBlock - Go through the uses list for this definition and make each use point to "V" instead of "this" when the use is outside the block. More...
 
void assertModuleIsMaterializedImpl () const
 
void assertModuleIsMaterialized () const
 
bool use_empty () const
 
bool materialized_use_empty () const
 
use_iterator materialized_use_begin ()
 
const_use_iterator materialized_use_begin () const
 
use_iterator use_begin ()
 
const_use_iterator use_begin () const
 
use_iterator use_end ()
 
const_use_iterator use_end () const
 
iterator_range< use_iteratormaterialized_uses ()
 
iterator_range< const_use_iteratormaterialized_uses () const
 
iterator_range< use_iteratoruses ()
 
iterator_range< const_use_iteratoruses () const
 
bool user_empty () const
 
user_iterator materialized_user_begin ()
 
const_user_iterator materialized_user_begin () const
 
user_iterator user_begin ()
 
const_user_iterator user_begin () const
 
user_iterator user_end ()
 
const_user_iterator user_end () const
 
Useruser_back ()
 
const Useruser_back () const
 
iterator_range< user_iteratormaterialized_users ()
 
iterator_range< const_user_iteratormaterialized_users () const
 
iterator_range< user_iteratorusers ()
 
iterator_range< const_user_iteratorusers () const
 
bool hasOneUse () const
 Return true if there is exactly one user of this value. More...
 
bool hasNUses (unsigned N) const
 Return true if this Value has exactly N users. More...
 
bool hasNUsesOrMore (unsigned N) const
 Return true if this value has N users or more. More...
 
bool isUsedInBasicBlock (const BasicBlock *BB) const
 Check if this value is used in the specified basic block. More...
 
unsigned getNumUses () const
 This method computes the number of uses of this Value. More...
 
void addUse (Use &U)
 This method should only be used by the Use class. More...
 
unsigned getValueID () const
 Return an ID for the concrete type of this object. More...
 
unsigned getRawSubclassOptionalData () const
 Return the raw optional flags value contained in this value. More...
 
void clearSubclassOptionalData ()
 Clear the optional flags contained in this value. More...
 
bool hasSameSubclassOptionalData (const Value *V) const
 Check the optional flags for equality. More...
 
bool hasValueHandle () const
 Return true if there is a value handle associated with this value. More...
 
bool isUsedByMetadata () const
 Return true if there is metadata referencing this value. More...
 
bool isSwiftError () const
 Return true if this value is a swifterror value. More...
 
const ValuestripPointerCasts () const
 Strip off pointer casts, all-zero GEPs, and aliases. More...
 
ValuestripPointerCasts ()
 
const ValuestripPointerCastsAndInvariantGroups () const
 Strip off pointer casts, all-zero GEPs, aliases and invariant group info. More...
 
ValuestripPointerCastsAndInvariantGroups ()
 
const ValuestripPointerCastsNoFollowAliases () const
 Strip off pointer casts and all-zero GEPs. More...
 
ValuestripPointerCastsNoFollowAliases ()
 
const ValuestripInBoundsConstantOffsets () const
 Strip off pointer casts and all-constant inbounds GEPs. More...
 
ValuestripInBoundsConstantOffsets ()
 
const ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset) const
 Accumulate offsets from stripInBoundsConstantOffsets(). More...
 
ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset)
 
const ValuestripInBoundsOffsets () const
 Strip off pointer casts and inbounds GEPs. More...
 
ValuestripInBoundsOffsets ()
 
uint64_t getPointerDereferenceableBytes (const DataLayout &DL, bool &CanBeNull) const
 Returns the number of bytes known to be dereferenceable for the pointer value. More...
 
unsigned getPointerAlignment (const DataLayout &DL) const
 Returns an alignment of the pointer value. More...
 
const ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB) const
 Translate PHI node to its predecessor from the given basic block. More...
 
ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB)
 
void mutateType (Type *Ty)
 Mutate the type of this Value to be of the specified type. More...
 
template<class Compare >
void sortUseList (Compare Cmp)
 Sort the use-list. More...
 
void reverseUseList ()
 Reverse the use-list. More...
 
void print (raw_ostream &O, bool IsForDebug=false) const
 Implement operator<< on Value. More...
 
void print (raw_ostream &O, ModuleSlotTracker &MST, bool IsForDebug=false) const
 
void printAsOperand (raw_ostream &O, bool PrintType=true, const Module *M=nullptr) const
 Print the name of this Value out to the specified raw_ostream. More...
 
void printAsOperand (raw_ostream &O, bool PrintType, ModuleSlotTracker &MST) const
 

Static Public Member Functions

static UnnamedAddr getMinUnnamedAddr (UnnamedAddr A, UnnamedAddr B)
 
static LinkageTypes getLinkOnceLinkage (bool ODR)
 
static LinkageTypes getWeakLinkage (bool ODR)
 
static bool isExternalLinkage (LinkageTypes Linkage)
 
static bool isAvailableExternallyLinkage (LinkageTypes Linkage)
 
static bool isLinkOnceODRLinkage (LinkageTypes Linkage)
 
static bool isLinkOnceLinkage (LinkageTypes Linkage)
 
static bool isWeakAnyLinkage (LinkageTypes Linkage)
 
static bool isWeakODRLinkage (LinkageTypes Linkage)
 
static bool isWeakLinkage (LinkageTypes Linkage)
 
static bool isAppendingLinkage (LinkageTypes Linkage)
 
static bool isInternalLinkage (LinkageTypes Linkage)
 
static bool isPrivateLinkage (LinkageTypes Linkage)
 
static bool isLocalLinkage (LinkageTypes Linkage)
 
static bool isExternalWeakLinkage (LinkageTypes Linkage)
 
static bool isCommonLinkage (LinkageTypes Linkage)
 
static bool isValidDeclarationLinkage (LinkageTypes Linkage)
 
static bool isInterposableLinkage (LinkageTypes Linkage)
 Whether the definition of this global may be replaced by something non-equivalent at link time. More...
 
static bool isDiscardableIfUnused (LinkageTypes Linkage)
 Whether the definition of this global may be discarded if it is not used in its compilation unit. More...
 
static bool isWeakForLinker (LinkageTypes Linkage)
 Whether the definition of this global may be replaced at link time. More...
 
static StringRef dropLLVMManglingEscape (StringRef Name)
 If the given string begins with the GlobalValue name mangling escape character '\1', drop it. More...
 
static std::string getGlobalIdentifier (StringRef Name, GlobalValue::LinkageTypes Linkage, StringRef FileName)
 Return the modified name for a global value suitable to be used as the key for a global lookup (e.g. More...
 
static GUID getGUID (StringRef GlobalName)
 Return a 64-bit global unique ID constructed from global value name (i.e. More...
 
static bool classof (const Value *V)
 
- Static Public Member Functions inherited from llvm::Constant
static bool classof (const Value *V)
 
static ConstantgetNullValue (Type *Ty)
 Constructor to create a '0' constant of arbitrary type. More...
 
static ConstantgetAllOnesValue (Type *Ty)
 
static ConstantgetIntegerValue (Type *Ty, const APInt &V)
 Return the value for an integer or pointer constant, or a vector thereof, with the given scalar value. More...
 
- Static Public Member Functions inherited from llvm::User
static bool classof (const Value *V)
 

Protected Member Functions

 GlobalValue (Type *Ty, ValueTy VTy, Use *Ops, unsigned NumOps, LinkageTypes Linkage, const Twine &Name, unsigned AddressSpace)
 
unsigned getGlobalValueSubClassData () const
 
void setGlobalValueSubClassData (unsigned V)
 
void setParent (Module *parent)
 
 ~GlobalValue ()
 
void copyAttributesFrom (const GlobalValue *Src)
 Copy all additional attributes (those not needed to create a GlobalValue) from the GlobalValue Src to this one. More...
 
- Protected Member Functions inherited from llvm::Constant
 Constant (Type *ty, ValueTy vty, Use *Ops, unsigned NumOps)
 
- Protected Member Functions inherited from llvm::User
void * operator new (size_t Size)
 Allocate a User with an operand pointer co-allocated. More...
 
void * operator new (size_t Size, unsigned Us)
 Allocate a User with the operands co-allocated. More...
 
void * operator new (size_t Size, unsigned Us, unsigned DescBytes)
 Allocate a User with the operands co-allocated. More...
 
 User (Type *ty, unsigned vty, Use *, unsigned NumOps)
 
void allocHungoffUses (unsigned N, bool IsPhi=false)
 Allocate the array of Uses, followed by a pointer (with bottom bit set) to the User. More...
 
void growHungoffUses (unsigned N, bool IsPhi=false)
 Grow the number of hung off uses. More...
 
 ~User ()=default
 
template<int Idx>
UseOp ()
 
template<int Idx>
const UseOp () const
 
- Protected Member Functions inherited from llvm::Value
 Value (Type *Ty, unsigned scid)
 
 ~Value ()
 Value's destructor should be virtual by design, but that would require that Value and all of its subclasses have a vtable that effectively duplicates the information in the value ID. More...
 
unsigned short getSubclassDataFromValue () const
 
void setValueSubclassData (unsigned short D)
 

Protected Attributes

TypeValueType
 
unsigned Linkage: 4
 
unsigned Visibility: 2
 
unsigned UnnamedAddrVal: 2
 
unsigned DllStorageClass: 2
 
unsigned ThreadLocal: 3
 
unsigned HasLLVMReservedName: 1
 True if the function's name starts with "llvm.". More...
 
unsigned IsDSOLocal: 1
 If true then there is a definition within the same linkage unit and that definition cannot be runtime preempted. More...
 
Intrinsic::ID IntID
 The intrinsic ID for this subclass (which must be a Function). More...
 
ModuleParent
 
- Protected Attributes inherited from llvm::Value
unsigned char SubclassOptionalData: 7
 Hold subclass data that can be dropped. More...
 
unsigned NumUserOperands: NumUserOperandsBits
 
unsigned IsUsedByMD: 1
 
unsigned HasName: 1
 
unsigned HasHungOffUses: 1
 
unsigned HasDescriptor: 1
 

Static Protected Attributes

static const unsigned GlobalValueSubClassDataBits = 17
 

Friends

class Constant
 

Additional Inherited Members

- Static Public Attributes inherited from llvm::Value
static const unsigned MaxAlignmentExponent = 29
 The maximum alignment for instructions. More...
 
static const unsigned MaximumAlignment = 1u << MaxAlignmentExponent
 
- Protected Types inherited from llvm::Value
enum  : unsigned { NumUserOperandsBits = 28 }
 The number of operands in the subclass. More...
 
- Static Protected Member Functions inherited from llvm::User
template<int Idx, typename U >
static UseOpFrom (const U *that)
 

Detailed Description

Definition at line 45 of file GlobalValue.h.

Member Typedef Documentation

◆ GUID

using llvm::GlobalValue::GUID = uint64_t

Declare a type to represent a global unique identifier for a global value.

This is a 64 bits hash that is used by PGO and ThinLTO to have a compact unique way to identify a symbol.

Definition at line 493 of file GlobalValue.h.

Member Enumeration Documentation

◆ DLLStorageClassTypes

Storage classes of global values for PE targets.

Enumerator
DefaultStorageClass 
DLLImportStorageClass 

Function to be imported from DLL.

DLLExportStorageClass 

Function to be accessible from DLL.

Definition at line 70 of file GlobalValue.h.

◆ LinkageTypes

An enumeration for the kinds of linkage for global values.

Enumerator
ExternalLinkage 

Externally visible function.

AvailableExternallyLinkage 

Available for inspection, not emission.

LinkOnceAnyLinkage 

Keep one copy of function when linking (inline)

LinkOnceODRLinkage 

Same, but only replaced by something equivalent.

WeakAnyLinkage 

Keep one copy of named function when linking (weak)

WeakODRLinkage 

Same, but only replaced by something equivalent.

AppendingLinkage 

Special purpose, only applies to global arrays.

InternalLinkage 

Rename collisions when linking (static functions).

PrivateLinkage 

Like Internal, but omit from symbol table.

ExternalWeakLinkage 

ExternalWeak linkage description.

CommonLinkage 

Tentative definitions.

Definition at line 48 of file GlobalValue.h.

◆ ThreadLocalMode

Enumerator
NotThreadLocal 
GeneralDynamicTLSModel 
LocalDynamicTLSModel 
InitialExecTLSModel 
LocalExecTLSModel 

Definition at line 181 of file GlobalValue.h.

◆ UnnamedAddr

Enumerator
None 
Local 
Global 

Definition at line 194 of file GlobalValue.h.

◆ VisibilityTypes

An enumeration for the kinds of visibility of global values.

Enumerator
DefaultVisibility 

The GV is visible.

HiddenVisibility 

The GV is hidden.

ProtectedVisibility 

The GV is protected.

Definition at line 63 of file GlobalValue.h.

Constructor & Destructor Documentation

◆ GlobalValue() [1/2]

llvm::GlobalValue::GlobalValue ( Type Ty,
ValueTy  VTy,
Use Ops,
unsigned  NumOps,
LinkageTypes  Linkage,
const Twine Name,
unsigned  AddressSpace 
)
inlineprotected

Definition at line 77 of file GlobalValue.h.

References llvm::None.

◆ ~GlobalValue()

llvm::GlobalValue::~GlobalValue ( )
inlineprotected

Definition at line 176 of file GlobalValue.h.

◆ GlobalValue() [2/2]

llvm::GlobalValue::GlobalValue ( const GlobalValue )
delete

Member Function Documentation

◆ canBeOmittedFromSymbolTable()

bool GlobalValue::canBeOmittedFromSymbolTable ( ) const

True if GV can be left out of the object symbol table.

This is the case for linkonce_odr values whose address is not significant. While legal, it is not normally profitable to omit them from the .o symbol table. Using this analysis makes sense when the information can be passed down to the linker or we are in LTO.

Definition at line 289 of file Globals.cpp.

References hasAtLeastLocalUnnamedAddr(), hasGlobalUnnamedAddr(), and hasLinkOnceODRLinkage().

Referenced by canBeHidden(), and llvm::LTOModule::makeBuffer().

◆ canIncreaseAlignment()

bool GlobalValue::canIncreaseAlignment ( ) const

◆ classof()

static bool llvm::GlobalValue::classof ( const Value V)
inlinestatic

Definition at line 570 of file GlobalValue.h.

References llvm::Value::getValueID().

◆ copyAttributesFrom()

void GlobalValue::copyAttributesFrom ( const GlobalValue Src)
protected

Copy all additional attributes (those not needed to create a GlobalValue) from the GlobalValue Src to this one.

copyAttributesFrom - copy all additional attributes (those not needed to create a GlobalValue) from the GlobalValue Src to this one.

Definition at line 66 of file Globals.cpp.

References getDLLStorageClass(), getUnnamedAddr(), getVisibility(), isDSOLocal(), setDLLStorageClass(), setDSOLocal(), setUnnamedAddr(), and setVisibility().

Referenced by llvm::GlobalIFunc::copyAttributesFrom(), llvm::GlobalAlias::copyAttributesFrom(), and llvm::GlobalObject::copyAttributesFrom().

◆ dropLLVMManglingEscape()

static StringRef llvm::GlobalValue::dropLLVMManglingEscape ( StringRef  Name)
inlinestatic

If the given string begins with the GlobalValue name mangling escape character '\1', drop it.

This function applies a specific mangling that is used in PGO profiles, among other things. If you're trying to get a symbol name for an arbitrary GlobalValue, this is not the function you're looking for; see Mangler.h.

Definition at line 472 of file GlobalValue.h.

References llvm::StringRef::empty(), Name, and llvm::StringRef::substr().

Referenced by llvm::DwarfUnit::addLinkageName(), llvm::DiagnosticInfoOptimizationBase::Argument::Argument(), llvm::WinException::beginFunction(), llvm::lto::createWriteIndexesThinBackend(), llvm::AsmPrinter::EmitDebugValue(), llvm::WinException::endFunclet(), getMCSymbolForMBB(), llvm::DiagnosticInfoOptimizationBase::getMsg(), getUnderlyingArgReg(), INITIALIZE_PASS(), instrumentMaskedLoadOrStore(), recoverFramePointer(), llvm::lto::LTO::run(), and sanitizeFunctionName().

◆ eraseFromParent()

void GlobalValue::eraseFromParent ( )

This method unlinks 'this' from the containing module and deletes it.

Definition at line 85 of file Globals.cpp.

References llvm::Value::getValueID(), and llvm_unreachable.

Referenced by deleteIfDead(), FunctionNumber(), getArrayElements(), getMinVisibility(), maybeSetDSOLocal(), and llvm::GlobalDCEPass::run().

◆ getAbsoluteSymbolRange()

Optional< ConstantRange > GlobalValue::getAbsoluteSymbolRange ( ) const

If this is an absolute symbol reference, returns the range of the symbol, otherwise returns None.

Definition at line 277 of file Globals.cpp.

References llvm::dyn_cast(), llvm::getConstantRangeFromMetadata(), llvm::LLVMContext::MD_absolute_symbol, and llvm::None.

Referenced by llvm::X86Subtarget::classifyGlobalReference().

◆ getAddressSpace()

unsigned GlobalValue::getAddressSpace ( ) const

◆ getAlignment()

unsigned GlobalValue::getAlignment ( ) const

◆ getBaseObject() [1/2]

const GlobalObject * GlobalValue::getBaseObject ( ) const

◆ getBaseObject() [2/2]

GlobalObject* llvm::GlobalValue::getBaseObject ( )
inline

Definition at line 546 of file GlobalValue.h.

◆ getComdat() [1/2]

const Comdat * GlobalValue::getComdat ( ) const

◆ getComdat() [2/2]

Comdat* llvm::GlobalValue::getComdat ( )
inline

Definition at line 228 of file GlobalValue.h.

◆ getDLLStorageClass()

DLLStorageClassTypes llvm::GlobalValue::getDLLStorageClass ( ) const
inline

◆ getGlobalIdentifier() [1/2]

std::string GlobalValue::getGlobalIdentifier ( StringRef  Name,
GlobalValue::LinkageTypes  Linkage,
StringRef  FileName 
)
static

Return the modified name for a global value suitable to be used as the key for a global lookup (e.g.

profile or ThinLTO). The value's original name is Name and has linkage of type Linkage. The value is defined in module FileName.

Definition at line 132 of file Globals.cpp.

References llvm::StringRef::empty(), isLocalLinkage(), Name, llvm::StringRef::str(), and llvm::StringRef::substr().

◆ getGlobalIdentifier() [2/2]

std::string GlobalValue::getGlobalIdentifier ( ) const

Return the modified name for this global value suitable to be used as the key for a global lookup (e.g.

profile or ThinLTO).

Definition at line 156 of file Globals.cpp.

References getLinkage(), llvm::Value::getName(), and getParent().

Referenced by llvm::getPGOFuncName(), resolveFwdRef(), and llvm::thinLTOInternalizeModule().

◆ getGlobalValueSubClassData()

unsigned llvm::GlobalValue::getGlobalValueSubClassData ( ) const
inlineprotected

◆ getGUID() [1/2]

static GUID llvm::GlobalValue::getGUID ( StringRef  GlobalName)
inlinestatic

◆ getGUID() [2/2]

GUID llvm::GlobalValue::getGUID ( ) const
inline

◆ getLinkage()

LinkageTypes llvm::GlobalValue::getLinkage ( ) const
inline

◆ getLinkOnceLinkage()

static LinkageTypes llvm::GlobalValue::getLinkOnceLinkage ( bool  ODR)
inlinestatic

Definition at line 284 of file GlobalValue.h.

◆ getMinUnnamedAddr()

static UnnamedAddr llvm::GlobalValue::getMinUnnamedAddr ( UnnamedAddr  A,
UnnamedAddr  B 
)
inlinestatic

Definition at line 218 of file GlobalValue.h.

References llvm::None.

Referenced by getMinVisibility().

◆ getParent() [1/2]

Module* llvm::GlobalValue::getParent ( )
inline

Get the module that this global value is contained inside of...

Definition at line 566 of file GlobalValue.h.

Referenced by AddAlignmentAssumptions(), addBoundsChecking(), allCallersPassInValidPointerForArgument(), llvm::AMDGPUTargetLowering::analyzeFormalArgumentsCompute(), asmClobbersCTR(), llvm::Value::assertModuleIsMaterializedImpl(), buildFrameType(), callIntrinsic(), callsShareTOCBase(), canCreateAliasFor(), llvm::canRenameComdatFunc(), llvm::ARMTargetLowering::CCAssignFnForReturn(), llvm::changeToUnreachable(), llvm::AArch64Subtarget::classifyGlobalFunctionReference(), llvm::X86Subtarget::classifyGlobalFunctionReference(), llvm::PPCSubtarget::classifyGlobalReference(), llvm::AArch64Subtarget::ClassifyGlobalReference(), llvm::X86Subtarget::classifyGlobalReference(), llvm::CloneAndPruneIntoFromInst(), llvm::CloneBasicBlock(), llvm::CloneFunction(), llvm::CloneFunctionInto(), llvm::FunctionComparator::cmpOperations(), llvm::FunctionComparator::cmpTypes(), combineADDToADDZE(), combineInstructionsOverFunction(), CompareValueComplexity(), llvm::ComputeLegalValueVTs(), ComputePostOrders(), llvm::ConstantFoldCall(), ConvertDoubleToBytes(), llvm::convertToDeclaration(), copyComdat(), llvm::SanitizerStatReport::create(), llvm::GlobalAlias::create(), llvm::createAMDGPUFunctionInliningPass(), llvm::IRBuilderBase::CreateAssumption(), createClone(), llvm::createCodeGenPreparePass(), llvm::createConstantPropagationPass(), llvm::IRBuilderBase::CreateElementUnorderedAtomicMemCpy(), llvm::IRBuilderBase::CreateElementUnorderedAtomicMemMove(), llvm::IRBuilderBase::CreateElementUnorderedAtomicMemSet(), llvm::IRBuilderBase::CreateFAddReduce(), createFFSIntrinsic(), llvm::IRBuilderBase::CreateFMulReduce(), llvm::IRBuilderBase::CreateGCRelocate(), llvm::IRBuilderBase::CreateGCResult(), CreateGCStatepointCallCommon(), CreateGCStatepointInvokeCommon(), llvm::IRBuilderBase::CreateGlobalString(), llvm::createHWAddressSanitizerPass(), llvm::IRBuilderBase::CreateInvariantStart(), llvm::createLegacyPMBasicAAResult(), llvm::IRBuilderBase::CreateLifetimeEnd(), llvm::IRBuilderBase::CreateLifetimeStart(), llvm::IRBuilderBase::CreateMaskedStore(), llvm::IRBuilderBase::CreateMemCpy(), llvm::createMemDerefPrinter(), llvm::IRBuilderBase::CreateMemMove(), llvm::IRBuilderBase::CreateMemSet(), llvm::createPGOFuncNameVar(), createPopcntIntrinsic(), llvm::createPPCCTRLoopsVerify(), llvm::createSampleProfileLoaderPass(), llvm::createScalarizerPass(), llvm::createShadowStackGCLoweringPass(), CreateVarArgHelper(), CreateWrapper(), llvm::VerifierSupport::DebugInfoCheckFailed(), llvm::DemoteRegToStack(), llvm::FunctionImportGlobalProcessing::doImportAsDefinition(), doPromotion(), dumpIR(), eliminateTailRecursion(), llvm::AsmPrinter::EmitAlignment(), llvm::AArch64TargetLowering::emitAtomicCmpXchgNoStoreLLBalance(), llvm::ARMTargetLowering::emitAtomicCmpXchgNoStoreLLBalance(), llvm::AsmPrinter::EmitDebugValue(), llvm::AsmPrinter::EmitGlobalVariable(), llvm::AMDGPU::HSAMD::MetadataStreamerV2::emitKernel(), llvm::emitLinkerFlagsForGlobalCOFF(), llvm::HexagonTargetLowering::emitLoadLinked(), llvm::AArch64TargetLowering::emitLoadLinked(), llvm::ARMTargetLowering::emitLoadLinked(), llvm::AsmPrinter::EmitSpecialLLVMGlobal(), llvm::HexagonTargetLowering::emitStoreConditional(), llvm::AArch64TargetLowering::emitStoreConditional(), llvm::ARMTargetLowering::emitStoreConditional(), llvm::PPCTargetLowering::emitTrailingFence(), enableCallSafepoints(), ensurePromotedGV(), eraseDeadBBsAndChildren(), llvm::GlobalIFunc::eraseFromParent(), llvm::GlobalAlias::eraseFromParent(), llvm::GlobalVariable::eraseFromParent(), explicifyGuards(), llvm::CodeExtractor::extractCodeRegion(), llvm::findAllNVVMAnnotation(), findCalledFunction(), llvm::findDevirtualizableCallsForTypeTest(), llvm::AnalysisResolver::findImplPass(), llvm::CodeExtractor::findInputsOutputs(), llvm::findOneNVVMAnnotation(), findUser(), forceRenaming(), forEachUser(), llvm::StackSafetyInfo::FunctionInfo::FunctionInfo(), generateUnsignedDivisionCode(), getAlignment(), llvm::getBestSimplifyQuery(), llvm::CallSiteBase<>::getCaller(), getChainID(), getComdatGVForCOFF(), llvm::MachineFunction::getDataLayout(), llvm::ScalarEvolution::getDataLayout(), getDebugLocString(), llvm::TargetLoweringBase::getDefaultSafeStackPointerLocation(), llvm::AMDGPUSubtarget::getExplicitKernArgSize(), getFirstNonAllocaInTheEntryBlock(), getGlobalIdentifier(), GetGlobalTypeString(), llvm::getInlineCost(), llvm::TargetLoweringBase::getIRStackGuard(), llvm::TargetLibraryInfoImpl::getLibFunc(), getLoadStackGuard(), llvm::ExecutionEngine::getMangledName(), getMinVisibility(), llvm::GlobalsAAResult::getModRefBehavior(), llvm::Trace::getModule(), llvm::BasicBlock::getModule(), getModuleFromVal(), getMOVL(), llvm::Mangler::getNameWithPrefix(), llvm::GetOrCreateFunctionComdat(), llvm::CallGraph::getOrInsertFunction(), getParent(), getParentPad(), llvm::getPGOFuncName(), llvm::PPCTargetLowering::getPICJumpTableRelocBaseExpr(), getPointerOperands(), llvm::MCJIT::getPointerToFunction(), llvm::NVPTXTargetLowering::getPrototype(), getReductionIntrinsic(), llvm::SCEVExpander::getRelatedExistingExpansion(), getRetComponentType(), llvm::TargetLoweringBase::getSafeStackPointerLocation(), getScalarIntrinsicDeclaration(), llvm::TargetLoweringObjectFile::getSectionForJumpTable(), getSignature(), getSqrtCall(), llvm::SelectionDAG::getSymbolFunctionGlobalAddress(), llvm::TargetLoweringObjectFile::getSymbolWithGlobalValueBase(), llvm::MipsTargetMachine::getTargetTransformInfo(), llvm::TargetMachine::getTargetTransformInfo(), llvm::HexagonTargetLowering::getTgtMemIntrinsic(), llvm::ARMTargetLowering::getTgtMemIntrinsic(), llvm::TargetMachine::getTLSModel(), getUnderlyingArgReg(), llvm::FunctionLoweringInfo::getValueFromVirtualReg(), getVarName(), llvm::GlobalVariable::GlobalVariable(), llvm::MipsCallLowering::MipsHandler::handle(), llvm::CallLowering::handleAssignments(), HandleByValArgument(), llvm::PPCSubtarget::hasLazyResolverStub(), hasProfileData(), hasReturnsTwiceAttr(), hasUndefContents(), llvm::inferLibFuncAttributes(), INITIALIZE_PASS(), llvm::MIRParserImpl::initializeConstantPool(), initSlots2BasicBlocks(), initSlots2Values(), llvm::InlineFunction(), insertCall(), insertIfNamed(), insertSinCosCall(), instrumentMaskedLoadOrStore(), llvm::isAllocaPromotable(), isAtomic(), isFuncOrArgAttr(), llvm::MipsTargetObjectFile::IsGlobalInSmallSection(), llvm::ARMSubtarget::isGVIndirectSymbol(), llvm::ARMSubtarget::isGVInGOT(), llvm::isImageReadOnly(), llvm::isImageReadWrite(), llvm::isImageWriteOnly(), llvm::isLegalToPromote(), llvm::TargetLowering::isOffsetFoldingLegal(), IsOperandAMemoryOperand(), llvm::SystemZSubtarget::isPC32DBLSymbol(), isPointerValueDeadOnEntryToFunction(), llvm::ARMTargetLowering::isReadOnly(), isReportingError(), llvm::isSampler(), IsSmallObject(), isTargetConstant(), isThunkProfitable(), isZeroLengthArray(), llvm::lintFunction(), LLVMGetNextFunction(), LLVMGetNextGlobal(), LLVMGetNextGlobalAlias(), LLVMGetPreviousFunction(), LLVMGetPreviousGlobal(), LLVMGetPreviousGlobalAlias(), llvm::X86CallLowering::lowerCall(), llvm::AArch64CallLowering::lowerCall(), llvm::MipsCallLowering::lowerCall(), llvm::CallLowering::lowerCall(), llvm::AsmPrinter::lowerConstant(), llvm::LowerDbgDeclare(), LowerEXTRACT_SUBVECTOR(), llvm::AMDGPUCallLowering::lowerFormalArguments(), llvm::AArch64CallLowering::lowerFormalArguments(), lowerGuardIntrinsic(), lowerObjCCall(), llvm::AMDGPUCallLowering::lowerReturn(), llvm::AArch64CallLowering::lowerReturn(), llvm::TargetLowering::LowerToTLSEmulatedModel(), LowerWRITE_REGISTER(), llvm::SparcTargetLowering::makeAddress(), llvm::ARMTargetLowering::makeDMB(), makeStatepointExplicitImpl(), llvm::orc::makeStub(), MarkBlocksLiveIn(), llvm::X86TargetLowering::markLibCallAttributes(), materialize(), maybePrintComdat(), mayLoopAccessLocation(), mayUseP9Setb(), memOpsHaveSameBasePtr(), mergeInlinedArrayAllocas(), llvm::orc::moveFunctionBody(), llvm::orc::moveGlobalVariableInitializer(), normalizePBQPSpillWeight(), OptimizeGlobalAddressOfMalloc(), llvm::cflaa::parentFunctionOfValue(), patchAndReplaceAllUsesWith(), performGlobalAddressCombine(), PerformHeapAllocSRoA(), postSplitCleanup(), PrepareCall(), prepareForSplit(), llvm::MIRPrinter::print(), llvm::Value::print(), llvm::MachineBasicBlock::print(), llvm::MachineInstr::print(), printMemOperand(), processInternalGlobal(), RedzoneSizeForScale(), relocationViaAlloca(), llvm::Intrinsic::remangleIntrinsicFunction(), llvm::GlobalIFunc::removeFromParent(), llvm::GlobalAlias::removeFromParent(), llvm::GlobalVariable::removeFromParent(), removeGlobalCtors(), replaceDevirtTrigger(), RetagMask(), llvm::returnTypeIsEligibleForTailCall(), llvm::ScalarizerPass::run(), llvm::NewGVNPass::run(), llvm::ControlHeightReductionPass::run(), llvm::IndVarSimplifyPass::run(), llvm::ThreadSanitizerPass::run(), llvm::EarlyCSEPass::run(), llvm::InstSimplifyPass::run(), llvm::SCCPPass::run(), llvm::MemorySanitizerPass::run(), llvm::AAEvaluator::run(), llvm::AMDGPUAA::run(), llvm::objcarc::ObjCARCAA::run(), llvm::PrintFunctionPass::run(), llvm::LoopUnrollPass::run(), llvm::LazyValueAnalysis::run(), llvm::BasicAA::run(), llvm::TargetLibraryAnalysis::run(), llvm::AAManager::run(), llvm::TargetIRAnalysis::run(), llvm::MCJIT::runFunction(), llvm::Float2IntPass::runImpl(), llvm::SLPVectorizerPass::runImpl(), llvm::JumpThreadingPass::runImpl(), llvm::NaryReassociatePass::runImpl(), llvm::ConstantHoistingPass::runImpl(), runImpl(), llvm::LegacyDivergenceAnalysis::runOnFunction(), llvm::LPPassManager::runOnFunction(), llvm::StackProtector::runOnFunction(), llvm::LazyValueInfoWrapperPass::runOnFunction(), llvm::BasicAAWrapperPass::runOnFunction(), llvm::FPPassManager::runOnFunction(), llvm::IRTranslator::runOnMachineFunction(), llvm::ScalarEvolution::ScalarEvolution(), selectELFSectionForGlobal(), llvm::XCoreTargetObjectFile::SelectSectionForGlobal(), llvm::TargetLoweringObjectFileMachO::SelectSectionForGlobal(), setFastFlags(), setUsedInitializer(), shouldApply(), shouldInstrumentBlock(), llvm::HexagonTargetObjectFile::shouldPutJumpTableInFunctionSection(), ShrinkDemandedConstant(), simplifyCFG(), splitGlobal(), SRAGlobal(), StackMallocSizeClass(), SwitchToLookupTable(), TryToShrinkGlobalToBoolean(), TypeSizeToSizeIndex(), unifyReturnBlockSet(), unswitchBestCondition(), llvm::UpgradeIntrinsicCall(), UpgradeIntrinsicFunction1(), UpgradePTESTIntrinsic(), UpgradeX86IntrinsicFunction(), UpgradeX86IntrinsicsWith8BitMask(), usedInOneFunc(), useFuncSeen(), UseTlsOffset(), llvm::verifyFunction(), VisitGlobalVariableForEmission(), llvm::SelectionDAGBuilder::visitSPDescriptorParent(), and llvm::InnerLoopVectorizer::widenInstruction().

◆ getParent() [2/2]

const Module* llvm::GlobalValue::getParent ( ) const
inline

Definition at line 567 of file GlobalValue.h.

◆ getSection()

StringRef GlobalValue::getSection ( ) const

Definition at line 161 of file Globals.cpp.

References getBaseObject().

Referenced by callsShareTOCBase(), and llvm::XCoreTargetLowering::ReplaceNodeResults().

◆ getThreadLocalMode()

ThreadLocalMode llvm::GlobalValue::getThreadLocalMode ( ) const
inline

◆ getType()

PointerType* llvm::GlobalValue::getType ( ) const
inline

Global values are always pointers.

Definition at line 274 of file GlobalValue.h.

References llvm::Value::getType().

Referenced by llvm::MachineIRBuilder::buildGlobalValue(), llvm::Interpreter::callExternalFunction(), canCreateAliasFor(), canDemoteGlobalVar(), llvm::orc::cloneGlobalAliasDecl(), llvm::orc::cloneGlobalVariableDecl(), llvm::convertToDeclaration(), llvm::GlobalAlias::create(), llvm::createDeadArgHackingPass(), CreateLoadIns(), llvm::createMergeFunctionsPass(), llvm::NVPTXAsmPrinter::doFinalization(), llvm::AsmPrinter::emitGlobalGOTEquivs(), llvm::ExecutionEngine::emitGlobals(), llvm::AsmPrinter::EmitGlobalVariable(), findInitTrampoline(), findUser(), FindUses(), llvm::SanitizerStatReport::finish(), forceRenaming(), forEachUser(), FunctionNumber(), getAddressSpace(), getArrayElements(), getComparePred(), llvm::SelectionDAG::getGlobalAddress(), getImplicitScaleFactor(), getOpenCLAlignment(), llvm::Module::getOrInsertFunction(), llvm::Module::getOrInsertGlobal(), getTypeNamePrefix(), llvm::SelectionDAG::InferPtrAlignment(), INITIALIZE_PASS(), llvm::IsConstantOffsetFromGlobal(), llvm::AMDGPU::isGlobalSegment(), llvm::AMDGPU::isGroupSegment(), isKnownTypeIdMember(), isNoWrap(), llvm::AMDGPU::isReadOnlySegment(), isZeroLengthArray(), llvm::BlockAddress::lookup(), llvm::TargetLoweringObjectFileELF::lowerRelativeReference(), llvm::TargetLoweringObjectFileCOFF::lowerRelativeReference(), llvm::TargetLoweringObjectFileWasm::lowerRelativeReference(), maybePrintComdat(), maybeSetDSOLocal(), MergeAliasResults(), mergeConstants(), OptimizeGlobalAliases(), PerformHeapAllocSRoA(), processInternalGlobal(), removeGlobalCtors(), replaceAliasWithAliasee(), RetagMask(), selectJumpTableArmEncoding(), llvm::GlobalAlias::setAliasee(), llvm::HexagonTargetObjectFile::shouldPutJumpTableInFunctionSection(), splitGlobal(), SRAGlobal(), TryToShrinkGlobalToBoolean(), llvm::ObjectSizeOffsetVisitor::visitGlobalVariable(), and wrapConstantAsMetadata().

◆ getUnnamedAddr()

UnnamedAddr llvm::GlobalValue::getUnnamedAddr ( ) const
inline

◆ getValueType()

Type* llvm::GlobalValue::getValueType ( ) const
inline

◆ getVisibility()

VisibilityTypes llvm::GlobalValue::getVisibility ( ) const
inline

◆ getWeakLinkage()

static LinkageTypes llvm::GlobalValue::getWeakLinkage ( bool  ODR)
inlinestatic

Definition at line 287 of file GlobalValue.h.

Referenced by thinLTOResolvePrevailingGUID().

◆ hasAppendingLinkage()

bool llvm::GlobalValue::hasAppendingLinkage ( ) const
inline

◆ hasAtLeastLocalUnnamedAddr()

bool llvm::GlobalValue::hasAtLeastLocalUnnamedAddr ( ) const
inline

Returns true if this value's address is not significant in this module.

This attribute is intended to be used only by the code generator and LTO to allow the linker to decide whether the global needs to be in the symbol table. It should probably not be used in optimizations, as the value may have uses outside the module; use hasGlobalUnnamedAddr() instead.

Definition at line 209 of file GlobalValue.h.

References llvm::None.

Referenced by canBeOmittedFromSymbolTable(), and llvm::AsmPrinter::doFinalization().

◆ hasAvailableExternallyLinkage()

bool llvm::GlobalValue::hasAvailableExternallyLinkage ( ) const
inline

◆ hasComdat()

bool llvm::GlobalValue::hasComdat ( ) const
inline

Definition at line 226 of file GlobalValue.h.

Referenced by callsShareTOCBase(), forEachUser(), and llvm::LTOModule::makeBuffer().

◆ hasCommonLinkage()

bool llvm::GlobalValue::hasCommonLinkage ( ) const
inline

◆ hasDefaultVisibility()

bool llvm::GlobalValue::hasDefaultVisibility ( ) const
inline

◆ hasDLLExportStorageClass()

bool llvm::GlobalValue::hasDLLExportStorageClass ( ) const
inline

Definition at line 265 of file GlobalValue.h.

Referenced by computeVariableSummary(), and llvm::emitLinkerFlagsForGlobalCOFF().

◆ hasDLLImportStorageClass()

bool llvm::GlobalValue::hasDLLImportStorageClass ( ) const
inline

◆ hasExactDefinition()

bool llvm::GlobalValue::hasExactDefinition ( ) const
inline

Return true if this global has an exact defintion.

Definition at line 407 of file GlobalValue.h.

Referenced by llvm::canTrackReturnsInterprocedurally(), llvm::createDeadArgHackingPass(), instrumentMaskedLoadOrStore(), and runImpl().

◆ hasExternalLinkage()

bool llvm::GlobalValue::hasExternalLinkage ( ) const
inline

◆ hasExternalWeakLinkage()

bool llvm::GlobalValue::hasExternalWeakLinkage ( ) const
inline

◆ hasGlobalUnnamedAddr()

bool llvm::GlobalValue::hasGlobalUnnamedAddr ( ) const
inline

◆ hasHiddenVisibility()

bool llvm::GlobalValue::hasHiddenVisibility ( ) const
inline

Definition at line 235 of file GlobalValue.h.

References Visibility.

Referenced by llvm::JITSymbolFlags::fromGlobalValue(), and llvm::LTOModule::makeBuffer().

◆ hasInternalLinkage()

bool llvm::GlobalValue::hasInternalLinkage ( ) const
inline

◆ hasLinkOnceLinkage()

bool llvm::GlobalValue::hasLinkOnceLinkage ( ) const
inline

◆ hasLinkOnceODRLinkage()

bool llvm::GlobalValue::hasLinkOnceODRLinkage ( ) const
inline

◆ hasLocalLinkage()

bool llvm::GlobalValue::hasLocalLinkage ( ) const
inline

Definition at line 436 of file GlobalValue.h.

Referenced by asmClobbersCTR(), canCreateAliasFor(), llvm::canTrackArgumentsInterprocedurally(), llvm::canTrackGlobalVariableInterprocedurally(), CC_MipsO32_FP64(), llvm::createDeadArgHackingPass(), llvm::createX86IndirectBranchTrackingPass(), deleteIfDead(), llvm::AsmPrinter::doFinalization(), llvm::FunctionImportGlobalProcessing::doImportAsDefinition(), llvm::AsmPrinter::emitGlobalGOTEquivs(), externalize(), llvm::RecordStreamer::flushSymverDirectives(), forceRenaming(), forEachUser(), llvm::JITSymbolFlags::fromGlobalValue(), getArrayElements(), llvm::TargetLoweringObjectFileMachO::getCFIPersonalitySymbol(), llvm::HexagonTargetObjectFile::getExplicitSectionGlobal(), llvm::getIntrinsicForCallSite(), getMinVisibility(), llvm::GlobalsAAResult::getModRefBehavior(), llvm::GlobalsAAResult::getModRefInfo(), getMOVL(), llvm::GetOrCreateFunctionComdat(), getRetComponentType(), llvm::SparcELFTargetObjectFile::getTTypeGlobalReference(), llvm::TargetLoweringObjectFileELF::getTTypeGlobalReference(), llvm::TargetLoweringObjectFileMachO::getTTypeGlobalReference(), handleNonPrevailingComdat(), hasOnlyColdCalls(), hasUsesToReplace(), inferDSOLocal(), INITIALIZE_PASS(), instrumentMaskedLoadOrStore(), IsBetterCanonical(), isDirectCall(), isFuncOrderCorrect(), llvm::MipsTargetObjectFile::IsGlobalInSmallSection(), llvm::TargetTransformInfoImplBase::isLoweredToCall(), isNonRenamableLocal(), llvm::TargetFrameLowering::isSafeForNoCSROpt(), llvm::LTOModule::makeBuffer(), makeVisible(), llvm::maybeMarkSanitizerLibraryCallNoBuiltin(), mayHaveOtherReferences(), mergeConstants(), OptimizeFunctions(), OptimizeGlobalAliases(), OptimizeGlobalVars(), llvm::LinkDiagnosticInfo::print(), PrintDSOLocation(), processGlobal(), promoteArguments(), llvm::LegacyInlinerBase::removeDeadFunctions(), replace(), llvm::XCoreTargetLowering::ReplaceNodeResults(), llvm::InlinerPass::run(), llvm::WholeProgramDevirtPass::run(), llvm::X86AsmPrinter::runOnMachineFunction(), llvm::ExecutionEngine::runStaticConstructorsDestructors(), llvm::FastISel::selectInstruction(), selectJumpTableArmEncoding(), llvm::HexagonTargetObjectFile::SelectSectionForGlobal(), llvm::XCoreTargetObjectFile::SelectSectionForGlobal(), shouldBeDeferred(), shouldRecordFunctionAddr(), splitGlobal(), and SRAGlobal().

◆ hasPrivateLinkage()

bool llvm::GlobalValue::hasPrivateLinkage ( ) const
inline

◆ hasProtectedVisibility()

bool llvm::GlobalValue::hasProtectedVisibility ( ) const
inline

Definition at line 236 of file GlobalValue.h.

References Visibility.

Referenced by llvm::LTOModule::makeBuffer().

◆ hasSection()

bool llvm::GlobalValue::hasSection ( ) const
inline

◆ hasValidDeclarationLinkage()

bool llvm::GlobalValue::hasValidDeclarationLinkage ( ) const
inline

Definition at line 441 of file GlobalValue.h.

Referenced by forEachUser().

◆ hasWeakAnyLinkage()

bool llvm::GlobalValue::hasWeakAnyLinkage ( ) const
inline

Definition at line 431 of file GlobalValue.h.

◆ hasWeakLinkage()

bool llvm::GlobalValue::hasWeakLinkage ( ) const
inline

◆ hasWeakODRLinkage()

bool llvm::GlobalValue::hasWeakODRLinkage ( ) const
inline

Definition at line 432 of file GlobalValue.h.

◆ isAbsoluteSymbolRef()

bool GlobalValue::isAbsoluteSymbolRef ( ) const

Returns whether this is a reference to an absolute symbol.

Definition at line 269 of file Globals.cpp.

References llvm::dyn_cast(), llvm::GlobalObject::getMetadata(), and llvm::LLVMContext::MD_absolute_symbol.

Referenced by LowerEXTRACT_SUBVECTOR().

◆ isAppendingLinkage()

static bool llvm::GlobalValue::isAppendingLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 312 of file GlobalValue.h.

Referenced by thinLTOResolvePrevailingGUID().

◆ isAvailableExternallyLinkage()

static bool llvm::GlobalValue::isAvailableExternallyLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 294 of file GlobalValue.h.

Referenced by llvm::thinLTOResolvePrevailingInModule().

◆ isCommonLinkage()

static bool llvm::GlobalValue::isCommonLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 327 of file GlobalValue.h.

◆ isDeclaration()

bool GlobalValue::isDeclaration ( ) const

Return true if the primary definition of this global value is outside of the current translation unit.

Definition at line 206 of file Globals.cpp.

References assert(), and F().

Referenced by addNoRecurseAttrs(), addNoRecurseAttrsTopDown(), assureFPCallStub(), llvm::buildModuleSummaryIndex(), llvm::Interpreter::callFunction(), callsiteIsHot(), copyFeaturesToFunction(), llvm::createAlwaysInlinerLegacyPass(), llvm::createAMDGPUFunctionInliningPass(), llvm::createDeadArgHackingPass(), llvm::createMergeFunctionsPass(), cxxDtorIsEmpty(), deduceFunctionAttributeInRPO(), deleteIfDead(), doCallSiteSplitting(), llvm::NVPTXAsmPrinter::doFinalization(), llvm::FunctionImportGlobalProcessing::doImportAsDefinition(), llvm::AsmPrinter::EmitGlobalVariable(), llvm::emitLinkerFlagsForGlobalCOFF(), emitSignedInt64(), enableCallSafepoints(), llvm::Evaluator::EvaluateBlock(), llvm::ExecutionEngine::FindFunctionNamed(), llvm::ExecutionEngine::FindGlobalVariableNamed(), llvm::AnalysisResolver::findImplPass(), llvm::MCJIT::findModuleForSymbol(), forceRenaming(), forEachUser(), FunctionNumber(), getArrayElements(), llvm::AMDGPULibFunc::getFunction(), llvm::GCModuleInfo::getFunctionInfo(), llvm::TargetLoweringObjectFile::getKindForGlobal(), getMinVisibility(), llvm::AMDGPULibFunc::getOrInsertFunction(), getParentPad(), llvm::MCJIT::getPointerToFunction(), getSignature(), hasAnyNonFlatUseOfReg(), llvm::GlobalVariable::hasInitializer(), hasProfileData(), INITIALIZE_PASS(), llvm::InlineFunction(), invokeFunctionPass(), llvm::LanaiTargetObjectFile::isGlobalInSmallSection(), llvm::MipsTargetObjectFile::IsGlobalInSmallSection(), isReportingError(), isWrapperOnlyCall(), llvm::lintFunction(), llvm::AMDGPUArgumentUsageInfo::lookupFuncArgInfo(), llvm::orc::makeStub(), maybePrintComdat(), llvm::orc::moveFunctionBody(), OptimizeFunctions(), OptimizeGlobalAliases(), OptimizeGlobalVars(), predictUseListOrder(), llvm::LegacyInlinerBase::removeDeadFunctions(), llvm::SyntheticCountsPropagation::run(), llvm::RewriteStatepointsForGC::runOnFunction(), llvm::FPPassManager::runOnFunction(), llvm::MCJIT::runStaticConstructorsDestructors(), llvm::ExecutionEngine::runStaticConstructorsDestructors(), llvm::ImportedFunctionsInliningStatistics::setModuleInfo(), shouldFixMainFunction(), stripDeadPrototypes(), useFuncSeen(), llvm::verifyModule(), llvm::Interpreter::visitCallSite(), llvm::LazyCallGraph::visitReferences(), writeIdentificationBlock(), and writeTypeIdSummaryRecord().

◆ isDeclarationForLinker()

bool llvm::GlobalValue::isDeclarationForLinker ( ) const
inline

◆ isDefinitionExact()

bool llvm::GlobalValue::isDefinitionExact ( ) const
inline

Return true if the currently visible definition of this global (if any) is exactly the definition we will see at runtime.

Non-exact linkage types inhibits most non-inlining IPO, since a differently optimized variant of the same function can have different observable or undefined behavior than in the variant currently visible. For instance, we could have started with

void foo(int *v) { int t = 5 / v[0]; (void) t; }

and "refined" it to

void foo(int *v) { }

However, we cannot infer readnone for foo, since that would justify DSE'ing a store to v[0] across a call to foo, which can cause undefined behavior if the linker replaces the actual call destination with the unoptimized foo.

Inlining is okay across non-exact linkage types as long as they're not interposable (see isInterposable), since in such cases the currently visible variant is a correct implementation of the original source function; it just isn't the only correct implementation.

Definition at line 402 of file GlobalValue.h.

Referenced by PropagateConstantReturn().

◆ isDiscardableIfUnused() [1/2]

static bool llvm::GlobalValue::isDiscardableIfUnused ( LinkageTypes  Linkage)
inlinestatic

Whether the definition of this global may be discarded if it is not used in its compilation unit.

Definition at line 361 of file GlobalValue.h.

Referenced by canCreateAliasFor(), deleteIfDead(), isGOTEquivalentCandidate(), makeVisible(), and optimizeGlobalsInModule().

◆ isDiscardableIfUnused() [2/2]

bool llvm::GlobalValue::isDiscardableIfUnused ( ) const
inline

Definition at line 453 of file GlobalValue.h.

Referenced by llvm::canRenameComdatFunc().

◆ isDSOLocal()

bool llvm::GlobalValue::isDSOLocal ( ) const
inline

◆ isExternalLinkage()

static bool llvm::GlobalValue::isExternalLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 291 of file GlobalValue.h.

Referenced by llvm::GlobalAlias::isValidLinkage().

◆ isExternalWeakLinkage()

static bool llvm::GlobalValue::isExternalWeakLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 324 of file GlobalValue.h.

◆ isInternalLinkage()

static bool llvm::GlobalValue::isInternalLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 315 of file GlobalValue.h.

Referenced by CompareValueComplexity().

◆ isInterposable()

bool llvm::GlobalValue::isInterposable ( ) const
inline

Return true if this global's definition can be substituted with an arbitrary definition at link time.

We cannot do any IPO or inlinining across interposable call edges, since the callee can be replaced with something arbitrary at link time.

Definition at line 420 of file GlobalValue.h.

Referenced by canCreateAliasFor(), computeVariableSummary(), llvm::Evaluator::EvaluateBlock(), llvm::getInlineCost(), llvm::GlobalVariable::hasDefinitiveInitializer(), instrumentMaskedLoadOrStore(), isFuncOrderCorrect(), llvm::StackSafetyInfo::FunctionInfo::IsInterposable(), OptimizeGlobalAliases(), shouldInstrumentBlock(), and llvm::ObjectSizeOffsetVisitor::visitGlobalAlias().

◆ isInterposableLinkage()

static bool llvm::GlobalValue::isInterposableLinkage ( LinkageTypes  Linkage)
inlinestatic

Whether the definition of this global may be replaced by something non-equivalent at link time.

For example, if a function has weak linkage then the code defining it may be replaced by different code.

Definition at line 337 of file GlobalValue.h.

References llvm_unreachable.

Referenced by llvm::canImportGlobalVar(), llvm::computeDeadSymbols(), selectCallee(), and llvm::thinLTOResolvePrevailingInModule().

◆ isLinkOnceLinkage()

static bool llvm::GlobalValue::isLinkOnceLinkage ( LinkageTypes  Linkage)
inlinestatic

◆ isLinkOnceODRLinkage()

static bool llvm::GlobalValue::isLinkOnceODRLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 297 of file GlobalValue.h.

Referenced by thinLTOResolvePrevailingGUID().

◆ isLocalLinkage()

static bool llvm::GlobalValue::isLocalLinkage ( LinkageTypes  Linkage)
inlinestatic

◆ isMaterializable()

bool GlobalValue::isMaterializable ( ) const

If this function's Module is being lazily streamed in functions from disk or some other source, this method can be used to check to see if the function has been read in yet or not.

Definition at line 45 of file Globals.cpp.

References F().

Referenced by maybePrintComdat().

◆ isPrivateLinkage()

static bool llvm::GlobalValue::isPrivateLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 318 of file GlobalValue.h.

Referenced by CompareValueComplexity().

◆ isStrongDefinitionForLinker()

bool llvm::GlobalValue::isStrongDefinitionForLinker ( ) const
inline

Returns true if this global's definition will be the one chosen by the linker.

NB! Ideally this should not be used at the IR level at all. If you're interested in optimization constraints implied by the linker's ability to choose an implementation, prefer using hasExactDefinition.

Definition at line 537 of file GlobalValue.h.

Referenced by callsShareTOCBase(), canIncreaseAlignment(), llvm::ARMTargetLowering::CCAssignFnForReturn(), llvm::GlobalVariable::hasUniqueInitializer(), and llvm::TargetMachine::shouldAssumeDSOLocal().

◆ isThreadLocal()

bool llvm::GlobalValue::isThreadLocal ( ) const
inline

◆ isValidDeclarationLinkage()

static bool llvm::GlobalValue::isValidDeclarationLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 330 of file GlobalValue.h.

Referenced by maybeSetDSOLocal().

◆ isWeakAnyLinkage()

static bool llvm::GlobalValue::isWeakAnyLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 303 of file GlobalValue.h.

◆ isWeakForLinker() [1/2]

static bool llvm::GlobalValue::isWeakForLinker ( LinkageTypes  Linkage)
inlinestatic

Whether the definition of this global may be replaced at link time.

NB: Using this method outside of the code generators is almost always a mistake: when working at the IR level use isInterposable instead as it knows about ODR semantics.

Definition at line 370 of file GlobalValue.h.

Referenced by llvm::RecordStreamer::flushSymverDirectives(), getMinVisibility(), llvm::GetOrCreateFunctionComdat(), isKnownTypeIdMember(), mergeConstants(), selectJumpTableArmEncoding(), llvm::TargetLoweringObjectFileMachO::SelectSectionForGlobal(), and llvm::TargetLoweringObjectFile::shouldPutJumpTableInFunctionSection().

◆ isWeakForLinker() [2/2]

bool llvm::GlobalValue::isWeakForLinker ( ) const
inline

Definition at line 457 of file GlobalValue.h.

References isWeakForLinker().

Referenced by isWeakForLinker().

◆ isWeakLinkage()

static bool llvm::GlobalValue::isWeakLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 309 of file GlobalValue.h.

Referenced by llvm::GlobalAlias::isValidLinkage().

◆ isWeakODRLinkage()

static bool llvm::GlobalValue::isWeakODRLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 306 of file GlobalValue.h.

◆ materialize()

Error GlobalValue::materialize ( )

Make sure this GlobalValue is fully read.

Definition at line 50 of file Globals.cpp.

References From, getParent(), llvm_unreachable, and llvm::Module::materialize().

Referenced by llvm::legacy::FunctionPassManager::run().

◆ removeFromParent()

void GlobalValue::removeFromParent ( )

This method unlinks 'this' from the containing module, but does not delete it.

Definition at line 73 of file Globals.cpp.

References llvm::Value::getValueID(), and llvm_unreachable.

◆ setDLLStorageClass()

void llvm::GlobalValue::setDLLStorageClass ( DLLStorageClassTypes  C)
inline

◆ setDSOLocal()

void llvm::GlobalValue::setDSOLocal ( bool  Local)
inline

◆ setGlobalValueSubClassData()

void llvm::GlobalValue::setGlobalValueSubClassData ( unsigned  V)
inlineprotected

◆ setLinkage()

void llvm::GlobalValue::setLinkage ( LinkageTypes  LT)
inline

◆ setParent()

void llvm::GlobalValue::setParent ( Module parent)
inlineprotected

Definition at line 172 of file GlobalValue.h.

◆ setThreadLocal()

void llvm::GlobalValue::setThreadLocal ( bool  Val)
inline

Definition at line 248 of file GlobalValue.h.

◆ setThreadLocalMode()

void llvm::GlobalValue::setThreadLocalMode ( ThreadLocalMode  Val)
inline

◆ setUnnamedAddr()

void llvm::GlobalValue::setUnnamedAddr ( UnnamedAddr  Val)
inline

◆ setVisibility()

void llvm::GlobalValue::setVisibility ( VisibilityTypes  V)
inline

Friends And Related Function Documentation

◆ Constant

friend class Constant
friend

Definition at line 117 of file GlobalValue.h.

Member Data Documentation

◆ DllStorageClass

unsigned llvm::GlobalValue::DllStorageClass
protected

Definition at line 98 of file GlobalValue.h.

◆ GlobalValueSubClassDataBits

const unsigned llvm::GlobalValue::GlobalValueSubClassDataBits = 17
staticprotected

Definition at line 91 of file GlobalValue.h.

◆ HasLLVMReservedName

unsigned llvm::GlobalValue::HasLLVMReservedName
protected

True if the function's name starts with "llvm.".

This corresponds to the value of Function::isIntrinsic(), which may be true even if Function::intrinsicID() returns Intrinsic::not_intrinsic.

Definition at line 106 of file GlobalValue.h.

◆ IntID

Intrinsic::ID llvm::GlobalValue::IntID
protected

The intrinsic ID for this subclass (which must be a Function).

This member is defined by this class, but not used for anything. Subclasses can use it to store their intrinsic ID, if they have one.

This is stored here to save space in Function on 64-bit hosts.

Definition at line 159 of file GlobalValue.h.

◆ IsDSOLocal

unsigned llvm::GlobalValue::IsDSOLocal
protected

If true then there is a definition within the same linkage unit and that definition cannot be runtime preempted.

Definition at line 110 of file GlobalValue.h.

◆ Linkage

unsigned llvm::GlobalValue::Linkage
protected

Definition at line 95 of file GlobalValue.h.

◆ Parent

Module* llvm::GlobalValue::Parent
protected

Definition at line 169 of file GlobalValue.h.

Referenced by canIncreaseAlignment().

◆ ThreadLocal

unsigned llvm::GlobalValue::ThreadLocal
protected

Definition at line 100 of file GlobalValue.h.

◆ UnnamedAddrVal

unsigned llvm::GlobalValue::UnnamedAddrVal
protected

Definition at line 97 of file GlobalValue.h.

◆ ValueType

Type* llvm::GlobalValue::ValueType
protected

Definition at line 89 of file GlobalValue.h.

◆ Visibility

unsigned llvm::GlobalValue::Visibility
protected

Definition at line 96 of file GlobalValue.h.


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