clang 23.0.0git
LUSummaryEncoding.cpp
Go to the documentation of this file.
1//===- LUSummaryEncoding.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// LUSummaryEncoding
20//----------------------------------------------------------------------------
21
22llvm::Expected<LUSummaryEncoding>
23JSONFormat::readLUSummaryEncoding(llvm::StringRef Path) {
24 auto ExpectedJSON = readJSON(Path);
25 if (!ExpectedJSON) {
26 return ErrorBuilder::wrap(ExpectedJSON.takeError())
27 .context(ErrorMessages::ReadingFromFile, "LUSummary", 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, "LUSummary", Path)
37 .build();
38 }
39
40 if (auto Err = checkSummaryType(*RootObjectPtr, JSONTypeValueLUSummary)) {
41 return ErrorBuilder::wrap(std::move(Err))
42 .context(ErrorMessages::ReadingFromFile, "LUSummary", Path)
43 .build();
44 }
45
46 auto ExpectedEncoding = readLUSummaryEncodingFromObject(*RootObjectPtr);
47 if (!ExpectedEncoding) {
48 return ErrorBuilder::wrap(ExpectedEncoding.takeError())
49 .context(ErrorMessages::ReadingFromFile, "LUSummary", Path)
50 .build();
51 }
52
53 return std::move(*ExpectedEncoding);
54}
55
57JSONFormat::readLUSummaryEncodingFromObject(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 Array *LUNamespaceArray = RootObject.getArray("lu_namespace");
76 if (!LUNamespaceArray) {
77 return ErrorBuilder::create(std::errc::invalid_argument,
79 "NestedBuildNamespace", "lu_namespace", "array")
80 .build();
81 }
82
83 auto ExpectedLUNamespace = nestedBuildNamespaceFromJSON(*LUNamespaceArray);
84 if (!ExpectedLUNamespace) {
85 return ErrorBuilder::wrap(ExpectedLUNamespace.takeError())
86 .context(ErrorMessages::ReadingFromField, "NestedBuildNamespace",
87 "lu_namespace")
88 .build();
89 }
90
91 LUSummaryEncoding Encoding(std::move(T), std::move(*ExpectedLUNamespace));
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 = luEntityIdTableFromJSON(*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 Object RootObject;
168
170
171 RootObject["target_triple"] =
172 llvm::Triple::normalize(getTargetTriple(SummaryEncoding).str());
173
174 RootObject["lu_namespace"] =
175 nestedBuildNamespaceToJSON(getLUNamespace(SummaryEncoding));
176
177 RootObject["id_table"] = luEntityIdTableToJSON(getIdTable(SummaryEncoding));
178
179 RootObject["linkage_table"] =
180 linkageTableToJSON(getLinkageTable(SummaryEncoding));
181
182 RootObject["data"] = encodingSummaryDataMapToJSON(getData(SummaryEncoding));
183
184 if (auto Error = writeJSON(std::move(RootObject), Path)) {
185 return ErrorBuilder::wrap(std::move(Error))
186 .context(ErrorMessages::WritingToFile, "LUSummary", Path)
187 .build();
188 }
189
190 return llvm::Error::success();
191}
192
193} // namespace clang::ssaf
llvm::json::Array Array
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< LUSummaryEncoding > readLUSummaryEncoding(llvm::StringRef Path) override
llvm::Error writeLUSummaryEncoding(const LUSummaryEncoding &SummaryEncoding, llvm::StringRef Path) override
Represents a link 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 * JSONTypeValueLUSummary
Value written to JSONTypeKey for serialized LUSummary 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)