mirror of
https://github.com/RPCS3/llvm-mirror.git
synced 2024-10-25 22:12:57 +02:00
091cf86389
Summary: The bitcode format is described in this document: https://drive.google.com/file/d/0B036uwnWM6RWdnBLakxmeDdOeXc/view For more info on ThinLTO see: https://sites.google.com/site/llvmthinlto The first customer is ThinLTO, however the data structures are designed and named more generally based on prior feedback. There are a few comments regarding how certain interfaces are used by ThinLTO, and the options added here to gold currently have ThinLTO-specific names as the behavior they provoke is currently ThinLTO-specific. This patch includes support for generating per-module function indexes, the combined index file via the gold plugin, and several tests (more are included with the associated clang patch D11908). Reviewers: dexonsmith, davidxl, joker.eph Subscribers: llvm-commits Differential Revision: http://reviews.llvm.org/D13107 llvm-svn: 249270
72 lines
2.4 KiB
C++
72 lines
2.4 KiB
C++
//===-- BitcodeWriterPass.h - Bitcode writing pass --------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
/// \file
|
|
///
|
|
/// This file provides a bitcode writing pass.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_BITCODE_BITCODEWRITERPASS_H
|
|
#define LLVM_BITCODE_BITCODEWRITERPASS_H
|
|
|
|
#include "llvm/ADT/StringRef.h"
|
|
|
|
namespace llvm {
|
|
class Module;
|
|
class ModulePass;
|
|
class raw_ostream;
|
|
class PreservedAnalyses;
|
|
|
|
/// \brief Create and return a pass that writes the module to the specified
|
|
/// ostream. Note that this pass is designed for use with the legacy pass
|
|
/// manager.
|
|
///
|
|
/// If \c ShouldPreserveUseListOrder, encode use-list order so it can be
|
|
/// reproduced when deserialized.
|
|
///
|
|
/// If \c EmitFunctionSummary, emit the function summary index (currently
|
|
/// for use in ThinLTO optimization).
|
|
ModulePass *createBitcodeWriterPass(raw_ostream &Str,
|
|
bool ShouldPreserveUseListOrder = false,
|
|
bool EmitFunctionSummary = false);
|
|
|
|
/// \brief Pass for writing a module of IR out to a bitcode file.
|
|
///
|
|
/// Note that this is intended for use with the new pass manager. To construct
|
|
/// a pass for the legacy pass manager, use the function above.
|
|
class BitcodeWriterPass {
|
|
raw_ostream &OS;
|
|
bool ShouldPreserveUseListOrder;
|
|
bool EmitFunctionSummary;
|
|
|
|
public:
|
|
/// \brief Construct a bitcode writer pass around a particular output stream.
|
|
///
|
|
/// If \c ShouldPreserveUseListOrder, encode use-list order so it can be
|
|
/// reproduced when deserialized.
|
|
///
|
|
/// If \c EmitFunctionSummary, emit the function summary index (currently
|
|
/// for use in ThinLTO optimization).
|
|
explicit BitcodeWriterPass(raw_ostream &OS,
|
|
bool ShouldPreserveUseListOrder = false,
|
|
bool EmitFunctionSummary = false)
|
|
: OS(OS), ShouldPreserveUseListOrder(ShouldPreserveUseListOrder),
|
|
EmitFunctionSummary(EmitFunctionSummary) {}
|
|
|
|
/// \brief Run the bitcode writer pass, and output the module to the selected
|
|
/// output stream.
|
|
PreservedAnalyses run(Module &M);
|
|
|
|
static StringRef name() { return "BitcodeWriterPass"; }
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|