LLVM 19.0.0git
Classes | Public Types | Public Member Functions | Public Attributes | List of all members
llvm::MachObjectWriter Class Reference

#include "llvm/MC/MCMachObjectWriter.h"

Inheritance diagram for llvm::MachObjectWriter:
Inheritance graph


struct  DataRegionData

Public Types

using VersionInfoType = { bool EmitBuildVersion

Public Member Functions

 MachObjectWriter (std::unique_ptr< MCMachObjectTargetWriter > MOTW, raw_pwrite_stream &OS, bool IsLittleEndian)
const MCSymbolfindAliasedSymbol (const MCSymbol &Sym) const
void writeHeader (MachO::HeaderFileType Type, unsigned NumLoadCommands, unsigned LoadCommandsSize, bool SubsectionsViaSymbols)
void writeSegmentLoadCommand (StringRef Name, unsigned NumSections, uint64_t VMAddr, uint64_t VMSize, uint64_t SectionDataStartOffset, uint64_t SectionDataSize, uint32_t MaxProt, uint32_t InitProt)
 Write a segment load command.
void writeSection (const MCAssembler &Asm, const MCSection &Sec, uint64_t VMAddr, uint64_t FileOffset, unsigned Flags, uint64_t RelocationsStart, unsigned NumRelocations)
void writeSymtabLoadCommand (uint32_t SymbolOffset, uint32_t NumSymbols, uint32_t StringTableOffset, uint32_t StringTableSize)
void writeDysymtabLoadCommand (uint32_t FirstLocalSymbol, uint32_t NumLocalSymbols, uint32_t FirstExternalSymbol, uint32_t NumExternalSymbols, uint32_t FirstUndefinedSymbol, uint32_t NumUndefinedSymbols, uint32_t IndirectSymbolOffset, uint32_t NumIndirectSymbols)
void writeNlist (MachSymbolData &MSD, const MCAssembler &Asm)
void writeLinkeditLoadCommand (uint32_t Type, uint32_t DataOffset, uint32_t DataSize)
void writeLinkerOptionsLoadCommand (const std::vector< std::string > &Options)
void addRelocation (const MCSymbol *RelSymbol, const MCSection *Sec, MachO::any_relocation_info &MRE)
void recordRelocation (MCAssembler &Asm, const MCFragment *Fragment, const MCFixup &Fixup, MCValue Target, uint64_t &FixedValue) override
 Record a relocation entry.
void bindIndirectSymbols (MCAssembler &Asm)
void computeSymbolTable (MCAssembler &Asm, std::vector< MachSymbolData > &LocalSymbolData, std::vector< MachSymbolData > &ExternalSymbolData, std::vector< MachSymbolData > &UndefinedSymbolData)
 Compute the symbol table data.
void computeSectionAddresses (const MCAssembler &Asm)
void executePostLayoutBinding (MCAssembler &Asm) override
 Perform any late binding of symbols (for example, to assign symbol indices for use when generating relocations).
bool isSymbolRefDifferenceFullyResolvedImpl (const MCAssembler &Asm, const MCSymbol &SymA, const MCFragment &FB, bool InSet, bool IsPCRel) const override
void populateAddrSigSection (MCAssembler &Asm)
uint64_t writeObject (MCAssembler &Asm) override
 Write the object file and returns the number of bytes written.
Lifetime management Methods
void reset () override
 lifetime management
Utility Methods
bool isFixupKindPCRel (const MCAssembler &Asm, unsigned Kind)
std::vector< IndirectSymbolData > & getIndirectSymbols ()
std::vector< DataRegionData > & getDataRegions ()
const llvm::SmallVectorImpl< MCSection * > & getSectionOrder () const
SectionAddrMapgetSectionAddressMap ()
MCLOHContainergetLOHContainer ()
uint64_t getSectionAddress (const MCSection *Sec) const
uint64_t getSymbolAddress (const MCSymbol &S, const MCAssembler &Asm) const
uint64_t getFragmentAddress (const MCAssembler &Asm, const MCFragment *Fragment) const
uint64_t getPaddingSize (const MCAssembler &Asm, const MCSection *SD) const
const MCSymbolgetAtom (const MCSymbol &S) const
bool doesSymbolRequireExternRelocation (const MCSymbol &S)
void setVersionMin (MCVersionMinType Type, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion=VersionTuple())
 Mach-O deployment target version information.
void setBuildVersion (MachO::PlatformType Platform, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion=VersionTuple())
void setTargetVariantBuildVersion (MachO::PlatformType Platform, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion)
Target Writer Proxy Accessors
bool is64Bit () const
bool isX86_64 () const
- Public Member Functions inherited from llvm::MCObjectWriter
 MCObjectWriter (const MCObjectWriter &)=delete
MCObjectWriteroperator= (const MCObjectWriter &)=delete
virtual ~MCObjectWriter ()
virtual void reset ()
 lifetime management
bool isSymbolRefDifferenceFullyResolved (const MCAssembler &Asm, const MCSymbolRefExpr *A, const MCSymbolRefExpr *B, bool InSet) const
 Check whether the difference (A - B) between two symbol references is fully resolved.
virtual void markGnuAbi ()
 ELF only. Mark that we have seen GNU ABI usage (e.g. SHF_GNU_RETAIN).
virtual void setOverrideABIVersion (uint8_t ABIVersion)
 ELF only, override the default ABIVersion in the ELF header.
void emitAddrsigSection ()
 Tell the object writer to emit an address-significance table during writeObject().
bool getEmitAddrsigSection ()
void addAddrsigSymbol (const MCSymbol *Sym)
 Record the given symbol in the address-significance table to be written diring writeObject().
std::vector< const MCSymbol * > & getAddrsigSyms ()
virtual void addExceptionEntry (const MCSymbol *Symbol, const MCSymbol *Trap, unsigned LanguageCode, unsigned ReasonCode, unsigned FunctionSize, bool hasDebug)
virtual void addCInfoSymEntry (StringRef Name, StringRef Metadata)

Public Attributes

union {
   MCVersionMinType   Type
 Used when EmitBuildVersion==false. More...
   MachO::PlatformType   Platform
 Used when EmitBuildVersion==true. More...
unsigned Major
unsigned Minor
unsigned Update
VersionTuple SDKVersion
 An optional version of the SDK that was used to build the source.
support::endian::Writer W

Additional Inherited Members

- Protected Member Functions inherited from llvm::MCObjectWriter
 MCObjectWriter ()=default
- Protected Attributes inherited from llvm::MCObjectWriter
std::vector< const MCSymbol * > AddrsigSyms
bool EmitAddrsigSection = false

Detailed Description

Definition at line 86 of file MCMachObjectWriter.h.

Member Typedef Documentation

◆ VersionInfoType

using llvm::MachObjectWriter::VersionInfoType = { bool EmitBuildVersion

Definition at line 96 of file MCMachObjectWriter.h.

Constructor & Destructor Documentation

◆ MachObjectWriter()

llvm::MachObjectWriter::MachObjectWriter ( std::unique_ptr< MCMachObjectTargetWriter MOTW,
raw_pwrite_stream OS,
bool  IsLittleEndian 

Definition at line 172 of file MCMachObjectWriter.h.

Member Function Documentation

◆ addRelocation()

void llvm::MachObjectWriter::addRelocation ( const MCSymbol RelSymbol,
const MCSection Sec,
MachO::any_relocation_info MRE 

Definition at line 318 of file MCMachObjectWriter.h.

References P.

Referenced by populateAddrSigSection().

◆ bindIndirectSymbols()

void MachObjectWriter::bindIndirectSymbols ( MCAssembler Asm)

◆ computeSectionAddresses()

void MachObjectWriter::computeSectionAddresses ( const MCAssembler Asm)

strictly be necessary.

Definition at line 676 of file MachObjectWriter.cpp.

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

Referenced by executePostLayoutBinding().

◆ computeSymbolTable()

void MachObjectWriter::computeSymbolTable ( MCAssembler Asm,
std::vector< MachSymbolData > &  LocalSymbolData,
std::vector< MachSymbolData > &  ExternalSymbolData,
std::vector< MachSymbolData > &  UndefinedSymbolData 

◆ doesSymbolRequireExternRelocation()

bool MachObjectWriter::doesSymbolRequireExternRelocation ( const MCSymbol S)

Definition at line 66 of file MachObjectWriter.cpp.

References llvm::MCSymbol::isUndefined().

◆ executePostLayoutBinding()

void MachObjectWriter::executePostLayoutBinding ( MCAssembler Asm)

Perform any late binding of symbols (for example, to assign symbol indices for use when generating relocations).

This routine is called by the assembler after layout and relaxation is complete.

Reimplemented from llvm::MCObjectWriter.

Definition at line 706 of file MachObjectWriter.cpp.

References bindIndirectSymbols(), and computeSectionAddresses().

◆ findAliasedSymbol()

const MCSymbol & MachObjectWriter::findAliasedSymbol ( const MCSymbol Sym) const

◆ getAtom()

const MCSymbol * MachObjectWriter::getAtom ( const MCSymbol S) const

◆ getDataRegions()

std::vector< DataRegionData > & llvm::MachObjectWriter::getDataRegions ( )

Definition at line 199 of file MCMachObjectWriter.h.

◆ getFragmentAddress()

uint64_t MachObjectWriter::getFragmentAddress ( const MCAssembler Asm,
const MCFragment Fragment 
) const

Definition at line 93 of file MachObjectWriter.cpp.

References llvm::MCFragment::getParent(), and getSectionAddress().

◆ getIndirectSymbols()

std::vector< IndirectSymbolData > & llvm::MachObjectWriter::getIndirectSymbols ( )

Definition at line 196 of file MCMachObjectWriter.h.

◆ getLOHContainer()

MCLOHContainer & llvm::MachObjectWriter::getLOHContainer ( )

Definition at line 204 of file MCMachObjectWriter.h.

◆ getPaddingSize()

uint64_t MachObjectWriter::getPaddingSize ( const MCAssembler Asm,
const MCSection SD 
) const

◆ getSectionAddress()

uint64_t llvm::MachObjectWriter::getSectionAddress ( const MCSection Sec) const

◆ getSectionAddressMap()

SectionAddrMap & llvm::MachObjectWriter::getSectionAddressMap ( )

Definition at line 203 of file MCMachObjectWriter.h.

◆ getSectionOrder()

const llvm::SmallVectorImpl< MCSection * > & llvm::MachObjectWriter::getSectionOrder ( ) const

Definition at line 200 of file MCMachObjectWriter.h.

◆ getSymbolAddress()

uint64_t MachObjectWriter::getSymbolAddress ( const MCSymbol S,
const MCAssembler Asm 
) const

◆ is64Bit()

bool llvm::MachObjectWriter::is64Bit ( ) const

◆ isFixupKindPCRel()

bool MachObjectWriter::isFixupKindPCRel ( const MCAssembler Asm,
unsigned  Kind 

◆ isSymbolRefDifferenceFullyResolvedImpl()

bool MachObjectWriter::isSymbolRefDifferenceFullyResolvedImpl ( const MCAssembler Asm,
const MCSymbol SymA,
const MCFragment FB,
bool  InSet,
bool  IsPCRel 
) const

◆ isX86_64()

bool llvm::MachObjectWriter::isX86_64 ( ) const

◆ populateAddrSigSection()

void MachObjectWriter::populateAddrSigSection ( MCAssembler Asm)

◆ recordRelocation()

void MachObjectWriter::recordRelocation ( MCAssembler Asm,
const MCFragment Fragment,
const MCFixup Fixup,
MCValue  Target,
uint64_t FixedValue 

Record a relocation entry.

This routine is called by the assembler after layout and relaxation, and post layout binding. The implementation is responsible for storing information about the relocation so that it can be emitted during writeObject().

Implements llvm::MCObjectWriter.

Definition at line 505 of file MachObjectWriter.cpp.

References Fixup, and isFixupTargetValid().

◆ reset()

void MachObjectWriter::reset ( )

◆ setBuildVersion()

void llvm::MachObjectWriter::setBuildVersion ( MachO::PlatformType  Platform,
unsigned  Major,
unsigned  Minor,
unsigned  Update,
VersionTuple  SDKVersion = VersionTuple() 

Definition at line 231 of file MCMachObjectWriter.h.

References Major, Minor, Platform, SDKVersion, and Update.

◆ setTargetVariantBuildVersion()

void llvm::MachObjectWriter::setTargetVariantBuildVersion ( MachO::PlatformType  Platform,
unsigned  Major,
unsigned  Minor,
unsigned  Update,
VersionTuple  SDKVersion 

Definition at line 241 of file MCMachObjectWriter.h.

References Major, Minor, Platform, SDKVersion, and Update.

◆ setVersionMin()

void llvm::MachObjectWriter::setVersionMin ( MCVersionMinType  Type,
unsigned  Major,
unsigned  Minor,
unsigned  Update,
VersionTuple  SDKVersion = VersionTuple() 

Mach-O deployment target version information.

Definition at line 221 of file MCMachObjectWriter.h.

References Major, Minor, SDKVersion, Type, and Update.

◆ writeDysymtabLoadCommand()

void MachObjectWriter::writeDysymtabLoadCommand ( uint32_t  FirstLocalSymbol,
uint32_t  NumLocalSymbols,
uint32_t  FirstExternalSymbol,
uint32_t  NumExternalSymbols,
uint32_t  FirstUndefinedSymbol,
uint32_t  NumUndefinedSymbols,
uint32_t  IndirectSymbolOffset,
uint32_t  NumIndirectSymbols 

◆ writeHeader()

void MachObjectWriter::writeHeader ( MachO::HeaderFileType  Type,
unsigned  NumLoadCommands,
unsigned  LoadCommandsSize,
bool  SubsectionsViaSymbols 

◆ writeLinkeditLoadCommand()

void MachObjectWriter::writeLinkeditLoadCommand ( uint32_t  Type,
uint32_t  DataOffset,
uint32_t  DataSize 

◆ writeLinkerOptionsLoadCommand()

void MachObjectWriter::writeLinkerOptionsLoadCommand ( const std::vector< std::string > &  Options)

◆ writeNlist()

void MachObjectWriter::writeNlist ( MachSymbolData &  MSD,
const MCAssembler Asm 

◆ writeObject()

uint64_t MachObjectWriter::writeObject ( MCAssembler Asm)

Write the object file and returns the number of bytes written.

This routine is called by the assembler after layout and relaxation is complete, fixups have been evaluated and applied, and relocations generated.

Implements llvm::MCObjectWriter.

Definition at line 784 of file MachObjectWriter.cpp.

References llvm::Address, llvm::alignTo(), assert(), llvm::MCSection::begin(), ComputeLinkerOptionsLoadCommandSize(), computeSymbolTable(), llvm::MCAssembler::CGProfileEntry::Count, llvm::Data, llvm::dbgs(), llvm::MCLOHContainer::emit(), End, llvm::support::endian::Writer::Endian, llvm::MCAssembler::CGProfileEntry::From, llvm::MCLOHContainer::getEmitSize(), llvm::MCSymbol::getIndex(), getLCFromMCVM(), llvm::SectionKind::getMetadata(), getPaddingSize(), getSectionAddress(), llvm::StringTableBuilder::getSize(), llvm::MCSymbolRefExpr::getSymbol(), getSymbolAddress(), llvm::MachO::INDIRECT_SYMBOL_ABS, llvm::MachO::INDIRECT_SYMBOL_LOCAL, is64Bit(), LLVM_DEBUG, llvm::MachO::MH_OBJECT, Minor, llvm::offsetToAlignment(), llvm::support::endian::Writer::OS, OS, populateAddrSigSection(), llvm::report_fatal_error(), llvm::reverse(), llvm::MachO::S_ATTR_SOME_INSTRUCTIONS, llvm::MachO::S_NON_LAZY_SYMBOL_POINTERS, SDKVersion, Size, llvm::raw_ostream::tell(), llvm::MCAssembler::CGProfileEntry::To, Update, llvm::MachO::VM_PROT_EXECUTE, llvm::MachO::VM_PROT_READ, llvm::MachO::VM_PROT_WRITE, W, llvm::support::endian::Writer::write(), llvm::StringTableBuilder::write(), llvm::support::endian::write(), llvm::raw_ostream::write_zeros(), writeDysymtabLoadCommand(), writeHeader(), writeLinkeditLoadCommand(), writeLinkerOptionsLoadCommand(), writeNlist(), writeSection(), writeSegmentLoadCommand(), and writeSymtabLoadCommand().

◆ writeSection()

void MachObjectWriter::writeSection ( const MCAssembler Asm,
const MCSection Sec,
uint64_t  VMAddr,
uint64_t  FileOffset,
unsigned  Flags,
uint64_t  RelocationsStart,
unsigned  NumRelocations 

◆ writeSegmentLoadCommand()

void MachObjectWriter::writeSegmentLoadCommand ( StringRef  Name,
unsigned  NumSections,
uint64_t  VMAddr,
uint64_t  VMSize,
uint64_t  SectionDataStartOffset,
uint64_t  SectionDataSize,
uint32_t  MaxProt,
uint32_t  InitProt 

Write a segment load command.

writeSegmentLoadCommand - Write a segment load command.

NumSectionsThe number of sections in this segment.
SectionDataSizeThe total size of the sections.

Definition at line 216 of file MachObjectWriter.cpp.

References assert(), is64Bit(), Name, llvm::support::endian::Writer::OS, llvm::raw_ostream::tell(), W, and llvm::support::endian::Writer::write().

Referenced by writeObject().

◆ writeSymtabLoadCommand()

void MachObjectWriter::writeSymtabLoadCommand ( uint32_t  SymbolOffset,
uint32_t  NumSymbols,
uint32_t  StringTableOffset,
uint32_t  StringTableSize 

Member Data Documentation

◆ Major

unsigned llvm::MachObjectWriter::Major

◆ Minor

unsigned llvm::MachObjectWriter::Minor

◆ Platform

MachO::PlatformType llvm::MachObjectWriter::Platform

Used when EmitBuildVersion==true.

Definition at line 100 of file MCMachObjectWriter.h.

Referenced by setBuildVersion(), and setTargetVariantBuildVersion().

◆ SDKVersion

VersionTuple llvm::MachObjectWriter::SDKVersion

An optional version of the SDK that was used to build the source.

Definition at line 106 of file MCMachObjectWriter.h.

Referenced by setBuildVersion(), setTargetVariantBuildVersion(), setVersionMin(), and writeObject().

◆ Type

MCVersionMinType llvm::MachObjectWriter::Type

Used when EmitBuildVersion==false.

Definition at line 99 of file MCMachObjectWriter.h.

Referenced by setVersionMin(), writeHeader(), and writeLinkeditLoadCommand().


union { ... } llvm::MachObjectWriter::TypeOrPlatform

◆ Update

unsigned llvm::MachObjectWriter::Update

◆ W

support::endian::Writer llvm::MachObjectWriter::W

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