LLVM 19.0.0git
DwarfCFIException.cpp
Go to the documentation of this file.
1//===-- CodeGen/AsmPrinter/DwarfException.cpp - Dwarf Exception Impl ------===//
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 contains support for writing DWARF exception info into asm files.
10//
11//===----------------------------------------------------------------------===//
12
13#include "DwarfException.h"
18#include "llvm/MC/MCAsmInfo.h"
19#include "llvm/MC/MCContext.h"
20#include "llvm/MC/MCStreamer.h"
24using namespace llvm;
25
27
29
30void DwarfCFIException::addPersonality(const GlobalValue *Personality) {
31 if (!llvm::is_contained(Personalities, Personality))
32 Personalities.push_back(Personality);
33}
34
35/// endModule - Emit all exception information that should come after the
36/// content.
38 // SjLj uses this pass and it doesn't need this info.
39 if (!Asm->MAI->usesCFIForEH())
40 return;
41
43
44 unsigned PerEncoding = TLOF.getPersonalityEncoding();
45
46 if ((PerEncoding & 0x80) != dwarf::DW_EH_PE_indirect)
47 return;
48
49 // Emit indirect reference table for all used personality functions
50 for (const GlobalValue *Personality : Personalities) {
51 MCSymbol *Sym = Asm->getSymbol(Personality);
53 }
54 Personalities.clear();
55}
56
58 shouldEmitPersonality = shouldEmitLSDA = false;
59 const Function &F = MF->getFunction();
60
61 // If any landing pads survive, we need an EH table.
62 bool hasLandingPads = !MF->getLandingPads().empty();
63
64 // See if we need frame move info.
65 bool shouldEmitMoves =
67
69 unsigned PerEncoding = TLOF.getPersonalityEncoding();
70 const GlobalValue *Per = nullptr;
71 if (F.hasPersonalityFn())
72 Per = dyn_cast<GlobalValue>(F.getPersonalityFn()->stripPointerCasts());
73
74 // Emit a personality function even when there are no landing pads
75 forceEmitPersonality =
76 // ...if a personality function is explicitly specified
77 F.hasPersonalityFn() &&
78 // ... and it's not known to be a noop in the absence of invokes
80 // ... and we're not explicitly asked not to emit it
81 F.needsUnwindTableEntry();
82
83 shouldEmitPersonality =
84 (forceEmitPersonality ||
85 (hasLandingPads && PerEncoding != dwarf::DW_EH_PE_omit)) &&
86 Per;
87
88 unsigned LSDAEncoding = TLOF.getLSDAEncoding();
89 shouldEmitLSDA = shouldEmitPersonality &&
90 LSDAEncoding != dwarf::DW_EH_PE_omit;
91
92 const MCAsmInfo &MAI = *MF->getMMI().getContext().getAsmInfo();
94 shouldEmitCFI =
95 MAI.usesCFIForEH() && (shouldEmitPersonality || shouldEmitMoves);
96 else
97 shouldEmitCFI = Asm->usesCFIWithoutEH() && shouldEmitMoves;
98}
99
101 if (!shouldEmitCFI)
102 return;
103
104 if (!hasEmittedCFISections) {
106 // If we don't say anything it implies `.cfi_sections .eh_frame`, so we
107 // chose not to be verbose in that case. And with `ForceDwarfFrameSection`,
108 // we should always emit .debug_frame.
109 if (CFISecType == AsmPrinter::CFISection::Debug ||
111 Asm->OutStreamer->emitCFISections(
112 CFISecType == AsmPrinter::CFISection::EH, true);
113 hasEmittedCFISections = true;
114 }
115
116 Asm->OutStreamer->emitCFIStartProc(/*IsSimple=*/false);
117
118 // Indicate personality routine, if any.
119 if (!shouldEmitPersonality)
120 return;
121
122 auto &F = MBB.getParent()->getFunction();
123 auto *P = dyn_cast<GlobalValue>(F.getPersonalityFn()->stripPointerCasts());
124 assert(P && "Expected personality function");
125 // Record the personality function.
126 addPersonality(P);
127
129 unsigned PerEncoding = TLOF.getPersonalityEncoding();
130 const MCSymbol *Sym = TLOF.getCFIPersonalitySymbol(P, Asm->TM, MMI);
131 Asm->OutStreamer->emitCFIPersonality(Sym, PerEncoding);
132
133 // Provide LSDA information.
134 if (shouldEmitLSDA)
135 Asm->OutStreamer->emitCFILsda(Asm->getMBBExceptionSym(MBB),
136 TLOF.getLSDAEncoding());
137}
138
140 if (shouldEmitCFI)
141 Asm->OutStreamer->emitCFIEndProc();
142}
143
144/// endFunction - Gather and emit post-function exception information.
145///
147 if (!shouldEmitPersonality)
148 return;
149
151}
MachineBasicBlock & MBB
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
This file contains constants used for implementing Dwarf debug support.
Symbol * Sym
Definition: ELF_riscv.cpp:479
#define F(x, y, z)
Definition: MD5.cpp:55
#define P(N)
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
This class is intended to be used as a driving class for all asm writers.
Definition: AsmPrinter.h:84
const TargetLoweringObjectFile & getObjFileLowering() const
Return information about object file lowering.
Definition: AsmPrinter.cpp:398
MCSymbol * getSymbol(const GlobalValue *GV) const
Definition: AsmPrinter.cpp:700
CFISection getModuleCFISectionType() const
Get the CFISection type for the module.
Definition: AsmPrinter.h:442
TargetMachine & TM
Target machine description.
Definition: AsmPrinter.h:87
MCSymbol * getMBBExceptionSym(const MachineBasicBlock &MBB)
const MCAsmInfo * MAI
Target Asm Printer information.
Definition: AsmPrinter.h:90
CFISection getFunctionCFISectionType(const Function &F) const
Get the CFISection type for a function.
std::unique_ptr< MCStreamer > OutStreamer
This is the MCStreamer object for the file we are generating.
Definition: AsmPrinter.h:99
const DataLayout & getDataLayout() const
Return information about data layout.
Definition: AsmPrinter.cpp:402
bool usesCFIWithoutEH() const
Since emitting CFI unwind information is entangled with supporting the exceptions,...
@ None
Do not emit either .eh_frame or .debug_frame.
@ Debug
Emit .debug_frame.
void endBasicBlockSection(const MachineBasicBlock &MBB) override
Process the end of a basic-block-section within a function.
~DwarfCFIException() override
void beginBasicBlockSection(const MachineBasicBlock &MBB) override
Process the beginning of a new basic-block-section within a function.
void endFunction(const MachineFunction *) override
Gather and emit post-function exception information.
void endModule() override
Emit all exception information that should come after the content.
DwarfCFIException(AsmPrinter *A)
void beginFunction(const MachineFunction *MF) override
Gather pre-function exception information.
Emits exception handling directives.
Definition: EHStreamer.h:30
AsmPrinter * Asm
Target of directive emission.
Definition: EHStreamer.h:33
MCSymbol * emitExceptionTable()
Emit landing pads and actions.
Definition: EHStreamer.cpp:380
MachineModuleInfo * MMI
Collected machine module information.
Definition: EHStreamer.h:36
This class is intended to be used as a base class for asm properties and features specific to the tar...
Definition: MCAsmInfo.h:56
bool usesCFIForEH() const
Returns true if the exception handling method for the platform uses call frame information to unwind.
Definition: MCAsmInfo.h:793
ExceptionHandling getExceptionHandlingType() const
Definition: MCAsmInfo.h:780
const MCAsmInfo * getAsmInfo() const
Definition: MCContext.h:446
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:40
const MachineFunction * getParent() const
Return the MachineFunction containing this basic block.
Function & getFunction()
Return the LLVM function that this machine code represents.
const std::vector< LandingPadInfo > & getLandingPads() const
Return a reference to the landing pad info for the current function.
MachineModuleInfo & getMMI() const
const MCContext & getContext() const
virtual void emitPersonalityValue(MCStreamer &Streamer, const DataLayout &TM, const MCSymbol *Sym) const
virtual MCSymbol * getCFIPersonalitySymbol(const GlobalValue *GV, const TargetMachine &TM, MachineModuleInfo *MMI) const
TargetOptions Options
unsigned ForceDwarfFrameSection
Emit DWARF debug frame section.
@ DW_EH_PE_indirect
Definition: Dwarf.h:539
@ DW_EH_PE_omit
Definition: Dwarf.h:524
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
@ None
No exception support.
bool isNoOpWithoutInvoke(EHPersonality Pers)
Return true if this personality may be safely removed if there are no invoke instructions remaining i...
EHPersonality classifyEHPersonality(const Value *Pers)
See if the given exception handling personality function is one that we understand.
bool is_contained(R &&Range, const E &Element)
Returns true if Element is found in Range.
Definition: STLExtras.h:1888