LLVM  10.0.0svn
LLVMContext.cpp
Go to the documentation of this file.
1 //===-- LLVMContext.cpp - Implement LLVMContext ---------------------------===//
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 implements LLVMContext, as a wrapper around the opaque
10 // class LLVMContextImpl.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "llvm/IR/LLVMContext.h"
15 #include "LLVMContextImpl.h"
16 #include "llvm/ADT/SmallVector.h"
17 #include "llvm/ADT/StringMap.h"
18 #include "llvm/ADT/StringRef.h"
19 #include "llvm/ADT/Twine.h"
20 #include "llvm/IR/DiagnosticInfo.h"
22 #include "llvm/IR/Metadata.h"
23 #include "llvm/IR/Module.h"
24 #include "llvm/IR/RemarkStreamer.h"
25 #include "llvm/Support/Casting.h"
28 #include <cassert>
29 #include <cstdlib>
30 #include <string>
31 #include <utility>
32 
33 using namespace llvm;
34 
36  // Create the fixed metadata kinds. This is done in the same order as the
37  // MD_* enum values so that they correspond.
38  std::pair<unsigned, StringRef> MDKinds[] = {
39 #define LLVM_FIXED_MD_KIND(EnumID, Name, Value) {EnumID, Name},
40 #include "llvm/IR/FixedMetadataKinds.def"
41 #undef LLVM_FIXED_MD_KIND
42  };
43 
44  for (auto &MDKind : MDKinds) {
45  unsigned ID = getMDKindID(MDKind.second);
46  assert(ID == MDKind.first && "metadata kind id drifted");
47  (void)ID;
48  }
49 
50  auto *DeoptEntry = pImpl->getOrInsertBundleTag("deopt");
51  assert(DeoptEntry->second == LLVMContext::OB_deopt &&
52  "deopt operand bundle id drifted!");
53  (void)DeoptEntry;
54 
55  auto *FuncletEntry = pImpl->getOrInsertBundleTag("funclet");
56  assert(FuncletEntry->second == LLVMContext::OB_funclet &&
57  "funclet operand bundle id drifted!");
58  (void)FuncletEntry;
59 
60  auto *GCTransitionEntry = pImpl->getOrInsertBundleTag("gc-transition");
61  assert(GCTransitionEntry->second == LLVMContext::OB_gc_transition &&
62  "gc-transition operand bundle id drifted!");
63  (void)GCTransitionEntry;
64 
65  SyncScope::ID SingleThreadSSID =
66  pImpl->getOrInsertSyncScopeID("singlethread");
67  assert(SingleThreadSSID == SyncScope::SingleThread &&
68  "singlethread synchronization scope ID drifted!");
69  (void)SingleThreadSSID;
70 
71  SyncScope::ID SystemSSID =
73  assert(SystemSSID == SyncScope::System &&
74  "system synchronization scope ID drifted!");
75  (void)SystemSSID;
76 }
77 
79 
80 void LLVMContext::addModule(Module *M) {
82 }
83 
84 void LLVMContext::removeModule(Module *M) {
86 }
87 
88 //===----------------------------------------------------------------------===//
89 // Recoverable Backend Errors
90 //===----------------------------------------------------------------------===//
91 
92 void LLVMContext::
94  void *DiagContext) {
96  pImpl->InlineAsmDiagContext = DiagContext;
97 }
98 
99 /// getInlineAsmDiagnosticHandler - Return the diagnostic handler set by
100 /// setInlineAsmDiagnosticHandler.
103  return pImpl->InlineAsmDiagHandler;
104 }
105 
106 /// getInlineAsmDiagnosticContext - Return the diagnostic context set by
107 /// setInlineAsmDiagnosticHandler.
109  return pImpl->InlineAsmDiagContext;
110 }
111 
114  void *DiagnosticContext, bool RespectFilters) {
115  pImpl->DiagHandler->DiagHandlerCallback = DiagnosticHandler;
116  pImpl->DiagHandler->DiagnosticContext = DiagnosticContext;
117  pImpl->RespectDiagnosticFilters = RespectFilters;
118 }
119 
120 void LLVMContext::setDiagnosticHandler(std::unique_ptr<DiagnosticHandler> &&DH,
121  bool RespectFilters) {
122  pImpl->DiagHandler = std::move(DH);
123  pImpl->RespectDiagnosticFilters = RespectFilters;
124 }
125 
127  pImpl->DiagnosticsHotnessRequested = Requested;
128 }
131 }
132 
135 }
138 }
139 
141  return pImpl->RemarkDiagStreamer.get();
142 }
144  return const_cast<LLVMContext *>(this)->getRemarkStreamer();
145 }
147  std::unique_ptr<RemarkStreamer> RemarkStreamer) {
148  pImpl->RemarkDiagStreamer = std::move(RemarkStreamer);
149 }
150 
153  return pImpl->DiagHandler->DiagHandlerCallback;
154 }
155 
157  return pImpl->DiagHandler->DiagnosticContext;
158 }
159 
160 void LLVMContext::setYieldCallback(YieldCallbackTy Callback, void *OpaqueHandle)
161 {
162  pImpl->YieldCallback = Callback;
163  pImpl->YieldOpaqueHandle = OpaqueHandle;
164 }
165 
167  if (pImpl->YieldCallback)
169 }
170 
171 void LLVMContext::emitError(const Twine &ErrorStr) {
173 }
174 
175 void LLVMContext::emitError(const Instruction *I, const Twine &ErrorStr) {
176  assert (I && "Invalid instruction");
177  diagnose(DiagnosticInfoInlineAsm(*I, ErrorStr));
178 }
179 
180 static bool isDiagnosticEnabled(const DiagnosticInfo &DI) {
181  // Optimization remarks are selective. They need to check whether the regexp
182  // pattern, passed via one of the -pass-remarks* flags, matches the name of
183  // the pass that is emitting the diagnostic. If there is no match, ignore the
184  // diagnostic and return.
185  //
186  // Also noisy remarks are only enabled if we have hotness information to sort
187  // them.
188  if (auto *Remark = dyn_cast<DiagnosticInfoOptimizationBase>(&DI))
189  return Remark->isEnabled() &&
190  (!Remark->isVerbose() || Remark->getHotness());
191 
192  return true;
193 }
194 
195 const char *
197  switch (Severity) {
198  case DS_Error:
199  return "error";
200  case DS_Warning:
201  return "warning";
202  case DS_Remark:
203  return "remark";
204  case DS_Note:
205  return "note";
206  }
207  llvm_unreachable("Unknown DiagnosticSeverity");
208 }
209 
211  if (auto *OptDiagBase = dyn_cast<DiagnosticInfoOptimizationBase>(&DI))
212  if (RemarkStreamer *RS = getRemarkStreamer())
213  RS->emit(*OptDiagBase);
214 
215  // If there is a report handler, use it.
216  if (pImpl->DiagHandler &&
218  pImpl->DiagHandler->handleDiagnostics(DI))
219  return;
220 
221  if (!isDiagnosticEnabled(DI))
222  return;
223 
224  // Otherwise, print the message with a prefix based on the severity.
226  errs() << getDiagnosticMessagePrefix(DI.getSeverity()) << ": ";
227  DI.print(DP);
228  errs() << "\n";
229  if (DI.getSeverity() == DS_Error)
230  exit(1);
231 }
232 
233 void LLVMContext::emitError(unsigned LocCookie, const Twine &ErrorStr) {
234  diagnose(DiagnosticInfoInlineAsm(LocCookie, ErrorStr));
235 }
236 
237 //===----------------------------------------------------------------------===//
238 // Metadata Kind Uniquing
239 //===----------------------------------------------------------------------===//
240 
241 /// Return a unique non-zero ID for the specified metadata kind.
243  // If this is new, assign it its ID.
245  std::make_pair(
246  Name, pImpl->CustomMDKindNames.size()))
247  .first->second;
248 }
249 
250 /// getHandlerNames - Populate client-supplied smallvector using custom
251 /// metadata name and ID.
255  E = pImpl->CustomMDKindNames.end(); I != E; ++I)
256  Names[I->second] = I->first();
257 }
258 
261 }
262 
264  return pImpl->getOperandBundleTagID(Tag);
265 }
266 
268  return pImpl->getOrInsertSyncScopeID(SSN);
269 }
270 
272  pImpl->getSyncScopeNames(SSNs);
273 }
274 
275 void LLVMContext::setGC(const Function &Fn, std::string GCName) {
276  auto It = pImpl->GCNames.find(&Fn);
277 
278  if (It == pImpl->GCNames.end()) {
279  pImpl->GCNames.insert(std::make_pair(&Fn, std::move(GCName)));
280  return;
281  }
282  It->second = std::move(GCName);
283 }
284 
285 const std::string &LLVMContext::getGC(const Function &Fn) {
286  return pImpl->GCNames[&Fn];
287 }
288 
290  pImpl->GCNames.erase(&Fn);
291 }
292 
294  return pImpl->DiscardValueNames;
295 }
296 
298 
300  if (pImpl->DITypeMap)
301  return;
302 
303  pImpl->DITypeMap.emplace();
304 }
305 
307 
309  pImpl->DiscardValueNames = Discard;
310 }
311 
313  return pImpl->getOptPassGate();
314 }
315 
317  pImpl->setOptPassGate(OPG);
318 }
319 
321  return pImpl->DiagHandler.get();
322 }
323 
324 std::unique_ptr<DiagnosticHandler> LLVMContext::getDiagnosticHandler() {
325  return std::move(pImpl->DiagHandler);
326 }
void setDiagnosticHandler(std::unique_ptr< DiagnosticHandler > &&DH, bool RespectFilters=false)
setDiagnosticHandler - This method sets unique_ptr to object of DiagnosticHandler to provide custom d...
This is the base class for diagnostic handling in LLVM.
raw_ostream & errs()
This returns a reference to a raw_ostream for standard error.
void setRemarkStreamer(std::unique_ptr< RemarkStreamer > RemarkStreamer)
Set the diagnostics output used for optimization diagnostics.
void getOperandBundleTags(SmallVectorImpl< StringRef > &Tags) const
This class represents lattice values for constants.
Definition: AllocatorList.h:23
A Module instance is used to store all the information related to an LLVM module. ...
Definition: Module.h:66
const std::string & getGC(const Function &Fn)
Return the GC for a function.
Extensions to this class implement mechanisms to disable passes and individual optimizations at compi...
Definition: OptBisect.h:25
amdgpu Simplify well known AMD library false FunctionCallee Value const Twine & Name
RemarkStreamer * getRemarkStreamer()
Return the streamer used by the backend to save remark diagnostics.
std::unique_ptr< DiagnosticHandler > getDiagnosticHandler()
getDiagnosticHandler - transfers owenership of DiagnosticHandler unique_ptr to caller.
void(*)(LLVMContext *Context, void *OpaqueHandle) YieldCallbackTy
Defines the type of a yield callback.
Definition: LLVMContext.h:148
uint32_t getOperandBundleTagID(StringRef Tag) const
void setGC(const Function &Fn, std::string GCName)
Define the GC for a function.
SyncScope::ID getOrInsertSyncScopeID(StringRef SSN)
getOrInsertSyncScopeID - Maps synchronization scope name to synchronization scope ID...
This file contains the declarations for metadata subclasses.
void enableDebugTypeODRUniquing()
void * getInlineAsmDiagnosticContext() const
getInlineAsmDiagnosticContext - Return the diagnostic context set by setInlineAsmDiagnosticHandler.
void setInlineAsmDiagnosticHandler(InlineAsmDiagHandlerTy DiagHandler, void *DiagContext=nullptr)
setInlineAsmDiagnosticHandler - This method sets a handler that is invoked when problems with inline ...
Definition: LLVMContext.cpp:93
void setYieldCallback(YieldCallbackTy Callback, void *OpaqueHandle)
Registers a yield callback with the given context.
void getSyncScopeNames(SmallVectorImpl< StringRef > &SSNs) const
getSyncScopeNames - Populates client supplied SmallVector with synchronization scope names registered...
void yield()
Calls the yield callback (if applicable).
LLVMContext::InlineAsmDiagHandlerTy InlineAsmDiagHandler
void setDiscardValueNames(bool Discard)
Set the Context runtime configuration to discard all value name (but GlobalValue).
void disableDebugTypeODRUniquing()
unsigned getMDKindID(StringRef Name) const
getMDKindID - Return a unique non-zero ID for the specified metadata kind.
void setDiagnosticsHotnessThreshold(uint64_t Threshold)
Set the minimum hotness value a diagnostic needs in order to be included in optimization diagnostics...
DiagnosticSeverity
Defines the different supported severity of a diagnostic.
unsigned size() const
Definition: StringMap.h:111
Twine - A lightweight data structure for efficiently representing the concatenation of temporary valu...
Definition: Twine.h:80
void getMDKindNames(SmallVectorImpl< StringRef > &Result) const
getMDKindNames - Populate client supplied SmallVector with the name for custom metadata IDs registere...
void deleteGC(const Function &Fn)
Remove the GC for a function.
std::unique_ptr< DiagnosticHandler > DiagHandler
bool DiscardValueNames
Flag to indicate if Value (other than GlobalValue) retains their name or not.
static void DiagHandler(const SMDiagnostic &Diag, void *Context)
Definition: TextStub.cpp:1093
void emitError(unsigned LocCookie, const Twine &ErrorStr)
emitError - Emit an error message to the currently installed error handler with optional location inf...
OptPassGate & getOptPassGate() const
Access the object which can disable optional passes and individual optimizations at compile time...
void setDiagnosticsHotnessRequested(bool Requested)
Set if a code hotness metric should be included in optimization diagnostics.
void setOptPassGate(OptPassGate &)
Set the object which can disable optional passes and individual optimizations at compile time...
void(*)(const DiagnosticInfo &DI, void *Context) DiagnosticHandlerTy
LLVMContext::YieldCallbackTy YieldCallback
void setDiagnosticHandlerCallBack(DiagnosticHandler::DiagnosticHandlerTy DiagHandler, void *DiagContext=nullptr, bool RespectFilters=false)
setDiagnosticHandlerCallBack - This method sets a handler call back that is invoked when the backend ...
StringMap< unsigned > CustomMDKindNames
CustomMDKindNames - Map to hold the metadata string to ID mapping.
void setOptPassGate(OptPassGate &)
Set the object which can disable optional passes and individual optimizations at compile time...
This is the base abstract class for diagnostic reporting in the backend.
OptPassGate & getOptPassGate() const
Access the object which can disable optional passes and individual optimizations at compile time...
This is an important class for using LLVM in a threaded context.
Definition: LLVMContext.h:64
StringMapEntry< uint32_t > * getOrInsertBundleTag(StringRef Tag)
bool shouldDiscardValueNames() const
Return true if the Context runtime configuration is set to discard all value names.
static GCRegistry::Add< CoreCLRGC > E("coreclr", "CoreCLR-compatible GC")
void getOperandBundleTags(SmallVectorImpl< StringRef > &Result) const
getOperandBundleTags - Populate client supplied SmallVector with the bundle tags registered in this L...
void getSyncScopeNames(SmallVectorImpl< StringRef > &SSNs) const
getSyncScopeNames - Populates client supplied SmallVector with synchronization scope names registered...
std::pair< iterator, bool > insert(PtrType Ptr)
Inserts Ptr if and only if there is no element in the container equal to Ptr.
Definition: SmallPtrSet.h:370
uint64_t getDiagnosticsHotnessThreshold() const
Return the minimum hotness value a diagnostic would need in order to be included in optimization diag...
bool getDiagnosticsHotnessRequested() const
Return if a code hotness metric should be included in optimization diagnostics.
bool isODRUniquingDebugTypes() const
Whether there is a string map for uniquing debug info identifiers across the context.
uint64_t DiagnosticsHotnessThreshold
Diagnostic information for inline asm reporting.
virtual void print(DiagnosticPrinter &DP) const =0
Print using the given DP a user-friendly message.
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
LLVMContextImpl *const pImpl
Definition: LLVMContext.h:66
bool erase(PtrType Ptr)
erase - If the set contains the specified pointer, remove it and return true, otherwise return false...
Definition: SmallPtrSet.h:377
Module.h This file contains the declarations for the Module class.
static const char * getDiagnosticMessagePrefix(DiagnosticSeverity Severity)
Get the prefix that should be printed in front of a diagnostic of the given Severity.
bool insert(MapEntryTy *KeyValue)
insert - Insert the specified key/value pair into the map.
Definition: StringMap.h:393
SmallPtrSet< Module *, 4 > OwnedModules
OwnedModules - The set of modules instantiated in this context, and which will be automatically delet...
StringMap - This is an unconventional map that is specialized for handling keys that are "strings"...
Definition: StringMap.h:242
void(*)(const SMDiagnostic &, void *Context, unsigned LocCookie) InlineAsmDiagHandlerTy
Definition: LLVMContext.h:144
Synchronized with respect to all concurrently executing threads.
Definition: LLVMContext.h:54
static cl::opt< unsigned > Threshold("loop-unswitch-threshold", cl::desc("Max loop size to unswitch"), cl::init(100), cl::Hidden)
Streamer for remarks.
SyncScope::ID getOrInsertSyncScopeID(StringRef SSN)
getOrInsertSyncScopeID - Maps synchronization scope name to synchronization scope ID...
Basic diagnostic printer that uses an underlying raw_ostream.
iterator begin()
Definition: StringMap.h:337
#define I(x, y, z)
Definition: MD5.cpp:58
DenseMap< const Function *, std::string > GCNames
Maintain the GC name for each function.
DiagnosticSeverity getSeverity() const
InlineAsmDiagHandlerTy getInlineAsmDiagnosticHandler() const
getInlineAsmDiagnosticHandler - Return the diagnostic handler set by setInlineAsmDiagnosticHandler.
void diagnose(const DiagnosticInfo &DI)
Report a message to the currently installed diagnostic handler.
std::unique_ptr< RemarkStreamer > RemarkDiagStreamer
const DiagnosticHandler * getDiagHandlerPtr() const
getDiagHandlerPtr - Returns const raw pointer of DiagnosticHandler set by setDiagnosticHandler.
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
Synchronized with respect to signal handlers executing in the same thread.
Definition: LLVMContext.h:51
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:48
void * getDiagnosticContext() const
getDiagnosticContext - Return the diagnostic context set by setDiagnosticContext. ...
static bool isDiagnosticEnabled(const DiagnosticInfo &DI)
DiagnosticHandler::DiagnosticHandlerTy getDiagnosticHandlerCallBack() const
getDiagnosticHandlerCallBack - Return the diagnostic handler call back set by setDiagnosticHandlerCal...
Optional< DenseMap< const MDString *, DICompositeType * > > DITypeMap
iterator end()
Definition: StringMap.h:340
uint32_t getOperandBundleTagID(StringRef Tag) const
getOperandBundleTagID - Maps a bundle tag to an integer ID.
void resize(size_type N)
Definition: SmallVector.h:344