LLVM 20.0.0git
DwarfTransformer.h
Go to the documentation of this file.
1//===- DwarfTransformer.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_GSYM_DWARFTRANSFORMER_H
10#define LLVM_DEBUGINFO_GSYM_DWARFTRANSFORMER_H
11
12#include "llvm/ADT/StringRef.h"
14#include "llvm/Support/Error.h"
15
16namespace llvm {
17
18class raw_ostream;
19
20namespace gsym {
21
22struct CUInfo;
23struct FunctionInfo;
24class GsymCreator;
26
27/// A class that transforms the DWARF in a DWARFContext into GSYM information
28/// by populating the GsymCreator object that it is constructed with. This
29/// class supports converting all DW_TAG_subprogram DIEs into
30/// gsym::FunctionInfo objects that includes line table information and inline
31/// function information. Creating a separate class to transform this data
32/// allows this class to be unit tested.
34public:
35
36 /// Create a DWARF transformer.
37 ///
38 /// \param D The DWARF to use when converting to GSYM.
39 ///
40 /// \param G The GSYM creator to populate with the function information
41 /// from the debug info.
43
44 /// Extract the DWARF from the supplied object file and convert it into the
45 /// Gsym format in the GsymCreator object that is passed in. Returns an
46 /// error if something fatal is encountered.
47 ///
48 /// \param NumThreads The number of threads that the conversion process can
49 /// use.
50 ///
51 /// \param OS The stream to log warnings and non fatal issues to. If NULL
52 /// then don't log.
53 ///
54 /// \returns An error indicating any fatal issues that happen when parsing
55 /// the DWARF, or Error::success() if all goes well.
57
59
60private:
61
62 /// Parse the DWARF in the object file and convert it into the GsymCreator.
63 Error parse();
64
65 /// Handle any DIE (debug info entry) from the DWARF.
66 ///
67 /// This function will find all DW_TAG_subprogram DIEs that convert them into
68 /// GSYM FuntionInfo objects and add them to the GsymCreator supplied during
69 /// construction. The DIE and all its children will be recursively parsed
70 /// with calls to this function.
71 ///
72 /// \param Strm The thread specific log stream for any non fatal errors and
73 /// warnings. Once a thread has finished parsing an entire compile unit, all
74 /// information in this temporary stream will be forwarded to the member
75 /// variable log. This keeps logging thread safe. If the value is NULL, then
76 /// don't log.
77 ///
78 /// \param CUI The compile unit specific information that contains the DWARF
79 /// line table, cached file list, and other compile unit specific
80 /// information.
81 ///
82 /// \param Die The DWARF debug info entry to parse.
83 void handleDie(OutputAggregator &Strm, CUInfo &CUI, DWARFDie Die);
84
85 DWARFContext &DICtx;
86 GsymCreator &Gsym;
87
89};
90
91} // namespace gsym
92} // namespace llvm
93
94#endif // LLVM_DEBUGINFO_GSYM_DWARFTRANSFORMER_H
static GCRegistry::Add< StatepointGC > D("statepoint-example", "an example strategy for statepoint")
expand large fp convert
#define G(x, y, z)
Definition: MD5.cpp:56
ppc ctr loops verify
raw_pwrite_stream & OS
DWARFContext This data structure is the top level entity that deals with dwarf debug information pars...
Definition: DWARFContext.h:48
Utility class that carries the DWARF compile/type unit and the debug info entry in an object.
Definition: DWARFDie.h:42
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
A class that transforms the DWARF in a DWARFContext into GSYM information by populating the GsymCreat...
DwarfTransformer(DWARFContext &D, GsymCreator &G)
Create a DWARF transformer.
GsymCreator is used to emit GSYM data to a stand alone file or section within a file.
Definition: GsymCreator.h:134
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
Function information in GSYM files encodes information for one contiguous address range.
Definition: FunctionInfo.h:89
Definition: regcomp.c:192