lib/LTO/LTOCodeGenerator.cpp

   1 //===-LTOCodeGenerator.cpp - LLVM Link Time Optimizer ---------------------===//
   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 implements the Link Time Optimization library. This library is
  11 // intended to be used by linker to optimize code at link time.
  12 //
  13 //===----------------------------------------------------------------------===//
  14
  15 #include "llvm/LTO/LTOCodeGenerator.h"
  16 #include "llvm/ADT/StringExtras.h"
  17 #include "llvm/Analysis/Passes.h"
  18 #include "llvm/Bitcode/ReaderWriter.h"
  19 #include "llvm/CodeGen/RuntimeLibcalls.h"
  20 #include "llvm/Config/config.h"
  21 #include "llvm/IR/Constants.h"
  22 #include "llvm/IR/DataLayout.h"
  23 #include "llvm/IR/DerivedTypes.h"
  24 #include "llvm/IR/DiagnosticInfo.h"
  25 #include "llvm/IR/DiagnosticPrinter.h"
  26 #include "llvm/IR/LLVMContext.h"
  27 #include "llvm/IR/Mangler.h"
  28 #include "llvm/IR/Module.h"
  29 #include "llvm/IR/Verifier.h"
  30 #include "llvm/InitializePasses.h"
  31 #include "llvm/LTO/LTOModule.h"
  32 #include "llvm/Linker/Linker.h"
  33 #include "llvm/MC/MCAsmInfo.h"
  34 #include "llvm/MC/MCContext.h"
  35 #include "llvm/MC/SubtargetFeature.h"
  36 #include "llvm/PassManager.h"
  37 #include "llvm/Support/CommandLine.h"
  38 #include "llvm/Support/FileSystem.h"
  39 #include "llvm/Support/FormattedStream.h"
  40 #include "llvm/Support/Host.h"
  41 #include "llvm/Support/MemoryBuffer.h"
  42 #include "llvm/Support/Signals.h"
  43 #include "llvm/Support/TargetRegistry.h"
  44 #include "llvm/Support/TargetSelect.h"
  45 #include "llvm/Support/ToolOutputFile.h"
  46 #include "llvm/Support/raw_ostream.h"
  47 #include "llvm/Support/system_error.h"
  48 #include "llvm/Target/TargetLibraryInfo.h"
  49 #include "llvm/Target/TargetLowering.h"
  50 #include "llvm/Target/TargetOptions.h"
  51 #include "llvm/Target/TargetRegisterInfo.h"
  52 #include "llvm/Transforms/IPO.h"
  53 #include "llvm/Transforms/IPO/PassManagerBuilder.h"
  54 #include "llvm/Transforms/ObjCARC.h"
  55 using namespace llvm;
  56
  57 const char* LTOCodeGenerator::getVersionString() {
  58 #ifdef LLVM_VERSION_INFO
  59   return PACKAGE_NAME " version " PACKAGE_VERSION ", " LLVM_VERSION_INFO;
  60 #else
  61   return PACKAGE_NAME " version " PACKAGE_VERSION;
  62 #endif
  63 }
  64
  65 LTOCodeGenerator::LTOCodeGenerator()
  66     : Context(getGlobalContext()), Linker(new Module("ld-temp.o", Context)),
  67       TargetMach(NULL), EmitDwarfDebugInfo(false), ScopeRestrictionsDone(false),
  68       CodeModel(LTO_CODEGEN_PIC_MODEL_DYNAMIC),
  69       InternalizeStrategy(LTO_INTERNALIZE_FULL), NativeObjectFile(NULL),
  70       DiagHandler(NULL), DiagContext(NULL) {
  71   initializeLTOPasses();
  72 }
  73
  74 LTOCodeGenerator::~LTOCodeGenerator() {
  75   delete TargetMach;
  76   delete NativeObjectFile;
  77   TargetMach = NULL;
  78   NativeObjectFile = NULL;
  79
  80   Linker.deleteModule();
  81
  82   for (std::vector<char *>::iterator I = CodegenOptions.begin(),
  83                                      E = CodegenOptions.end();
  84        I != E; ++I)
  85     free(*I);
  86 }
  87
  88 // Initialize LTO passes. Please keep this funciton in sync with
  89 // PassManagerBuilder::populateLTOPassManager(), and make sure all LTO
  90 // passes are initialized.
  91 void LTOCodeGenerator::initializeLTOPasses() {
  92   PassRegistry &R = *PassRegistry::getPassRegistry();
  93
  94   initializeInternalizePassPass(R);
  95   initializeIPSCCPPass(R);
  96   initializeGlobalOptPass(R);
  97   initializeConstantMergePass(R);
  98   initializeDAHPass(R);
  99   initializeInstCombinerPass(R);
 100   initializeSimpleInlinerPass(R);
 101   initializePruneEHPass(R);
 102   initializeGlobalDCEPass(R);
 103   initializeArgPromotionPass(R);
 104   initializeJumpThreadingPass(R);
 105   initializeSROAPass(R);
 106   initializeSROA_DTPass(R);
 107   initializeSROA_SSAUpPass(R);
 108   initializeFunctionAttrsPass(R);
 109   initializeGlobalsModRefPass(R);
 110   initializeLICMPass(R);
 111   initializeGVNPass(R);
 112   initializeMemCpyOptPass(R);
 113   initializeDCEPass(R);
 114   initializeCFGSimplifyPassPass(R);
 115 }
 116
 117 bool LTOCodeGenerator::addModule(LTOModule* mod, std::string& errMsg) {
 118   bool ret = Linker.linkInModule(mod->getLLVVMModule(), &errMsg);
 119
 120   const std::vector<const char*> &undefs = mod->getAsmUndefinedRefs();
 121   for (int i = 0, e = undefs.size(); i != e; ++i)
 122     AsmUndefinedRefs[undefs[i]] = 1;
 123
 124   return !ret;
 125 }
 126
 127 void LTOCodeGenerator::setTargetOptions(TargetOptions options) {
 128   Options.LessPreciseFPMADOption = options.LessPreciseFPMADOption;
 129   Options.NoFramePointerElim = options.NoFramePointerElim;
 130   Options.AllowFPOpFusion = options.AllowFPOpFusion;
 131   Options.UnsafeFPMath = options.UnsafeFPMath;
 132   Options.NoInfsFPMath = options.NoInfsFPMath;
 133   Options.NoNaNsFPMath = options.NoNaNsFPMath;
 134   Options.HonorSignDependentRoundingFPMathOption =
 135     options.HonorSignDependentRoundingFPMathOption;
 136   Options.UseSoftFloat = options.UseSoftFloat;
 137   Options.FloatABIType = options.FloatABIType;
 138   Options.NoZerosInBSS = options.NoZerosInBSS;
 139   Options.GuaranteedTailCallOpt = options.GuaranteedTailCallOpt;
 140   Options.DisableTailCalls = options.DisableTailCalls;
 141   Options.StackAlignmentOverride = options.StackAlignmentOverride;
 142   Options.TrapFuncName = options.TrapFuncName;
 143   Options.PositionIndependentExecutable = options.PositionIndependentExecutable;
 144   Options.EnableSegmentedStacks = options.EnableSegmentedStacks;
 145   Options.UseInitArray = options.UseInitArray;
 146 }
 147
 148 void LTOCodeGenerator::setDebugInfo(lto_debug_model debug) {
 149   switch (debug) {
 150   case LTO_DEBUG_MODEL_NONE:
 151     EmitDwarfDebugInfo = false;
 152     return;
 153
 154   case LTO_DEBUG_MODEL_DWARF:
 155     EmitDwarfDebugInfo = true;
 156     return;
 157   }
 158   llvm_unreachable("Unknown debug format!");
 159 }
 160
 161 void LTOCodeGenerator::setCodePICModel(lto_codegen_model model) {
 162   switch (model) {
 163   case LTO_CODEGEN_PIC_MODEL_STATIC:
 164   case LTO_CODEGEN_PIC_MODEL_DYNAMIC:
 165   case LTO_CODEGEN_PIC_MODEL_DYNAMIC_NO_PIC:
 166     CodeModel = model;
 167     return;
 168   }
 169   llvm_unreachable("Unknown PIC model!");
 170 }
 171
 172 void
 173 LTOCodeGenerator::setInternalizeStrategy(lto_internalize_strategy Strategy) {
 174   switch (Strategy) {
 175   case LTO_INTERNALIZE_FULL:
 176   case LTO_INTERNALIZE_NONE:
 177   case LTO_INTERNALIZE_HIDDEN:
 178     InternalizeStrategy = Strategy;
 179     return;
 180   }
 181   llvm_unreachable("Unknown internalize strategy!");
 182 }
 183
 184 bool LTOCodeGenerator::writeMergedModules(const char *path,
 185                                           std::string &errMsg) {
 186   if (!determineTarget(errMsg))
 187     return false;
 188
 189   // mark which symbols can not be internalized
 190   applyScopeRestrictions();
 191
 192   // create output file
 193   std::string ErrInfo;
 194   tool_output_file Out(path, ErrInfo, sys::fs::F_None);
 195   if (!ErrInfo.empty()) {
 196     errMsg = "could not open bitcode file for writing: ";
 197     errMsg += path;
 198     return false;
 199   }
 200
 201   // write bitcode to it
 202   WriteBitcodeToFile(Linker.getModule(), Out.os());
 203   Out.os().close();
 204
 205   if (Out.os().has_error()) {
 206     errMsg = "could not write bitcode file: ";
 207     errMsg += path;
 208     Out.os().clear_error();
 209     return false;
 210   }
 211
 212   Out.keep();
 213   return true;
 214 }
 215
 216 bool LTOCodeGenerator::compile_to_file(const char** name,
 217                                        bool disableOpt,
 218                                        bool disableInline,
 219                                        bool disableGVNLoadPRE,
 220                                        std::string& errMsg) {
 221   // make unique temp .o file to put generated object file
 222   SmallString<128> Filename;
 223   int FD;
 224   error_code EC = sys::fs::createTemporaryFile("lto-llvm", "o", FD, Filename);
 225   if (EC) {
 226     errMsg = EC.message();
 227     return false;
 228   }
 229
 230   // generate object file
 231   tool_output_file objFile(Filename.c_str(), FD);
 232
 233   bool genResult = generateObjectFile(objFile.os(), disableOpt, disableInline,
 234                                       disableGVNLoadPRE, errMsg);
 235   objFile.os().close();
 236   if (objFile.os().has_error()) {
 237     objFile.os().clear_error();
 238     sys::fs::remove(Twine(Filename));
 239     return false;
 240   }
 241
 242   objFile.keep();
 243   if (!genResult) {
 244     sys::fs::remove(Twine(Filename));
 245     return false;
 246   }
 247
 248   NativeObjectPath = Filename.c_str();
 249   *name = NativeObjectPath.c_str();
 250   return true;
 251 }
 252
 253 const void* LTOCodeGenerator::compile(size_t* length,
 254                                       bool disableOpt,
 255                                       bool disableInline,
 256                                       bool disableGVNLoadPRE,
 257                                       std::string& errMsg) {
 258   const char *name;
 259   if (!compile_to_file(&name, disableOpt, disableInline, disableGVNLoadPRE,
 260                        errMsg))
 261     return NULL;
 262
 263   // remove old buffer if compile() called twice
 264   delete NativeObjectFile;
 265
 266   // read .o file into memory buffer
 267   std::unique_ptr<MemoryBuffer> BuffPtr;
 268   if (error_code ec = MemoryBuffer::getFile(name, BuffPtr, -1, false)) {
 269     errMsg = ec.message();
 270     sys::fs::remove(NativeObjectPath);
 271     return NULL;
 272   }
 273   NativeObjectFile = BuffPtr.release();
 274
 275   // remove temp files
 276   sys::fs::remove(NativeObjectPath);
 277
 278   // return buffer, unless error
 279   if (NativeObjectFile == NULL)
 280     return NULL;
 281   *length = NativeObjectFile->getBufferSize();
 282   return NativeObjectFile->getBufferStart();
 283 }
 284
 285 bool LTOCodeGenerator::determineTarget(std::string &errMsg) {
 286   if (TargetMach != NULL)
 287     return true;
 288
 289   std::string TripleStr = Linker.getModule()->getTargetTriple();
 290   if (TripleStr.empty())
 291     TripleStr = sys::getDefaultTargetTriple();
 292   llvm::Triple Triple(TripleStr);
 293
 294   // create target machine from info for merged modules
 295   const Target *march = TargetRegistry::lookupTarget(TripleStr, errMsg);
 296   if (march == NULL)
 297     return false;
 298
 299   // The relocation model is actually a static member of TargetMachine and
 300   // needs to be set before the TargetMachine is instantiated.
 301   Reloc::Model RelocModel = Reloc::Default;
 302   switch (CodeModel) {
 303   case LTO_CODEGEN_PIC_MODEL_STATIC:
 304     RelocModel = Reloc::Static;
 305     break;
 306   case LTO_CODEGEN_PIC_MODEL_DYNAMIC:
 307     RelocModel = Reloc::PIC_;
 308     break;
 309   case LTO_CODEGEN_PIC_MODEL_DYNAMIC_NO_PIC:
 310     RelocModel = Reloc::DynamicNoPIC;
 311     break;
 312   }
 313
 314   // construct LTOModule, hand over ownership of module and target
 315   SubtargetFeatures Features;
 316   Features.getDefaultSubtargetFeatures(Triple);
 317   std::string FeatureStr = Features.getString();
 318   // Set a default CPU for Darwin triples.
 319   if (MCpu.empty() && Triple.isOSDarwin()) {
 320     if (Triple.getArch() == llvm::Triple::x86_64)
 321       MCpu = "core2";
 322     else if (Triple.getArch() == llvm::Triple::x86)
 323       MCpu = "yonah";
 324   }
 325
 326   TargetMach = march->createTargetMachine(TripleStr, MCpu, FeatureStr, Options,
 327                                           RelocModel, CodeModel::Default,
 328                                           CodeGenOpt::Aggressive);
 329   return true;
 330 }
 331
 332 void LTOCodeGenerator::
 333 applyRestriction(GlobalValue &GV,
 334                  const ArrayRef<StringRef> &Libcalls,
 335                  std::vector<const char*> &MustPreserveList,
 336                  SmallPtrSet<GlobalValue*, 8> &AsmUsed,
 337                  Mangler &Mangler) {
 338   // There are no restrictions to apply to declarations.
 339   if (GV.isDeclaration())
 340     return;
 341
 342   // There is nothing more restrictive than private linkage.
 343   if (GV.hasPrivateLinkage())
 344     return;
 345
 346   SmallString<64> Buffer;
 347   TargetMach->getNameWithPrefix(Buffer, &GV, Mangler);
 348
 349   if (MustPreserveSymbols.count(Buffer))
 350     MustPreserveList.push_back(GV.getName().data());
 351   if (AsmUndefinedRefs.count(Buffer))
 352     AsmUsed.insert(&GV);
 353
 354   // Conservatively append user-supplied runtime library functions to
 355   // llvm.compiler.used.  These could be internalized and deleted by
 356   // optimizations like -globalopt, causing problems when later optimizations
 357   // add new library calls (e.g., llvm.memset => memset and printf => puts).
 358   // Leave it to the linker to remove any dead code (e.g. with -dead_strip).
 359   if (isa<Function>(GV) &&
 360       std::binary_search(Libcalls.begin(), Libcalls.end(), GV.getName()))
 361     AsmUsed.insert(&GV);
 362 }
 363
 364 static void findUsedValues(GlobalVariable *LLVMUsed,
 365                            SmallPtrSet<GlobalValue*, 8> &UsedValues) {
 366   if (LLVMUsed == 0) return;
 367
 368   ConstantArray *Inits = cast<ConstantArray>(LLVMUsed->getInitializer());
 369   for (unsigned i = 0, e = Inits->getNumOperands(); i != e; ++i)
 370     if (GlobalValue *GV =
 371         dyn_cast<GlobalValue>(Inits->getOperand(i)->stripPointerCasts()))
 372       UsedValues.insert(GV);
 373 }
 374
 375 static void accumulateAndSortLibcalls(std::vector<StringRef> &Libcalls,
 376                                       const TargetLibraryInfo& TLI,
 377                                       const TargetLowering *Lowering)
 378 {
 379   // TargetLibraryInfo has info on C runtime library calls on the current
 380   // target.
 381   for (unsigned I = 0, E = static_cast<unsigned>(LibFunc::NumLibFuncs);
 382        I != E; ++I) {
 383     LibFunc::Func F = static_cast<LibFunc::Func>(I);
 384     if (TLI.has(F))
 385       Libcalls.push_back(TLI.getName(F));
 386   }
 387
 388   // TargetLowering has info on library calls that CodeGen expects to be
 389   // available, both from the C runtime and compiler-rt.
 390   if (Lowering)
 391     for (unsigned I = 0, E = static_cast<unsigned>(RTLIB::UNKNOWN_LIBCALL);
 392          I != E; ++I)
 393       if (const char *Name
 394           = Lowering->getLibcallName(static_cast<RTLIB::Libcall>(I)))
 395         Libcalls.push_back(Name);
 396
 397   array_pod_sort(Libcalls.begin(), Libcalls.end());
 398   Libcalls.erase(std::unique(Libcalls.begin(), Libcalls.end()),
 399                  Libcalls.end());
 400 }
 401
 402 void LTOCodeGenerator::applyScopeRestrictions() {
 403   if (ScopeRestrictionsDone || !shouldInternalize())
 404     return;
 405   Module *mergedModule = Linker.getModule();
 406
 407   // Start off with a verification pass.
 408   PassManager passes;
 409   passes.add(createVerifierPass());
 410
 411   // mark which symbols can not be internalized
 412   Mangler Mangler(TargetMach->getDataLayout());
 413   std::vector<const char*> MustPreserveList;
 414   SmallPtrSet<GlobalValue*, 8> AsmUsed;
 415   std::vector<StringRef> Libcalls;
 416   TargetLibraryInfo TLI(Triple(TargetMach->getTargetTriple()));
 417   accumulateAndSortLibcalls(Libcalls, TLI, TargetMach->getTargetLowering());
 418
 419   for (Module::iterator f = mergedModule->begin(),
 420          e = mergedModule->end(); f != e; ++f)
 421     applyRestriction(*f, Libcalls, MustPreserveList, AsmUsed, Mangler);
 422   for (Module::global_iterator v = mergedModule->global_begin(),
 423          e = mergedModule->global_end(); v !=  e; ++v)
 424     applyRestriction(*v, Libcalls, MustPreserveList, AsmUsed, Mangler);
 425   for (Module::alias_iterator a = mergedModule->alias_begin(),
 426          e = mergedModule->alias_end(); a != e; ++a)
 427     applyRestriction(*a, Libcalls, MustPreserveList, AsmUsed, Mangler);
 428
 429   GlobalVariable *LLVMCompilerUsed =
 430     mergedModule->getGlobalVariable("llvm.compiler.used");
 431   findUsedValues(LLVMCompilerUsed, AsmUsed);
 432   if (LLVMCompilerUsed)
 433     LLVMCompilerUsed->eraseFromParent();
 434
 435   if (!AsmUsed.empty()) {
 436     llvm::Type *i8PTy = llvm::Type::getInt8PtrTy(Context);
 437     std::vector<Constant*> asmUsed2;
 438     for (SmallPtrSet<GlobalValue*, 16>::const_iterator i = AsmUsed.begin(),
 439            e = AsmUsed.end(); i !=e; ++i) {
 440       GlobalValue *GV = *i;
 441       Constant *c = ConstantExpr::getBitCast(GV, i8PTy);
 442       asmUsed2.push_back(c);
 443     }
 444
 445     llvm::ArrayType *ATy = llvm::ArrayType::get(i8PTy, asmUsed2.size());
 446     LLVMCompilerUsed =
 447       new llvm::GlobalVariable(*mergedModule, ATy, false,
 448                                llvm::GlobalValue::AppendingLinkage,
 449                                llvm::ConstantArray::get(ATy, asmUsed2),
 450                                "llvm.compiler.used");
 451
 452     LLVMCompilerUsed->setSection("llvm.metadata");
 453   }
 454
 455   passes.add(
 456       createInternalizePass(MustPreserveList, shouldOnlyInternalizeHidden()));
 457
 458   // apply scope restrictions
 459   passes.run(*mergedModule);
 460
 461   ScopeRestrictionsDone = true;
 462 }
 463
 464 /// Optimize merged modules using various IPO passes
 465 bool LTOCodeGenerator::generateObjectFile(raw_ostream &out,
 466                                           bool DisableOpt,
 467                                           bool DisableInline,
 468                                           bool DisableGVNLoadPRE,
 469                                           std::string &errMsg) {
 470   if (!this->determineTarget(errMsg))
 471     return false;
 472
 473   Module *mergedModule = Linker.getModule();
 474
 475   // Mark which symbols can not be internalized
 476   this->applyScopeRestrictions();
 477
 478   // Instantiate the pass manager to organize the passes.
 479   PassManager passes;
 480
 481   // Start off with a verification pass.
 482   passes.add(createVerifierPass());
 483
 484   // Add an appropriate DataLayout instance for this module...
 485   mergedModule->setDataLayout(TargetMach->getDataLayout());
 486   passes.add(new DataLayoutPass(mergedModule));
 487
 488   // Add appropriate TargetLibraryInfo for this module.
 489   passes.add(new TargetLibraryInfo(Triple(TargetMach->getTargetTriple())));
 490
 491   TargetMach->addAnalysisPasses(passes);
 492
 493   // Enabling internalize here would use its AllButMain variant. It
 494   // keeps only main if it exists and does nothing for libraries. Instead
 495   // we create the pass ourselves with the symbol list provided by the linker.
 496   if (!DisableOpt)
 497     PassManagerBuilder().populateLTOPassManager(passes,
 498                                               /*Internalize=*/false,
 499                                               !DisableInline,
 500                                               DisableGVNLoadPRE);
 501
 502   // Make sure everything is still good.
 503   passes.add(createVerifierPass());
 504
 505   PassManager codeGenPasses;
 506
 507   codeGenPasses.add(new DataLayoutPass(mergedModule));
 508
 509   formatted_raw_ostream Out(out);
 510
 511   // If the bitcode files contain ARC code and were compiled with optimization,
 512   // the ObjCARCContractPass must be run, so do it unconditionally here.
 513   codeGenPasses.add(createObjCARCContractPass());
 514
 515   if (TargetMach->addPassesToEmitFile(codeGenPasses, Out,
 516                                       TargetMachine::CGFT_ObjectFile)) {
 517     errMsg = "target file type not supported";
 518     return false;
 519   }
 520
 521   // Run our queue of passes all at once now, efficiently.
 522   passes.run(*mergedModule);
 523
 524   // Run the code generator, and write assembly file
 525   codeGenPasses.run(*mergedModule);
 526
 527   return true;
 528 }
 529
 530 /// setCodeGenDebugOptions - Set codegen debugging options to aid in debugging
 531 /// LTO problems.
 532 void LTOCodeGenerator::setCodeGenDebugOptions(const char *options) {
 533   for (std::pair<StringRef, StringRef> o = getToken(options);
 534        !o.first.empty(); o = getToken(o.second)) {
 535     // ParseCommandLineOptions() expects argv[0] to be program name. Lazily add
 536     // that.
 537     if (CodegenOptions.empty())
 538       CodegenOptions.push_back(strdup("libLLVMLTO"));
 539     CodegenOptions.push_back(strdup(o.first.str().c_str()));
 540   }
 541 }
 542
 543 void LTOCodeGenerator::parseCodeGenDebugOptions() {
 544   // if options were requested, set them
 545   if (!CodegenOptions.empty())
 546     cl::ParseCommandLineOptions(CodegenOptions.size(),
 547                                 const_cast<char **>(&CodegenOptions[0]));
 548 }
 549
 550 void LTOCodeGenerator::DiagnosticHandler(const DiagnosticInfo &DI,
 551                                          void *Context) {
 552   ((LTOCodeGenerator *)Context)->DiagnosticHandler2(DI);
 553 }
 554
 555 void LTOCodeGenerator::DiagnosticHandler2(const DiagnosticInfo &DI) {
 556   // Map the LLVM internal diagnostic severity to the LTO diagnostic severity.
 557   lto_codegen_diagnostic_severity_t Severity;
 558   switch (DI.getSeverity()) {
 559   case DS_Error:
 560     Severity = LTO_DS_ERROR;
 561     break;
 562   case DS_Warning:
 563     Severity = LTO_DS_WARNING;
 564     break;
 565   case DS_Remark:
 566     Severity = LTO_DS_REMARK;
 567     break;
 568   case DS_Note:
 569     Severity = LTO_DS_NOTE;
 570     break;
 571   }
 572   // Create the string that will be reported to the external diagnostic handler.
 573   std::string MsgStorage;
 574   raw_string_ostream Stream(MsgStorage);
 575   DiagnosticPrinterRawOStream DP(Stream);
 576   DI.print(DP);
 577   Stream.flush();
 578
 579   // If this method has been called it means someone has set up an external
 580   // diagnostic handler. Assert on that.
 581   assert(DiagHandler && "Invalid diagnostic handler");
 582   (*DiagHandler)(Severity, MsgStorage.c_str(), DiagContext);
 583 }
 584
 585 void
 586 LTOCodeGenerator::setDiagnosticHandler(lto_diagnostic_handler_t DiagHandler,
 587                                        void *Ctxt) {
 588   this->DiagHandler = DiagHandler;
 589   this->DiagContext = Ctxt;
 590   if (!DiagHandler)
 591     return Context.setDiagnosticHandler(NULL, NULL);
 592   // Register the LTOCodeGenerator stub in the LLVMContext to forward the
 593   // diagnostic to the external DiagHandler.
 594   Context.setDiagnosticHandler(LTOCodeGenerator::DiagnosticHandler, this);
 595 }