LLVM 18.0.0git
MCDwarf.h
Go to the documentation of this file.
1//===- MCDwarf.h - Machine Code Dwarf support -------------------*- C++ -*-===//
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 the declaration of the MCDwarfFile to support the dwarf
10// .file directive and the .loc directive.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef LLVM_MC_MCDWARF_H
15#define LLVM_MC_MCDWARF_H
16
17#include "llvm/ADT/MapVector.h"
19#include "llvm/ADT/StringMap.h"
20#include "llvm/ADT/StringRef.h"
22#include "llvm/Support/Error.h"
23#include "llvm/Support/MD5.h"
24#include "llvm/Support/SMLoc.h"
26#include <cassert>
27#include <cstdint>
28#include <optional>
29#include <string>
30#include <utility>
31#include <vector>
32
33namespace llvm {
34
35template <typename T> class ArrayRef;
36class MCAsmBackend;
37class MCContext;
38class MCObjectStreamer;
39class MCSection;
40class MCStreamer;
41class MCSymbol;
42class raw_ostream;
43class SourceMgr;
44
45namespace mcdwarf {
46// Emit the common part of the DWARF 5 range/locations list tables header.
48} // namespace mcdwarf
49
50/// Manage the .debug_line_str section contents, if we use it.
52 BumpPtrAllocator Alloc;
53 StringSaver Saver{Alloc};
54 MCSymbol *LineStrLabel = nullptr;
56 bool UseRelocs = false;
57
58public:
59 /// Construct an instance that can emit .debug_line_str (for use in a normal
60 /// v5 line table).
61 explicit MCDwarfLineStr(MCContext &Ctx);
62
63 StringSaver &getSaver() { return Saver; }
64
65 /// Emit a reference to the string.
66 void emitRef(MCStreamer *MCOS, StringRef Path);
67
68 /// Emit the .debug_line_str section if appropriate.
69 void emitSection(MCStreamer *MCOS);
70
71 /// Returns finalized section.
73
74 /// Adds path \p Path to the line string. Returns offset in the
75 /// .debug_line_str section.
76 size_t addString(StringRef Path);
77};
78
79/// Instances of this class represent the name of the dwarf .file directive and
80/// its associated dwarf file number in the MC file. MCDwarfFile's are created
81/// and uniqued by the MCContext class. In Dwarf 4 file numbers start from 1;
82/// i.e. the entry with file number 1 is the first element in the vector of
83/// DwarfFiles and there is no MCDwarfFile with file number 0. In Dwarf 5 file
84/// numbers start from 0, with the MCDwarfFile with file number 0 being the
85/// primary source file, and file numbers correspond to their index in the
86/// vector.
88 // The base name of the file without its directory path.
89 std::string Name;
90
91 // The index into the list of directory names for this file name.
92 unsigned DirIndex = 0;
93
94 /// The MD5 checksum, if there is one. Non-owning pointer to data allocated
95 /// in MCContext.
96 std::optional<MD5::MD5Result> Checksum;
97
98 /// The source code of the file. Non-owning reference to data allocated in
99 /// MCContext.
100 std::optional<StringRef> Source;
101};
102
103/// Instances of this class represent the information from a
104/// dwarf .loc directive.
106 uint32_t FileNum;
107 uint32_t Line;
108 uint16_t Column;
109 // Flags (see #define's below)
110 uint8_t Flags;
111 uint8_t Isa;
112 uint32_t Discriminator;
113
114// Flag that indicates the initial value of the is_stmt_start flag.
115#define DWARF2_LINE_DEFAULT_IS_STMT 1
116
117#define DWARF2_FLAG_IS_STMT (1 << 0)
118#define DWARF2_FLAG_BASIC_BLOCK (1 << 1)
119#define DWARF2_FLAG_PROLOGUE_END (1 << 2)
120#define DWARF2_FLAG_EPILOGUE_BEGIN (1 << 3)
121
122private: // MCContext manages these
123 friend class MCContext;
124 friend class MCDwarfLineEntry;
125
126 MCDwarfLoc(unsigned fileNum, unsigned line, unsigned column, unsigned flags,
127 unsigned isa, unsigned discriminator)
128 : FileNum(fileNum), Line(line), Column(column), Flags(flags), Isa(isa),
129 Discriminator(discriminator) {}
130
131 // Allow the default copy constructor and assignment operator to be used
132 // for an MCDwarfLoc object.
133
134public:
135 /// Get the FileNum of this MCDwarfLoc.
136 unsigned getFileNum() const { return FileNum; }
137
138 /// Get the Line of this MCDwarfLoc.
139 unsigned getLine() const { return Line; }
140
141 /// Get the Column of this MCDwarfLoc.
142 unsigned getColumn() const { return Column; }
143
144 /// Get the Flags of this MCDwarfLoc.
145 unsigned getFlags() const { return Flags; }
146
147 /// Get the Isa of this MCDwarfLoc.
148 unsigned getIsa() const { return Isa; }
149
150 /// Get the Discriminator of this MCDwarfLoc.
151 unsigned getDiscriminator() const { return Discriminator; }
152
153 /// Set the FileNum of this MCDwarfLoc.
154 void setFileNum(unsigned fileNum) { FileNum = fileNum; }
155
156 /// Set the Line of this MCDwarfLoc.
157 void setLine(unsigned line) { Line = line; }
158
159 /// Set the Column of this MCDwarfLoc.
160 void setColumn(unsigned column) {
161 assert(column <= UINT16_MAX);
162 Column = column;
163 }
164
165 /// Set the Flags of this MCDwarfLoc.
166 void setFlags(unsigned flags) {
167 assert(flags <= UINT8_MAX);
168 Flags = flags;
169 }
170
171 /// Set the Isa of this MCDwarfLoc.
172 void setIsa(unsigned isa) {
173 assert(isa <= UINT8_MAX);
174 Isa = isa;
175 }
176
177 /// Set the Discriminator of this MCDwarfLoc.
178 void setDiscriminator(unsigned discriminator) {
179 Discriminator = discriminator;
180 }
181};
182
183/// Instances of this class represent the line information for
184/// the dwarf line table entries. Which is created after a machine
185/// instruction is assembled and uses an address from a temporary label
186/// created at the current address in the current section and the info from
187/// the last .loc directive seen as stored in the context.
189 MCSymbol *Label;
190
191private:
192 // Allow the default copy constructor and assignment operator to be used
193 // for an MCDwarfLineEntry object.
194
195public:
196 // Constructor to create an MCDwarfLineEntry given a symbol and the dwarf loc.
198 : MCDwarfLoc(loc), Label(label) {}
199
200 MCSymbol *getLabel() const { return Label; }
201
202 // This indicates the line entry is synthesized for an end entry.
203 bool IsEndEntry = false;
204
205 // Override the label with the given EndLabel.
206 void setEndLabel(MCSymbol *EndLabel) {
207 Label = EndLabel;
208 IsEndEntry = true;
209 }
210
211 // This is called when an instruction is assembled into the specified
212 // section and if there is information from the last .loc directive that
213 // has yet to have a line entry made for it is made.
214 static void make(MCStreamer *MCOS, MCSection *Section);
215};
216
217/// Instances of this class represent the line information for a compile
218/// unit where machine instructions have been assembled after seeing .loc
219/// directives. This is the information used to build the dwarf line
220/// table for a section.
222public:
223 // Add an entry to this MCLineSection's line entries.
224 void addLineEntry(const MCDwarfLineEntry &LineEntry, MCSection *Sec) {
225 MCLineDivisions[Sec].push_back(LineEntry);
226 }
227
228 // Add an end entry by cloning the last entry, if exists, for the section
229 // the given EndLabel belongs to. The label is replaced by the given EndLabel.
230 void addEndEntry(MCSymbol *EndLabel);
231
232 using MCDwarfLineEntryCollection = std::vector<MCDwarfLineEntry>;
233 using iterator = MCDwarfLineEntryCollection::iterator;
234 using const_iterator = MCDwarfLineEntryCollection::const_iterator;
236
237private:
238 // A collection of MCDwarfLineEntry for each section.
239 MCLineDivisionMap MCLineDivisions;
240
241public:
242 // Returns the collection of MCDwarfLineEntry for a given Compile Unit ID.
244 return MCLineDivisions;
245 }
246};
247
249 /// First special line opcode - leave room for the standard opcodes.
250 /// Note: If you want to change this, you'll have to update the
251 /// "StandardOpcodeLengths" table that is emitted in
252 /// \c Emit().
254 /// Minimum line offset in a special line info. opcode. The value
255 /// -5 was chosen to give a reasonable range of values.
256 int8_t DWARF2LineBase = -5;
257 /// Range of line offsets in a special line info. opcode.
258 uint8_t DWARF2LineRange = 14;
259};
260
262 MCSymbol *Label = nullptr;
266 std::string CompilationDir;
268 bool HasSource = false;
269private:
270 bool HasAllMD5 = true;
271 bool HasAnyMD5 = false;
272
273public:
275
276 Expected<unsigned> tryGetFile(StringRef &Directory, StringRef &FileName,
277 std::optional<MD5::MD5Result> Checksum,
278 std::optional<StringRef> Source,
279 uint16_t DwarfVersion, unsigned FileNumber = 0);
280 std::pair<MCSymbol *, MCSymbol *>
282 std::optional<MCDwarfLineStr> &LineStr) const;
283 std::pair<MCSymbol *, MCSymbol *>
285 ArrayRef<char> SpecialOpcodeLengths,
286 std::optional<MCDwarfLineStr> &LineStr) const;
288 HasAllMD5 = true;
289 HasAnyMD5 = false;
290 }
291 void trackMD5Usage(bool MD5Used) {
292 HasAllMD5 &= MD5Used;
293 HasAnyMD5 |= MD5Used;
294 }
295 bool isMD5UsageConsistent() const {
296 return MCDwarfFiles.empty() || (HasAllMD5 == HasAnyMD5);
297 }
298
299 void setRootFile(StringRef Directory, StringRef FileName,
300 std::optional<MD5::MD5Result> Checksum,
301 std::optional<StringRef> Source) {
302 CompilationDir = std::string(Directory);
303 RootFile.Name = std::string(FileName);
304 RootFile.DirIndex = 0;
305 RootFile.Checksum = Checksum;
306 RootFile.Source = Source;
307 trackMD5Usage(Checksum.has_value());
308 HasSource = Source.has_value();
309 }
310
313 MCDwarfFiles.clear();
314 RootFile.Name.clear();
316 HasSource = false;
317 }
318
319private:
320 void emitV2FileDirTables(MCStreamer *MCOS) const;
321 void emitV5FileDirTables(MCStreamer *MCOS,
322 std::optional<MCDwarfLineStr> &LineStr) const;
323};
324
327 bool HasSplitLineTable = false;
328
329public:
330 void maybeSetRootFile(StringRef Directory, StringRef FileName,
331 std::optional<MD5::MD5Result> Checksum,
332 std::optional<StringRef> Source) {
333 if (!Header.RootFile.Name.empty())
334 return;
335 Header.setRootFile(Directory, FileName, Checksum, Source);
336 }
337
338 unsigned getFile(StringRef Directory, StringRef FileName,
339 std::optional<MD5::MD5Result> Checksum,
340 uint16_t DwarfVersion, std::optional<StringRef> Source) {
341 HasSplitLineTable = true;
342 return cantFail(Header.tryGetFile(Directory, FileName, Checksum, Source,
343 DwarfVersion));
344 }
345
346 void Emit(MCStreamer &MCOS, MCDwarfLineTableParams Params,
347 MCSection *Section) const;
348};
349
352 MCLineSection MCLineSections;
353
354public:
355 // This emits the Dwarf file and the line tables for all Compile Units.
356 static void emit(MCStreamer *MCOS, MCDwarfLineTableParams Params);
357
358 // This emits the Dwarf file and the line tables for a given Compile Unit.
359 void emitCU(MCStreamer *MCOS, MCDwarfLineTableParams Params,
360 std::optional<MCDwarfLineStr> &LineStr) const;
361
362 // This emits a single line table associated with a given Section.
363 static void
364 emitOne(MCStreamer *MCOS, MCSection *Section,
366
367 Expected<unsigned> tryGetFile(StringRef &Directory, StringRef &FileName,
368 std::optional<MD5::MD5Result> Checksum,
369 std::optional<StringRef> Source,
370 uint16_t DwarfVersion, unsigned FileNumber = 0);
371 unsigned getFile(StringRef &Directory, StringRef &FileName,
372 std::optional<MD5::MD5Result> Checksum,
373 std::optional<StringRef> Source, uint16_t DwarfVersion,
374 unsigned FileNumber = 0) {
375 return cantFail(tryGetFile(Directory, FileName, Checksum, Source,
376 DwarfVersion, FileNumber));
377 }
378
379 void setRootFile(StringRef Directory, StringRef FileName,
380 std::optional<MD5::MD5Result> Checksum,
381 std::optional<StringRef> Source) {
382 Header.CompilationDir = std::string(Directory);
383 Header.RootFile.Name = std::string(FileName);
384 Header.RootFile.DirIndex = 0;
385 Header.RootFile.Checksum = Checksum;
386 Header.RootFile.Source = Source;
387 Header.trackMD5Usage(Checksum.has_value());
388 Header.HasSource = Source.has_value();
389 }
390
391 void resetFileTable() { Header.resetFileTable(); }
392
393 bool hasRootFile() const { return !Header.RootFile.Name.empty(); }
394
395 MCDwarfFile &getRootFile() { return Header.RootFile; }
396 const MCDwarfFile &getRootFile() const { return Header.RootFile; }
397
398 // Report whether MD5 usage has been consistent (all-or-none).
399 bool isMD5UsageConsistent() const { return Header.isMD5UsageConsistent(); }
400
402 return Header.Label;
403 }
404
405 void setLabel(MCSymbol *Label) {
406 Header.Label = Label;
407 }
408
410 return Header.MCDwarfDirs;
411 }
412
414 return Header.MCDwarfDirs;
415 }
416
418 return Header.MCDwarfFiles;
419 }
420
422 return Header.MCDwarfFiles;
423 }
424
426 return MCLineSections;
427 }
429 return MCLineSections;
430 }
431};
432
434public:
435 /// Utility function to encode a Dwarf pair of LineDelta and AddrDeltas.
436 static void encode(MCContext &Context, MCDwarfLineTableParams Params,
437 int64_t LineDelta, uint64_t AddrDelta, SmallVectorImpl<char> &OS);
438
439 /// Utility function to emit the encoding to a streamer.
440 static void Emit(MCStreamer *MCOS, MCDwarfLineTableParams Params,
441 int64_t LineDelta, uint64_t AddrDelta);
442};
443
445public:
446 //
447 // When generating dwarf for assembly source files this emits the Dwarf
448 // sections.
449 //
450 static void Emit(MCStreamer *MCOS);
451};
452
453// When generating dwarf for assembly source files this is the info that is
454// needed to be gathered for each symbol that will have a dwarf label.
456private:
457 // Name of the symbol without a leading underbar, if any.
458 StringRef Name;
459 // The dwarf file number this symbol is in.
460 unsigned FileNumber;
461 // The line number this symbol is at.
462 unsigned LineNumber;
463 // The low_pc for the dwarf label is taken from this symbol.
464 MCSymbol *Label;
465
466public:
467 MCGenDwarfLabelEntry(StringRef name, unsigned fileNumber, unsigned lineNumber,
468 MCSymbol *label)
469 : Name(name), FileNumber(fileNumber), LineNumber(lineNumber),
470 Label(label) {}
471
472 StringRef getName() const { return Name; }
473 unsigned getFileNumber() const { return FileNumber; }
474 unsigned getLineNumber() const { return LineNumber; }
475 MCSymbol *getLabel() const { return Label; }
476
477 // This is called when label is created when we are generating dwarf for
478 // assembly source files.
479 static void Make(MCSymbol *Symbol, MCStreamer *MCOS, SourceMgr &SrcMgr,
480 SMLoc &Loc);
481};
482
484public:
485 enum OpType {
503 };
504
505private:
506 OpType Operation;
507 MCSymbol *Label;
508 unsigned Register;
509 union {
511 unsigned Register2;
512 };
513 unsigned AddressSpace = ~0u;
514 SMLoc Loc;
515 std::vector<char> Values;
516 std::string Comment;
517
518 MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R, int O, SMLoc Loc,
519 StringRef V = "", StringRef Comment = "")
520 : Operation(Op), Label(L), Register(R), Offset(O), Loc(Loc),
521 Values(V.begin(), V.end()), Comment(Comment) {
523 }
524
525 MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R1, unsigned R2, SMLoc Loc)
526 : Operation(Op), Label(L), Register(R1), Register2(R2), Loc(Loc) {
527 assert(Op == OpRegister);
528 }
529
530 MCCFIInstruction(OpType Op, MCSymbol *L, unsigned R, int O, unsigned AS,
531 SMLoc Loc)
533 Loc(Loc) {
535 }
536
537public:
538 /// .cfi_def_cfa defines a rule for computing CFA as: take address from
539 /// Register and add Offset to it.
541 SMLoc Loc = {}) {
542 return MCCFIInstruction(OpDefCfa, L, Register, Offset, Loc);
543 }
544
545 /// .cfi_def_cfa_register modifies a rule for computing CFA. From now
546 /// on Register will be used instead of the old one. Offset remains the same.
548 SMLoc Loc = {}) {
549 return MCCFIInstruction(OpDefCfaRegister, L, Register, 0, Loc);
550 }
551
552 /// .cfi_def_cfa_offset modifies a rule for computing CFA. Register
553 /// remains the same, but offset is new. Note that it is the absolute offset
554 /// that will be added to a defined register to the compute CFA address.
556 SMLoc Loc = {}) {
557 return MCCFIInstruction(OpDefCfaOffset, L, 0, Offset, Loc);
558 }
559
560 /// .cfi_adjust_cfa_offset Same as .cfi_def_cfa_offset, but
561 /// Offset is a relative value that is added/subtracted from the previous
562 /// offset.
564 SMLoc Loc = {}) {
565 return MCCFIInstruction(OpAdjustCfaOffset, L, 0, Adjustment, Loc);
566 }
567
568 // FIXME: Update the remaining docs to use the new proposal wording.
569 /// .cfi_llvm_def_aspace_cfa defines the rule for computing the CFA to
570 /// be the result of evaluating the DWARF operation expression
571 /// `DW_OP_constu AS; DW_OP_aspace_bregx R, B` as a location description.
573 int Offset,
574 unsigned AddressSpace,
575 SMLoc Loc) {
577 AddressSpace, Loc);
578 }
579
580 /// .cfi_offset Previous value of Register is saved at offset Offset
581 /// from CFA.
583 int Offset, SMLoc Loc = {}) {
584 return MCCFIInstruction(OpOffset, L, Register, Offset, Loc);
585 }
586
587 /// .cfi_rel_offset Previous value of Register is saved at offset
588 /// Offset from the current CFA register. This is transformed to .cfi_offset
589 /// using the known displacement of the CFA register from the CFA.
591 int Offset, SMLoc Loc = {}) {
593 }
594
595 /// .cfi_register Previous value of Register1 is saved in
596 /// register Register2.
597 static MCCFIInstruction createRegister(MCSymbol *L, unsigned Register1,
598 unsigned Register2, SMLoc Loc = {}) {
599 return MCCFIInstruction(OpRegister, L, Register1, Register2, Loc);
600 }
601
602 /// .cfi_window_save SPARC register window is saved.
604 return MCCFIInstruction(OpWindowSave, L, 0, 0, Loc);
605 }
606
607 /// .cfi_negate_ra_state AArch64 negate RA state.
609 return MCCFIInstruction(OpNegateRAState, L, 0, 0, Loc);
610 }
611
612 /// .cfi_restore says that the rule for Register is now the same as it
613 /// was at the beginning of the function, after all initial instructions added
614 /// by .cfi_startproc were executed.
616 SMLoc Loc = {}) {
617 return MCCFIInstruction(OpRestore, L, Register, 0, Loc);
618 }
619
620 /// .cfi_undefined From now on the previous value of Register can't be
621 /// restored anymore.
623 SMLoc Loc = {}) {
624 return MCCFIInstruction(OpUndefined, L, Register, 0, Loc);
625 }
626
627 /// .cfi_same_value Current value of Register is the same as in the
628 /// previous frame. I.e., no restoration is needed.
630 SMLoc Loc = {}) {
631 return MCCFIInstruction(OpSameValue, L, Register, 0, Loc);
632 }
633
634 /// .cfi_remember_state Save all current rules for all registers.
636 return MCCFIInstruction(OpRememberState, L, 0, 0, Loc);
637 }
638
639 /// .cfi_restore_state Restore the previously saved state.
641 return MCCFIInstruction(OpRestoreState, L, 0, 0, Loc);
642 }
643
644 /// .cfi_escape Allows the user to add arbitrary bytes to the unwind
645 /// info.
647 SMLoc Loc = {}, StringRef Comment = "") {
648 return MCCFIInstruction(OpEscape, L, 0, 0, Loc, Vals, Comment);
649 }
650
651 /// A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE
653 SMLoc Loc = {}) {
654 return MCCFIInstruction(OpGnuArgsSize, L, 0, Size, Loc);
655 }
656
657 OpType getOperation() const { return Operation; }
658 MCSymbol *getLabel() const { return Label; }
659
660 unsigned getRegister() const {
666 return Register;
667 }
668
669 unsigned getRegister2() const {
671 return Register2;
672 }
673
674 unsigned getAddressSpace() const {
676 return AddressSpace;
677 }
678
679 int getOffset() const {
684 return Offset;
685 }
686
689 return StringRef(&Values[0], Values.size());
690 }
691
692 StringRef getComment() const { return Comment; }
693 SMLoc getLoc() const { return Loc; }
694};
695
697 MCDwarfFrameInfo() = default;
698
699 MCSymbol *Begin = nullptr;
700 MCSymbol *End = nullptr;
701 const MCSymbol *Personality = nullptr;
702 const MCSymbol *Lsda = nullptr;
703 std::vector<MCCFIInstruction> Instructions;
704 unsigned CurrentCfaRegister = 0;
706 unsigned LsdaEncoding = 0;
708 bool IsSignalFrame = false;
709 bool IsSimple = false;
710 unsigned RAReg = static_cast<unsigned>(INT_MAX);
711 bool IsBKeyFrame = false;
712 bool IsMTETaggedFrame = false;
713};
714
716public:
717 //
718 // This emits the frame info section.
719 //
720 static void Emit(MCObjectStreamer &streamer, MCAsmBackend *MAB, bool isEH);
721 static void encodeAdvanceLoc(MCContext &Context, uint64_t AddrDelta,
723};
724
725} // end namespace llvm
726
727#endif // LLVM_MC_MCDWARF_H
This file defines the StringMap class.
dxil metadata emit
dxil metadata DXIL Metadata Emit
uint64_t Size
This file implements a map that provides insertion order iteration.
#define R2(n)
LLVMContext & Context
PowerPC Reduce CR logical Operation
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
static const char * name
Definition: SMEABIPass.cpp:49
raw_pwrite_stream & OS
This file defines the SmallVector class.
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition: ArrayRef.h:41
Allocate memory in an ever growing pool, as if by bump-pointer.
Definition: Allocator.h:66
This class represents an Operation in the Expression.
Tagged union holding either a T or a Error.
Definition: Error.h:474
Generic interface to target specific assembler backends.
Definition: MCAsmBackend.h:43
static MCCFIInstruction createDefCfaRegister(MCSymbol *L, unsigned Register, SMLoc Loc={})
.cfi_def_cfa_register modifies a rule for computing CFA.
Definition: MCDwarf.h:547
static MCCFIInstruction createOffset(MCSymbol *L, unsigned Register, int Offset, SMLoc Loc={})
.cfi_offset Previous value of Register is saved at offset Offset from CFA.
Definition: MCDwarf.h:582
MCSymbol * getLabel() const
Definition: MCDwarf.h:658
static MCCFIInstruction createUndefined(MCSymbol *L, unsigned Register, SMLoc Loc={})
.cfi_undefined From now on the previous value of Register can't be restored anymore.
Definition: MCDwarf.h:622
static MCCFIInstruction cfiDefCfaOffset(MCSymbol *L, int Offset, SMLoc Loc={})
.cfi_def_cfa_offset modifies a rule for computing CFA.
Definition: MCDwarf.h:555
unsigned getAddressSpace() const
Definition: MCDwarf.h:674
static MCCFIInstruction createRelOffset(MCSymbol *L, unsigned Register, int Offset, SMLoc Loc={})
.cfi_rel_offset Previous value of Register is saved at offset Offset from the current CFA register.
Definition: MCDwarf.h:590
static MCCFIInstruction createRestore(MCSymbol *L, unsigned Register, SMLoc Loc={})
.cfi_restore says that the rule for Register is now the same as it was at the beginning of the functi...
Definition: MCDwarf.h:615
unsigned getRegister2() const
Definition: MCDwarf.h:669
unsigned getRegister() const
Definition: MCDwarf.h:660
static MCCFIInstruction createRegister(MCSymbol *L, unsigned Register1, unsigned Register2, SMLoc Loc={})
.cfi_register Previous value of Register1 is saved in register Register2.
Definition: MCDwarf.h:597
static MCCFIInstruction createLLVMDefAspaceCfa(MCSymbol *L, unsigned Register, int Offset, unsigned AddressSpace, SMLoc Loc)
.cfi_llvm_def_aspace_cfa defines the rule for computing the CFA to be the result of evaluating the DW...
Definition: MCDwarf.h:572
SMLoc getLoc() const
Definition: MCDwarf.h:693
int getOffset() const
Definition: MCDwarf.h:679
static MCCFIInstruction createNegateRAState(MCSymbol *L, SMLoc Loc={})
.cfi_negate_ra_state AArch64 negate RA state.
Definition: MCDwarf.h:608
static MCCFIInstruction createRememberState(MCSymbol *L, SMLoc Loc={})
.cfi_remember_state Save all current rules for all registers.
Definition: MCDwarf.h:635
OpType getOperation() const
Definition: MCDwarf.h:657
StringRef getComment() const
Definition: MCDwarf.h:692
static MCCFIInstruction cfiDefCfa(MCSymbol *L, unsigned Register, int Offset, SMLoc Loc={})
.cfi_def_cfa defines a rule for computing CFA as: take address from Register and add Offset to it.
Definition: MCDwarf.h:540
StringRef getValues() const
Definition: MCDwarf.h:687
static MCCFIInstruction createAdjustCfaOffset(MCSymbol *L, int Adjustment, SMLoc Loc={})
.cfi_adjust_cfa_offset Same as .cfi_def_cfa_offset, but Offset is a relative value that is added/subt...
Definition: MCDwarf.h:563
static MCCFIInstruction createEscape(MCSymbol *L, StringRef Vals, SMLoc Loc={}, StringRef Comment="")
.cfi_escape Allows the user to add arbitrary bytes to the unwind info.
Definition: MCDwarf.h:646
static MCCFIInstruction createWindowSave(MCSymbol *L, SMLoc Loc={})
.cfi_window_save SPARC register window is saved.
Definition: MCDwarf.h:603
static MCCFIInstruction createGnuArgsSize(MCSymbol *L, int Size, SMLoc Loc={})
A special wrapper for .cfi_escape that indicates GNU_ARGS_SIZE.
Definition: MCDwarf.h:652
static MCCFIInstruction createRestoreState(MCSymbol *L, SMLoc Loc={})
.cfi_restore_state Restore the previously saved state.
Definition: MCDwarf.h:640
static MCCFIInstruction createSameValue(MCSymbol *L, unsigned Register, SMLoc Loc={})
.cfi_same_value Current value of Register is the same as in the previous frame.
Definition: MCDwarf.h:629
Context object for machine code objects.
Definition: MCContext.h:76
void maybeSetRootFile(StringRef Directory, StringRef FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source)
Definition: MCDwarf.h:330
unsigned getFile(StringRef Directory, StringRef FileName, std::optional< MD5::MD5Result > Checksum, uint16_t DwarfVersion, std::optional< StringRef > Source)
Definition: MCDwarf.h:338
static void encodeAdvanceLoc(MCContext &Context, uint64_t AddrDelta, SmallVectorImpl< char > &OS)
Definition: MCDwarf.cpp:1935
static void encode(MCContext &Context, MCDwarfLineTableParams Params, int64_t LineDelta, uint64_t AddrDelta, SmallVectorImpl< char > &OS)
Utility function to encode a Dwarf pair of LineDelta and AddrDeltas.
Definition: MCDwarf.cpp:688
Instances of this class represent the line information for the dwarf line table entries.
Definition: MCDwarf.h:188
void setEndLabel(MCSymbol *EndLabel)
Definition: MCDwarf.h:206
MCDwarfLineEntry(MCSymbol *label, const MCDwarfLoc loc)
Definition: MCDwarf.h:197
MCSymbol * getLabel() const
Definition: MCDwarf.h:200
static void make(MCStreamer *MCOS, MCSection *Section)
Definition: MCDwarf.cpp:94
Manage the .debug_line_str section contents, if we use it.
Definition: MCDwarf.h:51
StringSaver & getSaver()
Definition: MCDwarf.h:63
void emitSection(MCStreamer *MCOS)
Emit the .debug_line_str section if appropriate.
Definition: MCDwarf.cpp:335
SmallString< 0 > getFinalizedData()
Returns finalized section.
Definition: MCDwarf.cpp:343
void emitRef(MCStreamer *MCOS, StringRef Path)
Emit a reference to the string.
Definition: MCDwarf.cpp:357
size_t addString(StringRef Path)
Adds path Path to the line string.
Definition: MCDwarf.cpp:353
bool isMD5UsageConsistent() const
Definition: MCDwarf.h:399
const MCDwarfFile & getRootFile() const
Definition: MCDwarf.h:396
void setLabel(MCSymbol *Label)
Definition: MCDwarf.h:405
const SmallVectorImpl< std::string > & getMCDwarfDirs() const
Definition: MCDwarf.h:409
void setRootFile(StringRef Directory, StringRef FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source)
Definition: MCDwarf.h:379
MCDwarfFile & getRootFile()
Definition: MCDwarf.h:395
const MCLineSection & getMCLineSections() const
Definition: MCDwarf.h:425
bool hasRootFile() const
Definition: MCDwarf.h:393
unsigned getFile(StringRef &Directory, StringRef &FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source, uint16_t DwarfVersion, unsigned FileNumber=0)
Definition: MCDwarf.h:371
SmallVectorImpl< std::string > & getMCDwarfDirs()
Definition: MCDwarf.h:413
SmallVectorImpl< MCDwarfFile > & getMCDwarfFiles()
Definition: MCDwarf.h:421
MCLineSection & getMCLineSections()
Definition: MCDwarf.h:428
MCSymbol * getLabel() const
Definition: MCDwarf.h:401
static void emitOne(MCStreamer *MCOS, MCSection *Section, const MCLineSection::MCDwarfLineEntryCollection &LineEntries)
Definition: MCDwarf.cpp:169
Expected< unsigned > tryGetFile(StringRef &Directory, StringRef &FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source, uint16_t DwarfVersion, unsigned FileNumber=0)
Definition: MCDwarf.cpp:569
void emitCU(MCStreamer *MCOS, MCDwarfLineTableParams Params, std::optional< MCDwarfLineStr > &LineStr) const
Definition: MCDwarf.cpp:555
const SmallVectorImpl< MCDwarfFile > & getMCDwarfFiles() const
Definition: MCDwarf.h:417
Instances of this class represent the information from a dwarf .loc directive.
Definition: MCDwarf.h:105
unsigned getLine() const
Get the Line of this MCDwarfLoc.
Definition: MCDwarf.h:139
void setLine(unsigned line)
Set the Line of this MCDwarfLoc.
Definition: MCDwarf.h:157
unsigned getIsa() const
Get the Isa of this MCDwarfLoc.
Definition: MCDwarf.h:148
void setIsa(unsigned isa)
Set the Isa of this MCDwarfLoc.
Definition: MCDwarf.h:172
void setDiscriminator(unsigned discriminator)
Set the Discriminator of this MCDwarfLoc.
Definition: MCDwarf.h:178
unsigned getFlags() const
Get the Flags of this MCDwarfLoc.
Definition: MCDwarf.h:145
unsigned getColumn() const
Get the Column of this MCDwarfLoc.
Definition: MCDwarf.h:142
void setFlags(unsigned flags)
Set the Flags of this MCDwarfLoc.
Definition: MCDwarf.h:166
unsigned getDiscriminator() const
Get the Discriminator of this MCDwarfLoc.
Definition: MCDwarf.h:151
void setColumn(unsigned column)
Set the Column of this MCDwarfLoc.
Definition: MCDwarf.h:160
unsigned getFileNum() const
Get the FileNum of this MCDwarfLoc.
Definition: MCDwarf.h:136
void setFileNum(unsigned fileNum)
Set the FileNum of this MCDwarfLoc.
Definition: MCDwarf.h:154
MCGenDwarfLabelEntry(StringRef name, unsigned fileNumber, unsigned lineNumber, MCSymbol *label)
Definition: MCDwarf.h:467
StringRef getName() const
Definition: MCDwarf.h:472
static void Make(MCSymbol *Symbol, MCStreamer *MCOS, SourceMgr &SrcMgr, SMLoc &Loc)
Definition: MCDwarf.cpp:1205
MCSymbol * getLabel() const
Definition: MCDwarf.h:475
unsigned getLineNumber() const
Definition: MCDwarf.h:474
unsigned getFileNumber() const
Definition: MCDwarf.h:473
Instances of this class represent the line information for a compile unit where machine instructions ...
Definition: MCDwarf.h:221
const MCLineDivisionMap & getMCLineEntries() const
Definition: MCDwarf.h:243
void addEndEntry(MCSymbol *EndLabel)
Definition: MCDwarf.cpp:147
MCDwarfLineEntryCollection::const_iterator const_iterator
Definition: MCDwarf.h:234
MCDwarfLineEntryCollection::iterator iterator
Definition: MCDwarf.h:233
void addLineEntry(const MCDwarfLineEntry &LineEntry, MCSection *Sec)
Definition: MCDwarf.h:224
std::vector< MCDwarfLineEntry > MCDwarfLineEntryCollection
Definition: MCDwarf.h:232
Streaming object file generation interface.
Instances of this class represent a uniqued identifier for a section in the current translation unit.
Definition: MCSection.h:39
Streaming machine code generation interface.
Definition: MCStreamer.h:212
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:40
Wrapper class representing virtual and physical registers.
Definition: Register.h:19
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 class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:577
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1200
This owns the files read by a parser, handles include stacks, and handles diagnostic wrangling.
Definition: SourceMgr.h:31
StringMap - This is an unconventional map that is specialized for handling keys that are "strings",...
Definition: StringMap.h:112
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
Saves strings in the provided stable storage and returns a StringRef with a stable character pointer.
Definition: StringSaver.h:21
Utility for building string tables with deduplicated suffixes.
MCSymbol * emitListsTableHeaderStart(MCStreamer &S)
Definition: MCDwarf.cpp:47
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
AddressSpace
Definition: NVPTXBaseInfo.h:21
SourceMgr SrcMgr
Definition: Error.cpp:24
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
Definition: Casting.h:548
void cantFail(Error Err, const char *Msg=nullptr)
Report a fatal error if Err is a failure value.
Definition: Error.h:749
DWARFExpression::Operation Op
ArrayRef(const T &OneElt) -> ArrayRef< T >
Instances of this class represent the name of the dwarf .file directive and its associated dwarf file...
Definition: MCDwarf.h:87
std::optional< MD5::MD5Result > Checksum
The MD5 checksum, if there is one.
Definition: MCDwarf.h:96
std::string Name
Definition: MCDwarf.h:89
std::optional< StringRef > Source
The source code of the file.
Definition: MCDwarf.h:100
unsigned DirIndex
Definition: MCDwarf.h:92
const MCSymbol * Personality
Definition: MCDwarf.h:701
uint32_t CompactUnwindEncoding
Definition: MCDwarf.h:707
unsigned PersonalityEncoding
Definition: MCDwarf.h:705
MCSymbol * Begin
Definition: MCDwarf.h:699
std::vector< MCCFIInstruction > Instructions
Definition: MCDwarf.h:703
unsigned LsdaEncoding
Definition: MCDwarf.h:706
const MCSymbol * Lsda
Definition: MCDwarf.h:702
unsigned CurrentCfaRegister
Definition: MCDwarf.h:704
void trackMD5Usage(bool MD5Used)
Definition: MCDwarf.h:291
SmallVector< MCDwarfFile, 3 > MCDwarfFiles
Definition: MCDwarf.h:264
bool isMD5UsageConsistent() const
Definition: MCDwarf.h:295
SmallVector< std::string, 3 > MCDwarfDirs
Definition: MCDwarf.h:263
std::string CompilationDir
Definition: MCDwarf.h:266
StringMap< unsigned > SourceIdMap
Definition: MCDwarf.h:265
void setRootFile(StringRef Directory, StringRef FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source)
Definition: MCDwarf.h:299
Expected< unsigned > tryGetFile(StringRef &Directory, StringRef &FileName, std::optional< MD5::MD5Result > Checksum, std::optional< StringRef > Source, uint16_t DwarfVersion, unsigned FileNumber=0)
Definition: MCDwarf.cpp:586
uint8_t DWARF2LineOpcodeBase
First special line opcode - leave room for the standard opcodes.
Definition: MCDwarf.h:253
uint8_t DWARF2LineRange
Range of line offsets in a special line info. opcode.
Definition: MCDwarf.h:258
int8_t DWARF2LineBase
Minimum line offset in a special line info.
Definition: MCDwarf.h:256