LLVM 19.0.0git
Classes | Public Types | Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Protected Attributes | List of all members
llvm::MCSection Class Referenceabstract

Instances of this class represent a uniqued identifier for a section in the current translation unit. More...

#include "llvm/MC/MCSection.h"

Inheritance diagram for llvm::MCSection:
Inheritance graph
[legend]

Classes

struct  FragList
 
struct  iterator
 

Public Types

enum  SectionVariant {
  SV_COFF = 0 , SV_ELF , SV_GOFF , SV_MachO ,
  SV_Wasm , SV_XCOFF , SV_SPIRV , SV_DXContainer
}
 
enum  BundleLockStateType { NotBundleLocked , BundleLocked , BundleLockedAlignToEnd }
 Express the state of bundle locked groups while emitting code. More...
 

Public Member Functions

 MCSection (const MCSection &)=delete
 
MCSection & operator= (const MCSection &)=delete
 
StringRef getName () const
 
bool isText () const
 
SectionVariant getVariant () const
 
MCSymbol * getBeginSymbol ()
 
const MCSymbol * getBeginSymbol () const
 
void setBeginSymbol (MCSymbol *Sym)
 
MCSymbol * getEndSymbol (MCContext &Ctx)
 
bool hasEnded () const
 
Align getAlign () const
 
void setAlignment (Align Value)
 
void ensureMinAlignment (Align MinAlignment)
 Makes sure that Alignment is at least MinAlignment.
 
unsigned getOrdinal () const
 
void setOrdinal (unsigned Value)
 
unsigned getLayoutOrder () const
 
void setLayoutOrder (unsigned Value)
 
BundleLockStateType getBundleLockState () const
 
void setBundleLockState (BundleLockStateType NewState)
 
bool isBundleLocked () const
 
bool isBundleGroupBeforeFirstInst () const
 
void setBundleGroupBeforeFirstInst (bool IsFirst)
 
bool hasInstructions () const
 
void setHasInstructions (bool Value)
 
bool hasLayout () const
 
void setHasLayout (bool Value)
 
bool isRegistered () const
 
void setIsRegistered (bool Value)
 
const MCDummyFragment & getDummyFragment () const
 
MCDummyFragment & getDummyFragment ()
 
FragList * curFragList () const
 
iterator begin () const
 
iterator end () const
 
bool empty () const
 
void addFragment (MCFragment &F)
 
void dump () const
 
virtual void printSwitchToSection (const MCAsmInfo &MAI, const Triple &T, raw_ostream &OS, uint32_t Subsection) const =0
 
virtual bool useCodeAlign () const =0
 Return true if a .align directive should use "optimized nops" to fill instead of 0s.
 
bool isVirtualSection () const
 Check whether this section is "virtual", that is has no actual object file contents.
 
virtual StringRef getVirtualSectionKind () const
 
void addPendingLabel (MCSymbol *label, unsigned Subsection=0)
 Add a pending label for the requested subsection.
 

Public Attributes

friend MCAssembler
 
friend MCObjectStreamer
 

Static Public Attributes

static constexpr unsigned NonUniqueID = ~0U
 

Protected Member Functions

 MCSection (SectionVariant V, StringRef Name, bool IsText, bool IsVirtual, MCSymbol *Begin)
 
 ~MCSection ()
 

Protected Attributes

StringRef Name
 
SectionVariant Variant
 

Detailed Description

Instances of this class represent a uniqued identifier for a section in the current translation unit.

The MCContext class uniques and creates these.

Definition at line 36 of file MCSection.h.

Member Enumeration Documentation

◆ BundleLockStateType

enum llvm::MCSection::BundleLockStateType

Express the state of bundle locked groups while emitting code.

Enumerator
NotBundleLocked 
BundleLocked 
BundleLockedAlignToEnd 

Definition at line 54 of file MCSection.h.

◆ SectionVariant

enum llvm::MCSection::SectionVariant
Enumerator
SV_COFF 
SV_ELF 
SV_GOFF 
SV_MachO 
SV_Wasm 
SV_XCOFF 
SV_SPIRV 
SV_DXContainer 

Definition at line 42 of file MCSection.h.

Constructor & Destructor Documentation

◆ MCSection() [1/2]

MCSection::MCSection ( SectionVariant  V,
StringRef  Name,
bool  IsText,
bool  IsVirtual,
MCSymbol *  Begin 
)
protected

Definition at line 23 of file MCSection.cpp.

References llvm::MCFragment::setParent().

◆ ~MCSection()

MCSection::~MCSection ( )
protected

Definition at line 41 of file MCSection.cpp.

References _, X, and Y.

◆ MCSection() [2/2]

llvm::MCSection::MCSection ( const MCSection &  )
delete

Member Function Documentation

◆ addFragment()

void llvm::MCSection::addFragment ( MCFragment &  F)
inline

Definition at line 201 of file MCSection.h.

References assert(), F, llvm::MCFragment::getLayoutOrder(), llvm::MCSection::FragList::Head, and llvm::MCSection::FragList::Tail.

Referenced by llvm::MCWinCOFFStreamer::emitCOFFSafeSEH().

◆ addPendingLabel()

void llvm::MCSection::addPendingLabel ( MCSymbol *  label,
unsigned  Subsection = 0 
)

Add a pending label for the requested subsection.

This label will be associated with a fragment in flushPendingLabels()

◆ begin()

iterator llvm::MCSection::begin ( ) const
inline

Definition at line 197 of file MCSection.h.

References llvm::MCSection::FragList::Head.

Referenced by EmitUnwindCode(), and llvm::MachObjectWriter::writeObject().

◆ curFragList()

FragList * llvm::MCSection::curFragList ( ) const
inline

Definition at line 196 of file MCSection.h.

Referenced by llvm::MCSectionMachO::allocAtoms(), and llvm::MCAsmLayout::getSectionAddressSize().

◆ dump()

LLVM_DUMP_METHOD void MCSection::dump ( ) const

Definition at line 72 of file MCSection.cpp.

References llvm::errs(), F, llvm::First, getName(), and OS.

◆ empty()

bool llvm::MCSection::empty ( ) const
inline

Definition at line 199 of file MCSection.h.

References llvm::MCSection::FragList::Head.

Referenced by llvm::WebAssemblyAsmPrinter::EmitProducerInfo().

◆ end()

iterator llvm::MCSection::end ( ) const
inline

Definition at line 198 of file MCSection.h.

◆ ensureMinAlignment()

void llvm::MCSection::ensureMinAlignment ( Align  MinAlignment)
inline

Makes sure that Alignment is at least MinAlignment.

Definition at line 162 of file MCSection.h.

Referenced by llvm::MCWinCOFFStreamer::emitCOFFSafeSEH(), llvm::MCWinCOFFStreamer::emitCOFFSymbolIndex(), llvm::AMDGPUAsmPrinter::emitFunctionBodyEnd(), llvm::MCObjectStreamer::emitValueToAlignment(), and llvm::MipsTargetELFStreamer::finish().

◆ getAlign()

Align llvm::MCSection::getAlign ( ) const
inline

Definition at line 158 of file MCSection.h.

Referenced by addData(), getAlignment(), and llvm::MachObjectWriter::getPaddingSize().

◆ getBeginSymbol() [1/2]

MCSymbol * llvm::MCSection::getBeginSymbol ( )
inline

Definition at line 147 of file MCSection.h.

Referenced by llvm::DwarfCompileUnit::addAddrTableBase(), llvm::DwarfUnit::addRnglistsBase(), llvm::DwarfCompileUnit::addScopeRangeList(), llvm::DwarfUnit::addStringOffsetsStart(), llvm::DwarfCompileUnit::applyStmtList(), llvm::MCContext::createELFRelSection(), llvm::DwarfUnit::emitCommonHeader(), llvm::MCObjectFileInfo::getBBAddrMapSection(), getBeginSymbol(), llvm::MCObjectFileInfo::getKCFITrapSection(), llvm::MCObjectFileInfo::getPCSection(), llvm::MCObjectFileInfo::getPseudoProbeSection(), llvm::MCObjectFileInfo::getStackSizesSection(), llvm::DwarfCompileUnit::initStmtList(), llvm::MCDwarfLineStr::MCDwarfLineStr(), and llvm::LoongArchAsmBackend::shouldInsertFixupForCodeAlign().

◆ getBeginSymbol() [2/2]

const MCSymbol * llvm::MCSection::getBeginSymbol ( ) const
inline

Definition at line 148 of file MCSection.h.

References getBeginSymbol().

◆ getBundleLockState()

BundleLockStateType llvm::MCSection::getBundleLockState ( ) const
inline

Definition at line 173 of file MCSection.h.

◆ getDummyFragment() [1/2]

MCDummyFragment & llvm::MCSection::getDummyFragment ( )
inline

Definition at line 194 of file MCSection.h.

◆ getDummyFragment() [2/2]

const MCDummyFragment & llvm::MCSection::getDummyFragment ( ) const
inline

Definition at line 193 of file MCSection.h.

◆ getEndSymbol()

MCSymbol * MCSection::getEndSymbol ( MCContext &  Ctx)

Definition at line 33 of file MCSection.cpp.

References llvm::MCContext::createTempSymbol().

◆ getLayoutOrder()

unsigned llvm::MCSection::getLayoutOrder ( ) const
inline

Definition at line 170 of file MCSection.h.

Referenced by llvm::MachObjectWriter::getPaddingSize().

◆ getName()

StringRef llvm::MCSection::getName ( ) const
inline

Definition at line 142 of file MCSection.h.

References Name.

Referenced by addData(), llvm::BTFDebug::beginFunctionImpl(), canGoAfterDWARF(), canUseLocalRelocation(), dump(), llvm::MCObjectStreamer::emitInstruction(), llvm::MCContext::getAssociativeCOFFSection(), llvm::MCObjectFileInfo::getPseudoProbeSection(), llvm::TargetLoweringObjectFileELF::getSectionForMachineBasicBlock(), isDwoSection(), llvm::MCAsmInfoDarwin::isSectionAtomizableBySymbols(), llvm::MCSectionCOFF::printSwitchToSection(), llvm::MCSectionELF::printSwitchToSection(), llvm::MCSectionMachO::printSwitchToSection(), llvm::MCSectionWasm::printSwitchToSection(), llvm::MCSectionXCOFF::printSwitchToSection(), llvm::MCSectionGOFF::printSwitchToSection(), and llvm::XtensaTargetELFStreamer::startLiteralSection().

◆ getOrdinal()

unsigned llvm::MCSection::getOrdinal ( ) const
inline

Definition at line 167 of file MCSection.h.

◆ getVariant()

SectionVariant llvm::MCSection::getVariant ( ) const
inline

Definition at line 145 of file MCSection.h.

References Variant.

Referenced by llvm::MCSectionCOFF::classof(), llvm::MCSectionELF::classof(), llvm::MCSectionGOFF::classof(), llvm::MCSectionMachO::classof(), llvm::MCSectionWasm::classof(), and llvm::MCSectionXCOFF::classof().

◆ getVirtualSectionKind()

StringRef MCSection::getVirtualSectionKind ( ) const
virtual

Reimplemented in llvm::MCSectionCOFF, and llvm::MCSectionELF.

Definition at line 69 of file MCSection.cpp.

Referenced by llvm::MCObjectStreamer::emitInstruction().

◆ hasEnded()

bool MCSection::hasEnded ( ) const

Definition at line 39 of file MCSection.cpp.

References llvm::MCSymbol::isInSection().

◆ hasInstructions()

bool llvm::MCSection::hasInstructions ( ) const
inline

Definition at line 184 of file MCSection.h.

Referenced by AttemptToFoldSymbolOffsetDifference(), and llvm::MCObjectStreamer::mayHaveInstructions().

◆ hasLayout()

bool llvm::MCSection::hasLayout ( ) const
inline

Definition at line 187 of file MCSection.h.

◆ isBundleGroupBeforeFirstInst()

bool llvm::MCSection::isBundleGroupBeforeFirstInst ( ) const
inline

Definition at line 177 of file MCSection.h.

Referenced by llvm::MCELFStreamer::emitBundleUnlock().

◆ isBundleLocked()

bool llvm::MCSection::isBundleLocked ( ) const
inline

Definition at line 175 of file MCSection.h.

References NotBundleLocked.

◆ isRegistered()

bool llvm::MCSection::isRegistered ( ) const
inline

Definition at line 190 of file MCSection.h.

Referenced by llvm::AArch64TargetStreamer::emitNoteSection().

◆ isText()

bool llvm::MCSection::isText ( ) const
inline

Definition at line 143 of file MCSection.h.

Referenced by llvm::MCSectionXCOFF::printSwitchToSection(), and llvm::MCSectionCOFF::useCodeAlign().

◆ isVirtualSection()

bool llvm::MCSection::isVirtualSection ( ) const
inline

Check whether this section is "virtual", that is has no actual object file contents.

Definition at line 225 of file MCSection.h.

Referenced by llvm::AsmPrinter::emitGlobalVariable(), llvm::MCObjectStreamer::emitInstruction(), llvm::MachObjectWriter::getPaddingSize(), llvm::MCAsmLayout::getSectionFileSize(), and llvm::MCAssembler::writeSectionData().

◆ operator=()

MCSection & llvm::MCSection::operator= ( const MCSection &  )
delete

◆ printSwitchToSection()

virtual void llvm::MCSection::printSwitchToSection ( const MCAsmInfo &  MAI,
const Triple &  T,
raw_ostream &  OS,
uint32_t  Subsection 
) const
pure virtual

Implemented in llvm::MCSectionDXContainer, llvm::MCSectionCOFF, llvm::MCSectionELF, llvm::MCSectionMachO, llvm::MCSectionSPIRV, llvm::MCSectionWasm, llvm::MCSectionXCOFF, and llvm::MCSectionGOFF.

◆ setAlignment()

void llvm::MCSection::setAlignment ( Align  Value)
inline

Definition at line 159 of file MCSection.h.

Referenced by llvm::MipsTargetELFStreamer::emitDirectiveEnd(), llvm::MipsTargetELFStreamer::emitMipsAbiFlags(), llvm::MipsRegInfoRecord::EmitMipsOptionRecord(), llvm::dwarf_linker::classic::DwarfStreamer::emitSwiftAST(), llvm::dwarf_linker::classic::DwarfStreamer::emitSwiftReflectionSection(), and llvm::XtensaTargetELFStreamer::startLiteralSection().

◆ setBeginSymbol()

void llvm::MCSection::setBeginSymbol ( MCSymbol *  Sym)
inline

Definition at line 151 of file MCSection.h.

References assert(), and Sym.

◆ setBundleGroupBeforeFirstInst()

void llvm::MCSection::setBundleGroupBeforeFirstInst ( bool  IsFirst)
inline

Definition at line 180 of file MCSection.h.

Referenced by llvm::MCELFStreamer::emitBundleLock().

◆ setBundleLockState()

void MCSection::setBundleLockState ( BundleLockStateType  NewState)

Definition at line 50 of file MCSection.cpp.

References BundleLockedAlignToEnd, NotBundleLocked, and llvm::report_fatal_error().

Referenced by llvm::MCELFStreamer::emitBundleLock(), and llvm::MCELFStreamer::emitBundleUnlock().

◆ setHasInstructions()

void llvm::MCSection::setHasInstructions ( bool  Value)
inline

Definition at line 185 of file MCSection.h.

◆ setHasLayout()

void llvm::MCSection::setHasLayout ( bool  Value)
inline

Definition at line 188 of file MCSection.h.

Referenced by llvm::MCAssembler::layout().

◆ setIsRegistered()

void llvm::MCSection::setIsRegistered ( bool  Value)
inline

Definition at line 191 of file MCSection.h.

◆ setLayoutOrder()

void llvm::MCSection::setLayoutOrder ( unsigned  Value)
inline

Definition at line 171 of file MCSection.h.

Referenced by llvm::MCAssembler::layout().

◆ setOrdinal()

void llvm::MCSection::setOrdinal ( unsigned  Value)
inline

Definition at line 168 of file MCSection.h.

Referenced by llvm::MCAssembler::layout().

◆ useCodeAlign()

virtual bool llvm::MCSection::useCodeAlign ( ) const
pure virtual

Return true if a .align directive should use "optimized nops" to fill instead of 0s.

Implemented in llvm::MCSectionCOFF, llvm::MCSectionDXContainer, llvm::MCSectionELF, llvm::MCSectionGOFF, llvm::MCSectionMachO, llvm::MCSectionSPIRV, llvm::MCSectionWasm, and llvm::MCSectionXCOFF.

Referenced by llvm::MCAssembler::computeFragmentSize().

Member Data Documentation

◆ MCAssembler

friend llvm::MCSection::MCAssembler

Definition at line 38 of file MCSection.h.

◆ MCObjectStreamer

friend llvm::MCSection::MCObjectStreamer

Definition at line 39 of file MCSection.h.

◆ Name

StringRef llvm::MCSection::Name
protected

Definition at line 131 of file MCSection.h.

Referenced by getName(), llvm::MCSectionCOFF::isImplicitlyDiscardable(), llvm::MCSectionCOFF::shouldOmitSectionDirective(), llvm::MCSectionELF::shouldOmitSectionDirective(), and llvm::MCSectionWasm::shouldOmitSectionDirective().

◆ NonUniqueID

constexpr unsigned llvm::MCSection::NonUniqueID = ~0U
staticconstexpr

Definition at line 40 of file MCSection.h.

Referenced by llvm::MCContext::createELFGroupSection(), llvm::AsmPrinter::emitPatchableFunctionEntries(), llvm::AsmPrinter::emitXRayTable(), llvm::MCContext::getELFSection(), llvm::TargetLoweringObjectFileELF::getSectionForLSDA(), and llvm::MCSectionELF::isUnique().

◆ Variant

SectionVariant llvm::MCSection::Variant
protected

Definition at line 132 of file MCSection.h.

Referenced by getVariant().

The documentation for this class was generated from the following files:
Generated on Sat Jun 29 2024 16:07:42 for LLVM by doxygen 1.9.6