Subversion Repositories QNX 8.QNX8 LLVM/Clang compiler suite

//===-LTOBackend.h - LLVM Link Time Optimizer Backend ---------------------===//

//

// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.

// See https://llvm.org/LICENSE.txt for license information.

// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception

//

//===----------------------------------------------------------------------===//

//

// This file implements the "backend" phase of LTO, i.e. it performs

// optimization and code generation on a loaded module. It is generally used

// internally by the LTO class but can also be used independently, for example

// to implement a standalone ThinLTO backend.

//

//===----------------------------------------------------------------------===//

#ifndef LLVM_LTO_LTOBACKEND_H

#define LLVM_LTO_LTOBACKEND_H

#include "llvm/ADT/MapVector.h"

#include "llvm/IR/DiagnosticInfo.h"

#include "llvm/IR/ModuleSummaryIndex.h"

#include "llvm/LTO/LTO.h"

#include "llvm/Support/MemoryBuffer.h"

#include "llvm/Target/TargetOptions.h"

#include "llvm/Transforms/IPO/FunctionImport.h"

namespace llvm {

class BitcodeModule;

class Error;

class Module;

class Target;

namespace lto {

/// Runs middle-end LTO optimizations on \p Mod.

bool opt(const Config &Conf, TargetMachine *TM, unsigned Task, Module &Mod,

         bool IsThinLTO, ModuleSummaryIndex *ExportSummary,

         const ModuleSummaryIndex *ImportSummary,

         const std::vector<uint8_t> &CmdArgs);

/// Runs a regular LTO backend. The regular LTO backend can also act as the

/// regular LTO phase of ThinLTO, which may need to access the combined index.

Error backend(const Config &C, AddStreamFn AddStream,

              unsigned ParallelCodeGenParallelismLevel, Module &M,

              ModuleSummaryIndex &CombinedIndex);

/// Runs a ThinLTO backend.

/// If \p ModuleMap is not nullptr, all the module files to be imported have

/// already been mapped to memory and the corresponding BitcodeModule objects

/// are saved in the ModuleMap. If \p ModuleMap is nullptr, module files will

/// be mapped to memory on demand and at any given time during importing, only

/// one source module will be kept open at the most.

Error thinBackend(const Config &C, unsigned Task, AddStreamFn AddStream,

                  Module &M, const ModuleSummaryIndex &CombinedIndex,

                  const FunctionImporter::ImportMapTy &ImportList,

                  const GVSummaryMapTy &DefinedGlobals,

                  MapVector<StringRef, BitcodeModule> *ModuleMap,

                  const std::vector<uint8_t> &CmdArgs = std::vector<uint8_t>());

Error finalizeOptimizationRemarks(

    std::unique_ptr<ToolOutputFile> DiagOutputFile);

/// Returns the BitcodeModule that is ThinLTO.

BitcodeModule *findThinLTOModule(MutableArrayRef<BitcodeModule> BMs);

/// Variant of the above.

Expected<BitcodeModule> findThinLTOModule(MemoryBufferRef MBRef);

/// Distributed ThinLTO: collect the referenced modules based on

/// module summary and initialize ImportList. Returns false if the

/// operation failed.

bool initImportList(const Module &M, const ModuleSummaryIndex &CombinedIndex,

                    FunctionImporter::ImportMapTy &ImportList);

}

}

#endif