class MCELFStreamer

Declaration

class MCELFStreamer : public MCObjectStreamer { /* full declaration omitted */ };

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.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:23

Inherits from: MCObjectStreamer

Method Overview

  • public void ChangeSection(llvm::MCSection * Section, const llvm::MCExpr * Subsection)
  • public void EmitAssemblerFlag(llvm::MCAssemblerFlag Flag)
  • public void EmitBundleAlignMode(unsigned int AlignPow2)
  • public void EmitBundleLock(bool AlignToEnd)
  • public void EmitBundleUnlock()
  • public void EmitCommonSymbol(llvm::MCSymbol * Symbol, uint64_t Size, unsigned int ByteAlignment)
  • public void EmitIdent(llvm::StringRef IdentString)
  • public void EmitLabel(llvm::MCSymbol * Symbol, llvm::SMLoc Loc = llvm::SMLoc())
  • public void EmitLabelAtPos(llvm::MCSymbol * Symbol, llvm::SMLoc Loc, llvm::MCFragment * F, uint64_t Offset)
  • public void EmitLocalCommonSymbol(llvm::MCSymbol * Symbol, uint64_t Size, unsigned int ByteAlignment)
  • public bool EmitSymbolAttribute(llvm::MCSymbol * Symbol, llvm::MCSymbolAttr Attribute)
  • public void EmitSymbolDesc(llvm::MCSymbol * Symbol, unsigned int DescValue)
  • public void EmitTBSSSymbol(llvm::MCSection * Section, llvm::MCSymbol * Symbol, uint64_t Size, unsigned int ByteAlignment = 0)
  • public void EmitThumbFunc(llvm::MCSymbol * Func)
  • public void EmitValueImpl(const llvm::MCExpr * Value, unsigned int Size, llvm::SMLoc Loc = llvm::SMLoc())
  • public void EmitValueToAlignment(unsigned int, int64_t, unsigned int, unsigned int)
  • public void EmitWeakReference(llvm::MCSymbol * Alias, const llvm::MCSymbol * Symbol)
  • public void EmitZerofill(llvm::MCSection * Section, llvm::MCSymbol * Symbol = nullptr, uint64_t Size = 0, unsigned int ByteAlignment = 0, llvm::SMLoc L = llvm::SMLoc())
  • public void FinishImpl()
  • public void InitSections(bool NoExecStack)
  • public MCELFStreamer(llvm::MCContext & Context, std::unique_ptr<MCAsmBackend> TAB, std::unique_ptr<MCObjectWriter> OW, std::unique_ptr<MCCodeEmitter> Emitter)
  • public void emitCGProfileEntry(const llvm::MCSymbolRefExpr * From, const llvm::MCSymbolRefExpr * To, uint64_t Count)
  • public void emitELFSize(llvm::MCSymbol * Symbol, const llvm::MCExpr * Value)
  • public void emitELFSymverDirective(llvm::StringRef AliasName, const llvm::MCSymbol * Aliasee)
  • public void reset()
  • public ~MCELFStreamer()

Inherited from MCObjectStreamer:

Inherited from MCStreamer:

Methods

void ChangeSection(llvm::MCSection* Section,
                   const llvm::MCExpr* Subsection)

Description

Update streamer for a new active section. This is called by PopSection and SwitchSection, if the current section changes.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:42

Parameters

llvm::MCSection* Section
const llvm::MCExpr* Subsection

void EmitAssemblerFlag(llvm::MCAssemblerFlag Flag)

Description

Note in the output the specified \p Flag.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:46

Parameters

llvm::MCAssemblerFlag Flag

void EmitBundleAlignMode(unsigned int AlignPow2)

Description

Set the bundle alignment mode from now on in the section. The argument is the power of 2 to which the alignment is set. The value 0 means turn the bundle alignment off.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:78

Parameters

unsigned int AlignPow2

void EmitBundleLock(bool AlignToEnd)

Description

The following instructions are a bundle-locked group.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:79

Parameters

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

void EmitBundleUnlock()

Description

Ends a bundle-locked group.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:80

void EmitCommonSymbol(llvm::MCSymbol* Symbol,
                      uint64_t Size,
                      unsigned int ByteAlignment)

Description

Emit a common symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:51

Parameters

llvm::MCSymbol* Symbol
- The common symbol to emit.
uint64_t Size
- The size of the common symbol.
unsigned int ByteAlignment
- The alignment of the symbol if non-zero. This must be a power of 2.

void EmitIdent(llvm::StringRef IdentString)

Description

Emit the "identifiers" directive. This implements the '.ident "version foo"' assembler directive.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:69

Parameters

llvm::StringRef IdentString

void EmitLabel(llvm::MCSymbol* Symbol,
               llvm::SMLoc Loc = llvm::SMLoc())

Description

@ {

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:43

Parameters

llvm::MCSymbol* Symbol
llvm::SMLoc Loc = llvm::SMLoc()

void EmitLabelAtPos(llvm::MCSymbol* Symbol,
                    llvm::SMLoc Loc,
                    llvm::MCFragment* F,
                    uint64_t Offset)

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:44

Parameters

llvm::MCSymbol* Symbol
llvm::SMLoc Loc
llvm::MCFragment* F
uint64_t Offset

void EmitLocalCommonSymbol(
    llvm::MCSymbol* Symbol,
    uint64_t Size,
    unsigned int ByteAlignment)

Description

Emit a local common (.lcomm) symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:58

Parameters

llvm::MCSymbol* Symbol
- The common symbol to emit.
uint64_t Size
- The size of the common symbol.
unsigned int ByteAlignment
- The alignment of the common symbol in bytes.

bool EmitSymbolAttribute(
    llvm::MCSymbol* Symbol,
    llvm::MCSymbolAttr Attribute)

Description

Add the given \p Attribute to \p Symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:49

Parameters

llvm::MCSymbol* Symbol
llvm::MCSymbolAttr Attribute

void EmitSymbolDesc(llvm::MCSymbol* Symbol,
                    unsigned int DescValue)

Description

Set the \p DescValue for the \p Symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:50

Parameters

llvm::MCSymbol* Symbol
- The symbol to have its n_desc field set.
unsigned int DescValue
- The value to set into the n_desc field.

void EmitTBSSSymbol(
    llvm::MCSection* Section,
    llvm::MCSymbol* Symbol,
    uint64_t Size,
    unsigned int ByteAlignment = 0)

Description

Emit a thread local bss (.tbss) symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:64

Parameters

llvm::MCSection* Section
- The thread local common section.
llvm::MCSymbol* Symbol
- The thread local common symbol to emit.
uint64_t Size
- The size of the symbol.
unsigned int ByteAlignment = 0
- The alignment of the thread local common symbol if non-zero. This must be a power of 2 on some targets.

void EmitThumbFunc(llvm::MCSymbol* Func)

Description

Note in the output that the specified \p Func is a Thumb mode function (ARM target only).

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:47

Parameters

llvm::MCSymbol* Func

void EmitValueImpl(
    const llvm::MCExpr* Value,
    unsigned int Size,
    llvm::SMLoc Loc = llvm::SMLoc())

Description

Emit the expression \p Value into the output as a native integer of the given \p Size bytes. This is used to implement assembler directives such as .word, .quad, etc.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:66

Parameters

const llvm::MCExpr* Value
- The value to emit.
unsigned int Size
- The size of the integer (in bytes) to emit. This must match a native machine width.
llvm::SMLoc Loc = llvm::SMLoc()
- The location of the expression for error reporting.

void EmitValueToAlignment(unsigned int,
                          int64_t,
                          unsigned int,
                          unsigned int)

Description

Emit some number of copies of \p Value until the byte alignment \p ByteAlignment is reached. If the number of bytes need to emit for the alignment is not a multiple of \p ValueSize, then the contents of the emitted fill bytes is undefined. This used to implement the .align assembler directive.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:71

Parameters

unsigned int
int64_t
unsigned int
unsigned int

void EmitWeakReference(
    llvm::MCSymbol* Alias,
    const llvm::MCSymbol* Symbol)

Description

Emit an weak reference from \p Alias to \p Symbol. This corresponds to an assembler statement such as: .weakref alias, symbol

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:48

Parameters

llvm::MCSymbol* Alias
- The alias that is being created.
const llvm::MCSymbol* Symbol
- The symbol being aliased.

void EmitZerofill(
    llvm::MCSection* Section,
    llvm::MCSymbol* Symbol = nullptr,
    uint64_t Size = 0,
    unsigned int ByteAlignment = 0,
    llvm::SMLoc L = llvm::SMLoc())

Description

Emit the zerofill section and an optional symbol.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:61

Parameters

llvm::MCSection* Section
- The zerofill section to create and or to put the symbol
llvm::MCSymbol* Symbol = nullptr
- The zerofill symbol to emit, if non-NULL.
uint64_t Size = 0
- The size of the zerofill symbol.
unsigned int ByteAlignment = 0
- The alignment of the zerofill symbol if non-zero. This must be a power of 2 on some targets.
llvm::SMLoc L = llvm::SMLoc()

void FinishImpl()

Description

Streamer specific finalization.

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:76

void InitSections(bool NoExecStack)

Description

@ {

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:41

Parameters

bool NoExecStack

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

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:25

Parameters

llvm::MCContext& Context
std::unique_ptr<MCAsmBackend> TAB
std::unique_ptr<MCObjectWriter> OW
std::unique_ptr<MCCodeEmitter> Emitter

void emitCGProfileEntry(
    const llvm::MCSymbolRefExpr* From,
    const llvm::MCSymbolRefExpr* To,
    uint64_t Count)

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:73

Parameters

const llvm::MCSymbolRefExpr* From
const llvm::MCSymbolRefExpr* To
uint64_t Count

void emitELFSize(llvm::MCSymbol* Symbol,
                 const llvm::MCExpr* Value)

Description

Emit an ELF .size directive. This corresponds to an assembler statement such as: .size symbol, expression

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:54

Parameters

llvm::MCSymbol* Symbol
const llvm::MCExpr* Value

void emitELFSymverDirective(
    llvm::StringRef AliasName,
    const llvm::MCSymbol* Aliasee)

Description

Emit an ELF .symver directive. This corresponds to an assembler statement such as: .symver _start, foo @ SOME_VERSION

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:55

Parameters

llvm::StringRef AliasName
- The versioned alias (i.e. "foo@@SOME_VERSION")
const llvm::MCSymbol* Aliasee
- The aliased symbol (i.e. "_start")

void reset()

Description

state management

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:32

~MCELFStreamer()

Declared at: llvm/include/llvm/MC/MCELFStreamer.h:29