LLVM  4.0.0
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 Referenceabstract

#include <GlobalValue.h>

Inheritance diagram for llvm::GlobalValue:
[legend]
Collaboration diagram for llvm::GlobalValue:
[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
typedef Useop_iterator
 
typedef const Useconst_op_iterator
 
typedef iterator_range
< op_iterator
op_range
 
typedef iterator_range
< const_op_iterator
const_op_range
 
- Public Types inherited from llvm::Value
enum  ValueTy
 Concrete subclass of this. More...
 
typedef use_iterator_impl< Useuse_iterator
 
typedef use_iterator_impl
< const Use
const_use_iterator
 
typedef user_iterator_impl< Useruser_iterator
 
typedef user_iterator_impl
< const User
const_user_iterator
 

Public Member Functions

 GlobalValue (const GlobalValue &)=delete
 
 ~GlobalValue () override
 
unsigned getAlignment () 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
 
ComdatgetComdat ()
 
const ComdatgetComdat () const
 
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
 
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
 
virtual void copyAttributesFrom (const GlobalValue *Src)
 Copy all additional attributes (those not needed to create a GlobalValue) from the GlobalValue Src to this one. More...
 
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...
 
virtual void removeFromParent ()=0
 This method unlinks 'this' from the containing module, but does not delete it. More...
 
virtual void eraseFromParent ()=0
 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
 
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 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...
 
ConstantstripPointerCasts ()
 
const ConstantstripPointerCasts () const
 
- Public Member Functions inherited from llvm::User
 User (const User &)=delete
 
 ~User () override=default
 
void operator delete (void *Usr)
 Free memory allocated for User and Use objects. More...
 
void operator delete (void *, unsigned)
 Placement delete - required by std, but never called. More...
 
void operator delete (void *, unsigned, bool)
 Placement delete - required by std, but never called. More...
 
UsegetOperandList ()
 
const UsegetOperandList () const
 
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_iterator
operand_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
 
void operator= (const Value &)=delete
 
virtual ~Value ()
 
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 assertModuleIsMaterialized () const
 
bool 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_iterator
materialized_uses () const
 
iterator_range< use_iteratoruses ()
 
iterator_range
< const_use_iterator
uses () 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_iterator
materialized_users () const
 
iterator_range< user_iteratorusers ()
 
iterator_range
< const_user_iterator
users () 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...
 
ValuestripPointerCasts ()
 Strip off pointer casts, all-zero GEPs, and aliases. More...
 
const ValuestripPointerCasts () const
 
ValuestripPointerCastsNoFollowAliases ()
 Strip off pointer casts and all-zero GEPs. More...
 
const ValuestripPointerCastsNoFollowAliases () const
 
ValuestripInBoundsConstantOffsets ()
 Strip off pointer casts and all-constant inbounds GEPs. More...
 
const ValuestripInBoundsConstantOffsets () const
 
ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset)
 Accumulate offsets from stripInBoundsConstantOffsets(). More...
 
const ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset) const
 
ValuestripInBoundsOffsets ()
 Strip off pointer casts and inbounds GEPs. More...
 
const ValuestripInBoundsOffsets () const
 
unsigned 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...
 
ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB)
 Translate PHI node to its predecessor from the given basic block. More...
 
const ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB) const
 
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 getRealLinkageName (StringRef Name)
 If special LLVM prefix that is used to inform the asm printer to not emit usual symbol prefix before the symbol name is used then return linkage name after skipping this special LLVM prefix. 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)
 Get the all ones value. More...
 
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)
 
- 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...
 
template<int Idx>
UseOp ()
 
template<int Idx>
const UseOp () const
 
- Protected Member Functions inherited from llvm::Value
 Value (Type *Ty, unsigned scid)
 
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...
 
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 = 18
 

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

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 465 of file GlobalValue.h.

Member Enumeration Documentation

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.

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.

Enumerator
NotThreadLocal 
GeneralDynamicTLSModel 
LocalDynamicTLSModel 
InitialExecTLSModel 
LocalExecTLSModel 

Definition at line 165 of file GlobalValue.h.

Enumerator
None 
Local 
Global 

Definition at line 181 of file GlobalValue.h.

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

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, and llvm::Value::setName().

llvm::GlobalValue::GlobalValue ( const GlobalValue )
delete
llvm::GlobalValue::~GlobalValue ( )
inlineoverride

Definition at line 175 of file GlobalValue.h.

References llvm::Constant::removeDeadConstantUsers().

Member Function Documentation

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

Definition at line 541 of file GlobalValue.h.

References llvm::Value::getValueID().

void GlobalValue::copyAttributesFrom ( const GlobalValue Src)
virtual

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.

Reimplemented in llvm::Function, llvm::GlobalVariable, and llvm::GlobalObject.

Definition at line 66 of file Globals.cpp.

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

Referenced by llvm::orc::cloneGlobalAliasDecl(), llvm::CloneModule(), and llvm::GlobalObject::copyAttributesFrom().

virtual void llvm::GlobalValue::eraseFromParent ( )
pure virtual

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

Implemented in llvm::Function, llvm::GlobalVariable, llvm::GlobalAlias, and llvm::GlobalIFunc.

Referenced by deleteIfDead().

Optional< ConstantRange > GlobalValue::getAbsoluteSymbolRange ( ) const

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

Definition at line 259 of file Globals.cpp.

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

unsigned GlobalValue::getAlignment ( ) const
const GlobalObject* llvm::GlobalValue::getBaseObject ( ) const
inline
GlobalObject * GlobalValue::getBaseObject ( )

Definition at line 243 of file Globals.cpp.

References getBaseObject().

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

Definition at line 215 of file GlobalValue.h.

References getComdat().

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

Definition at line 244 of file GlobalValue.h.

References DllStorageClass.

Referenced by copyAttributesFrom(), getEncodedDLLStorageClass(), and OptimizeGlobalAliases().

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 116 of file Globals.cpp.

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

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 140 of file Globals.cpp.

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

Referenced by getGUID(), and llvm::getPGOFuncName().

unsigned llvm::GlobalValue::getGlobalValueSubClassData ( ) const
inlineprotected
static GUID llvm::GlobalValue::getGUID ( StringRef  GlobalName)
inlinestatic

Return a 64-bit global unique ID constructed from global value name (i.e.

returned by getGlobalIdentifier()).

Definition at line 469 of file GlobalValue.h.

References llvm::MD5Hash().

Referenced by computeAliasSummary(), computeVariableSummary(), and llvm::FunctionImporter::importFunctions().

GUID llvm::GlobalValue::getGUID ( ) const
inline
LinkageTypes llvm::GlobalValue::getLinkage ( ) const
inline
static LinkageTypes llvm::GlobalValue::getLinkOnceLinkage ( bool  ODR)
inlinestatic

Definition at line 263 of file GlobalValue.h.

References LinkOnceAnyLinkage, and LinkOnceODRLinkage.

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

Definition at line 205 of file GlobalValue.h.

References Global, Local, and None.

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

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

Definition at line 537 of file GlobalValue.h.

References Parent.

Referenced by AddAlignmentAssumptions(), AllCallersPassInValidPointerForArgument(), llvm::Value::assertModuleIsMaterialized(), callIntrinsic(), llvm::canRenameComdatFunc(), llvm::changeToUnreachable(), llvm::X86Subtarget::classifyGlobalFunctionReference(), llvm::AArch64Subtarget::ClassifyGlobalReference(), llvm::X86Subtarget::classifyGlobalReference(), llvm::CloneAndPruneIntoFromInst(), llvm::CloneFunction(), llvm::orc::cloneFunctionDecl(), llvm::orc::cloneGlobalVariableDecl(), llvm::FunctionComparator::cmpTypes(), combineInstructionsOverFunction(), llvm::ComputeLegalValueVTs(), llvm::ConstantFoldCall(), llvm::SanitizerStatReport::create(), llvm::GlobalAlias::create(), llvm::IRBuilderBase::CreateAssumption(), createClone(), llvm::IRBuilderBase::CreateGCRelocate(), llvm::IRBuilderBase::CreateGCResult(), CreateGCStatepointCallCommon(), CreateGCStatepointInvokeCommon(), llvm::IRBuilderBase::CreateGlobalString(), llvm::IRBuilder< TargetFolder >::CreateInvariantGroupBarrier(), llvm::IRBuilderBase::CreateInvariantStart(), llvm::createLegacyPMBasicAAResult(), llvm::IRBuilderBase::CreateLifetimeEnd(), llvm::IRBuilderBase::CreateLifetimeStart(), llvm::IRBuilderBase::CreateMemCpy(), llvm::IRBuilderBase::CreateMemMove(), llvm::IRBuilderBase::CreateMemSet(), llvm::createPGOFuncNameVar(), createPopcntIntrinsic(), CreateWrapper(), llvm::DependenceInfo::depends(), DoPromotion(), eliminateTailRecursion(), llvm::AsmPrinter::EmitAlignment(), llvm::AArch64TargetLowering::emitAtomicCmpXchgNoStoreLLBalance(), llvm::ARMTargetLowering::emitAtomicCmpXchgNoStoreLLBalance(), llvm::AsmPrinter::EmitGlobalVariable(), llvm::TargetLoweringObjectFileCOFF::emitLinkerFlagsForGlobal(), llvm::HexagonTargetLowering::emitLoadLinked(), llvm::AArch64TargetLowering::emitLoadLinked(), llvm::ARMTargetLowering::emitLoadLinked(), llvm::AsmPrinter::EmitSpecialLLVMGlobal(), llvm::HexagonTargetLowering::emitStoreConditional(), llvm::AArch64TargetLowering::emitStoreConditional(), llvm::ARMTargetLowering::emitStoreConditional(), ensurePromotedGV(), llvm::GlobalIFunc::eraseFromParent(), llvm::GlobalAlias::eraseFromParent(), llvm::GlobalVariable::eraseFromParent(), llvm::Function::eraseFromParent(), llvm::CodeExtractor::extractCodeRegion(), llvm::findAllNVVMAnnotation(), llvm::findDevirtualizableCallsForTypeTest(), llvm::findOneNVVMAnnotation(), forceRenaming(), generateUnsignedDivisionCode(), getAlignment(), llvm::CallSiteBase<>::getCaller(), getComdatGVForCOFF(), llvm::lto::InputFile::Symbol::getCommonSize(), llvm::MachineFunction::getDataLayout(), llvm::TargetLoweringBase::getDefaultSafeStackPointerLocation(), llvm::RegionBase< RegionTr >::getDepth(), getGlobalIdentifier(), llvm::AArch64TargetLowering::getIRStackGuard(), llvm::TargetLoweringBase::getIRStackGuard(), llvm::TargetLibraryInfoImpl::getLibFunc(), getLoadStackGuard(), llvm::ExecutionEngine::getMangledName(), llvm::Trace::getModule(), llvm::BasicBlock::getModule(), getModuleFromVal(), llvm::Mangler::getNameWithPrefix(), llvm::CallGraph::getOrInsertFunction(), getParent(), llvm::getPGOFuncName(), llvm::MCJIT::getPointerToFunction(), llvm::NVPTXTargetLowering::getPrototype(), getRuntimeMDForKernel(), llvm::AArch64TargetLowering::getSafeStackPointerLocation(), llvm::TargetLoweringBase::getSafeStackPointerLocation(), llvm::TargetLoweringObjectFile::getSectionForJumpTable(), llvm::DependenceInfo::getSplitIteration(), llvm::SparcTargetLowering::getSRetArgSize(), llvm::TargetLoweringObjectFile::getSymbolWithGlobalValueBase(), llvm::MipsTargetMachine::getTargetIRAnalysis(), llvm::TargetMachine::getTargetIRAnalysis(), llvm::ARMTargetLowering::getTgtMemIntrinsic(), llvm::TargetMachine::getTLSModel(), getVarName(), llvm::GlobalVariable::GlobalVariable(), llvm::CallLowering::handleAssignments(), HandleByValArgument(), llvm::PPCSubtarget::hasLazyResolverStub(), hasReturnsTwiceAttr(), INITIALIZE_PASS(), llvm::MIRParserImpl::initializeConstantPool(), initSlots2BasicBlocks(), initSlots2Values(), llvm::InlineFunction(), insertSinCosCall(), llvm::ARMSubtarget::isGVIndirectSymbol(), llvm::isImageReadOnly(), llvm::isImageReadWrite(), llvm::isImageWriteOnly(), llvm::TargetLowering::isOffsetFoldingLegal(), llvm::SystemZSubtarget::isPC32DBLSymbol(), isPointerValueDeadOnEntryToFunction(), llvm::isSampler(), IsSmallObject(), llvm::lintFunction(), LLVMGetNextFunction(), LLVMGetNextGlobal(), LLVMGetPreviousFunction(), LLVMGetPreviousGlobal(), llvm::AArch64CallLowering::lowerCall(), llvm::CallLowering::lowerCall(), llvm::AsmPrinter::lowerConstant(), llvm::LowerDbgDeclare(), llvm::AArch64CallLowering::lowerFormalArguments(), lowerGuardIntrinsic(), llvm::AArch64CallLowering::lowerReturn(), llvm::TargetLowering::LowerToTLSEmulatedModel(), llvm::ARMTargetLowering::makeDMB(), llvm::orc::makeStub(), materialize(), mergeInlinedArrayAllocas(), llvm::orc::moveFunctionBody(), llvm::orc::moveGlobalVariableInitializer(), OptimizeGlobalAddressOfMalloc(), parentFunctionOfValue(), PerformHeapAllocSRoA(), postSplitCleanup(), PrepareCall(), prepareForSplit(), llvm::DivergenceAnalysis::print(), llvm::MIRPrinter::print(), llvm::Value::print(), llvm::Function::print(), llvm::MachineBasicBlock::print(), llvm::MachineInstr::print(), llvm::MIPrinter::printIRBlockReference(), processInternalGlobal(), PromoteArguments(), llvm::Intrinsic::remangleIntrinsicFunction(), llvm::GlobalIFunc::removeFromParent(), llvm::GlobalAlias::removeFromParent(), llvm::GlobalVariable::removeFromParent(), llvm::Function::removeFromParent(), replaceDevirtTrigger(), resideInSameSection(), llvm::returnTypeIsEligibleForTailCall(), llvm::IndVarSimplifyPass::run(), llvm::SCCPPass::run(), llvm::objcarc::ObjCARCAA::run(), llvm::BasicAA::run(), llvm::TargetLibraryAnalysis::run(), llvm::MCJIT::runFunction(), NewGVN::runGVN(), llvm::Float2IntPass::runImpl(), runImpl(), llvm::SLPVectorizerPass::runImpl(), llvm::NaryReassociatePass::runImpl(), llvm::LazyValueInfoWrapperPass::runOnFunction(), llvm::StackProtector::runOnFunction(), llvm::BasicAAWrapperPass::runOnFunction(), llvm::IRTranslator::runOnMachineFunction(), llvm::ScalarEvolution::ScalarEvolution(), selectELFSectionForGlobal(), llvm::XCoreTargetObjectFile::SelectSectionForGlobal(), llvm::TargetLoweringObjectFileMachO::SelectSectionForGlobal(), setUsedInitializer(), simplifyCFG(), SRAGlobal(), SwitchToLookupTable(), TryToShrinkGlobalToBoolean(), llvm::UpgradeIntrinsicCall(), UpgradeIntrinsicFunction1(), UpgradeSSE41Function(), UpgradeX86IntrinsicsWith8BitMask(), UpgradeX86MaskedShift(), usedInOneFunc(), llvm::verifyFunction(), and llvm::SelectionDAGBuilder::visitSPDescriptorParent().

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

Definition at line 538 of file GlobalValue.h.

References Parent.

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

If special LLVM prefix that is used to inform the asm printer to not emit usual symbol prefix before the symbol name is used then return linkage name after skipping this special LLVM prefix.

Definition at line 444 of file GlobalValue.h.

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

Referenced by llvm::DwarfUnit::addLinkageName(), llvm::DiagnosticInfoOptimizationBase::Argument::Argument(), llvm::WinException::beginFunction(), llvm::WinException::endFunclet(), getMCSymbolForMBB(), LowerINTRINSIC_WO_CHAIN(), llvm::yaml::MappingTraits< DiagnosticInfoOptimizationBase * >::mapping(), recoverFramePointer(), and sanitizeFunctionName().

StringRef GlobalValue::getSection ( ) const

Definition at line 145 of file Globals.cpp.

References getBaseObject().

Referenced by hasSection(), and resideInSameSection().

ThreadLocalMode llvm::GlobalValue::getThreadLocalMode ( ) const
inline
PointerType* llvm::GlobalValue::getType ( ) const
inline
UnnamedAddr llvm::GlobalValue::getUnnamedAddr ( ) const
inline
Type* llvm::GlobalValue::getValueType ( ) const
inline
VisibilityTypes llvm::GlobalValue::getVisibility ( ) const
inline
static LinkageTypes llvm::GlobalValue::getWeakLinkage ( bool  ODR)
inlinestatic

Definition at line 266 of file GlobalValue.h.

References WeakAnyLinkage, and WeakODRLinkage.

Referenced by thinLTOResolveWeakForLinkerGUID().

bool llvm::GlobalValue::hasAppendingLinkage ( ) const
inline
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 196 of file GlobalValue.h.

References getUnnamedAddr(), and None.

Referenced by llvm::canBeOmittedFromSymbolTable().

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

Definition at line 213 of file GlobalValue.h.

References getComdat().

Referenced by resideInSameSection().

bool llvm::GlobalValue::hasCommonLinkage ( ) const
inline
bool llvm::GlobalValue::hasDefaultVisibility ( ) const
inline
bool llvm::GlobalValue::hasDLLExportStorageClass ( ) const
inline
bool llvm::GlobalValue::hasDLLImportStorageClass ( ) const
inline
bool llvm::GlobalValue::hasExactDefinition ( ) const
inline

Return true if this global has an exact defintion.

Definition at line 386 of file GlobalValue.h.

References isDeclaration(), and isDefinitionExact().

Referenced by addArgumentAttrs(), addArgumentReturnedAttrs(), addNoAliasAttrs(), addNonNullAttrs(), checkFunctionMemoryAccess(), runImpl(), and runIPSCCP().

bool llvm::GlobalValue::hasExternalLinkage ( ) const
inline
bool llvm::GlobalValue::hasExternalWeakLinkage ( ) const
inline
bool llvm::GlobalValue::hasGlobalUnnamedAddr ( ) const
inline
bool llvm::GlobalValue::hasHiddenVisibility ( ) const
inline

Definition at line 221 of file GlobalValue.h.

References HiddenVisibility, and Visibility.

Referenced by llvm::JITSymbolFlags::fromGlobalValue().

bool llvm::GlobalValue::hasInternalLinkage ( ) const
inline
bool llvm::GlobalValue::hasLinkOnceLinkage ( ) const
inline
bool llvm::GlobalValue::hasLinkOnceODRLinkage ( ) const
inline
bool llvm::GlobalValue::hasLocalLinkage ( ) const
inline

Definition at line 415 of file GlobalValue.h.

References getLinkage(), and isLocalLinkage().

Referenced by canIncreaseAlignment(), llvm::PPCSubtarget::classifyGlobalReference(), deleteIfDead(), llvm::ExecutionEngine::emitGlobals(), externalize(), findReturnsToZap(), forceRenaming(), llvm::JITSymbolFlags::fromGlobalValue(), llvm::TargetLoweringObjectFileMachO::getCFIPersonalitySymbol(), llvm::HexagonTargetObjectFile::getExplicitSectionGlobal(), llvm::getIntrinsicForCallSite(), llvm::GlobalsAAResult::getModRefInfo(), llvm::SparcELFTargetObjectFile::getTTypeGlobalReference(), llvm::TargetLoweringObjectFileELF::getTTypeGlobalReference(), llvm::TargetLoweringObjectFileMachO::getTTypeGlobalReference(), hasUsesToReplace(), inlineCallsImpl(), IsBetterCanonical(), llvm::Function::isDefTriviallyDead(), llvm::TargetTransformInfoImplBase::isLoweredToCall(), isNonRenamableLocal(), llvm::TargetFrameLowering::isSafeForNoCSROpt(), makeVisible(), llvm::maybeMarkSanitizerLibraryCallNoBuiltin(), mayHaveOtherReferences(), mergeConstants(), OptimizeFunctions(), OptimizeGlobalAliases(), OptimizeGlobalVars(), processGlobal(), PromoteArguments(), llvm::orc::raiseVisibilityOnValue(), llvm::LegacyInlinerBase::removeDeadFunctions(), runIPSCCP(), llvm::X86AsmPrinter::runOnMachineFunction(), llvm::ExecutionEngine::runStaticConstructorsDestructors(), llvm::FastISel::selectInstruction(), llvm::HexagonTargetObjectFile::SelectSectionForGlobal(), llvm::XCoreTargetObjectFile::SelectSectionForGlobal(), setVisibility(), llvm::TargetMachine::shouldAssumeDSOLocal(), shouldBeDeferred(), shouldRecordFunctionAddr(), and SRAGlobal().

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

Definition at line 222 of file GlobalValue.h.

References ProtectedVisibility, and Visibility.

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

Definition at line 420 of file GlobalValue.h.

References getLinkage(), and isValidDeclarationLinkage().

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

Definition at line 410 of file GlobalValue.h.

References getLinkage(), and isWeakAnyLinkage().

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

Definition at line 409 of file GlobalValue.h.

References getLinkage(), and isWeakLinkage().

Referenced by llvm::JITSymbolFlags::fromGlobalValue().

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

Definition at line 411 of file GlobalValue.h.

References getLinkage(), and isWeakODRLinkage().

bool GlobalValue::isAbsoluteSymbolRef ( ) const

Returns whether this is a reference to an absolute symbol.

Definition at line 251 of file Globals.cpp.

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

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

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

Definition at line 291 of file GlobalValue.h.

References AppendingLinkage.

Referenced by hasAppendingLinkage().

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

Definition at line 273 of file GlobalValue.h.

References AvailableExternallyLinkage.

Referenced by hasAvailableExternallyLinkage(), and isDiscardableIfUnused().

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

Definition at line 306 of file GlobalValue.h.

References CommonLinkage.

Referenced by hasCommonLinkage().

bool GlobalValue::isDeclaration ( ) const

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

Definition at line 188 of file Globals.cpp.

References assert(), and F.

Referenced by addNoRecurseAttrs(), addNoRecurseAttrsTopDown(), assureFPCallStub(), llvm::buildModuleSummaryIndex(), llvm::Interpreter::callFunction(), cxxDtorIsEmpty(), deduceFunctionAttributeInRPO(), deleteIfDead(), llvm::ExecutionEngine::emitGlobals(), llvm::AsmPrinter::EmitGlobalVariable(), llvm::TargetLoweringObjectFileCOFF::emitLinkerFlagsForGlobal(), llvm::Evaluator::EvaluateBlock(), llvm::ExecutionEngine::FindFunctionNamed(), llvm::ExecutionEngine::FindGlobalVariableNamed(), llvm::MCJIT::findModuleForSymbol(), getCalledFunction(), llvm::GCModuleInfo::getFunctionInfo(), llvm::TargetLoweringObjectFile::getKindForGlobal(), llvm::MCJIT::getPointerToFunction(), hasExactDefinition(), llvm::GlobalVariable::hasInitializer(), inlineCallsImpl(), llvm::InlineFunction(), invokeFunctionPass(), isDeclarationForLinker(), llvm::LanaiTargetObjectFile::isGlobalInSmallSection(), llvm::MipsTargetObjectFile::IsGlobalInSmallSection(), isReportingError(), llvm::lintFunction(), llvm::orc::makeStub(), llvm::orc::moveFunctionBody(), OptimizeFunctions(), OptimizeGlobalAliases(), OptimizeGlobalVars(), predictUseListOrder(), removeConvergentAttrs(), llvm::LegacyInlinerBase::removeDeadFunctions(), runIPSCCP(), llvm::FPPassManager::runOnFunction(), llvm::ExecutionEngine::runStaticConstructorsDestructors(), llvm::Function::stealArgumentListFrom(), stripDeadPrototypes(), and llvm::Interpreter::visitCallSite().

bool llvm::GlobalValue::isDeclarationForLinker ( ) const
inline
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 381 of file GlobalValue.h.

Referenced by hasExactDefinition(), and PropagateConstantReturn().

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 340 of file GlobalValue.h.

References isAvailableExternallyLinkage(), isLinkOnceLinkage(), and isLocalLinkage().

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

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

Definition at line 431 of file GlobalValue.h.

References getLinkage().

Referenced by llvm::canRenameComdatFunc().

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

Definition at line 303 of file GlobalValue.h.

References ExternalWeakLinkage.

Referenced by hasExternalWeakLinkage(), and isValidDeclarationLinkage().

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

Definition at line 294 of file GlobalValue.h.

References InternalLinkage.

Referenced by hasInternalLinkage(), and isLocalLinkage().

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 399 of file GlobalValue.h.

References getLinkage(), and isInterposableLinkage().

Referenced by llvm::Evaluator::EvaluateBlock(), llvm::getInlineCost(), llvm::GlobalVariable::hasDefinitiveInitializer(), OptimizeGlobalAliases(), and llvm::ObjectSizeOffsetVisitor::visitGlobalAlias().

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 316 of file GlobalValue.h.

References AppendingLinkage, AvailableExternallyLinkage, CommonLinkage, ExternalLinkage, ExternalWeakLinkage, InternalLinkage, LinkOnceAnyLinkage, LinkOnceODRLinkage, llvm_unreachable, PrivateLinkage, WeakAnyLinkage, and WeakODRLinkage.

Referenced by isInterposable().

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

Definition at line 276 of file GlobalValue.h.

References LinkOnceODRLinkage.

Referenced by hasLinkOnceODRLinkage(), and thinLTOResolveWeakForLinkerGUID().

static bool llvm::GlobalValue::isLocalLinkage ( LinkageTypes  Linkage)
inlinestatic
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.

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

Definition at line 297 of file GlobalValue.h.

References PrivateLinkage.

Referenced by hasPrivateLinkage(), and isLocalLinkage().

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 509 of file GlobalValue.h.

References isDeclarationForLinker(), and isWeakForLinker().

Referenced by canIncreaseAlignment(), llvm::PPCSubtarget::classifyGlobalReference(), llvm::GlobalVariable::hasUniqueInitializer(), resideInSameSection(), and llvm::TargetMachine::shouldAssumeDSOLocal().

bool llvm::GlobalValue::isThreadLocal ( ) const
inline
static bool llvm::GlobalValue::isValidDeclarationLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 309 of file GlobalValue.h.

References isExternalLinkage(), and isExternalWeakLinkage().

Referenced by hasValidDeclarationLinkage().

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

Definition at line 282 of file GlobalValue.h.

References WeakAnyLinkage.

Referenced by hasWeakAnyLinkage(), and isWeakLinkage().

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 349 of file GlobalValue.h.

References CommonLinkage, ExternalWeakLinkage, LinkOnceAnyLinkage, LinkOnceODRLinkage, WeakAnyLinkage, and WeakODRLinkage.

Referenced by mergeConstants(), llvm::TargetLoweringObjectFileMachO::SelectSectionForGlobal(), and llvm::TargetLoweringObjectFile::shouldPutJumpTableInFunctionSection().

bool llvm::GlobalValue::isWeakForLinker ( ) const
inline
static bool llvm::GlobalValue::isWeakLinkage ( LinkageTypes  Linkage)
inlinestatic

Definition at line 288 of file GlobalValue.h.

References isWeakAnyLinkage(), and isWeakODRLinkage().

Referenced by hasWeakLinkage(), and llvm::GlobalAlias::isValidLinkage().

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

Definition at line 285 of file GlobalValue.h.

References WeakODRLinkage.

Referenced by hasWeakODRLinkage(), isWeakLinkage(), and thinLTOResolveWeakForLinkerGUID().

Error GlobalValue::materialize ( )

Make sure this GlobalValue is fully read.

Definition at line 50 of file Globals.cpp.

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

Referenced by llvm::FunctionImporter::importFunctions(), and llvm::legacy::FunctionPassManager::run().

virtual void llvm::GlobalValue::removeFromParent ( )
pure virtual

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

Implemented in llvm::Function, llvm::GlobalVariable, llvm::GlobalAlias, and llvm::GlobalIFunc.

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

Definition at line 253 of file GlobalValue.h.

References C, and DllStorageClass.

Referenced by copyAttributesFrom(), OptimizeGlobalAliases(), and upgradeDLLImportExportLinkage().

void llvm::GlobalValue::setGlobalValueSubClassData ( unsigned  V)
inlineprotected
void llvm::GlobalValue::setLinkage ( LinkageTypes  LT)
inline
void llvm::GlobalValue::setParent ( Module parent)
inlineprotected

Definition at line 160 of file GlobalValue.h.

References Parent.

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

Definition at line 233 of file GlobalValue.h.

References GeneralDynamicTLSModel, NotThreadLocal, and setThreadLocalMode().

void llvm::GlobalValue::setThreadLocalMode ( ThreadLocalMode  Val)
inline
void llvm::GlobalValue::setUnnamedAddr ( UnnamedAddr  Val)
inline
void llvm::GlobalValue::setVisibility ( VisibilityTypes  V)
inline

Friends And Related Function Documentation

friend class Constant
friend

Definition at line 107 of file GlobalValue.h.

Member Data Documentation

unsigned llvm::GlobalValue::DllStorageClass
protected
const unsigned llvm::GlobalValue::GlobalValueSubClassDataBits = 18
staticprotected

Definition at line 89 of file GlobalValue.h.

Referenced by setGlobalValueSubClassData().

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 104 of file GlobalValue.h.

Referenced by llvm::Function::isIntrinsic(), and llvm::Function::recalculateIntrinsicID().

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 147 of file GlobalValue.h.

Referenced by llvm::Function::getIntrinsicID(), and llvm::Function::recalculateIntrinsicID().

unsigned llvm::GlobalValue::Linkage
protected

Definition at line 93 of file GlobalValue.h.

Referenced by getLinkage(), and setLinkage().

Module* llvm::GlobalValue::Parent
protected

Definition at line 157 of file GlobalValue.h.

Referenced by canIncreaseAlignment(), getParent(), and setParent().

unsigned llvm::GlobalValue::ThreadLocal
protected

Definition at line 98 of file GlobalValue.h.

Referenced by getThreadLocalMode().

unsigned llvm::GlobalValue::UnnamedAddrVal
protected

Definition at line 95 of file GlobalValue.h.

Referenced by getUnnamedAddr(), and setUnnamedAddr().

Type* llvm::GlobalValue::ValueType
protected

Definition at line 87 of file GlobalValue.h.

Referenced by getValueType().

unsigned llvm::GlobalValue::Visibility
protected

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