lib/IR/DiagnosticInfo.cpp

   1 //===- llvm/Support/DiagnosticInfo.cpp - Diagnostic Definitions -*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file defines the different classes involved in low level diagnostics.
  11 //
  12 // Diagnostics reporting is still done as part of the LLVMContext.
  13 //===----------------------------------------------------------------------===//
  14
  15 #include "LLVMContextImpl.h"
  16 #include "llvm/ADT/Twine.h"
  17 #include "llvm/IR/Constants.h"
  18 #include "llvm/IR/DebugInfo.h"
  19 #include "llvm/IR/DiagnosticInfo.h"
  20 #include "llvm/IR/DiagnosticPrinter.h"
  21 #include "llvm/IR/Function.h"
  22 #include "llvm/IR/Instruction.h"
  23 #include "llvm/IR/Metadata.h"
  24 #include "llvm/IR/Module.h"
  25 #include "llvm/Support/CommandLine.h"
  26 #include "llvm/Support/Regex.h"
  27 #include <atomic>
  28 #include <string>
  29
  30 using namespace llvm;
  31
  32 namespace {
  33
  34 /// \brief Regular expression corresponding to the value given in one of the
  35 /// -pass-remarks* command line flags. Passes whose name matches this regexp
  36 /// will emit a diagnostic when calling the associated diagnostic function
  37 /// (emitOptimizationRemark, emitOptimizationRemarkMissed or
  38 /// emitOptimizationRemarkAnalysis).
  39 struct PassRemarksOpt {
  40   std::shared_ptr<Regex> Pattern;
  41
  42   void operator=(const std::string &Val) {
  43     // Create a regexp object to match pass names for emitOptimizationRemark.
  44     if (!Val.empty()) {
  45       Pattern = std::make_shared<Regex>(Val);
  46       std::string RegexError;
  47       if (!Pattern->isValid(RegexError))
  48         report_fatal_error("Invalid regular expression '" + Val +
  49                                "' in -pass-remarks: " + RegexError,
  50                            false);
  51     }
  52   };
  53 };
  54
  55 static PassRemarksOpt PassRemarksOptLoc;
  56 static PassRemarksOpt PassRemarksMissedOptLoc;
  57 static PassRemarksOpt PassRemarksAnalysisOptLoc;
  58
  59 // -pass-remarks
  60 //    Command line flag to enable emitOptimizationRemark()
  61 static cl::opt<PassRemarksOpt, true, cl::parser<std::string>>
  62 PassRemarks("pass-remarks", cl::value_desc("pattern"),
  63             cl::desc("Enable optimization remarks from passes whose name match "
  64                      "the given regular expression"),
  65             cl::Hidden, cl::location(PassRemarksOptLoc), cl::ValueRequired,
  66             cl::ZeroOrMore);
  67
  68 // -pass-remarks-missed
  69 //    Command line flag to enable emitOptimizationRemarkMissed()
  70 static cl::opt<PassRemarksOpt, true, cl::parser<std::string>> PassRemarksMissed(
  71     "pass-remarks-missed", cl::value_desc("pattern"),
  72     cl::desc("Enable missed optimization remarks from passes whose name match "
  73              "the given regular expression"),
  74     cl::Hidden, cl::location(PassRemarksMissedOptLoc), cl::ValueRequired,
  75     cl::ZeroOrMore);
  76
  77 // -pass-remarks-analysis
  78 //    Command line flag to enable emitOptimizationRemarkAnalysis()
  79 static cl::opt<PassRemarksOpt, true, cl::parser<std::string>>
  80 PassRemarksAnalysis(
  81     "pass-remarks-analysis", cl::value_desc("pattern"),
  82     cl::desc(
  83         "Enable optimization analysis remarks from passes whose name match "
  84         "the given regular expression"),
  85     cl::Hidden, cl::location(PassRemarksAnalysisOptLoc), cl::ValueRequired,
  86     cl::ZeroOrMore);
  87 }
  88
  89 int llvm::getNextAvailablePluginDiagnosticKind() {
  90   static std::atomic<int> PluginKindID(DK_FirstPluginKind);
  91   return ++PluginKindID;
  92 }
  93
  94 DiagnosticInfoInlineAsm::DiagnosticInfoInlineAsm(const Instruction &I,
  95                                                  const Twine &MsgStr,
  96                                                  DiagnosticSeverity Severity)
  97     : DiagnosticInfo(DK_InlineAsm, Severity), LocCookie(0), MsgStr(MsgStr),
  98       Instr(&I) {
  99   if (const MDNode *SrcLoc = I.getMetadata("srcloc")) {
 100     if (SrcLoc->getNumOperands() != 0)
 101       if (const auto *CI =
 102               mdconst::dyn_extract<ConstantInt>(SrcLoc->getOperand(0)))
 103         LocCookie = CI->getZExtValue();
 104   }
 105 }
 106
 107 void DiagnosticInfoInlineAsm::print(DiagnosticPrinter &DP) const {
 108   DP << getMsgStr();
 109   if (getLocCookie())
 110     DP << " at line " << getLocCookie();
 111 }
 112
 113 void DiagnosticInfoStackSize::print(DiagnosticPrinter &DP) const {
 114   DP << "stack size limit exceeded (" << getStackSize() << ") in "
 115      << getFunction();
 116 }
 117
 118 void DiagnosticInfoDebugMetadataVersion::print(DiagnosticPrinter &DP) const {
 119   DP << "ignoring debug info with an invalid version (" << getMetadataVersion()
 120      << ") in " << getModule();
 121 }
 122
 123 void DiagnosticInfoSampleProfile::print(DiagnosticPrinter &DP) const {
 124   if (getFileName() && getLineNum() > 0)
 125     DP << getFileName() << ":" << getLineNum() << ": ";
 126   else if (getFileName())
 127     DP << getFileName() << ": ";
 128   DP << getMsg();
 129 }
 130
 131 bool DiagnosticInfoOptimizationBase::isLocationAvailable() const {
 132   return getDebugLoc();
 133 }
 134
 135 void DiagnosticInfoOptimizationBase::getLocation(StringRef *Filename,
 136                                                  unsigned *Line,
 137                                                  unsigned *Column) const {
 138   DILocation *L = getDebugLoc();
 139   assert(L != nullptr && "debug location is invalid");
 140   *Filename = L->getFilename();
 141   *Line = L->getLine();
 142   *Column = L->getColumn();
 143 }
 144
 145 const std::string DiagnosticInfoOptimizationBase::getLocationStr() const {
 146   StringRef Filename("<unknown>");
 147   unsigned Line = 0;
 148   unsigned Column = 0;
 149   if (isLocationAvailable())
 150     getLocation(&Filename, &Line, &Column);
 151   return (Filename + ":" + Twine(Line) + ":" + Twine(Column)).str();
 152 }
 153
 154 void DiagnosticInfoOptimizationBase::print(DiagnosticPrinter &DP) const {
 155   DP << getLocationStr() << ": " << getMsg();
 156 }
 157
 158 bool DiagnosticInfoOptimizationRemark::isEnabled() const {
 159   return PassRemarksOptLoc.Pattern &&
 160          PassRemarksOptLoc.Pattern->match(getPassName());
 161 }
 162
 163 bool DiagnosticInfoOptimizationRemarkMissed::isEnabled() const {
 164   return PassRemarksMissedOptLoc.Pattern &&
 165          PassRemarksMissedOptLoc.Pattern->match(getPassName());
 166 }
 167
 168 bool DiagnosticInfoOptimizationRemarkAnalysis::isEnabled() const {
 169   return PassRemarksAnalysisOptLoc.Pattern &&
 170          PassRemarksAnalysisOptLoc.Pattern->match(getPassName());
 171 }
 172
 173 void DiagnosticInfoMIRParser::print(DiagnosticPrinter &DP) const {
 174   DP << Diagnostic;
 175 }
 176
 177 void llvm::emitOptimizationRemark(LLVMContext &Ctx, const char *PassName,
 178                                   const Function &Fn, const DebugLoc &DLoc,
 179                                   const Twine &Msg) {
 180   Ctx.diagnose(DiagnosticInfoOptimizationRemark(PassName, Fn, DLoc, Msg));
 181 }
 182
 183 void llvm::emitOptimizationRemarkMissed(LLVMContext &Ctx, const char *PassName,
 184                                         const Function &Fn,
 185                                         const DebugLoc &DLoc,
 186                                         const Twine &Msg) {
 187   Ctx.diagnose(DiagnosticInfoOptimizationRemarkMissed(PassName, Fn, DLoc, Msg));
 188 }
 189
 190 void llvm::emitOptimizationRemarkAnalysis(LLVMContext &Ctx,
 191                                           const char *PassName,
 192                                           const Function &Fn,
 193                                           const DebugLoc &DLoc,
 194                                           const Twine &Msg) {
 195   Ctx.diagnose(
 196       DiagnosticInfoOptimizationRemarkAnalysis(PassName, Fn, DLoc, Msg));
 197 }
 198
 199 bool DiagnosticInfoOptimizationFailure::isEnabled() const {
 200   // Only print warnings.
 201   return getSeverity() == DS_Warning;
 202 }
 203
 204 void llvm::emitLoopVectorizeWarning(LLVMContext &Ctx, const Function &Fn,
 205                                     const DebugLoc &DLoc, const Twine &Msg) {
 206   Ctx.diagnose(DiagnosticInfoOptimizationFailure(
 207       Fn, DLoc, Twine("loop not vectorized: " + Msg)));
 208 }
 209
 210 void llvm::emitLoopInterleaveWarning(LLVMContext &Ctx, const Function &Fn,
 211                                      const DebugLoc &DLoc, const Twine &Msg) {
 212   Ctx.diagnose(DiagnosticInfoOptimizationFailure(
 213       Fn, DLoc, Twine("loop not interleaved: " + Msg)));
 214 }