Streaming object file generation interface. More...

#include "llvm/MC/MCObjectStreamer.h"

Inheritance diagram for llvm::MCObjectStreamer:

[legend]

Public Member Functions
void	reset () override
	state management

bool	isIntegratedAssemblerRequired () const override
	Object streamers require the integrated assembler.

void	emitFrames (MCAsmBackend *MAB)

void	emitCFISections (bool EH, bool Debug) override

void	insert (MCFragment *F)

MCDataFragment *	getOrCreateDataFragment (const MCSubtargetInfo *STI=nullptr)
	Get a data fragment to write into, creating a new one if the current fragment is not a data fragment.

void	visitUsedSymbol (const MCSymbol &Sym) override

MCAssembler &	getAssembler ()

MCAssembler *	getAssemblerPtr () override

MCStreamer Interface
void	emitLabel (MCSymbol *Symbol, SMLoc Loc=SMLoc()) override
	Emit a label for `Symbol` into the current section.

virtual void	emitLabelAtPos (MCSymbol *Symbol, SMLoc Loc, MCDataFragment &F, uint64_t Offset)

void	emitAssignment (MCSymbol Symbol, const MCExpr Value) override
	Emit an assignment of `Value` to `Symbol`.

void	emitConditionalAssignment (MCSymbol Symbol, const MCExpr Value) override
	Emit an assignment of `Value` to `Symbol`, but only if `Value` is also emitted.

void	emitValueImpl (const MCExpr *Value, unsigned Size, SMLoc Loc=SMLoc()) override
	Emit the expression `Value` into the output as a native integer of the given `Size` bytes.

void	emitULEB128Value (const MCExpr *Value) override

void	emitSLEB128Value (const MCExpr *Value) override

void	emitWeakReference (MCSymbol Alias, const MCSymbol Symbol) override
	Emit an weak reference from `Alias` to `Symbol`.

void	changeSection (MCSection *Section, uint32_t Subsection=0) override
	This is called by popSection and switchSection, if the current section changes.

void	switchSectionNoPrint (MCSection *Section) override
	Similar to switchSection, but does not print the section directive.

void	emitInstruction (const MCInst &Inst, const MCSubtargetInfo &STI) override
	Emit the given `Instruction` into the current section.

virtual void	emitInstToFragment (const MCInst &Inst, const MCSubtargetInfo &)
	Emit an instruction to a special fragment, because this instruction can change its size during relaxation.

void	emitBundleAlignMode (Align Alignment) override
	Set the bundle alignment mode from now on in the section.

void	emitBundleLock (bool AlignToEnd) override
	The following instructions are a bundle-locked group.

void	emitBundleUnlock () override
	Ends a bundle-locked group.

void	emitBytes (StringRef Data) override
	Emit the bytes in `Data` into the output.

void	emitValueToAlignment (Align Alignment, int64_t Value=0, unsigned ValueSize=1, unsigned MaxBytesToEmit=0) override
	Emit some number of copies of `Value` until the byte alignment `ByteAlignment` is reached.

void	emitCodeAlignment (Align ByteAlignment, const MCSubtargetInfo *STI, unsigned MaxBytesToEmit=0) override
	Emit nops until the byte alignment `ByteAlignment` is reached.

void	emitValueToOffset (const MCExpr *Offset, unsigned char Value, SMLoc Loc) override
	Emit some number of copies of `Value` until the byte offset `Offset` is reached.

void	emitDwarfLocDirective (unsigned FileNo, unsigned Line, unsigned Column, unsigned Flags, unsigned Isa, unsigned Discriminator, StringRef FileName) override
	This implements the DWARF2 '.loc fileno lineno ...' assembler directive.

void	emitDwarfAdvanceLineAddr (int64_t LineDelta, const MCSymbol LastLabel, const MCSymbol Label, unsigned PointerSize) override
	If targets does not support representing debug line section by .loc/.file directives in assembly output, we need to populate debug line section with raw debug line contents.

void	emitDwarfLineEndEntry (MCSection Section, MCSymbol LastLabel, MCSymbol *EndLabel=nullptr) override
	Emit the debug line end entry.

void	emitDwarfAdvanceFrameAddr (const MCSymbol LastLabel, const MCSymbol Label, SMLoc Loc)

void	emitCVLocDirective (unsigned FunctionId, unsigned FileNo, unsigned Line, unsigned Column, bool PrologueEnd, bool IsStmt, StringRef FileName, SMLoc Loc) override
	This implements the CodeView '.cv_loc' assembler directive.

void	emitCVLinetableDirective (unsigned FunctionId, const MCSymbol Begin, const MCSymbol End) override
	This implements the CodeView '.cv_linetable' assembler directive.

void	emitCVInlineLinetableDirective (unsigned PrimaryFunctionId, unsigned SourceFileId, unsigned SourceLineNum, const MCSymbol FnStartSym, const MCSymbol FnEndSym) override
	This implements the CodeView '.cv_inline_linetable' assembler directive.

void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, StringRef FixedSizePortion) override
	This implements the CodeView '.cv_def_range' assembler directive.

void	emitCVStringTableDirective () override
	This implements the CodeView '.cv_stringtable' assembler directive.

void	emitCVFileChecksumsDirective () override
	This implements the CodeView '.cv_filechecksums' assembler directive.

void	emitCVFileChecksumOffsetDirective (unsigned FileNo) override
	This implements the CodeView '.cv_filechecksumoffset' assembler directive.

void	emitDTPRel32Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a dtprel (32-bit DTP relative) value.

void	emitDTPRel64Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a dtprel (64-bit DTP relative) value.

void	emitTPRel32Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a tprel (32-bit TP relative) value.

void	emitTPRel64Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a tprel (64-bit TP relative) value.

void	emitGPRel32Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a gprel32 (32-bit GP relative) value.

void	emitGPRel64Value (const MCExpr *Value) override
	Emit the expression `Value` into the output as a gprel64 (64-bit GP relative) value.

std::optional< std::pair< bool, std::string > >	emitRelocDirective (const MCExpr &Offset, StringRef Name, const MCExpr *Expr, SMLoc Loc, const MCSubtargetInfo &STI) override
	Record a relocation described by the .reloc directive.

void	emitFill (const MCExpr &NumBytes, uint64_t FillValue, SMLoc Loc=SMLoc()) override
	Emit `Size` bytes worth of the value specified by `FillValue`.

void	emitFill (const MCExpr &NumValues, int64_t Size, int64_t Expr, SMLoc Loc=SMLoc()) override
	Emit `NumValues` copies of `Size` bytes.

void	emitNops (int64_t NumBytes, int64_t ControlledNopLength, SMLoc Loc, const MCSubtargetInfo &STI) override

void	emitFileDirective (StringRef Filename) override
	Switch to a new logical file.

void	emitFileDirective (StringRef Filename, StringRef CompilerVersion, StringRef TimeStamp, StringRef Description) override
	Emit ".file assembler diretive with additioal info.

void	emitAddrsig () override

void	emitAddrsigSym (const MCSymbol *Sym) override

void	finishImpl () override
	Streamer specific finalization.

void	emitAbsoluteSymbolDiff (const MCSymbol Hi, const MCSymbol Lo, unsigned Size) override
	Emit the absolute difference between two symbols if possible.

void	emitAbsoluteSymbolDiffAsULEB128 (const MCSymbol Hi, const MCSymbol Lo) override
	Emit the absolute difference between two symbols encoded with ULEB128.

bool	mayHaveInstructions (MCSection &Sec) const override

void	emitPendingAssignments (MCSymbol *Symbol)
	Emits pending conditional assignments that depend on `Symbol` being emitted.

void	emitFill (uint64_t NumBytes, uint8_t FillValue)
	Emit NumBytes bytes worth of the value specified by FillValue.

virtual void	emitFill (const MCExpr &NumBytes, uint64_t FillValue, SMLoc Loc=SMLoc())
	Emit `Size` bytes worth of the value specified by `FillValue`.

virtual void	emitFill (const MCExpr &NumValues, int64_t Size, int64_t Expr, SMLoc Loc=SMLoc())
	Emit `NumValues` copies of `Size` bytes.

Public Member Functions inherited from llvm::MCStreamer
	MCStreamer (const MCStreamer &)=delete

MCStreamer &	operator= (const MCStreamer &)=delete

virtual	~MCStreamer ()

void	visitUsedExpr (const MCExpr &Expr)

virtual void	visitUsedSymbol (const MCSymbol &Sym)

void	setTargetStreamer (MCTargetStreamer *TS)

void	setStartTokLocPtr (const SMLoc *Loc)

SMLoc	getStartTokLoc () const

virtual void	reset ()
	State management.

MCContext &	getContext () const

virtual MCAssembler *	getAssemblerPtr ()

void	setUseAssemblerInfoForParsing (bool v)

bool	getUseAssemblerInfoForParsing ()

MCTargetStreamer *	getTargetStreamer ()

void	setAllowAutoPadding (bool v)

bool	getAllowAutoPadding () const

MCSymbol *	emitLineTableLabel ()

virtual MCSymbol *	emitCFILabel ()
	When emitting an object file, create and emit a real label.

WinEH::FrameInfo *	EnsureValidWinFrameInfo (SMLoc Loc)
	Retrieve the current frame info if one is available and it is not yet closed.

unsigned	getNumFrameInfos ()

ArrayRef< MCDwarfFrameInfo >	getDwarfFrameInfos () const

bool	hasUnfinishedDwarfFrameInfo ()

unsigned	getNumWinFrameInfos ()

ArrayRef< std::unique_ptr< WinEH::FrameInfo > >	getWinFrameInfos () const

void	generateCompactUnwindEncodings (MCAsmBackend *MAB)

virtual void	emitFileDirective (StringRef Filename)
	Switch to a new logical file.

virtual void	emitFileDirective (StringRef Filename, StringRef CompilerVersion, StringRef TimeStamp, StringRef Description)
	Emit ".file assembler diretive with additioal info.

virtual void	emitIdent (StringRef IdentString)
	Emit the "identifiers" directive.

unsigned	emitDwarfFileDirective (unsigned FileNo, StringRef Directory, StringRef Filename, std::optional< MD5::MD5Result > Checksum=std::nullopt, std::optional< StringRef > Source=std::nullopt, unsigned CUID=0)
	Associate a filename with a specified logical file number.

virtual Expected< unsigned >	tryEmitDwarfFileDirective (unsigned FileNo, StringRef Directory, StringRef Filename, std::optional< MD5::MD5Result > Checksum=std::nullopt, std::optional< StringRef > Source=std::nullopt, unsigned CUID=0)
	Associate a filename with a specified logical file number.

virtual void	emitDwarfFile0Directive (StringRef Directory, StringRef Filename, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source, unsigned CUID=0)
	Specify the "root" file of the compilation, using the ".file 0" extension.

virtual void	emitCFIBKeyFrame ()

virtual void	emitCFIMTETaggedFrame ()

virtual void	emitDwarfLocDirective (unsigned FileNo, unsigned Line, unsigned Column, unsigned Flags, unsigned Isa, unsigned Discriminator, StringRef FileName)
	This implements the DWARF2 '.loc fileno lineno ...' assembler directive.

virtual void	emitDwarfLocLabelDirective (SMLoc Loc, StringRef Name)
	This implements the '.loc_label Name' directive.

virtual bool	emitCVFileDirective (unsigned FileNo, StringRef Filename, ArrayRef< uint8_t > Checksum, unsigned ChecksumKind)
	Associate a filename with a specified logical file number, and also specify that file's checksum information.

virtual bool	emitCVFuncIdDirective (unsigned FunctionId)
	Introduces a function id for use with .cv_loc.

virtual bool	emitCVInlineSiteIdDirective (unsigned FunctionId, unsigned IAFunc, unsigned IAFile, unsigned IALine, unsigned IACol, SMLoc Loc)
	Introduces an inline call site id for use with .cv_loc.

virtual void	emitCVLocDirective (unsigned FunctionId, unsigned FileNo, unsigned Line, unsigned Column, bool PrologueEnd, bool IsStmt, StringRef FileName, SMLoc Loc)
	This implements the CodeView '.cv_loc' assembler directive.

virtual void	emitCVLinetableDirective (unsigned FunctionId, const MCSymbol FnStart, const MCSymbol FnEnd)
	This implements the CodeView '.cv_linetable' assembler directive.

virtual void	emitCVInlineLinetableDirective (unsigned PrimaryFunctionId, unsigned SourceFileId, unsigned SourceLineNum, const MCSymbol FnStartSym, const MCSymbol FnEndSym)
	This implements the CodeView '.cv_inline_linetable' assembler directive.

virtual void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, StringRef FixedSizePortion)
	This implements the CodeView '.cv_def_range' assembler directive.

virtual void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, codeview::DefRangeRegisterRelHeader DRHdr)

virtual void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, codeview::DefRangeSubfieldRegisterHeader DRHdr)

virtual void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, codeview::DefRangeRegisterHeader DRHdr)

virtual void	emitCVDefRangeDirective (ArrayRef< std::pair< const MCSymbol , const MCSymbol > > Ranges, codeview::DefRangeFramePointerRelHeader DRHdr)

virtual void	emitCVStringTableDirective ()
	This implements the CodeView '.cv_stringtable' assembler directive.

virtual void	emitCVFileChecksumsDirective ()
	This implements the CodeView '.cv_filechecksums' assembler directive.

virtual void	emitCVFileChecksumOffsetDirective (unsigned FileNo)
	This implements the CodeView '.cv_filechecksumoffset' assembler directive.

virtual void	emitCVFPOData (const MCSymbol *ProcSym, SMLoc Loc={})
	This implements the CodeView '.cv_fpo_data' assembler directive.

virtual void	emitAbsoluteSymbolDiff (const MCSymbol Hi, const MCSymbol Lo, unsigned Size)
	Emit the absolute difference between two symbols.

virtual void	emitAbsoluteSymbolDiffAsULEB128 (const MCSymbol Hi, const MCSymbol Lo)
	Emit the absolute difference between two symbols encoded with ULEB128.

virtual MCSymbol *	getDwarfLineTableSymbol (unsigned CUID)

virtual void	emitCFISections (bool EH, bool Debug)

void	emitCFIStartProc (bool IsSimple, SMLoc Loc=SMLoc())

void	emitCFIEndProc ()

virtual void	emitCFIDefCfa (int64_t Register, int64_t Offset, SMLoc Loc={})

virtual void	emitCFIDefCfaOffset (int64_t Offset, SMLoc Loc={})

virtual void	emitCFIDefCfaRegister (int64_t Register, SMLoc Loc={})

virtual void	emitCFILLVMDefAspaceCfa (int64_t Register, int64_t Offset, int64_t AddressSpace, SMLoc Loc={})

virtual void	emitCFIOffset (int64_t Register, int64_t Offset, SMLoc Loc={})

virtual void	emitCFIPersonality (const MCSymbol *Sym, unsigned Encoding)

virtual void	emitCFILsda (const MCSymbol *Sym, unsigned Encoding)

virtual void	emitCFIRememberState (SMLoc Loc)

virtual void	emitCFIRestoreState (SMLoc Loc)

virtual void	emitCFISameValue (int64_t Register, SMLoc Loc={})

virtual void	emitCFIRestore (int64_t Register, SMLoc Loc={})

virtual void	emitCFIRelOffset (int64_t Register, int64_t Offset, SMLoc Loc)

virtual void	emitCFIAdjustCfaOffset (int64_t Adjustment, SMLoc Loc={})

virtual void	emitCFIEscape (StringRef Values, SMLoc Loc={})

virtual void	emitCFIReturnColumn (int64_t Register)

virtual void	emitCFIGnuArgsSize (int64_t Size, SMLoc Loc={})

virtual void	emitCFISignalFrame ()

virtual void	emitCFIUndefined (int64_t Register, SMLoc Loc={})

virtual void	emitCFIRegister (int64_t Register1, int64_t Register2, SMLoc Loc={})

virtual void	emitCFIWindowSave (SMLoc Loc={})

virtual void	emitCFINegateRAState (SMLoc Loc={})

virtual void	emitCFINegateRAStateWithPC (SMLoc Loc={})

virtual void	emitCFILabelDirective (SMLoc Loc, StringRef Name)

virtual void	emitCFIValOffset (int64_t Register, int64_t Offset, SMLoc Loc={})

virtual void	emitWinCFIStartProc (const MCSymbol *Symbol, SMLoc Loc=SMLoc())

virtual void	emitWinCFIEndProc (SMLoc Loc=SMLoc())

virtual void	emitWinCFIFuncletOrFuncEnd (SMLoc Loc=SMLoc())
	This is used on platforms, such as Windows on ARM64, that require function or funclet sizes to be emitted in .xdata before the End marker is emitted for the frame.

virtual void	emitWinCFIStartChained (SMLoc Loc=SMLoc())

virtual void	emitWinCFIEndChained (SMLoc Loc=SMLoc())

virtual void	emitWinCFIPushReg (MCRegister Register, SMLoc Loc=SMLoc())

virtual void	emitWinCFISetFrame (MCRegister Register, unsigned Offset, SMLoc Loc=SMLoc())

virtual void	emitWinCFIAllocStack (unsigned Size, SMLoc Loc=SMLoc())

virtual void	emitWinCFISaveReg (MCRegister Register, unsigned Offset, SMLoc Loc=SMLoc())

virtual void	emitWinCFISaveXMM (MCRegister Register, unsigned Offset, SMLoc Loc=SMLoc())

virtual void	emitWinCFIPushFrame (bool Code, SMLoc Loc=SMLoc())

virtual void	emitWinCFIEndProlog (SMLoc Loc=SMLoc())

virtual void	emitWinEHHandler (const MCSymbol *Sym, bool Unwind, bool Except, SMLoc Loc=SMLoc())

virtual void	emitWinEHHandlerData (SMLoc Loc=SMLoc())

virtual void	emitCGProfileEntry (const MCSymbolRefExpr From, const MCSymbolRefExpr To, uint64_t Count)

MCSection *	getAssociatedPDataSection (const MCSection *TextSec)
	Get the .pdata section used for the given section.

MCSection *	getAssociatedXDataSection (const MCSection *TextSec)
	Get the .xdata section used for the given section.

virtual void	emitSyntaxDirective ()

virtual std::optional< std::pair< bool, std::string > >	emitRelocDirective (const MCExpr &Offset, StringRef Name, const MCExpr *Expr, SMLoc Loc, const MCSubtargetInfo &STI)
	Record a relocation described by the .reloc directive.

virtual void	emitAddrsig ()

virtual void	emitAddrsigSym (const MCSymbol *Sym)

virtual void	emitInstruction (const MCInst &Inst, const MCSubtargetInfo &STI)
	Emit the given `Instruction` into the current section.

virtual void	emitPseudoProbe (uint64_t Guid, uint64_t Index, uint64_t Type, uint64_t Attr, uint64_t Discriminator, const MCPseudoProbeInlineStack &InlineStack, MCSymbol *FnSym)
	Emit the a pseudo probe into the current section.

virtual void	emitBundleAlignMode (Align Alignment)
	Set the bundle alignment mode from now on in the section.

virtual void	emitBundleLock (bool AlignToEnd)
	The following instructions are a bundle-locked group.

virtual void	emitBundleUnlock ()
	Ends a bundle-locked group.

void	emitRawText (const Twine &String)
	If this file is backed by a assembly streamer, this dumps the specified string in the output .s file.

virtual void	finishImpl ()
	Streamer specific finalization.

void	finish (SMLoc EndLoc=SMLoc())
	Finish emission of machine code.

virtual bool	mayHaveInstructions (MCSection &Sec) const

void	maybeEmitDwarf64Mark ()
	Emit a special value of 0xffffffff if producing 64-bit debugging info.

virtual void	emitDwarfUnitLength (uint64_t Length, const Twine &Comment)
	Emit a unit length field.

virtual MCSymbol *	emitDwarfUnitLength (const Twine &Prefix, const Twine &Comment)
	Emit a unit length field.

virtual void	emitDwarfLineStartLabel (MCSymbol *StartSym)
	Emit the debug line start label.

virtual void	emitDwarfLineEndEntry (MCSection Section, MCSymbol LastLabel, MCSymbol *EndLabel=nullptr)
	Emit the debug line end entry.

virtual void	emitDwarfAdvanceLineAddr (int64_t LineDelta, const MCSymbol LastLabel, const MCSymbol Label, unsigned PointerSize)
	If targets does not support representing debug line section by .loc/.file directives in assembly output, we need to populate debug line section with raw debug line contents.

virtual bool	isVerboseAsm () const
	Return true if this streamer supports verbose assembly and if it is enabled.

virtual bool	hasRawTextSupport () const
	Return true if this asm streamer supports emitting unformatted text to the .s file with EmitRawText.

virtual void	AddComment (const Twine &T, bool EOL=true)
	Add a textual comment.

virtual raw_ostream &	getCommentOS ()
	Return a raw_ostream that comments can be written to.

virtual void	emitRawComment (const Twine &T, bool TabPrefix=true)
	Print T and prefix it with the comment string (normally #) and optionally a tab.

virtual void	addExplicitComment (const Twine &T)
	Add explicit comment T.

virtual void	emitExplicitComments ()
	Emit added explicit comments.

virtual void	addBlankLine ()
	Emit a blank line to a .s file to pretty it up.

MCSectionSubPair	getCurrentSection () const
	Return the current section that the streamer is emitting code to.

MCSection *	getCurrentSectionOnly () const

MCSectionSubPair	getPreviousSection () const
	Return the previous section that the streamer is emitting code to.

MCFragment *	getCurrentFragment () const

void	pushSection ()
	Save the current and previous section on the section stack.

virtual bool	popSection ()
	Restore the current and previous section from the section stack.

virtual void	switchSection (MCSection *Section, uint32_t Subsec=0)
	Set the current section where code is being emitted to `Section`.

bool	switchSection (MCSection Section, const MCExpr )

virtual void	initSections (bool NoExecStack, const MCSubtargetInfo &STI)
	Create the default sections and set the initial one.

MCSymbol *	endSection (MCSection *Section)

virtual StringRef	getMnemonic (const MCInst &MI) const
	Returns the mnemonic for `MI`, if the streamer has access to a instruction printer and returns an empty string otherwise.

virtual void	emitEHSymAttributes (const MCSymbol Symbol, MCSymbol EHSymbol)

virtual void	emitAssemblerFlag (MCAssemblerFlag Flag)
	Note in the output the specified `Flag`.

virtual void	emitLinkerOptions (ArrayRef< std::string > Kind)
	Emit the given list `Options` of strings as linker options into the output.

virtual void	emitDataRegion (MCDataRegionType Kind)
	Note in the output the specified region `Kind`.

virtual void	emitVersionMin (MCVersionMinType Type, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion)
	Specify the Mach-O minimum deployment target version.

virtual void	emitBuildVersion (unsigned Platform, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion)
	Emit/Specify Mach-O build version command.

virtual void	emitDarwinTargetVariantBuildVersion (unsigned Platform, unsigned Major, unsigned Minor, unsigned Update, VersionTuple SDKVersion)

void	emitVersionForTarget (const Triple &Target, const VersionTuple &SDKVersion, const Triple *DarwinTargetVariantTriple, const VersionTuple &DarwinTargetVariantSDKVersion)

virtual void	emitThumbFunc (MCSymbol *Func)
	Note in the output that the specified `Func` is a Thumb mode function (ARM target only).

virtual bool	emitSymbolAttribute (MCSymbol *Symbol, MCSymbolAttr Attribute)=0
	Add the given `Attribute` to `Symbol`.

virtual void	emitSymbolDesc (MCSymbol *Symbol, unsigned DescValue)
	Set the `DescValue` for the `Symbol`.

virtual void	beginCOFFSymbolDef (const MCSymbol *Symbol)
	Start emitting COFF symbol definition.

virtual void	emitCOFFSymbolStorageClass (int StorageClass)
	Emit the storage class of the symbol.

virtual void	emitCOFFSymbolType (int Type)
	Emit the type of the symbol.

virtual void	endCOFFSymbolDef ()
	Marks the end of the symbol definition.

virtual void	emitCOFFSafeSEH (MCSymbol const *Symbol)

virtual void	emitCOFFSymbolIndex (MCSymbol const *Symbol)
	Emits the symbol table index of a Symbol into the current section.

virtual void	emitCOFFSectionIndex (MCSymbol const *Symbol)
	Emits a COFF section index.

virtual void	emitCOFFSecRel32 (MCSymbol const *Symbol, uint64_t Offset)
	Emits a COFF section relative relocation.

virtual void	emitCOFFImgRel32 (MCSymbol const *Symbol, int64_t Offset)
	Emits a COFF image relative relocation.

virtual void	emitCOFFSecNumber (MCSymbol const *Symbol)
	Emits the physical number of the section containing the given symbol as assigned during object writing (i.e., this is not a runtime relocation).

virtual void	emitCOFFSecOffset (MCSymbol const *Symbol)
	Emits the offset of the symbol from the beginning of the section during object writing (i.e., this is not a runtime relocation).

virtual void	emitXCOFFLocalCommonSymbol (MCSymbol LabelSym, uint64_t Size, MCSymbol CsectSym, Align Alignment)
	Emits an lcomm directive with XCOFF csect information.

virtual void	emitXCOFFSymbolLinkageWithVisibility (MCSymbol *Symbol, MCSymbolAttr Linkage, MCSymbolAttr Visibility)
	Emit a symbol's linkage and visibility with a linkage directive for XCOFF.

virtual void	emitXCOFFRenameDirective (const MCSymbol *Name, StringRef Rename)
	Emit a XCOFF .rename directive which creates a synonym for an illegal or undesirable name.

virtual void	emitXCOFFExceptDirective (const MCSymbol Symbol, const MCSymbol Trap, unsigned Lang, unsigned Reason, unsigned FunctionSize, bool hasDebug)
	Emit an XCOFF .except directive which adds information about a trap instruction to the object file exception section.

virtual void	emitXCOFFRefDirective (const MCSymbol *Symbol)
	Emit a XCOFF .ref directive which creates R_REF type entry in the relocation table for one or more symbols.

virtual void	emitXCOFFCInfoSym (StringRef Name, StringRef Metadata)
	Emit a C_INFO symbol with XCOFF embedded metadata to the .info section.

virtual void	emitELFSize (MCSymbol Symbol, const MCExpr Value)
	Emit an ELF .size directive.

virtual void	emitELFSymverDirective (const MCSymbol *OriginalSym, StringRef Name, bool KeepOriginalSym)
	Emit an ELF .symver directive.

virtual void	emitLOHDirective (MCLOHType Kind, const MCLOHArgs &Args)
	Emit a Linker Optimization Hint (LOH) directive.

virtual void	emitGNUAttribute (unsigned Tag, unsigned Value)
	Emit a .gnu_attribute directive.

virtual void	emitCommonSymbol (MCSymbol *Symbol, uint64_t Size, Align ByteAlignment)=0
	Emit a common symbol.

virtual void	emitLocalCommonSymbol (MCSymbol *Symbol, uint64_t Size, Align ByteAlignment)
	Emit a local common (.lcomm) symbol.

virtual void	emitZerofill (MCSection Section, MCSymbol Symbol=nullptr, uint64_t Size=0, Align ByteAlignment=Align(1), SMLoc Loc=SMLoc())=0
	Emit the zerofill section and an optional symbol.

virtual void	emitTBSSSymbol (MCSection Section, MCSymbol Symbol, uint64_t Size, Align ByteAlignment=Align(1))
	Emit a thread local bss (.tbss) symbol.

virtual void	emitBinaryData (StringRef Data)
	Functionally identical to EmitBytes.

void	emitValue (const MCExpr *Value, unsigned Size, SMLoc Loc=SMLoc())

virtual void	emitIntValue (uint64_t Value, unsigned Size)
	Special case of EmitValue that avoids the client having to pass in a MCExpr for constant integers.

virtual void	emitIntValue (const APInt &Value)

virtual void	emitIntValueInHex (uint64_t Value, unsigned Size)
	Special case of EmitValue that avoids the client having to pass in a MCExpr for constant integers & prints in Hex format for certain modes.

void	emitInt8 (uint64_t Value)

void	emitInt16 (uint64_t Value)

void	emitInt32 (uint64_t Value)

void	emitInt64 (uint64_t Value)

virtual void	emitIntValueInHexWithPadding (uint64_t Value, unsigned Size)
	Special case of EmitValue that avoids the client having to pass in a MCExpr for constant integers & prints in Hex format for certain modes, pads the field with leading zeros to Size width.

unsigned	emitULEB128IntValue (uint64_t Value, unsigned PadTo=0)
	Special case of EmitULEB128Value that avoids the client having to pass in a MCExpr for constant integers.

unsigned	emitSLEB128IntValue (int64_t Value)
	Special case of EmitSLEB128Value that avoids the client having to pass in a MCExpr for constant integers.

void	emitSymbolValue (const MCSymbol *Sym, unsigned Size, bool IsSectionRelative=false)
	Special case of EmitValue that avoids the client having to pass in a MCExpr for MCSymbols.

void	emitFill (uint64_t NumBytes, uint8_t FillValue)
	Emit NumBytes bytes worth of the value specified by FillValue.

void	emitZeros (uint64_t NumBytes)
	Emit NumBytes worth of zeros.

Protected Member Functions
	MCObjectStreamer (MCContext &Context, std::unique_ptr< MCAsmBackend > TAB, std::unique_ptr< MCObjectWriter > OW, std::unique_ptr< MCCodeEmitter > Emitter)

	~MCObjectStreamer ()

bool	changeSectionImpl (MCSection *Section, uint32_t Subsection)

Protected Member Functions inherited from llvm::MCStreamer
	MCStreamer (MCContext &Ctx)

virtual void	changeSection (MCSection *, uint32_t)
	This is called by popSection and switchSection, if the current section changes.

virtual void	emitCFIStartProcImpl (MCDwarfFrameInfo &Frame)

virtual void	emitCFIEndProcImpl (MCDwarfFrameInfo &CurFrame)

WinEH::FrameInfo *	getCurrentWinFrameInfo ()

virtual void	emitWindowsUnwindTables (WinEH::FrameInfo *Frame)

virtual void	emitWindowsUnwindTables ()

virtual void	emitRawTextImpl (StringRef String)
	EmitRawText - If this file is backed by an assembly streamer, this dumps the specified string in the output .s file.

bool	checkCVLocSection (unsigned FuncId, unsigned FileNo, SMLoc Loc)
	Returns true if the .cv_loc directive is in the right section.

Additional Inherited Members
Protected Attributes inherited from llvm::MCStreamer
MCFragment *	CurFrag = nullptr

Detailed Description

Streaming object file generation interface.

This class provides an implementation of the MCStreamer interface which is suitable for use with the assembler backend. Specific object file formats are expected to subclass this interface to implement directives specific to that file format or custom semantics expected by the object writer implementation.

Definition at line 40 of file MCObjectStreamer.h.

Constructor & Destructor Documentation

◆ MCObjectStreamer()

MCObjectStreamer::MCObjectStreamer	(	MCContext &	Context,
		std::unique_ptr< MCAsmBackend >	TAB,
		std::unique_ptr< MCObjectWriter >	OW,
		std::unique_ptr< MCCodeEmitter >	Emitter
	)

protected

Definition at line 27 of file MCObjectStreamer.cpp.

References assert(), llvm::MCContext::getTargetOptions(), llvm::MCTargetOptions::MCRelaxAll, and llvm::MCStreamer::setAllowAutoPadding().

◆ ~MCObjectStreamer()

MCObjectStreamer::~MCObjectStreamer ( )

protecteddefault

Member Function Documentation

◆ changeSection()

void MCObjectStreamer::changeSection	(	MCSection *	Section,
		uint32_t	= `0`
	)

overridevirtual

This is called by popSection and switchSection, if the current section changes.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::MCWasmStreamer, llvm::RISCVELFStreamer, and llvm::MCWinCOFFStreamer.

Definition at line 284 of file MCObjectStreamer.cpp.

References changeSectionImpl().

Referenced by llvm::MCWasmStreamer::changeSection(), and switchSectionNoPrint().

◆ changeSectionImpl()

bool MCObjectStreamer::changeSectionImpl	(	MCSection *	Section,
		uint32_t	Subsection
	)

protected

Definition at line 288 of file MCObjectStreamer.cpp.

References llvm::MCContext::allocFragment(), assert(), llvm::MCContext::clearDwarfLocSeen(), llvm::MCStreamer::CurFrag, F, getAssembler(), llvm::MCStreamer::getContext(), I, and llvm::MCAssembler::registerSection().

Referenced by llvm::MCELFStreamer::changeSection(), changeSection(), and llvm::MCWinCOFFStreamer::changeSection().

◆ emitAbsoluteSymbolDiff()

void MCObjectStreamer::emitAbsoluteSymbolDiff	(	const MCSymbol *	Hi,
		const MCSymbol *	Lo,
		unsigned	Size
	)

overridevirtual

Emit the absolute difference between two symbols if possible.

Emit the absolute difference between Hi and Lo, as long as we can compute it. Currently, that requires that both symbols are in the same data fragment and that the target has not specified that diff expressions require relocations to be emitted. Otherwise, do nothing and return false.

Precondition: Offset of Hi is greater than the offset Lo.

Reimplemented from llvm::MCStreamer.

Definition at line 104 of file MCObjectStreamer.cpp.

References absoluteSymbolDiff(), llvm::MCStreamer::emitAbsoluteSymbolDiff(), llvm::MCStreamer::emitIntValue(), getAssembler(), llvm::MCStreamer::getContext(), llvm::Hi, llvm::Lo, and Size.

◆ emitAbsoluteSymbolDiffAsULEB128()

void MCObjectStreamer::emitAbsoluteSymbolDiffAsULEB128	(	const MCSymbol *	Hi,
		const MCSymbol *	Lo
	)

overridevirtual

Emit the absolute difference between two symbols encoded with ULEB128.

Reimplemented from llvm::MCStreamer.

Definition at line 113 of file MCObjectStreamer.cpp.

References absoluteSymbolDiff(), llvm::MCStreamer::emitAbsoluteSymbolDiffAsULEB128(), llvm::MCStreamer::emitULEB128IntValue(), getAssembler(), llvm::MCStreamer::getContext(), llvm::Hi, and llvm::Lo.

◆ emitAddrsig()

void MCObjectStreamer::emitAddrsig ( )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 807 of file MCObjectStreamer.cpp.

References llvm::MCObjectWriter::emitAddrsigSection(), getAssembler(), and llvm::MCAssembler::getWriter().

◆ emitAddrsigSym()

void MCObjectStreamer::emitAddrsigSym ( const MCSymbol * Sym )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 811 of file MCObjectStreamer.cpp.

References llvm::MCObjectWriter::addAddrsigSymbol(), getAssembler(), llvm::MCAssembler::getWriter(), and Sym.

◆ emitAssignment()

void MCObjectStreamer::emitAssignment	(	MCSymbol *	Symbol,
		const MCExpr *	Value
	)

overridevirtual

Emit an assignment of Value to Symbol.

This corresponds to an assembler statement such as: symbol = value

The assignment generates no code, but has the side effect of binding the value in the current context. For the assembly streamer, this prints the binding into the .s file.

Parameters

Symbol	- The symbol being assigned to.
Value	- The value for the symbol.

Reimplemented from llvm::MCStreamer.

Definition at line 316 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitAssignment(), emitPendingAssignments(), getAssembler(), and llvm::MCAssembler::registerSymbol().

Referenced by emitConditionalAssignment(), and emitPendingAssignments().

◆ emitBundleAlignMode()

void MCObjectStreamer::emitBundleAlignMode ( Align Alignment )

overridevirtual

Set the bundle alignment mode from now on in the section.

The value 1 means turn the bundle alignment off.

Reimplemented from llvm::MCStreamer.

Definition at line 405 of file MCObjectStreamer.cpp.

References BundlingNotImplementedMsg, and llvm_unreachable.

◆ emitBundleLock()

void MCObjectStreamer::emitBundleLock ( bool AlignToEnd )

overridevirtual

The following instructions are a bundle-locked group.

Parameters

AlignToEnd - If true, the bundle-locked group will be aligned to the end of a bundle.

Reimplemented from llvm::MCStreamer.

Definition at line 409 of file MCObjectStreamer.cpp.

References BundlingNotImplementedMsg, and llvm_unreachable.

◆ emitBundleUnlock()

void MCObjectStreamer::emitBundleUnlock ( )

overridevirtual

Ends a bundle-locked group.

Reimplemented from llvm::MCStreamer.

Definition at line 413 of file MCObjectStreamer.cpp.

References BundlingNotImplementedMsg, and llvm_unreachable.

◆ emitBytes()

void MCObjectStreamer::emitBytes ( StringRef Data )

overridevirtual

Emit the bytes in Data into the output.

This is used to implement assembler directives such as .byte, .ascii, etc.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::CSKYELFStreamer, and llvm::RISCVELFStreamer.

Definition at line 552 of file MCObjectStreamer.cpp.

References llvm::Data, DF, llvm::MCStreamer::getCurrentSectionOnly(), getOrCreateDataFragment(), and llvm::MCDwarfLineEntry::make().

Referenced by llvm::CSKYELFStreamer::emitBytes(), llvm::RISCVELFStreamer::emitBytes(), llvm::MCWinCOFFStreamer::emitCommonSymbol(), and llvm::MCELFStreamer::emitIdent().

◆ emitCFISections()

void MCObjectStreamer::emitCFISections	(	bool	EH,
		bool	Debug
	)

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 178 of file MCObjectStreamer.cpp.

References Debug, and llvm::MCStreamer::emitCFISections().

◆ emitCodeAlignment()

void MCObjectStreamer::emitCodeAlignment	(	Align	Alignment,
		const MCSubtargetInfo *	STI,
		unsigned	MaxBytesToEmit = `0`
	)

overridevirtual

Emit nops until the byte alignment ByteAlignment is reached.

This used to align code where the alignment bytes may be executed. This can emit different bytes for different sizes to optimize execution.

Parameters

Alignment	- The alignment to reach.
STI	- The MCSubtargetInfo in operation when padding is emitted.
MaxBytesToEmit	- The maximum numbers of bytes to emit, or 0. If the alignment cannot be reached in this many bytes, no bytes are emitted.

Reimplemented from llvm::MCStreamer.

Definition at line 571 of file MCObjectStreamer.cpp.

References emitValueToAlignment(), and llvm::MCStreamer::getCurrentFragment().

Referenced by llvm::MipsTargetELFStreamer::finish(), llvm::MCELFStreamer::initSections(), and llvm::MCWinCOFFStreamer::initSections().

◆ emitConditionalAssignment()

void MCObjectStreamer::emitConditionalAssignment	(	MCSymbol *	Symbol,
		const MCExpr *	Value
	)

overridevirtual

Emit an assignment of Value to Symbol, but only if Value is also emitted.

Reimplemented from llvm::MCStreamer.

Definition at line 322 of file MCObjectStreamer.cpp.

References emitAssignment().

◆ emitCVDefRangeDirective()

void MCObjectStreamer::emitCVDefRangeDirective	(	ArrayRef< std::pair< const MCSymbol , const MCSymbol > >	Ranges,
		StringRef	FixedSizePortion
	)

overridevirtual

This implements the CodeView '.cv_def_range' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 532 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitCVDefRangeDirective(), llvm::CodeViewContext::emitDefRange(), llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitCVFileChecksumOffsetDirective()

void MCObjectStreamer::emitCVFileChecksumOffsetDirective ( unsigned FileNo )

overridevirtual

This implements the CodeView '.cv_filechecksumoffset' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 548 of file MCObjectStreamer.cpp.

References llvm::CodeViewContext::emitFileChecksumOffset(), llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitCVFileChecksumsDirective()

void MCObjectStreamer::emitCVFileChecksumsDirective ( )

overridevirtual

This implements the CodeView '.cv_filechecksums' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 544 of file MCObjectStreamer.cpp.

References llvm::CodeViewContext::emitFileChecksums(), llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitCVInlineLinetableDirective()

void MCObjectStreamer::emitCVInlineLinetableDirective	(	unsigned	PrimaryFunctionId,
		unsigned	SourceFileId,
		unsigned	SourceLineNum,
		const MCSymbol *	FnStartSym,
		const MCSymbol *	FnEndSym
	)

overridevirtual

This implements the CodeView '.cv_inline_linetable' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 522 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitCVInlineLinetableDirective(), llvm::CodeViewContext::emitInlineLineTableForFunction(), llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitCVLinetableDirective()

void MCObjectStreamer::emitCVLinetableDirective	(	unsigned	FunctionId,
		const MCSymbol *	FnStart,
		const MCSymbol *	FnEnd
	)

overridevirtual

This implements the CodeView '.cv_linetable' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 514 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitCVLinetableDirective(), llvm::CodeViewContext::emitLineTableForFunction(), End, llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitCVLocDirective()

void MCObjectStreamer::emitCVLocDirective	(	unsigned	FunctionId,
		unsigned	FileNo,
		unsigned	Line,
		unsigned	Column,
		bool	PrologueEnd,
		bool	IsStmt,
		StringRef	FileName,
		SMLoc	Loc
	)

overridevirtual

This implements the CodeView '.cv_loc' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 498 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::checkCVLocSection(), llvm::MCContext::createTempSymbol(), emitLabel(), llvm::MCStreamer::getContext(), llvm::MCContext::getCVContext(), and llvm::CodeViewContext::recordCVLoc().

◆ emitCVStringTableDirective()

void MCObjectStreamer::emitCVStringTableDirective ( )

overridevirtual

This implements the CodeView '.cv_stringtable' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 541 of file MCObjectStreamer.cpp.

References llvm::CodeViewContext::emitStringTable(), llvm::MCStreamer::getContext(), and llvm::MCContext::getCVContext().

◆ emitDTPRel32Value()

void MCObjectStreamer::emitDTPRel32Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a dtprel (32-bit DTP relative) value.

This is used to implement assembler directives such as .dtprelword on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 585 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_DTPRel_4, and getOrCreateDataFragment().

◆ emitDTPRel64Value()

void MCObjectStreamer::emitDTPRel64Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a dtprel (64-bit DTP relative) value.

This is used to implement assembler directives such as .dtpreldword on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 593 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_DTPRel_8, and getOrCreateDataFragment().

◆ emitDwarfAdvanceFrameAddr()

void MCObjectStreamer::emitDwarfAdvanceFrameAddr	(	const MCSymbol *	LastLabel,
		const MCSymbol *	Label,
		SMLoc	Loc
	)

Definition at line 491 of file MCObjectStreamer.cpp.

References buildSymbolDiff(), llvm::MCStreamer::getContext(), and insert().

◆ emitDwarfAdvanceLineAddr()

void MCObjectStreamer::emitDwarfAdvanceLineAddr	(	int64_t	LineDelta,
		const MCSymbol *	LastLabel,
		const MCSymbol *	Label,
		unsigned	PointerSize
	)

overridevirtual

If targets does not support representing debug line section by .loc/.file directives in assembly output, we need to populate debug line section with raw debug line contents.

Reimplemented from llvm::MCStreamer.

Definition at line 455 of file MCObjectStreamer.cpp.

References buildSymbolDiff(), emitDwarfSetLineAddr(), llvm::MCStreamer::getContext(), llvm::MCAssembler::getDWARFLinetableParams(), and insert().

Referenced by emitDwarfLineEndEntry().

◆ emitDwarfLineEndEntry()

void MCObjectStreamer::emitDwarfLineEndEntry	(	MCSection *	Section,
		MCSymbol *	LastLabel,
		MCSymbol *	EndLabel = `nullptr`
	)

overridevirtual

Emit the debug line end entry.

Reimplemented from llvm::MCStreamer.

Definition at line 469 of file MCObjectStreamer.cpp.

References emitDwarfAdvanceLineAddr(), llvm::MCStreamer::endSection(), llvm::MCContext::getAsmInfo(), llvm::MCAsmInfo::getCodePointerSize(), llvm::MCStreamer::getContext(), llvm::MCObjectFileInfo::getDwarfLineSection(), llvm::MCContext::getObjectFileInfo(), INT64_MAX, and llvm::MCStreamer::switchSection().

◆ emitDwarfLocDirective()

void MCObjectStreamer::emitDwarfLocDirective	(	unsigned	FileNo,
		unsigned	Line,
		unsigned	Column,
		unsigned	Flags,
		unsigned	Isa,
		unsigned	Discriminator,
		StringRef	FileName
	)

overridevirtual

This implements the DWARF2 '.loc fileno lineno ...' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 417 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitDwarfLocDirective(), llvm::MCStreamer::getCurrentSectionOnly(), and llvm::MCDwarfLineEntry::make().

◆ emitFileDirective() [1/2]

void MCObjectStreamer::emitFileDirective ( StringRef Filename )

overridevirtual

Switch to a new logical file.

This is used to implement the '.file "foo.c"' assembler directive.

Reimplemented from llvm::MCStreamer.

Definition at line 790 of file MCObjectStreamer.cpp.

References getAssembler().

◆ emitFileDirective() [2/2]

void MCObjectStreamer::emitFileDirective	(	StringRef	Filename,
		StringRef	CompilerVersion,
		StringRef	TimeStamp,
		StringRef	Description
	)

overridevirtual

Emit ".file assembler diretive with additioal info.

Reimplemented from llvm::MCStreamer.

Definition at line 795 of file MCObjectStreamer.cpp.

References getAssembler(), llvm::MCAssembler::getWriter(), and llvm::StringRef::size().

◆ emitFill() [1/5]

void MCStreamer::emitFill	(	const MCExpr &	NumBytes,
		uint64_t	FillValue,
		SMLoc	Loc = `SMLoc()`
	)

virtual

Emit Size bytes worth of the value specified by FillValue.

This is used to implement assembler directives such as .space or .skip.

Parameters

NumBytes	- The number of bytes to emit.
FillValue	- The value to use when filling bytes.
Loc	- The location of the expression for error reporting.

Reimplemented from llvm::MCStreamer.

Definition at line 809 of file MCStreamer.cpp.

◆ emitFill() [2/5]

void MCObjectStreamer::emitFill	(	const MCExpr &	NumBytes,
		uint64_t	FillValue,
		SMLoc	Loc = `SMLoc()`
	)

overridevirtual

Emit Size bytes worth of the value specified by FillValue.

This is used to implement assembler directives such as .space or .skip.

Parameters

NumBytes	- The number of bytes to emit.
FillValue	- The value to use when filling bytes.
Loc	- The location of the expression for error reporting.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::CSKYELFStreamer, and llvm::RISCVELFStreamer.

Definition at line 748 of file MCObjectStreamer.cpp.

References assert(), llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), and insert().

Referenced by llvm::CSKYELFStreamer::emitFill(), and llvm::RISCVELFStreamer::emitFill().

◆ emitFill() [3/5]

void MCStreamer::emitFill	(	const MCExpr &	NumValues,
		int64_t	Size,
		int64_t	Expr,
		SMLoc	Loc = `SMLoc()`
	)

virtual

Emit NumValues copies of Size bytes.

Each Size bytes is taken from the lowest order 4 bytes of Expr expression.

This is used to implement assembler directives such as .fill.

Parameters

NumValues	- The number of copies of `Size` bytes to emit.
Size	- The size (in bytes) of each repeated value.
Expr	- The expression from which `Size` bytes are used.

Reimplemented from llvm::MCStreamer.

Definition at line 820 of file MCStreamer.cpp.

◆ emitFill() [4/5]

void MCObjectStreamer::emitFill	(	const MCExpr &	NumValues,
		int64_t	Size,
		int64_t	Expr,
		SMLoc	Loc = `SMLoc()`
	)

overridevirtual

Emit NumValues copies of Size bytes.

Each Size bytes is taken from the lowest order 4 bytes of Expr expression.

This is used to implement assembler directives such as .fill.

Parameters

NumValues	- The number of copies of `Size` bytes to emit.
Size	- The size (in bytes) of each repeated value.
Expr	- The expression from which `Size` bytes are used.

Reimplemented from llvm::MCStreamer.

Definition at line 755 of file MCObjectStreamer.cpp.

References assert(), llvm::SourceMgr::DK_Warning, llvm::MCStreamer::emitIntValue(), getAssemblerPtr(), llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), llvm::MCContext::getSourceManager(), insert(), llvm::SourceMgr::PrintMessage(), and Size.

◆ emitFill() [5/5]

void MCStreamer::emitFill	(	uint64_t	NumBytes,
		uint8_t	FillValue
	)

Emit NumBytes bytes worth of the value specified by FillValue.

This implements directives such as '.space'.

Definition at line 800 of file MCStreamer.cpp.

◆ emitFrames()

void MCObjectStreamer::emitFrames ( MCAsmBackend * MAB )

Definition at line 134 of file MCObjectStreamer.cpp.

References llvm::MCDwarfFrameEmitter::Emit(), and llvm::MCStreamer::getNumFrameInfos().

Referenced by llvm::MCELFStreamer::finishImpl(), and llvm::MCWasmStreamer::finishImpl().

◆ emitGPRel32Value()

void MCObjectStreamer::emitGPRel32Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a gprel32 (32-bit GP relative) value.

This is used to implement assembler directives such as .gprel32 on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 617 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_GPRel_4, and getOrCreateDataFragment().

◆ emitGPRel64Value()

void MCObjectStreamer::emitGPRel64Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a gprel64 (64-bit GP relative) value.

This is used to implement assembler directives such as .gpdword on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 625 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_GPRel_4, and getOrCreateDataFragment().

◆ emitInstruction()

void MCObjectStreamer::emitInstruction	(	const MCInst &	Inst,
		const MCSubtargetInfo &	STI
	)

overridevirtual

Emit the given Instruction into the current section.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::CSKYELFStreamer, llvm::HexagonMCELFStreamer, llvm::MipsELFStreamer, llvm::PPCELFStreamer, llvm::PPCXCOFFStreamer, and llvm::RISCVELFStreamer.

Definition at line 338 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), llvm::MCInst::getLoc(), llvm::MCSection::getName(), llvm::MCSection::getVirtualSectionKind(), llvm::MCSection::isVirtualSection(), and llvm::MCContext::reportError().

Referenced by llvm::MipsTargetELFStreamer::emitDirectiveCpLoad(), llvm::MipsTargetELFStreamer::emitDirectiveCpreturn(), llvm::CSKYELFStreamer::emitInstruction(), llvm::HexagonMCELFStreamer::emitInstruction(), llvm::MipsELFStreamer::emitInstruction(), llvm::PPCELFStreamer::emitInstruction(), llvm::PPCXCOFFStreamer::emitInstruction(), and llvm::RISCVELFStreamer::emitInstruction().

◆ emitInstToFragment()

void MCObjectStreamer::emitInstToFragment	(	const MCInst &	Inst,
		const MCSubtargetInfo &	STI
	)

virtual

Emit an instruction to a special fragment, because this instruction can change its size during relaxation.

Definition at line 388 of file MCObjectStreamer.cpp.

References llvm::MCContext::allocFragment(), llvm::MCCodeEmitter::encodeInstruction(), getAssembler(), llvm::MCStreamer::getContext(), llvm::MCAssembler::getEmitter(), and insert().

◆ emitLabel()

void MCObjectStreamer::emitLabel	(	MCSymbol *	Symbol,
		SMLoc	Loc = `SMLoc()`
	)

overridevirtual

Emit a label for Symbol into the current section.

This corresponds to an assembler statement such as: foo:

Parameters

Symbol - The symbol to emit. A given symbol should only be emitted as a label once, and symbols emitted as a label should never be used in an assignment.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::MCWasmStreamer, llvm::MCWinCOFFStreamer, llvm::MipsELFStreamer, and llvm::PPCELFStreamer.

Definition at line 225 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitLabel(), emitPendingAssignments(), F, getAssembler(), getOrCreateDataFragment(), and llvm::MCAssembler::registerSymbol().

Referenced by llvm::MCDwarfFrameEmitter::Emit(), emitCVLocDirective(), llvm::MCELFStreamer::emitLabel(), llvm::MCWasmStreamer::emitLabel(), and llvm::MCWinCOFFStreamer::emitLabel().

◆ emitLabelAtPos()

void MCObjectStreamer::emitLabelAtPos	(	MCSymbol *	Symbol,
		SMLoc	Loc,
		MCDataFragment &	F,
		uint64_t	Offset
	)

virtual

Reimplemented in llvm::MCELFStreamer, and llvm::MCWasmStreamer.

Definition at line 252 of file MCObjectStreamer.cpp.

References assert(), llvm::MCStreamer::emitLabel(), F, getAssembler(), llvm::MCStreamer::getCurrentSectionOnly(), llvm::Offset, and llvm::MCAssembler::registerSymbol().

Referenced by llvm::MCELFStreamer::emitLabelAtPos(), and llvm::MCWasmStreamer::emitLabelAtPos().

◆ emitNops()

void MCObjectStreamer::emitNops	(	int64_t	NumBytes,
		int64_t	ControlledNopLength,
		SMLoc	Loc,
		const MCSubtargetInfo &	STI
	)

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 783 of file MCObjectStreamer.cpp.

References assert(), llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), and insert().

◆ emitPendingAssignments()

void MCObjectStreamer::emitPendingAssignments ( MCSymbol * Symbol )

Emits pending conditional assignments that depend on Symbol being emitted.

Definition at line 240 of file MCObjectStreamer.cpp.

References A, and emitAssignment().

Referenced by emitAssignment(), and emitLabel().

◆ emitRelocDirective()

std::optional< std::pair< bool, std::string > > MCObjectStreamer::emitRelocDirective	(	const MCExpr &	Offset,
		StringRef	Name,
		const MCExpr *	Expr,
		SMLoc	Loc,
		const MCSubtargetInfo &	STI
	)

overridevirtual

Record a relocation described by the .reloc directive.

Return std::nullopt if succeeded. Otherwise, return a pair (Name is invalid, error message).

Reimplemented from llvm::MCStreamer.

Definition at line 695 of file MCObjectStreamer.cpp.

References llvm::MCSymbolRefExpr::create(), llvm::MCFixup::create(), DF, llvm::MCAssembler::getBackend(), llvm::MCValue::getConstant(), llvm::MCStreamer::getContext(), llvm::MCAsmBackend::getFixupKind(), getOffsetAndDataFragment(), getOrCreateDataFragment(), llvm::MCValue::getSymA(), llvm::MCValue::getSymB(), llvm::MCSymbolRefExpr::getSymbol(), llvm::MCValue::isAbsolute(), Name, llvm::Offset, and llvm::MCStreamer::visitUsedExpr().

◆ emitSLEB128Value()

void MCObjectStreamer::emitSLEB128Value ( const MCExpr * Value )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 270 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitSLEB128IntValue(), getAssemblerPtr(), llvm::MCStreamer::getContext(), and insert().

◆ emitTPRel32Value()

void MCObjectStreamer::emitTPRel32Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a tprel (32-bit TP relative) value.

This is used to implement assembler directives such as .tprelword on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 601 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_TPRel_4, and getOrCreateDataFragment().

◆ emitTPRel64Value()

void MCObjectStreamer::emitTPRel64Value ( const MCExpr * Value )

overridevirtual

Emit the expression Value into the output as a tprel (64-bit TP relative) value.

This is used to implement assembler directives such as .tpreldword on targets that support them.

Reimplemented from llvm::MCStreamer.

Definition at line 609 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::FK_TPRel_8, and getOrCreateDataFragment().

◆ emitULEB128Value()

void MCObjectStreamer::emitULEB128Value ( const MCExpr * Value )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 261 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::emitULEB128IntValue(), getAssemblerPtr(), llvm::MCStreamer::getContext(), and insert().

◆ emitValueImpl()

void MCObjectStreamer::emitValueImpl	(	const MCExpr *	Value,
		unsigned	Size,
		SMLoc	Loc = `SMLoc()`
	)

overridevirtual

Emit the expression Value into the output as a native integer of the given Size bytes.

This is used to implement assembler directives such as .word, .quad, etc.

Parameters

Value	- The value to emit.
Size	- The size of the integer (in bytes) to emit. This must match a native machine width.
Loc	- The location of the expression for error reporting.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::CSKYELFStreamer, llvm::MipsELFStreamer, and llvm::RISCVELFStreamer.

Definition at line 184 of file MCObjectStreamer.cpp.

References llvm::MCFixup::create(), DF, llvm::MCStreamer::emitIntValue(), llvm::MCStreamer::emitValueImpl(), getAssemblerPtr(), llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), llvm::MCFixup::getKindForSize(), getOrCreateDataFragment(), llvm::isIntN(), llvm::isUIntN(), llvm::MCDwarfLineEntry::make(), llvm::MCContext::reportError(), and Size.

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

◆ emitValueToAlignment()

void MCObjectStreamer::emitValueToAlignment	(	Align	Alignment,
		int64_t	Value = `0`,
		unsigned	ValueSize = `1`,
		unsigned	MaxBytesToEmit = `0`
	)

overridevirtual

Emit some number of copies of Value until the byte alignment ByteAlignment is reached.

If the number of bytes need to emit for the alignment is not a multiple of ValueSize, then the contents of the emitted fill bytes is undefined.

This used to implement the .align assembler directive.

Parameters

Alignment	- The alignment to reach.
Value	- The value to use when filling bytes.
ValueSize	- The size of the integer (in bytes) to emit for `Value`. This must match a native machine width.
MaxBytesToEmit	- The maximum numbers of bytes to emit, or 0. If the alignment cannot be reached in this many bytes, no bytes are emitted.

Reimplemented from llvm::MCStreamer.

Definition at line 558 of file MCObjectStreamer.cpp.

References llvm::MCSection::ensureMinAlignment(), llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentSectionOnly(), insert(), and llvm::Align::value().

Referenced by llvm::MCDwarfFrameEmitter::Emit(), emitCodeAlignment(), llvm::MCXCOFFStreamer::emitCommonSymbol(), llvm::MCWinCOFFStreamer::emitLocalCommonSymbol(), and llvm::MCELFStreamer::emitValueToAlignment().

◆ emitValueToOffset()

void MCObjectStreamer::emitValueToOffset	(	const MCExpr *	Offset,
		unsigned char	Value,
		SMLoc	Loc
	)

overridevirtual

Emit some number of copies of Value until the byte offset Offset is reached.

This is used to implement assembler directives such as .org.

Parameters

Offset	- The offset to reach. This may be an expression, but the expression must be associated with the current section.
Value	- The value to use when filling bytes.

Reimplemented from llvm::MCStreamer.

Definition at line 578 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::getContext(), insert(), and llvm::Offset.

◆ emitWeakReference()

void MCObjectStreamer::emitWeakReference	(	MCSymbol *	Alias,
		const MCSymbol *	Symbol
	)

overridevirtual

Emit an weak reference from Alias to Symbol.

This corresponds to an assembler statement such as: .weakref alias, symbol

Parameters

Alias	- The alias that is being created.
Symbol	- The symbol being aliased.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::MCWasmStreamer, and llvm::MCWinCOFFStreamer.

Definition at line 279 of file MCObjectStreamer.cpp.

References llvm::report_fatal_error().

◆ finishImpl()

void MCObjectStreamer::finishImpl ( )

overridevirtual

Streamer specific finalization.

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::MCWasmStreamer, and llvm::MCWinCOFFStreamer.

Definition at line 815 of file MCObjectStreamer.cpp.

References llvm::MCPseudoProbeTable::emit(), llvm::MCGenDwarfInfo::Emit(), llvm::MCDwarfLineTable::emit(), llvm::MCAssembler::Finish(), getAssembler(), llvm::MCStreamer::getContext(), and llvm::MCContext::RemapDebugPaths().

Referenced by llvm::MCELFStreamer::finishImpl(), llvm::MCWasmStreamer::finishImpl(), and llvm::MCWinCOFFStreamer::finishImpl().

◆ getAssembler()

MCAssembler & llvm::MCObjectStreamer::getAssembler ( )

inline

Definition at line 107 of file MCObjectStreamer.h.

◆ getAssemblerPtr()

MCAssembler * MCObjectStreamer::getAssemblerPtr ( )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 43 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::getUseAssemblerInfoForParsing().

Referenced by llvm::MCPseudoProbe::emit(), emitFill(), emitSLEB128Value(), emitULEB128Value(), and emitValueImpl().

◆ getOrCreateDataFragment()

MCDataFragment * MCObjectStreamer::getOrCreateDataFragment ( const MCSubtargetInfo * STI = nullptr )

Get a data fragment to write into, creating a new one if the current fragment is not a data fragment.

Optionally a STI can be passed in so that a new fragment is created if the Subtarget differs from the current fragment.

Definition at line 165 of file MCObjectStreamer.cpp.

References llvm::MCContext::allocFragment(), canReuseDataFragment(), F, llvm::MCStreamer::getContext(), llvm::MCStreamer::getCurrentFragment(), and insert().

Referenced by emitBytes(), llvm::MCWinCOFFStreamer::emitCOFFImgRel32(), llvm::MCWinCOFFStreamer::emitCOFFSecNumber(), llvm::MCWinCOFFStreamer::emitCOFFSecOffset(), llvm::MCWinCOFFStreamer::emitCOFFSecRel32(), llvm::MCWinCOFFStreamer::emitCOFFSectionIndex(), emitDTPRel32Value(), emitDTPRel64Value(), emitGPRel32Value(), emitGPRel64Value(), llvm::MCXCOFFStreamer::emitInstToData(), llvm::MCWinCOFFStreamer::emitInstToData(), emitLabel(), emitRelocDirective(), emitTPRel32Value(), emitTPRel64Value(), emitValueImpl(), and llvm::MCXCOFFStreamer::emitXCOFFRefDirective().

◆ insert()

void llvm::MCObjectStreamer::insert ( MCFragment * F )

inline

Definition at line 86 of file MCObjectStreamer.h.

References llvm::MCStreamer::CurFrag, F, llvm::MCFragment::getLayoutOrder(), and llvm::MCFragment::getParent().

Referenced by llvm::MCPseudoProbe::emit(), llvm::MCWinCOFFStreamer::emitCOFFSafeSEH(), llvm::MCWinCOFFStreamer::emitCOFFSymbolIndex(), emitDwarfAdvanceFrameAddr(), emitDwarfAdvanceLineAddr(), emitFill(), emitInstToFragment(), emitNops(), emitSLEB128Value(), emitULEB128Value(), emitValueToAlignment(), emitValueToOffset(), and getOrCreateDataFragment().

◆ isIntegratedAssemblerRequired()

bool llvm::MCObjectStreamer::isIntegratedAssemblerRequired ( ) const

inlineoverridevirtual

Object streamers require the integrated assembler.

Reimplemented from llvm::MCStreamer.

Definition at line 81 of file MCObjectStreamer.h.

◆ mayHaveInstructions()

bool MCObjectStreamer::mayHaveInstructions ( MCSection & Sec ) const

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 334 of file MCObjectStreamer.cpp.

References llvm::MCSection::hasInstructions().

◆ reset()

void MCObjectStreamer::reset ( )

overridevirtual

state management

Reimplemented from llvm::MCStreamer.

Reimplemented in llvm::MCWasmStreamer, llvm::MCWinCOFFStreamer, and llvm::CSKYELFStreamer.

Definition at line 123 of file MCObjectStreamer.cpp.

References llvm::MCStreamer::getContext(), and llvm::MCStreamer::reset().

Referenced by llvm::MCELFStreamer::reset(), llvm::MCWasmStreamer::reset(), and llvm::MCWinCOFFStreamer::reset().

◆ switchSectionNoPrint()

void MCObjectStreamer::switchSectionNoPrint ( MCSection * Section )

overridevirtual

Similar to switchSection, but does not print the section directive.

Reimplemented from llvm::MCStreamer.

Definition at line 311 of file MCObjectStreamer.cpp.

References changeSection(), and llvm::MCStreamer::switchSectionNoPrint().

◆ visitUsedSymbol()

void MCObjectStreamer::visitUsedSymbol ( const MCSymbol & Sym )

overridevirtual

Reimplemented from llvm::MCStreamer.

Definition at line 174 of file MCObjectStreamer.cpp.

References Sym.

Referenced by llvm::MCWinCOFFStreamer::emitCOFFImgRel32(), llvm::MCWinCOFFStreamer::emitCOFFSecNumber(), llvm::MCWinCOFFStreamer::emitCOFFSecOffset(), llvm::MCWinCOFFStreamer::emitCOFFSecRel32(), and llvm::MCWinCOFFStreamer::emitCOFFSectionIndex().

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

include/llvm/MC/MCObjectStreamer.h
lib/MC/MCObjectStreamer.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MCObjectStreamer()

◆ ~MCObjectStreamer()

Member Function Documentation

◆ changeSection()

◆ changeSectionImpl()

◆ emitAbsoluteSymbolDiff()

◆ emitAbsoluteSymbolDiffAsULEB128()

◆ emitAddrsig()

◆ emitAddrsigSym()

◆ emitAssignment()

◆ emitBundleAlignMode()

◆ emitBundleLock()

◆ emitBundleUnlock()

◆ emitBytes()

◆ emitCFISections()

◆ emitCodeAlignment()

◆ emitConditionalAssignment()

◆ emitCVDefRangeDirective()

◆ emitCVFileChecksumOffsetDirective()

◆ emitCVFileChecksumsDirective()

◆ emitCVInlineLinetableDirective()

◆ emitCVLinetableDirective()

◆ emitCVLocDirective()

◆ emitCVStringTableDirective()

◆ emitDTPRel32Value()

◆ emitDTPRel64Value()

◆ emitDwarfAdvanceFrameAddr()

◆ emitDwarfAdvanceLineAddr()

◆ emitDwarfLineEndEntry()

◆ emitDwarfLocDirective()

◆ emitFileDirective() [1/2]

◆ emitFileDirective() [2/2]

◆ emitFill() [1/5]

◆ emitFill() [2/5]

◆ emitFill() [3/5]

◆ emitFill() [4/5]

◆ emitFill() [5/5]

◆ emitFrames()

◆ emitGPRel32Value()

◆ emitGPRel64Value()

◆ emitInstruction()

◆ emitInstToFragment()

◆ emitLabel()

◆ emitLabelAtPos()

◆ emitNops()

◆ emitPendingAssignments()

◆ emitRelocDirective()

◆ emitSLEB128Value()

◆ emitTPRel32Value()

◆ emitTPRel64Value()

◆ emitULEB128Value()

◆ emitValueImpl()

◆ emitValueToAlignment()

◆ emitValueToOffset()

◆ emitWeakReference()

◆ finishImpl()

◆ getAssembler()

◆ getAssemblerPtr()

◆ getOrCreateDataFragment()

◆ insert()

◆ isIntegratedAssemblerRequired()

◆ mayHaveInstructions()

◆ reset()

◆ switchSectionNoPrint()

◆ visitUsedSymbol()