LLVM 19.0.0git
MCAsmBackend.cpp
Go to the documentation of this file.
1//===- MCAsmBackend.cpp - Target MC Assembly Backend ----------------------===//
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
10#include "llvm/MC/MCAssembler.h"
21#include <cassert>
22#include <cstddef>
23#include <cstdint>
24
25using namespace llvm;
26
27MCAsmBackend::MCAsmBackend(llvm::endianness Endian, unsigned RelaxFixupKind)
28 : Endian(Endian), RelaxFixupKind(RelaxFixupKind) {}
29
31
32std::unique_ptr<MCObjectWriter>
34 auto TW = createObjectTargetWriter();
35 switch (TW->getFormat()) {
36 case Triple::ELF:
37 return createELFObjectWriter(cast<MCELFObjectTargetWriter>(std::move(TW)),
39 case Triple::MachO:
40 return createMachObjectWriter(cast<MCMachObjectTargetWriter>(std::move(TW)),
42 case Triple::COFF:
44 cast<MCWinCOFFObjectTargetWriter>(std::move(TW)), OS);
45 case Triple::SPIRV:
47 cast<MCSPIRVObjectTargetWriter>(std::move(TW)), OS);
48 case Triple::Wasm:
49 return createWasmObjectWriter(cast<MCWasmObjectTargetWriter>(std::move(TW)),
50 OS);
51 case Triple::GOFF:
52 return createGOFFObjectWriter(cast<MCGOFFObjectTargetWriter>(std::move(TW)),
53 OS);
54 case Triple::XCOFF:
56 cast<MCXCOFFObjectTargetWriter>(std::move(TW)), OS);
59 cast<MCDXContainerTargetWriter>(std::move(TW)), OS);
60 default:
61 llvm_unreachable("unexpected object format");
62 }
63}
64
65std::unique_ptr<MCObjectWriter>
67 raw_pwrite_stream &DwoOS) const {
68 auto TW = createObjectTargetWriter();
69 switch (TW->getFormat()) {
70 case Triple::COFF:
72 cast<MCWinCOFFObjectTargetWriter>(std::move(TW)), OS, DwoOS);
73 case Triple::ELF:
75 cast<MCELFObjectTargetWriter>(std::move(TW)), OS, DwoOS,
77 case Triple::Wasm:
79 cast<MCWasmObjectTargetWriter>(std::move(TW)), OS, DwoOS);
80 default:
81 report_fatal_error("dwo only supported with COFF, ELF, and Wasm");
82 }
83}
84
85std::optional<MCFixupKind> MCAsmBackend::getFixupKind(StringRef Name) const {
86 return std::nullopt;
87}
88
90 static const MCFixupKindInfo Builtins[] = {
91 {"FK_NONE", 0, 0, 0},
92 {"FK_Data_1", 0, 8, 0},
93 {"FK_Data_2", 0, 16, 0},
94 {"FK_Data_4", 0, 32, 0},
95 {"FK_Data_8", 0, 64, 0},
96 {"FK_Data_leb128", 0, 0, 0},
97 {"FK_PCRel_1", 0, 8, MCFixupKindInfo::FKF_IsPCRel},
98 {"FK_PCRel_2", 0, 16, MCFixupKindInfo::FKF_IsPCRel},
99 {"FK_PCRel_4", 0, 32, MCFixupKindInfo::FKF_IsPCRel},
100 {"FK_PCRel_8", 0, 64, MCFixupKindInfo::FKF_IsPCRel},
101 {"FK_GPRel_1", 0, 8, 0},
102 {"FK_GPRel_2", 0, 16, 0},
103 {"FK_GPRel_4", 0, 32, 0},
104 {"FK_GPRel_8", 0, 64, 0},
105 {"FK_DTPRel_4", 0, 32, 0},
106 {"FK_DTPRel_8", 0, 64, 0},
107 {"FK_TPRel_4", 0, 32, 0},
108 {"FK_TPRel_8", 0, 64, 0},
109 {"FK_SecRel_1", 0, 8, 0},
110 {"FK_SecRel_2", 0, 16, 0},
111 {"FK_SecRel_4", 0, 32, 0},
112 {"FK_SecRel_8", 0, 64, 0},
113 };
114
115 assert((size_t)Kind <= std::size(Builtins) && "Unknown fixup kind");
116 return Builtins[Kind];
117}
118
120 const MCFixup &Fixup,
121 bool Resolved, uint64_t Value,
122 const MCRelaxableFragment *DF,
123 const bool WasForced) const {
124 if (!Resolved)
125 return true;
127}
128
130 // Consider a NULL personality (ie., no personality encoding) to be canonical
131 // because it's always at 0.
132 if (!Sym)
133 return true;
134
135 if (!Sym->isMachO())
136 llvm_unreachable("Expected MachO symbols only");
137
138 StringRef name = Sym->getName();
139 // XXX: We intentionally leave out "___gcc_personality_v0" because, despite
140 // being system-defined like these two, it is not very commonly-used.
141 // Reserving an empty slot for it seems silly.
142 return name == "___gxx_personality_v0" || name == "___objc_personality_v0";
143}
static RegisterPass< DebugifyFunctionPass > DF("debugify-function", "Attach debug info to a function")
std::string Name
Symbol * Sym
Definition: ELF_riscv.cpp:479
PowerPC TLS Dynamic Call Fixup
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
static const char * name
Definition: SMEABIPass.cpp:50
endianness Endian
raw_pwrite_stream & OS
std::unique_ptr< MCObjectWriter > createObjectWriter(raw_pwrite_stream &OS) const
Create a new MCObjectWriter instance for use by the assembler backend to emit the final object file.
std::unique_ptr< MCObjectWriter > createDwoObjectWriter(raw_pwrite_stream &OS, raw_pwrite_stream &DwoOS) const
Create an MCObjectWriter that writes two object files: a .o file which is linked into the final progr...
const llvm::endianness Endian
Definition: MCAsmBackend.h:51
MCAsmBackend(llvm::endianness Endian, unsigned RelaxFixupKind=MaxFixupKind)
virtual bool fixupNeedsRelaxationAdvanced(const MCAssembler &Asm, const MCFixup &Fixup, bool Resolved, uint64_t Value, const MCRelaxableFragment *DF, const bool WasForced) const
Target specific predicate for whether a given fixup requires the associated instruction to be relaxed...
virtual bool fixupNeedsRelaxation(const MCFixup &Fixup, uint64_t Value) const
Simple predicate for targets where !Resolved implies requiring relaxation.
Definition: MCAsmBackend.h:167
bool isDarwinCanonicalPersonality(const MCSymbol *Sym) const
virtual std::unique_ptr< MCObjectTargetWriter > createObjectTargetWriter() const =0
virtual const MCFixupKindInfo & getFixupKindInfo(MCFixupKind Kind) const
Get information on a fixup kind.
virtual std::optional< MCFixupKind > getFixupKind(StringRef Name) const
Map a relocation name used in .reloc to a fixup kind.
virtual ~MCAsmBackend()
Encode information on a single operation to perform on a byte sequence (e.g., an encoded instruction)...
Definition: MCFixup.h:71
A relaxable fragment holds on to its MCInst, since it may need to be relaxed during the assembler lay...
Definition: MCFragment.h:261
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:41
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
@ DXContainer
Definition: Triple.h:301
LLVM Value Representation.
Definition: Value.h:74
An abstract base class for streams implementations that also support a pwrite operation.
Definition: raw_ostream.h:434
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
std::unique_ptr< MCObjectWriter > createGOFFObjectWriter(std::unique_ptr< MCGOFFObjectTargetWriter > MOTW, raw_pwrite_stream &OS)
Construct a new GOFF writer instance.
std::unique_ptr< MCObjectWriter > createELFObjectWriter(std::unique_ptr< MCELFObjectTargetWriter > MOTW, raw_pwrite_stream &OS, bool IsLittleEndian)
Construct a new ELF writer instance.
std::unique_ptr< MCObjectWriter > createMachObjectWriter(std::unique_ptr< MCMachObjectTargetWriter > MOTW, raw_pwrite_stream &OS, bool IsLittleEndian)
Construct a new Mach-O writer instance.
std::unique_ptr< MCObjectWriter > createDXContainerObjectWriter(std::unique_ptr< MCDXContainerTargetWriter > MOTW, raw_pwrite_stream &OS)
Construct a new DXContainer writer instance.
std::unique_ptr< MCObjectWriter > createELFDwoObjectWriter(std::unique_ptr< MCELFObjectTargetWriter > MOTW, raw_pwrite_stream &OS, raw_pwrite_stream &DwoOS, bool IsLittleEndian)
std::unique_ptr< MCObjectWriter > createWasmObjectWriter(std::unique_ptr< MCWasmObjectTargetWriter > MOTW, raw_pwrite_stream &OS)
Construct a new Wasm writer instance.
void report_fatal_error(Error Err, bool gen_crash_diag=true)
Report a serious error, calling any installed error handler.
Definition: Error.cpp:167
std::unique_ptr< MCObjectWriter > createWinCOFFDwoObjectWriter(std::unique_ptr< MCWinCOFFObjectTargetWriter > MOTW, raw_pwrite_stream &OS, raw_pwrite_stream &DwoOS)
MCFixupKind
Extensible enumeration to represent the type of a fixup.
Definition: MCFixup.h:21
std::unique_ptr< MCObjectWriter > createWinCOFFObjectWriter(std::unique_ptr< MCWinCOFFObjectTargetWriter > MOTW, raw_pwrite_stream &OS)
Construct a new Win COFF writer instance.
std::unique_ptr< MCObjectWriter > createSPIRVObjectWriter(std::unique_ptr< MCSPIRVObjectTargetWriter > MOTW, raw_pwrite_stream &OS)
Construct a new SPIR-V writer instance.
endianness
Definition: bit.h:70
std::unique_ptr< MCObjectWriter > createXCOFFObjectWriter(std::unique_ptr< MCXCOFFObjectTargetWriter > MOTW, raw_pwrite_stream &OS)
std::unique_ptr< MCObjectWriter > createWasmDwoObjectWriter(std::unique_ptr< MCWasmObjectTargetWriter > MOTW, raw_pwrite_stream &OS, raw_pwrite_stream &DwoOS)
Target independent information on a fixup kind.
@ FKF_IsPCRel
Is this fixup kind PCrelative? This is used by the assembler backend to evaluate fixup values in a ta...