LLVM 20.0.0git
MCWasmStreamer.cpp
Go to the documentation of this file.
1//===- lib/MC/MCWasmStreamer.cpp - Wasm Object Output ---------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file assembles .s files and emits Wasm .o object files.
10//
11//===----------------------------------------------------------------------===//
12
17#include "llvm/MC/MCAssembler.h"
19#include "llvm/MC/MCExpr.h"
20#include "llvm/MC/MCFixup.h"
21#include "llvm/MC/MCFragment.h"
23#include "llvm/MC/MCSection.h"
25#include "llvm/MC/MCSymbol.h"
31
32namespace llvm {
33class MCContext;
34class MCStreamer;
35class MCSubtargetInfo;
36} // namespace llvm
37
38using namespace llvm;
39
40MCWasmStreamer::~MCWasmStreamer() = default; // anchor.
41
43 auto *Symbol = cast<MCSymbolWasm>(S);
44 MCObjectStreamer::emitLabel(Symbol, Loc);
45
46 const MCSectionWasm &Section =
47 static_cast<const MCSectionWasm &>(*getCurrentSectionOnly());
48 if (Section.getSegmentFlags() & wasm::WASM_SEG_FLAG_TLS)
49 Symbol->setTLS();
50}
51
54 auto *Symbol = cast<MCSymbolWasm>(S);
56
57 const MCSectionWasm &Section =
58 static_cast<const MCSectionWasm &>(*getCurrentSectionOnly());
59 if (Section.getSegmentFlags() & wasm::WASM_SEG_FLAG_TLS)
60 Symbol->setTLS();
61}
62
64 // Let the target do whatever target specific stuff it needs to do.
66
67 // Do any generic stuff we need to do.
68 llvm_unreachable("invalid assembler flag!");
69}
70
73 auto *SectionWasm = cast<MCSectionWasm>(Section);
74 const MCSymbol *Grp = SectionWasm->getGroup();
75 if (Grp)
76 Asm.registerSymbol(*Grp);
77
78 this->MCObjectStreamer::changeSection(Section, Subsection);
79 Asm.registerSymbol(*Section->getBeginSymbol());
80}
81
83 const MCSymbol *Symbol) {
87 Alias->setVariableValue(Value);
88}
89
91 assert(Attribute != MCSA_IndirectSymbol && "indirect symbols not supported");
92
93 auto *Symbol = cast<MCSymbolWasm>(S);
94
95 // Adding a symbol attribute always introduces the symbol; note that an
96 // important side effect of calling registerSymbol here is to register the
97 // symbol with the assembler.
99
100 switch (Attribute) {
102 case MCSA_Reference:
107 case MCSA_Invalid:
109 case MCSA_Protected:
110 case MCSA_Exported:
111 return false;
112
113 case MCSA_Hidden:
114 Symbol->setHidden(true);
115 break;
116
117 case MCSA_Weak:
119 Symbol->setWeak(true);
120 Symbol->setExternal(true);
121 break;
122
123 case MCSA_Global:
124 Symbol->setExternal(true);
125 break;
126
128 Symbol->setType(wasm::WASM_SYMBOL_TYPE_FUNCTION);
129 break;
130
131 case MCSA_ELF_TypeTLS:
132 Symbol->setTLS();
133 break;
134
136 case MCSA_Cold:
137 break;
138
139 case MCSA_NoDeadStrip:
140 Symbol->setNoStrip();
141 break;
142
143 default:
144 // unrecognized directive
145 llvm_unreachable("unexpected MCSymbolAttr");
146 return false;
147 }
148
149 return true;
150}
151
153 Align ByteAlignment) {
154 llvm_unreachable("Common symbols are not yet implemented for Wasm");
155}
156
158 cast<MCSymbolWasm>(Symbol)->setSize(Value);
159}
160
162 Align ByteAlignment) {
163 llvm_unreachable("Local common symbols are not yet implemented for Wasm");
164}
165
167 // TODO(sbc): Add the ident section once we support mergable strings
168 // sections in the object format
169}
170
171void MCWasmStreamer::emitInstToFragment(const MCInst &Inst,
172 const MCSubtargetInfo &STI) {
174 MCRelaxableFragment &F = *cast<MCRelaxableFragment>(getCurrentFragment());
175
176 for (auto &Fixup : F.getFixups())
177 fixSymbolsInTLSFixups(Fixup.getValue());
178}
179
180void MCWasmStreamer::emitInstToData(const MCInst &Inst,
181 const MCSubtargetInfo &STI) {
182 MCAssembler &Assembler = getAssembler();
184 SmallString<256> Code;
185 Assembler.getEmitter().encodeInstruction(Inst, Code, Fixups, STI);
186
187 for (auto &Fixup : Fixups)
188 fixSymbolsInTLSFixups(Fixup.getValue());
189
190 // Append the encoded instruction to the current data fragment (or create a
191 // new such fragment if the current fragment is not a data fragment).
193
194 // Add the fixups and data.
195 for (unsigned I = 0, E = Fixups.size(); I != E; ++I) {
196 Fixups[I].setOffset(Fixups[I].getOffset() + DF->getContents().size());
197 DF->getFixups().push_back(Fixups[I]);
198 }
199 DF->setHasInstructions(STI);
200 DF->getContents().append(Code.begin(), Code.end());
201}
202
204 emitFrames(nullptr);
205
207}
208
209void MCWasmStreamer::fixSymbolsInTLSFixups(const MCExpr *expr) {
210 switch (expr->getKind()) {
211 case MCExpr::Target:
212 case MCExpr::Constant:
213 break;
214
215 case MCExpr::Binary: {
216 const MCBinaryExpr *be = cast<MCBinaryExpr>(expr);
217 fixSymbolsInTLSFixups(be->getLHS());
218 fixSymbolsInTLSFixups(be->getRHS());
219 break;
220 }
221
222 case MCExpr::SymbolRef: {
223 const MCSymbolRefExpr &symRef = *cast<MCSymbolRefExpr>(expr);
224 switch (symRef.getKind()) {
228 cast<MCSymbolWasm>(symRef.getSymbol()).setTLS();
229 break;
230 default:
231 break;
232 }
233 break;
234 }
235
236 case MCExpr::Unary:
237 fixSymbolsInTLSFixups(cast<MCUnaryExpr>(expr)->getSubExpr());
238 break;
239 }
240}
241
243 llvm_unreachable("Generic Wasm doesn't support this directive");
244}
245
246void MCWasmStreamer::emitSymbolDesc(MCSymbol *Symbol, unsigned DescValue) {
247 llvm_unreachable("Wasm doesn't support this directive");
248}
249
251 uint64_t Size, Align ByteAlignment,
252 SMLoc Loc) {
253 llvm_unreachable("Wasm doesn't support this directive");
254}
255
257 uint64_t Size, Align ByteAlignment) {
258 llvm_unreachable("Wasm doesn't support this directive");
259}
260
262 std::unique_ptr<MCAsmBackend> &&MAB,
263 std::unique_ptr<MCObjectWriter> &&OW,
264 std::unique_ptr<MCCodeEmitter> &&CE) {
265 MCWasmStreamer *S =
266 new MCWasmStreamer(Context, std::move(MAB), std::move(OW), std::move(CE));
267 return S;
268}
static GCRegistry::Add< CoreCLRGC > E("coreclr", "CoreCLR-compatible GC")
static RegisterPass< DebugifyFunctionPass > DF("debugify-function", "Attach debug info to a function")
uint64_t Size
#define F(x, y, z)
Definition: MD5.cpp:55
#define I(x, y, z)
Definition: MD5.cpp:58
PowerPC TLS Dynamic Call Fixup
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
This file defines the SmallString class.
This file defines the SmallVector class.
virtual void handleAssemblerFlag(MCAssemblerFlag Flag)
Handle any target-specific assembler flags. By default, do nothing.
Definition: MCAsmBackend.h:226
MCCodeEmitter & getEmitter() const
Definition: MCAssembler.h:190
MCAsmBackend & getBackend() const
Definition: MCAssembler.h:188
bool registerSymbol(const MCSymbol &Symbol)
Binary assembler expressions.
Definition: MCExpr.h:488
const MCExpr * getLHS() const
Get the left-hand side expression of the binary operator.
Definition: MCExpr.h:635
const MCExpr * getRHS() const
Get the right-hand side expression of the binary operator.
Definition: MCExpr.h:638
virtual void encodeInstruction(const MCInst &Inst, SmallVectorImpl< char > &CB, SmallVectorImpl< MCFixup > &Fixups, const MCSubtargetInfo &STI) const =0
Encode the given Inst to bytes and append to CB.
Context object for machine code objects.
Definition: MCContext.h:83
Fragment for data and encoded instructions.
Definition: MCFragment.h:219
Base class for the full range of assembler expressions which are needed for parsing.
Definition: MCExpr.h:34
@ Unary
Unary expressions.
Definition: MCExpr.h:40
@ Constant
Constant expressions.
Definition: MCExpr.h:38
@ SymbolRef
References to labels and assigned expressions.
Definition: MCExpr.h:39
@ Target
Target specific expression.
Definition: MCExpr.h:41
@ Binary
Binary expressions.
Definition: MCExpr.h:37
ExprKind getKind() const
Definition: MCExpr.h:78
Instances of this class represent a single low-level machine instruction.
Definition: MCInst.h:184
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.
MCAssembler & getAssembler()
virtual void emitInstToFragment(const MCInst &Inst, const MCSubtargetInfo &)
Emit an instruction to a special fragment, because this instruction can change its size during relaxa...
void emitLabel(MCSymbol *Symbol, SMLoc Loc=SMLoc()) override
Emit a label for Symbol into the current section.
void finishImpl() override
Streamer specific finalization.
void changeSection(MCSection *Section, uint32_t Subsection=0) override
This is called by popSection and switchSection, if the current section changes.
void emitFrames(MCAsmBackend *MAB)
virtual void emitLabelAtPos(MCSymbol *Symbol, SMLoc Loc, MCDataFragment &F, uint64_t Offset)
A relaxable fragment holds on to its MCInst, since it may need to be relaxed during the assembler lay...
Definition: MCFragment.h:234
This represents a section on wasm.
Definition: MCSectionWasm.h:26
Instances of this class represent a uniqued identifier for a section in the current translation unit.
Definition: MCSection.h:36
Streaming machine code generation interface.
Definition: MCStreamer.h:213
MCFragment * getCurrentFragment() const
Definition: MCStreamer.h:409
MCContext & getContext() const
Definition: MCStreamer.h:300
MCSection * getCurrentSectionOnly() const
Definition: MCStreamer.h:398
Generic base class for all target subtargets.
Represent a reference to a symbol from inside an expression.
Definition: MCExpr.h:188
const MCSymbol & getSymbol() const
Definition: MCExpr.h:406
static const MCSymbolRefExpr * create(const MCSymbol *Symbol, MCContext &Ctx)
Definition: MCExpr.h:393
VariantKind getKind() const
Definition: MCExpr.h:408
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:41
void setVariableValue(const MCExpr *Value)
Definition: MCSymbol.cpp:47
void emitLabelAtPos(MCSymbol *Symbol, SMLoc Loc, MCDataFragment &F, uint64_t Offset) override
void emitCommonSymbol(MCSymbol *Symbol, uint64_t Size, Align ByteAlignment) override
Emit a common symbol.
void emitLocalCommonSymbol(MCSymbol *Symbol, uint64_t Size, Align ByteAlignment) override
Emit a local common (.lcomm) symbol.
void emitIdent(StringRef IdentString) override
Emit the "identifiers" directive.
void emitSymbolDesc(MCSymbol *Symbol, unsigned DescValue) override
Set the DescValue for the Symbol.
void emitLabel(MCSymbol *Symbol, SMLoc Loc=SMLoc()) override
Emit a label for Symbol into the current section.
void emitThumbFunc(MCSymbol *Func) override
Note in the output that the specified Func is a Thumb mode function (ARM target only).
~MCWasmStreamer() override
void changeSection(MCSection *Section, uint32_t Subsection) override
This is called by popSection and switchSection, if the current section changes.
void finishImpl() override
Streamer specific finalization.
void emitTBSSSymbol(MCSection *Section, MCSymbol *Symbol, uint64_t Size, Align ByteAlignment=Align(1)) override
Emit a thread local bss (.tbss) symbol.
void emitELFSize(MCSymbol *Symbol, const MCExpr *Value) override
Emit an ELF .size directive.
void emitWeakReference(MCSymbol *Alias, const MCSymbol *Symbol) override
Emit an weak reference from Alias to Symbol.
bool emitSymbolAttribute(MCSymbol *Symbol, MCSymbolAttr Attribute) override
Add the given Attribute to Symbol.
void emitZerofill(MCSection *Section, MCSymbol *Symbol=nullptr, uint64_t Size=0, Align ByteAlignment=Align(1), SMLoc Loc=SMLoc()) override
Emit the zerofill section and an optional symbol.
void emitAssemblerFlag(MCAssemblerFlag Flag) override
Note in the output the specified Flag.
Represents a location in source code.
Definition: SMLoc.h:23
SmallString - A SmallString is just a SmallVector with methods and accessors that make it work better...
Definition: SmallString.h:26
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1209
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
LLVM Value Representation.
Definition: Value.h:74
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
NodeAddr< CodeNode * > Code
Definition: RDFGraph.h:388
@ WASM_SYMBOL_TYPE_FUNCTION
Definition: Wasm.h:209
@ WASM_SEG_FLAG_TLS
Definition: Wasm.h:219
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
@ Offset
Definition: DWP.cpp:480
static Error getOffset(const SymbolRef &Sym, SectionRef Sec, uint64_t &Result)
MCAssemblerFlag
Definition: MCDirectives.h:53
MCStreamer * createWasmStreamer(MCContext &Ctx, std::unique_ptr< MCAsmBackend > &&TAB, std::unique_ptr< MCObjectWriter > &&OW, std::unique_ptr< MCCodeEmitter > &&CE)
MCSymbolAttr
Definition: MCDirectives.h:18
@ MCSA_WeakDefAutoPrivate
.weak_def_can_be_hidden (MachO)
Definition: MCDirectives.h:48
@ MCSA_Protected
.protected (ELF)
Definition: MCDirectives.h:43
@ MCSA_Exported
.globl _foo, exported (XCOFF)
Definition: MCDirectives.h:34
@ MCSA_PrivateExtern
.private_extern (MachO)
Definition: MCDirectives.h:42
@ MCSA_WeakReference
.weak_reference (MachO)
Definition: MCDirectives.h:47
@ MCSA_LazyReference
.lazy_reference (MachO)
Definition: MCDirectives.h:37
@ MCSA_Reference
.reference (MachO)
Definition: MCDirectives.h:44
@ MCSA_SymbolResolver
.symbol_resolver (MachO)
Definition: MCDirectives.h:40
@ MCSA_Weak
.weak
Definition: MCDirectives.h:45
@ MCSA_ELF_TypeTLS
.type _foo, STT_TLS # aka @tls_object
Definition: MCDirectives.h:26
@ MCSA_IndirectSymbol
.indirect_symbol (MachO)
Definition: MCDirectives.h:35
@ MCSA_WeakDefinition
.weak_definition (MachO)
Definition: MCDirectives.h:46
@ MCSA_Global
.type _foo, @gnu_unique_object
Definition: MCDirectives.h:30
@ MCSA_Cold
.cold (MachO)
Definition: MCDirectives.h:22
@ MCSA_ELF_TypeObject
.type _foo, STT_OBJECT # aka @object
Definition: MCDirectives.h:25
@ MCSA_ELF_TypeFunction
.type _foo, STT_FUNC # aka @function
Definition: MCDirectives.h:23
@ MCSA_Hidden
.hidden (ELF)
Definition: MCDirectives.h:33
@ MCSA_Invalid
Not a valid directive.
Definition: MCDirectives.h:19
@ MCSA_NoDeadStrip
.no_dead_strip (MachO)
Definition: MCDirectives.h:39
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition: Alignment.h:39