clang 23.0.0git
TUSummaryEncoding.cpp
Go to the documentation of this file.
1//===- TUSummaryEncoding.cpp ----------------------------------------------===//
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#include "JSONFormatImpl.h"
10
12#include "llvm/TargetParser/Triple.h"
13
14#include <set>
15
16namespace clang::ssaf {
17
18//----------------------------------------------------------------------------
19// TUSummaryEncoding
20//----------------------------------------------------------------------------
21
22llvm::Expected<TUSummaryEncoding>
23JSONFormat::readTUSummaryEncoding(llvm::StringRef Path) {
24 auto ExpectedJSON = readJSON(Path);
25 if (!ExpectedJSON) {
26 return ErrorBuilder::wrap(ExpectedJSON.takeError())
27 .context(ErrorMessages::ReadingFromFile, "TUSummary", Path)
28 .build();
29 }
30
31 Object *RootObjectPtr = ExpectedJSON->getAsObject();
32 if (!RootObjectPtr) {
33 return ErrorBuilder::create(std::errc::invalid_argument,
35 "object")
36 .context(ErrorMessages::ReadingFromFile, "TUSummary", Path)
37 .build();
38 }
39
40 if (auto Err = checkSummaryType(*RootObjectPtr, JSONTypeValueTUSummary)) {
41 return ErrorBuilder::wrap(std::move(Err))
42 .context(ErrorMessages::ReadingFromFile, "TUSummary", Path)
43 .build();
44 }
45
46 auto ExpectedEncoding = readTUSummaryEncodingFromObject(*RootObjectPtr);
47 if (!ExpectedEncoding) {
48 return ErrorBuilder::wrap(ExpectedEncoding.takeError())
49 .context(ErrorMessages::ReadingFromFile, "TUSummary", Path)
50 .build();
51 }
52
53 return std::move(*ExpectedEncoding);
54}
55
57JSONFormat::readTUSummaryEncodingFromObject(const Object &RootObject) {
58 auto OptTargetTriple = RootObject.getString("target_triple");
59 if (!OptTargetTriple) {
60 return ErrorBuilder::create(std::errc::invalid_argument,
62 "TargetTriple", "target_triple", "string")
63 .build();
64 }
65
66 if (auto Err = validateNormalizedTargetTriple(*OptTargetTriple)) {
67 return ErrorBuilder::wrap(std::move(Err))
69 "target_triple")
70 .build();
71 }
72
73 llvm::Triple T(*OptTargetTriple);
74
75 const Object *TUNamespaceObject = RootObject.getObject("tu_namespace");
76 if (!TUNamespaceObject) {
77 return ErrorBuilder::create(std::errc::invalid_argument,
79 "BuildNamespace", "tu_namespace", "object")
80 .build();
81 }
82
83 auto ExpectedTUNamespace = buildNamespaceFromJSON(*TUNamespaceObject);
84 if (!ExpectedTUNamespace) {
85 return ErrorBuilder::wrap(ExpectedTUNamespace.takeError())
87 "tu_namespace")
88 .build();
89 }
90
91 TUSummaryEncoding Encoding(std::move(T), std::move(*ExpectedTUNamespace));
92
93 {
94 const Array *IdTableArray = RootObject.getArray("id_table");
95 if (!IdTableArray) {
96 return ErrorBuilder::create(std::errc::invalid_argument,
98 "IdTable", "id_table", "array")
99 .build();
100 }
101
102 auto ExpectedIdTable = tuEntityIdTableFromJSON(*IdTableArray);
103 if (!ExpectedIdTable) {
104 return ErrorBuilder::wrap(ExpectedIdTable.takeError())
105 .context(ErrorMessages::ReadingFromField, "IdTable", "id_table")
106 .build();
107 }
108
109 getIdTable(Encoding) = std::move(*ExpectedIdTable);
110 }
111
112 {
113 const Array *LinkageTableArray = RootObject.getArray("linkage_table");
114 if (!LinkageTableArray) {
115 return ErrorBuilder::create(std::errc::invalid_argument,
117 "LinkageTable", "linkage_table", "array")
118 .build();
119 }
120
121 auto ExpectedIdRange =
122 llvm::make_second_range(getEntities(getIdTable(Encoding)));
123 std::set<EntityId> ExpectedIds(ExpectedIdRange.begin(),
124 ExpectedIdRange.end());
125
126 // Move ExpectedIds in since linkageTableFromJSON consumes it to verify
127 // that the linkage table contains exactly the ids present in the IdTable.
128 auto ExpectedLinkageTable =
129 linkageTableFromJSON(*LinkageTableArray, std::move(ExpectedIds));
130 if (!ExpectedLinkageTable) {
131 return ErrorBuilder::wrap(ExpectedLinkageTable.takeError())
133 "linkage_table")
134 .build();
135 }
136
137 getLinkageTable(Encoding) = std::move(*ExpectedLinkageTable);
138 }
139
140 {
141 const Array *SummaryDataArray = RootObject.getArray("data");
142 if (!SummaryDataArray) {
143 return ErrorBuilder::create(std::errc::invalid_argument,
145 "SummaryData entries", "data", "array")
146 .build();
147 }
148
149 auto ExpectedEncodingSummaryDataMap =
150 encodingSummaryDataMapFromJSON(*SummaryDataArray);
151 if (!ExpectedEncodingSummaryDataMap) {
152 return ErrorBuilder::wrap(ExpectedEncodingSummaryDataMap.takeError())
153 .context(ErrorMessages::ReadingFromField, "SummaryData entries",
154 "data")
155 .build();
156 }
157
158 getData(Encoding) = std::move(*ExpectedEncodingSummaryDataMap);
159 }
160
161 return std::move(Encoding);
162}
163
164llvm::Error
166 llvm::StringRef Path) {
167 if (auto Error = writeJSON(tuSummaryEncodingToJSON(SummaryEncoding), Path)) {
168 return ErrorBuilder::wrap(std::move(Error))
169 .context(ErrorMessages::WritingToFile, "TUSummary", Path)
170 .build();
171 }
172
173 return llvm::Error::success();
174}
175
176Object JSONFormat::tuSummaryEncodingToJSON(
177 const TUSummaryEncoding &SummaryEncoding) const {
178 Object RootObject;
179
181
182 RootObject["target_triple"] =
183 llvm::Triple::normalize(getTargetTriple(SummaryEncoding).str());
184
185 RootObject["tu_namespace"] =
186 buildNamespaceToJSON(getTUNamespace(SummaryEncoding));
187
188 RootObject["id_table"] = tuEntityIdTableToJSON(getIdTable(SummaryEncoding));
189
190 RootObject["linkage_table"] =
191 linkageTableToJSON(getLinkageTable(SummaryEncoding));
192
193 RootObject["data"] = encodingSummaryDataMapToJSON(getData(SummaryEncoding));
194
195 return RootObject;
196}
197
198} // namespace clang::ssaf
llvm::json::Object Object
static ErrorBuilder create(std::error_code EC, const char *Fmt, Args &&...ArgVals)
Create an ErrorBuilder with an error code and formatted message.
ErrorBuilder & context(const char *Msg)
Add context information as a plain string.
llvm::Error build() const
Build and return the final error.
static ErrorBuilder wrap(llvm::Error E)
Wrap an existing error and optionally add context.
llvm::Expected< TUSummaryEncoding > readTUSummaryEncoding(llvm::StringRef Path) override
llvm::Error writeTUSummaryEncoding(const TUSummaryEncoding &SummaryEncoding, llvm::StringRef Path) override
Represents a translation unit summary in its serialized encoding.
constexpr const char * ReadingFromFile
constexpr const char * ReadingFromField
constexpr const char * FailedToReadObjectAtField
constexpr const char * WritingToFile
constexpr const char * FailedToReadObject
constexpr const char * JSONTypeKey
Root-object key naming the summary kind so files are self-describing.
constexpr const char * JSONTypeValueTUSummary
Value written to JSONTypeKey for serialized TUSummary files.
llvm::Error validateNormalizedTargetTriple(llvm::StringRef Triple)
Validates that Triple is a target triple string in normalized form.
llvm::json::Object Object
llvm::Expected< Value > readJSON(llvm::StringRef Path)
llvm::Error checkSummaryType(const Object &RootObject, llvm::StringRef ExpectedType)
Reads the JSONTypeKey field from the root object and verifies it equals ExpectedType.
llvm::Error writeJSON(Value &&V, llvm::StringRef Path)