LLVM 20.0.0git
DebugLinesSubsection.h
Go to the documentation of this file.
1//===- DebugLinesSubsection.h -----------------------------------*- 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#ifndef LLVM_DEBUGINFO_CODEVIEW_DEBUGLINESSUBSECTION_H
10#define LLVM_DEBUGINFO_CODEVIEW_DEBUGLINESSUBSECTION_H
11
12#include "llvm/ADT/StringRef.h"
18#include "llvm/Support/Endian.h"
19#include "llvm/Support/Error.h"
20#include <cstdint>
21#include <vector>
22
23namespace llvm {
24class BinaryStreamReader;
25class BinaryStreamWriter;
26namespace codeview {
27
28class DebugChecksumsSubsection;
29class DebugStringTableSubsection;
30
31// Corresponds to the `CV_DebugSLinesHeader_t` structure.
33 support::ulittle32_t RelocOffset; // Code offset of line contribution.
34 support::ulittle16_t RelocSegment; // Code segment of line contribution.
35 support::ulittle16_t Flags; // See LineFlags enumeration.
36 support::ulittle32_t CodeSize; // Code size of this line contribution.
37};
38
39// Corresponds to the `CV_DebugSLinesFileBlockHeader_t` structure.
41 support::ulittle32_t NameIndex; // Offset of FileChecksum entry in File
42 // checksums buffer. The checksum entry then
43 // contains another offset into the string
44 // table of the actual name.
45 support::ulittle32_t NumLines; // Number of lines
46 support::ulittle32_t BlockSize; // Code size of block, in bytes.
47 // The following two variable length arrays appear immediately after the
48 // header. The structure definitions follow.
49 // LineNumberEntry Lines[NumLines];
50 // ColumnNumberEntry Columns[NumLines];
51};
52
53// Corresponds to `CV_Line_t` structure
55 support::ulittle32_t Offset; // Offset to start of code bytes for line number
56 support::ulittle32_t Flags; // Start:24, End:7, IsStatement:1
57};
58
59// Corresponds to `CV_Column_t` structure
63};
64
69};
70
72public:
74 LineColumnEntry &Item);
75
76 const LineFragmentHeader *Header = nullptr;
77};
78
80 friend class LineColumnExtractor;
81
84
85public:
87
88 static bool classof(const DebugSubsectionRef *S) {
89 return S->kind() == DebugSubsectionKind::Lines;
90 }
91
93
94 Iterator begin() const { return LinesAndColumns.begin(); }
95 Iterator end() const { return LinesAndColumns.end(); }
96
97 const LineFragmentHeader *header() const { return Header; }
98
99 bool hasColumnInfo() const;
100
101private:
102 const LineFragmentHeader *Header = nullptr;
103 LineInfoArray LinesAndColumns;
104};
105
107 struct Block {
108 Block(uint32_t ChecksumBufferOffset)
109 : ChecksumBufferOffset(ChecksumBufferOffset) {}
110
111 uint32_t ChecksumBufferOffset;
112 std::vector<LineNumberEntry> Lines;
113 std::vector<ColumnNumberEntry> Columns;
114 };
115
116public:
119
120 static bool classof(const DebugSubsection *S) {
121 return S->kind() == DebugSubsectionKind::Lines;
122 }
123
124 void createBlock(StringRef FileName);
127 uint32_t ColStart, uint32_t ColEnd);
128
129 uint32_t calculateSerializedSize() const override;
130 Error commit(BinaryStreamWriter &Writer) const override;
131
134 void setFlags(LineFlags Flags);
135
136 bool hasColumnInfo() const;
137
138private:
139 DebugChecksumsSubsection &Checksums;
140 uint32_t RelocOffset = 0;
141 uint16_t RelocSegment = 0;
142 uint32_t CodeSize = 0;
143 LineFlags Flags = LF_None;
144 std::vector<Block> Blocks;
145};
146
147} // end namespace codeview
148} // end namespace llvm
149
150#endif // LLVM_DEBUGINFO_CODEVIEW_DEBUGLINESSUBSECTION_H
Lightweight arrays that are backed by an arbitrary BinaryStream.
uint64_t Size
Provides read only access to a subclass of BinaryStream.
BinaryStreamRef is to BinaryStream what ArrayRef is to an Array.
Provides write only access to a subclass of WritableBinaryStream.
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
FixedStreamArray is similar to VarStreamArray, except with each record having a fixed-length.
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
VarStreamArray represents an array of variable length records backed by a stream.
Iterator end() const
VarStreamArrayIterator< LineColumnEntry, LineColumnExtractor > Iterator
Iterator begin(bool *HadError=nullptr) const
const LineFragmentHeader * header() const
static bool classof(const DebugSubsectionRef *S)
Error initialize(BinaryStreamReader Reader)
void setRelocationAddress(uint16_t Segment, uint32_t Offset)
static bool classof(const DebugSubsection *S)
void addLineInfo(uint32_t Offset, const LineInfo &Line)
Error commit(BinaryStreamWriter &Writer) const override
void addLineAndColumnInfo(uint32_t Offset, const LineInfo &Line, uint32_t ColStart, uint32_t ColEnd)
uint32_t calculateSerializedSize() const override
Represents a read-write view of a CodeView string table.
DebugSubsectionKind kind() const
DebugSubsectionKind kind() const
Error operator()(BinaryStreamRef Stream, uint32_t &Len, LineColumnEntry &Item)
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
@ Offset
Definition: DWP.cpp:480
FixedStreamArray< ColumnNumberEntry > Columns
FixedStreamArray< LineNumberEntry > LineNumbers