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 const char *DiagnosticInfo::AlwaysPrint = "";
  95
  96 DiagnosticInfoInlineAsm::DiagnosticInfoInlineAsm(const Instruction &I,
  97                                                  const Twine &MsgStr,
  98                                                  DiagnosticSeverity Severity)
  99     : DiagnosticInfo(DK_InlineAsm, Severity), LocCookie(0), MsgStr(MsgStr),
 100       Instr(&I) {
 101   if (const MDNode *SrcLoc = I.getMetadata("srcloc")) {
 102     if (SrcLoc->getNumOperands() != 0)
 103       if (const auto *CI =
 104               mdconst::dyn_extract<ConstantInt>(SrcLoc->getOperand(0)))
 105         LocCookie = CI->getZExtValue();
 106   }
 107 }
 108
 109 void DiagnosticInfoInlineAsm::print(DiagnosticPrinter &DP) const {
 110   DP << getMsgStr();
 111   if (getLocCookie())
 112     DP << " at line " << getLocCookie();
 113 }
 114
 115 void DiagnosticInfoStackSize::print(DiagnosticPrinter &DP) const {
 116   DP << "stack size limit exceeded (" << getStackSize() << ") in "
 117      << getFunction();
 118 }
 119
 120 void DiagnosticInfoDebugMetadataVersion::print(DiagnosticPrinter &DP) const {
 121   DP << "ignoring debug info with an invalid version (" << getMetadataVersion()
 122      << ") in " << getModule();
 123 }
 124
 125 void DiagnosticInfoSampleProfile::print(DiagnosticPrinter &DP) const {
 126   if (getFileName() && getLineNum() > 0)
 127     DP << getFileName() << ":" << getLineNum() << ": ";
 128   else if (getFileName())
 129     DP << getFileName() << ": ";
 130   DP << getMsg();
 131 }
 132
 133 bool DiagnosticInfoOptimizationBase::isLocationAvailable() const {
 134   return getDebugLoc();
 135 }
 136
 137 void DiagnosticInfoOptimizationBase::getLocation(StringRef *Filename,
 138                                                  unsigned *Line,
 139                                                  unsigned *Column) const {
 140   DILocation *L = getDebugLoc();
 141   assert(L != nullptr && "debug location is invalid");
 142   *Filename = L->getFilename();
 143   *Line = L->getLine();
 144   *Column = L->getColumn();
 145 }
 146
 147 const std::string DiagnosticInfoOptimizationBase::getLocationStr() const {
 148   StringRef Filename("<unknown>");
 149   unsigned Line = 0;
 150   unsigned Column = 0;
 151   if (isLocationAvailable())
 152     getLocation(&Filename, &Line, &Column);
 153   return (Filename + ":" + Twine(Line) + ":" + Twine(Column)).str();
 154 }
 155
 156 void DiagnosticInfoOptimizationBase::print(DiagnosticPrinter &DP) const {
 157   DP << getLocationStr() << ": " << getMsg();
 158 }
 159
 160 bool DiagnosticInfoOptimizationRemark::isEnabled() const {
 161   return PassRemarksOptLoc.Pattern &&
 162          PassRemarksOptLoc.Pattern->match(getPassName());
 163 }
 164
 165 bool DiagnosticInfoOptimizationRemarkMissed::isEnabled() const {
 166   return PassRemarksMissedOptLoc.Pattern &&
 167          PassRemarksMissedOptLoc.Pattern->match(getPassName());
 168 }
 169
 170 bool DiagnosticInfoOptimizationRemarkAnalysis::isEnabled() const {
 171   return getPassName() == DiagnosticInfo::AlwaysPrint ||
 172          (PassRemarksAnalysisOptLoc.Pattern &&
 173           PassRemarksAnalysisOptLoc.Pattern->match(getPassName()));
 174 }
 175
 176 void DiagnosticInfoMIRParser::print(DiagnosticPrinter &DP) const {
 177   DP << Diagnostic;
 178 }
 179
 180 void llvm::emitOptimizationRemark(LLVMContext &Ctx, const char *PassName,
 181                                   const Function &Fn, const DebugLoc &DLoc,
 182                                   const Twine &Msg) {
 183   Ctx.diagnose(DiagnosticInfoOptimizationRemark(PassName, Fn, DLoc, Msg));
 184 }
 185
 186 void llvm::emitOptimizationRemarkMissed(LLVMContext &Ctx, const char *PassName,
 187                                         const Function &Fn,
 188                                         const DebugLoc &DLoc,
 189                                         const Twine &Msg) {
 190   Ctx.diagnose(DiagnosticInfoOptimizationRemarkMissed(PassName, Fn, DLoc, Msg));
 191 }
 192
 193 void llvm::emitOptimizationRemarkAnalysis(LLVMContext &Ctx,
 194                                           const char *PassName,
 195                                           const Function &Fn,
 196                                           const DebugLoc &DLoc,
 197                                           const Twine &Msg) {
 198   Ctx.diagnose(
 199       DiagnosticInfoOptimizationRemarkAnalysis(PassName, Fn, DLoc, Msg));
 200 }
 201
 202 void llvm::emitOptimizationRemarkAnalysisFPCommute(LLVMContext &Ctx,
 203                                                    const char *PassName,
 204                                                    const Function &Fn,
 205                                                    const DebugLoc &DLoc,
 206                                                    const Twine &Msg) {
 207   Ctx.diagnose(DiagnosticInfoOptimizationRemarkAnalysisFPCommute(PassName, Fn,
 208                                                                  DLoc, Msg));
 209 }
 210
 211 void llvm::emitOptimizationRemarkAnalysisAliasing(LLVMContext &Ctx,
 212                                                   const char *PassName,
 213                                                   const Function &Fn,
 214                                                   const DebugLoc &DLoc,
 215                                                   const Twine &Msg) {
 216   Ctx.diagnose(DiagnosticInfoOptimizationRemarkAnalysisAliasing(PassName, Fn,
 217                                                                 DLoc, Msg));
 218 }
 219
 220 bool DiagnosticInfoOptimizationFailure::isEnabled() const {
 221   // Only print warnings.
 222   return getSeverity() == DS_Warning;
 223 }
 224
 225 void llvm::emitLoopVectorizeWarning(LLVMContext &Ctx, const Function &Fn,
 226                                     const DebugLoc &DLoc, const Twine &Msg) {
 227   Ctx.diagnose(DiagnosticInfoOptimizationFailure(
 228       Fn, DLoc, Twine("loop not vectorized: " + Msg)));
 229 }
 230
 231 void llvm::emitLoopInterleaveWarning(LLVMContext &Ctx, const Function &Fn,
 232                                      const DebugLoc &DLoc, const Twine &Msg) {
 233   Ctx.diagnose(DiagnosticInfoOptimizationFailure(
 234       Fn, DLoc, Twine("loop not interleaved: " + Msg)));
 235 }