LLVM 20.0.0git
RemarkLinker.h
Go to the documentation of this file.
1//===-- llvm/Remarks/RemarkLinker.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// This file provides an interface to link together multiple remark files.
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_REMARKS_REMARKLINKER_H
14#define LLVM_REMARKS_REMARKLINKER_H
15
16#include "llvm/Remarks/Remark.h"
19#include "llvm/Support/Error.h"
20#include <memory>
21#include <optional>
22#include <set>
23
24namespace llvm {
25
26namespace object {
27class ObjectFile;
28}
29
30namespace remarks {
31
33private:
34 /// Compare through the pointers.
35 struct RemarkPtrCompare {
36 bool operator()(const std::unique_ptr<Remark> &LHS,
37 const std::unique_ptr<Remark> &RHS) const {
38 assert(LHS && RHS && "Invalid pointers to compare.");
39 return *LHS < *RHS;
40 };
41 };
42
43 /// The main string table for the remarks.
44 /// Note: all remarks should use the strings from this string table to avoid
45 /// dangling references.
46 StringTable StrTab;
47
48 /// A set holding unique remarks.
49 /// FIXME: std::set is probably not the most appropriate data structure here.
50 /// Due to the limitation of having a move-only key, there isn't another
51 /// obvious choice for now.
52 std::set<std::unique_ptr<Remark>, RemarkPtrCompare> Remarks;
53
54 /// A path to append before the external file path found in remark metadata.
55 std::optional<std::string> PrependPath;
56
57 /// If true, keep all remarks, otherwise only keep remarks with valid debug
58 /// locations.
59 bool KeepAllRemarks = true;
60
61 /// Keep this remark. If it's already in the set, discard it.
62 Remark &keep(std::unique_ptr<Remark> Remark);
63
64 /// Returns true if \p R should be kept. If KeepAllRemarks is false, only
65 /// return true if \p R has a valid debug location.
66 bool shouldKeepRemark(const Remark &R) {
67 return KeepAllRemarks ? true : R.Loc.has_value();
68 }
69
70public:
71 /// Set a path to prepend to the external file path.
72 void setExternalFilePrependPath(StringRef PrependPath);
73
74 /// Set KeepAllRemarks to \p B.
75 void setKeepAllRemarks(bool B) { KeepAllRemarks = B; }
76
77 /// Link the remarks found in \p Buffer.
78 /// If \p RemarkFormat is not provided, try to deduce it from the metadata in
79 /// \p Buffer.
80 /// \p Buffer can be either a standalone remark container or just
81 /// metadata. This takes care of uniquing and merging the remarks.
82 Error link(StringRef Buffer,
83 std::optional<Format> RemarkFormat = std::nullopt);
84
85 /// Link the remarks found in \p Obj by looking for the right section and
86 /// calling the method above.
87 Error link(const object::ObjectFile &Obj,
88 std::optional<Format> RemarkFormat = std::nullopt);
89
90 /// Serialize the linked remarks to the stream \p OS, using the format \p
91 /// RemarkFormat.
92 /// This clears internal state such as the string table.
93 /// Note: this implies that the serialization mode is standalone.
95
96 /// Check whether there are any remarks linked.
97 bool empty() const { return Remarks.empty(); }
98
99 /// Return a collection of the linked unique remarks to iterate on.
100 /// Ex:
101 /// for (const Remark &R : RL.remarks() { [...] }
102 using iterator = pointee_iterator<decltype(Remarks)::const_iterator>;
103
105 return {Remarks.begin(), Remarks.end()};
106 }
107};
108
109/// Returns a buffer with the contents of the remarks section depending on the
110/// format of the file. If the section doesn't exist, this returns an empty
111/// optional.
114
115} // end namespace remarks
116} // end namespace llvm
117
118#endif // LLVM_REMARKS_REMARKLINKER_H
basic Basic Alias true
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
raw_pwrite_stream & OS
Value * RHS
Value * LHS
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
Tagged union holding either a T or a Error.
Definition: Error.h:481
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
A range adaptor for a pair of iterators.
This class is the base class for all object file types.
Definition: ObjectFile.h:229
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:52
Format
The format used for serializing/deserializing remarks.
Definition: RemarkFormat.h:25
Expected< std::optional< StringRef > > getRemarksSectionContents(const object::ObjectFile &Obj)
Returns a buffer with the contents of the remarks section depending on the format of the file.
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
cl::opt< std::string > RemarksFormat("lto-pass-remarks-format", cl::desc("The format used for serializing remarks (default: YAML)"), cl::value_desc("format"), cl::init("yaml"))
An iterator type that allows iterating over the pointees via some other iterator.
Definition: iterator.h:324
void setExternalFilePrependPath(StringRef PrependPath)
Set a path to prepend to the external file path.
Error serialize(raw_ostream &OS, Format RemarksFormat) const
Serialize the linked remarks to the stream OS, using the format RemarkFormat.
bool empty() const
Check whether there are any remarks linked.
Definition: RemarkLinker.h:97
void setKeepAllRemarks(bool B)
Set KeepAllRemarks to B.
Definition: RemarkLinker.h:75
Error link(StringRef Buffer, std::optional< Format > RemarkFormat=std::nullopt)
Link the remarks found in Buffer.
iterator_range< iterator > remarks() const
Definition: RemarkLinker.h:104
A remark type used for both emission and parsing.
Definition: Remark.h:97
The string table used for serializing remarks.