LLVM 20.0.0git
Public Types | Public Member Functions | Friends | List of all members
llvm::MCAssembler Class Reference

#include "llvm/MC/MCAssembler.h"

Public Types

using SectionListType = SmallVector< MCSection *, 0 >
 
using const_iterator = pointee_iterator< SectionListType::const_iterator >
 

Public Member Functions

 MCAssembler (MCContext &Context, std::unique_ptr< MCAsmBackend > Backend, std::unique_ptr< MCCodeEmitter > Emitter, std::unique_ptr< MCObjectWriter > Writer)
 Construct a new assembler instance.
 
 MCAssembler (const MCAssembler &)=delete
 
MCAssembler & operator= (const MCAssembler &)=delete
 
uint64_t computeFragmentSize (const MCFragment &F) const
 Compute the effective fragment size.
 
void layoutBundle (MCFragment *Prev, MCFragment *F) const
 
uint64_t getFragmentOffset (const MCFragment &F) const
 
uint64_t getSectionAddressSize (const MCSection &Sec) const
 
uint64_t getSectionFileSize (const MCSection &Sec) const
 
bool getSymbolOffset (const MCSymbol &S, uint64_t &Val) const
 
uint64_t getSymbolOffset (const MCSymbol &S) const
 
const MCSymbol * getBaseSymbol (const MCSymbol &Symbol) const
 
void writeSectionData (raw_ostream &OS, const MCSection *Section) const
 Emit the section contents to OS.
 
bool isThumbFunc (const MCSymbol *Func) const
 Check whether a given symbol has been flagged with .thumb_func.
 
void setIsThumbFunc (const MCSymbol *Func)
 Flag a function symbol as the target of a .thumb_func directive.
 
void reset ()
 Reuse an assembler instance.
 
MCContext & getContext () const
 
MCAsmBackend * getBackendPtr () const
 
MCCodeEmitter * getEmitterPtr () const
 
MCAsmBackend & getBackend () const
 
MCCodeEmitter & getEmitter () const
 
MCObjectWriter & getWriter () const
 
MCDwarfLineTableParams getDWARFLinetableParams () const
 
void Finish ()
 Finish - Do final processing and write the object to the output stream.
 
void layout ()
 
bool hasLayout () const
 
bool getRelaxAll () const
 
void setRelaxAll (bool Value)
 
bool isBundlingEnabled () const
 
unsigned getBundleAlignSize () const
 
void setBundleAlignSize (unsigned Size)
 
const_iterator begin () const
 
const_iterator end () const
 
iterator_range< pointee_iterator< typename SmallVector< const MCSymbol *, 0 >::const_iterator > > symbols () const
 
bool registerSection (MCSection &Section)
 
bool registerSymbol (const MCSymbol &Symbol)
 
void writeFragmentPadding (raw_ostream &OS, const MCEncodedFragment &F, uint64_t FSize) const
 Write the necessary bundle padding to OS.
 
void dump () const
 

Friends

class MCObjectWriter
 

Detailed Description

Definition at line 53 of file MCAssembler.h.

Member Typedef Documentation

◆ const_iterator

using llvm::MCAssembler::const_iterator = pointee_iterator<SectionListType::const_iterator>

Definition at line 57 of file MCAssembler.h.

◆ SectionListType

using llvm::MCAssembler::SectionListType = SmallVector<MCSection *, 0>

Definition at line 56 of file MCAssembler.h.

Constructor & Destructor Documentation

◆ MCAssembler() [1/2]

MCAssembler::MCAssembler ( MCContext &  Context,
std::unique_ptr< MCAsmBackend >  Backend,
std::unique_ptr< MCCodeEmitter >  Emitter,
std::unique_ptr< MCObjectWriter >  Writer 
)

Construct a new assembler instance.

Definition at line 82 of file MCAssembler.cpp.

◆ MCAssembler() [2/2]

llvm::MCAssembler::MCAssembler ( const MCAssembler &  )
delete

Member Function Documentation

◆ begin()

const_iterator llvm::MCAssembler::begin ( ) const
inline

Definition at line 218 of file MCAssembler.h.

References llvm::SmallVectorTemplateCommon< T, typename >::begin().

◆ computeFragmentSize()

uint64_t MCAssembler::computeFragmentSize ( const MCFragment &  F) const

Compute the effective fragment size.

Definition at line 249 of file MCAssembler.cpp.

References A, assert(), llvm::MCExpr::evaluateAsValue(), F, llvm::MCFragment::FT_Align, llvm::MCFragment::FT_BoundaryAlign, llvm::MCFragment::FT_CompactEncodedInst, llvm::MCFragment::FT_CVDefRange, llvm::MCFragment::FT_CVInlineLines, llvm::MCFragment::FT_Data, llvm::MCFragment::FT_Dummy, llvm::MCFragment::FT_Dwarf, llvm::MCFragment::FT_DwarfFrame, llvm::MCFragment::FT_Fill, llvm::MCFragment::FT_LEB, llvm::MCFragment::FT_Nops, llvm::MCFragment::FT_Org, llvm::MCFragment::FT_PseudoProbe, llvm::MCFragment::FT_Relaxable, llvm::MCFragment::FT_SymbolId, llvm::MCAlignFragment::getAlignment(), getBackend(), getBackendPtr(), getContext(), getFragmentOffset(), llvm::MCOrgFragment::getLoc(), llvm::MCAlignFragment::getMaxBytesToEmit(), llvm::MCOrgFragment::getOffset(), llvm::MCFragment::getParent(), getSymbolOffset(), llvm::MCAlignFragment::hasEmitNops(), llvm_unreachable, llvm::Offset, llvm::offsetToAlignment(), llvm::MCContext::reportError(), Size, llvm::MCSection::useCodeAlign(), and llvm::Align::value().

Referenced by getSectionAddressSize(), and layoutBundle().

◆ dump()

LLVM_DUMP_METHOD void MCAssembler::dump ( ) const

Definition at line 1324 of file MCAssembler.cpp.

References llvm::MCSection::dump(), llvm::errs(), llvm::First, OS, Sym, and symbols().

Referenced by layout().

◆ end()

const_iterator llvm::MCAssembler::end ( ) const
inline

Definition at line 219 of file MCAssembler.h.

References llvm::SmallVectorTemplateCommon< T, typename >::end().

◆ Finish()

void MCAssembler::Finish ( )

Finish - Do final processing and write the object to the output stream.

Writer is used for custom object writer (as the MCJIT does), if not specified it is automatically created from backend.

Definition at line 1021 of file MCAssembler.cpp.

References getWriter(), layout(), and llvm::MCObjectWriter::writeObject().

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

◆ getBackend()

MCAsmBackend & llvm::MCAssembler::getBackend ( ) const
inline

Definition at line 188 of file MCAssembler.h.

Referenced by computeFragmentSize(), llvm::MCELFStreamer::emitAssemblerFlag(), llvm::MCWasmStreamer::emitAssemblerFlag(), llvm::MCWinCOFFStreamer::emitAssemblerFlag(), llvm::X86_MC::emitInstruction(), llvm::MCObjectStreamer::emitRelocDirective(), llvm::MCXCOFFStreamer::emitXCOFFRefDirective(), layout(), llvm::LoongArchTargetELFStreamer::LoongArchTargetELFStreamer(), llvm::RISCVTargetELFStreamer::RISCVTargetELFStreamer(), and writeFragmentPadding().

◆ getBackendPtr()

MCAsmBackend * llvm::MCAssembler::getBackendPtr ( ) const
inline

Definition at line 184 of file MCAssembler.h.

Referenced by computeFragmentSize(), layout(), reset(), writeFragmentPadding(), and writeSectionData().

◆ getBaseSymbol()

const MCSymbol * MCAssembler::getBaseSymbol ( const MCSymbol &  Symbol) const

Definition at line 495 of file MCAssembler.cpp.

References A, assert(), llvm::MCExpr::evaluateAsValue(), getContext(), llvm::MCExpr::getLoc(), llvm::MCSymbol::getName(), llvm::MCSymbolRefExpr::getSymbol(), llvm::MCSymbol::isCommon(), and llvm::MCContext::reportError().

◆ getBundleAlignSize()

unsigned llvm::MCAssembler::getBundleAlignSize ( ) const
inline

Definition at line 210 of file MCAssembler.h.

Referenced by llvm::MCELFStreamer::emitBundleAlignMode(), layoutBundle(), setSectionAlignmentForBundling(), and writeFragmentPadding().

◆ getContext()

MCContext & llvm::MCAssembler::getContext ( ) const
inline

Definition at line 182 of file MCAssembler.h.

Referenced by computeFragmentSize(), llvm::MCELFStreamer::emitCommonSymbol(), llvm::MipsTargetELFStreamer::emitDirectiveCpLoad(), llvm::MipsTargetELFStreamer::emitDirectiveCpsetup(), llvm::MipsTargetELFStreamer::emitDirectiveEnd(), llvm::MipsTargetELFStreamer::emitFrame(), llvm::MCELFStreamer::emitIdent(), llvm::MipsTargetELFStreamer::emitMipsAbiFlags(), llvm::MipsTargetELFStreamer::finish(), getBaseSymbol(), llvm::HexagonMCELFStreamer::HexagonMCEmitCommonSymbol(), llvm::MipsTargetELFStreamer::MipsTargetELFStreamer(), and writeSectionData().

◆ getDWARFLinetableParams()

MCDwarfLineTableParams llvm::MCAssembler::getDWARFLinetableParams ( ) const
inline

Definition at line 194 of file MCAssembler.h.

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

◆ getEmitter()

MCCodeEmitter & llvm::MCAssembler::getEmitter ( ) const
inline

Definition at line 190 of file MCAssembler.h.

References Emitter.

Referenced by llvm::MCXCOFFStreamer::emitInstToData(), llvm::MCWinCOFFStreamer::emitInstToData(), and llvm::MCObjectStreamer::emitInstToFragment().

◆ getEmitterPtr()

MCCodeEmitter * llvm::MCAssembler::getEmitterPtr ( ) const
inline

Definition at line 186 of file MCAssembler.h.

References Emitter.

Referenced by llvm::PPCELFStreamer::emitInstruction(), llvm::PPCXCOFFStreamer::emitInstruction(), reset(), and llvm::AMDGPUAsmPrinter::runOnMachineFunction().

◆ getFragmentOffset()

uint64_t llvm::MCAssembler::getFragmentOffset ( const MCFragment &  F) const
inline

Definition at line 153 of file MCAssembler.h.

References F.

Referenced by computeFragmentSize(), and getSectionAddressSize().

◆ getRelaxAll()

bool llvm::MCAssembler::getRelaxAll ( ) const
inline

Definition at line 205 of file MCAssembler.h.

◆ getSectionAddressSize()

uint64_t MCAssembler::getSectionAddressSize ( const MCSection &  Sec) const

Definition at line 532 of file MCAssembler.cpp.

References assert(), computeFragmentSize(), llvm::MCSection::curFragList(), F, getFragmentOffset(), and llvm::MCSection::FragList::Tail.

Referenced by getSectionFileSize(), and writeSectionData().

◆ getSectionFileSize()

uint64_t MCAssembler::getSectionFileSize ( const MCSection &  Sec) const

Definition at line 539 of file MCAssembler.cpp.

References getSectionAddressSize(), and llvm::MCSection::isVirtualSection().

Referenced by writeSectionData().

◆ getSymbolOffset() [1/2]

uint64_t MCAssembler::getSymbolOffset ( const MCSymbol &  S) const

Definition at line 489 of file MCAssembler.cpp.

References getSymbolOffsetImpl().

◆ getSymbolOffset() [2/2]

bool MCAssembler::getSymbolOffset ( const MCSymbol &  S,
uint64_t &  Val 
) const

Definition at line 485 of file MCAssembler.cpp.

References getSymbolOffsetImpl().

Referenced by computeFragmentSize().

◆ getWriter()

MCObjectWriter & llvm::MCAssembler::getWriter ( ) const
inline

Definition at line 192 of file MCAssembler.h.

Referenced by llvm::MCObjectStreamer::emitAddrsig(), llvm::MCObjectStreamer::emitAddrsigSym(), llvm::MCObjectStreamer::emitFileDirective(), Finish(), llvm::MCELFStreamer::getWriter(), llvm::MCWinCOFFStreamer::getWriter(), and layout().

◆ hasLayout()

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

Definition at line 204 of file MCAssembler.h.

◆ isBundlingEnabled()

bool llvm::MCAssembler::isBundlingEnabled ( ) const
inline

Definition at line 208 of file MCAssembler.h.

Referenced by canReuseDataFragment(), setSectionAlignmentForBundling(), and writeFragmentPadding().

◆ isThumbFunc()

bool MCAssembler::isThumbFunc ( const MCSymbol *  Func) const

Check whether a given symbol has been flagged with .thumb_func.

Definition at line 114 of file MCAssembler.cpp.

References llvm::MCExpr::evaluateAsRelocatable(), isThumbFunc(), llvm::Ref, Sym, and llvm::MCSymbolRefExpr::VK_None.

Referenced by isThumbFunc().

◆ layout()

void MCAssembler::layout ( )

Definition at line 887 of file MCAssembler.cpp.

References _, llvm::MCAsmBackend::applyFixup(), assert(), DEBUG_WITH_TYPE, DF, dump(), llvm::errs(), llvm::MCObjectWriter::executePostLayoutBinding(), llvm::MCAsmBackend::finishLayout(), Fixup, llvm::MCFragment::FT_Align, llvm::MCFragment::FT_CVDefRange, llvm::MCFragment::FT_Data, llvm::MCFragment::FT_Dwarf, llvm::MCFragment::FT_DwarfFrame, llvm::MCFragment::FT_LEB, llvm::MCFragment::FT_PseudoProbe, llvm::MCFragment::FT_Relaxable, getBackend(), getBackendPtr(), llvm::MCEncodedFragmentWithContents< ContentsSize >::getContents(), llvm::MCEncodedFragmentWithFixups< ContentsSize, FixupsSize >::getFixups(), llvm::MCEncodedFragment::getSubtargetInfo(), getWriter(), llvm::MCAlignFragment::hasEmitNops(), llvm::MCFragment::hasInstructions(), llvm::List, llvm::MCSection::setOrdinal(), llvm::MCAsmBackend::shouldInsertFixupForCodeAlign(), and llvm::CallingConv::Tail.

Referenced by Finish().

◆ layoutBundle()

void MCAssembler::layoutBundle ( MCFragment *  Prev,
MCFragment *  F 
) const

Definition at line 394 of file MCAssembler.cpp.

References assert(), computeBundlePadding(), computeFragmentSize(), DF, F, getBundleAlignSize(), llvm::report_fatal_error(), and llvm::MCEncodedFragment::setBundlePadding().

◆ operator=()

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

◆ registerSection()

bool MCAssembler::registerSection ( MCSection &  Section)

Definition at line 105 of file MCAssembler.cpp.

References assert(), and llvm::SmallVectorTemplateBase< T, bool >::push_back().

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

◆ registerSymbol()

bool MCAssembler::registerSymbol ( const MCSymbol &  Symbol)

Definition at line 546 of file MCAssembler.cpp.

Referenced by llvm::MCWinCOFFStreamer::changeSection(), llvm::MipsELFStreamer::createPendingLabelRelocs(), llvm::MCObjectStreamer::emitAssignment(), llvm::MCWinCOFFStreamer::emitCOFFSafeSEH(), llvm::MCWinCOFFStreamer::emitCOFFSymbolIndex(), llvm::MCWinCOFFStreamer::emitCOFFSymbolStorageClass(), llvm::MCWinCOFFStreamer::emitCOFFSymbolType(), llvm::MCELFStreamer::emitCommonSymbol(), llvm::MCWinCOFFStreamer::emitCommonSymbol(), llvm::MCXCOFFStreamer::emitCommonSymbol(), llvm::MipsTargetELFStreamer::emitDirectiveCpLoad(), llvm::RISCVTargetELFStreamer::emitDirectiveVariantCC(), llvm::MipsTargetELFStreamer::emitLabel(), llvm::MCObjectStreamer::emitLabel(), llvm::MCObjectStreamer::emitLabelAtPos(), llvm::MCELFStreamer::emitLocalCommonSymbol(), llvm::MCELFStreamer::emitSymbolAttribute(), llvm::MCWasmStreamer::emitSymbolAttribute(), llvm::MCWinCOFFStreamer::emitSymbolAttribute(), llvm::MCXCOFFStreamer::emitSymbolAttribute(), llvm::MCELFStreamer::emitWeakReference(), llvm::MCWasmStreamer::emitWeakReference(), llvm::MCWinCOFFStreamer::emitWeakReference(), llvm::HexagonMCELFStreamer::HexagonMCEmitCommonSymbol(), and llvm::HexagonMCELFStreamer::HexagonMCEmitLocalCommonSymbol().

◆ reset()

void MCAssembler::reset ( )

Reuse an assembler instance.

Definition at line 89 of file MCAssembler.cpp.

References llvm::SmallVectorImpl< T >::clear(), getBackendPtr(), getEmitterPtr(), llvm::MCAsmBackend::reset(), and llvm::MCCodeEmitter::reset().

◆ setBundleAlignSize()

void llvm::MCAssembler::setBundleAlignSize ( unsigned  Size)
inline

Definition at line 212 of file MCAssembler.h.

References assert(), and Size.

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

◆ setIsThumbFunc()

void llvm::MCAssembler::setIsThumbFunc ( const MCSymbol *  Func)
inline

Flag a function symbol as the target of a .thumb_func directive.

Definition at line 176 of file MCAssembler.h.

References llvm::SmallPtrSetImpl< PtrType >::insert().

◆ setRelaxAll()

void llvm::MCAssembler::setRelaxAll ( bool  Value)
inline

Definition at line 206 of file MCAssembler.h.

◆ symbols()

iterator_range< pointee_iterator< typename SmallVector< const MCSymbol *, 0 >::const_iterator > > llvm::MCAssembler::symbols ( ) const
inline

Definition at line 223 of file MCAssembler.h.

References llvm::make_pointee_range().

Referenced by dump().

◆ writeFragmentPadding()

void MCAssembler::writeFragmentPadding ( raw_ostream &  OS,
const MCEncodedFragment &  F,
uint64_t  FSize 
) const

Write the necessary bundle padding to OS.

Expects a fragment F containing instructions and its size FSize.

Definition at line 555 of file MCAssembler.cpp.

References llvm::MCEncodedFragment::alignToBundleEnd(), assert(), getBackend(), getBackendPtr(), getBundleAlignSize(), llvm::MCEncodedFragment::getBundlePadding(), llvm::MCEncodedFragment::getSubtargetInfo(), llvm::MCFragment::hasInstructions(), isBundlingEnabled(), OS, and llvm::report_fatal_error().

◆ writeSectionData()

void MCAssembler::writeSectionData ( raw_ostream &  OS,
const MCSection *  Section 
) const

Emit the section contents to OS.

Definition at line 809 of file MCAssembler.cpp.

References assert(), DF, F, llvm::MCFragment::FT_Align, llvm::MCFragment::FT_Data, llvm::MCFragment::FT_Fill, llvm::MCFragment::FT_Org, getBackendPtr(), getContext(), getSectionAddressSize(), getSectionFileSize(), llvm::MCSection::isVirtualSection(), llvm_unreachable, OS, llvm::MCContext::reportError(), llvm::raw_ostream::tell(), and writeFragment().

Friends And Related Function Documentation

◆ MCObjectWriter

friend class MCObjectWriter
friend

Definition at line 55 of file MCAssembler.h.

The documentation for this class was generated from the following files:
Generated on Thu Jul 25 2024 20:35:18 for LLVM by doxygen 1.9.6