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"
30
31namespace llvm {
32class MCContext;
33class MCStreamer;
34class MCSubtargetInfo;
35} // namespace llvm
36
37using namespace llvm;
38
39MCWasmStreamer::~MCWasmStreamer() = default; // anchor.
40
42 auto *Symbol = cast<MCSymbolWasm>(S);
43 MCObjectStreamer::emitLabel(Symbol, Loc);
44
45 const MCSectionWasm &Section =
46 static_cast<const MCSectionWasm &>(*getCurrentSectionOnly());
47 if (Section.getSegmentFlags() & wasm::WASM_SEG_FLAG_TLS)
48 Symbol->setTLS();
49}
50
53 auto *Symbol = cast<MCSymbolWasm>(S);
55
56 const MCSectionWasm &Section =
57 static_cast<const MCSectionWasm &>(*getCurrentSectionOnly());
58 if (Section.getSegmentFlags() & wasm::WASM_SEG_FLAG_TLS)
59 Symbol->setTLS();
60}
61
63 // Let the target do whatever target specific stuff it needs to do.
65
66 // Do any generic stuff we need to do.
67 llvm_unreachable("invalid assembler flag!");
68}
69
72 auto *SectionWasm = cast<MCSectionWasm>(Section);
73 const MCSymbol *Grp = SectionWasm->getGroup();
74 if (Grp)
75 Asm.registerSymbol(*Grp);
76
77 this->MCObjectStreamer::changeSection(Section, Subsection);
78 Asm.registerSymbol(*Section->getBeginSymbol());
79}
80
82 const MCSymbol *Symbol) {
86 Alias->setVariableValue(Value);
87}
88
90 assert(Attribute != MCSA_IndirectSymbol && "indirect symbols not supported");
91
92 auto *Symbol = cast<MCSymbolWasm>(S);
93
94 // Adding a symbol attribute always introduces the symbol; note that an
95 // important side effect of calling registerSymbol here is to register the
96 // symbol with the assembler.
98
99 switch (Attribute) {
101 case MCSA_Reference:
106 case MCSA_Invalid:
108 case MCSA_Protected:
109 case MCSA_Exported:
110 return false;
111
112 case MCSA_Hidden:
113 Symbol->setHidden(true);
114 break;
115
116 case MCSA_Weak:
118 Symbol->setWeak(true);
119 Symbol->setExternal(true);
120 break;
121
122 case MCSA_Global:
123 Symbol->setExternal(true);
124 break;
125
127 Symbol->setType(wasm::WASM_SYMBOL_TYPE_FUNCTION);
128 break;
129
130 case MCSA_ELF_TypeTLS:
131 Symbol->setTLS();
132 break;
133
135 case MCSA_Cold:
136 break;
137
138 case MCSA_NoDeadStrip:
139 Symbol->setNoStrip();
140 break;
141
142 default:
143 // unrecognized directive
144 llvm_unreachable("unexpected MCSymbolAttr");
145 return false;
146 }
147
148 return true;
149}
150
152 Align ByteAlignment) {
153 llvm_unreachable("Common symbols are not yet implemented for Wasm");
154}
155
157 cast<MCSymbolWasm>(Symbol)->setSize(Value);
158}
159
161 Align ByteAlignment) {
162 llvm_unreachable("Local common symbols are not yet implemented for Wasm");
163}
164
166 // TODO(sbc): Add the ident section once we support mergable strings
167 // sections in the object format
168}
169
170void MCWasmStreamer::emitInstToFragment(const MCInst &Inst,
171 const MCSubtargetInfo &STI) {
173 MCRelaxableFragment &F = *cast<MCRelaxableFragment>(getCurrentFragment());
174
175 for (auto &Fixup : F.getFixups())
176 fixSymbolsInTLSFixups(Fixup.getValue());
177}
178
179void MCWasmStreamer::emitInstToData(const MCInst &Inst,
180 const MCSubtargetInfo &STI) {
181 MCAssembler &Assembler = getAssembler();
183 SmallString<256> Code;
184 Assembler.getEmitter().encodeInstruction(Inst, Code, Fixups, STI);
185
186 for (auto &Fixup : Fixups)
187 fixSymbolsInTLSFixups(Fixup.getValue());
188
189 // Append the encoded instruction to the current data fragment (or create a
190 // new such fragment if the current fragment is not a data fragment).
192
193 // Add the fixups and data.
194 for (unsigned I = 0, E = Fixups.size(); I != E; ++I) {
195 Fixups[I].setOffset(Fixups[I].getOffset() + DF->getContents().size());
196 DF->getFixups().push_back(Fixups[I]);
197 }
198 DF->setHasInstructions(STI);
199 DF->getContents().append(Code.begin(), Code.end());
200}
201
203 emitFrames(nullptr);
204
206}
207
208void MCWasmStreamer::fixSymbolsInTLSFixups(const MCExpr *expr) {
209 switch (expr->getKind()) {
210 case MCExpr::Target:
211 case MCExpr::Constant:
212 break;
213
214 case MCExpr::Binary: {
215 const MCBinaryExpr *be = cast<MCBinaryExpr>(expr);
216 fixSymbolsInTLSFixups(be->getLHS());
217 fixSymbolsInTLSFixups(be->getRHS());
218 break;
219 }
220
221 case MCExpr::SymbolRef: {
222 const MCSymbolRefExpr &symRef = *cast<MCSymbolRefExpr>(expr);
223 switch (symRef.getKind()) {
227 cast<MCSymbolWasm>(symRef.getSymbol()).setTLS();
228 break;
229 default:
230 break;
231 }
232 break;
233 }
234
235 case MCExpr::Unary:
236 fixSymbolsInTLSFixups(cast<MCUnaryExpr>(expr)->getSubExpr());
237 break;
238 }
239}
240
242 llvm_unreachable("Generic Wasm doesn't support this directive");
243}
244
245void MCWasmStreamer::emitSymbolDesc(MCSymbol *Symbol, unsigned DescValue) {
246 llvm_unreachable("Wasm doesn't support this directive");
247}
248
250 uint64_t Size, Align ByteAlignment,
251 SMLoc Loc) {
252 llvm_unreachable("Wasm doesn't support this directive");
253}
254
256 uint64_t Size, Align ByteAlignment) {
257 llvm_unreachable("Wasm doesn't support this directive");
258}
259
261 std::unique_ptr<MCAsmBackend> &&MAB,
262 std::unique_ptr<MCObjectWriter> &&OW,
263 std::unique_ptr<MCCodeEmitter> &&CE) {
264 MCWasmStreamer *S =
265 new MCWasmStreamer(Context, std::move(MAB), std::move(OW), std::move(CE));
266 return S;
267}
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:493
const MCExpr * getLHS() const
Get the left-hand side expression of the binary operator.
Definition: MCExpr.h:640
const MCExpr * getRHS() const
Get the right-hand side expression of the binary operator.
Definition: MCExpr.h:643
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:185
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:411
MCContext & getContext() const
Definition: MCStreamer.h:300
MCSection * getCurrentSectionOnly() const
Definition: MCStreamer.h:400
Generic base class for all target subtargets.
Represent a reference to a symbol from inside an expression.
Definition: MCExpr.h:192
const MCSymbol & getSymbol() const
Definition: MCExpr.h:411
static const MCSymbolRefExpr * create(const MCSymbol *Symbol, MCContext &Ctx)
Definition: MCExpr.h:398
VariantKind getKind() const
Definition: MCExpr.h:413
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:1196
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:51
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:216
@ WASM_SEG_FLAG_TLS
Definition: Wasm.h:226
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