6024e5c395
clang 20.0.0 (based on r547379) from build 12806354. Bug: http://b/379133546 Test: N/A Change-Id: I2eb8938af55d809de674be63cb30cf27e801862b Upstream-Commit: ad834e67b1105d15ef907f6255d4c96e8e733f57
107 lines
3.9 KiB
C++
107 lines
3.9 KiB
C++
//===- MIRParser.h - MIR serialization format parser ------------*- C++ -*-===//
|
|
//
|
|
// 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 MIR serialization library is currently a work in progress. It can't
|
|
// serialize machine functions at this time.
|
|
//
|
|
// This file declares the functions that parse the MIR serialization format
|
|
// files.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_CODEGEN_MIRPARSER_MIRPARSER_H
|
|
#define LLVM_CODEGEN_MIRPARSER_MIRPARSER_H
|
|
|
|
#include "llvm/ADT/STLFunctionalExtras.h"
|
|
#include "llvm/ADT/StringRef.h"
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <optional>
|
|
|
|
namespace llvm {
|
|
|
|
class Function;
|
|
class LLVMContext;
|
|
class MemoryBuffer;
|
|
class Module;
|
|
class MIRParserImpl;
|
|
class MachineModuleInfo;
|
|
class SMDiagnostic;
|
|
class StringRef;
|
|
|
|
template <typename IRUnitT, typename... ExtraArgTs> class AnalysisManager;
|
|
using ModuleAnalysisManager = AnalysisManager<Module>;
|
|
|
|
typedef llvm::function_ref<std::optional<std::string>(StringRef, StringRef)>
|
|
DataLayoutCallbackTy;
|
|
|
|
/// This class initializes machine functions by applying the state loaded from
|
|
/// a MIR file.
|
|
class MIRParser {
|
|
std::unique_ptr<MIRParserImpl> Impl;
|
|
|
|
public:
|
|
MIRParser(std::unique_ptr<MIRParserImpl> Impl);
|
|
MIRParser(const MIRParser &) = delete;
|
|
~MIRParser();
|
|
|
|
/// Parses the optional LLVM IR module in the MIR file.
|
|
///
|
|
/// A new, empty module is created if the LLVM IR isn't present.
|
|
/// \returns nullptr if a parsing error occurred.
|
|
std::unique_ptr<Module>
|
|
parseIRModule(DataLayoutCallbackTy DataLayoutCallback =
|
|
[](StringRef, StringRef) { return std::nullopt; });
|
|
|
|
/// Parses MachineFunctions in the MIR file and add them to the given
|
|
/// MachineModuleInfo \p MMI.
|
|
///
|
|
/// \returns true if an error occurred.
|
|
bool parseMachineFunctions(Module &M, MachineModuleInfo &MMI);
|
|
|
|
/// Parses MachineFunctions in the MIR file and add them as the result
|
|
/// of MachineFunctionAnalysis in ModulePassManager \p MAM.
|
|
/// User should register at least MachineFunctionAnalysis,
|
|
/// MachineModuleAnalysis, FunctionAnalysisManagerModuleProxy and
|
|
/// PassInstrumentationAnalysis in \p MAM before parsing MIR.
|
|
///
|
|
/// \returns true if an error occurred.
|
|
bool parseMachineFunctions(Module &M, ModuleAnalysisManager &MAM);
|
|
};
|
|
|
|
/// This function is the main interface to the MIR serialization format parser.
|
|
///
|
|
/// It reads in a MIR file and returns a MIR parser that can parse the embedded
|
|
/// LLVM IR module and initialize the machine functions by parsing the machine
|
|
/// function's state.
|
|
///
|
|
/// \param Filename - The name of the file to parse.
|
|
/// \param Error - Error result info.
|
|
/// \param Context - Context which will be used for the parsed LLVM IR module.
|
|
/// \param ProcessIRFunction - function to run on every IR function or stub
|
|
/// loaded from the MIR file.
|
|
std::unique_ptr<MIRParser> createMIRParserFromFile(
|
|
StringRef Filename, SMDiagnostic &Error, LLVMContext &Context,
|
|
std::function<void(Function &)> ProcessIRFunction = nullptr);
|
|
|
|
/// This function is another interface to the MIR serialization format parser.
|
|
///
|
|
/// It returns a MIR parser that works with the given memory buffer and that can
|
|
/// parse the embedded LLVM IR module and initialize the machine functions by
|
|
/// parsing the machine function's state.
|
|
///
|
|
/// \param Contents - The MemoryBuffer containing the machine level IR.
|
|
/// \param Context - Context which will be used for the parsed LLVM IR module.
|
|
std::unique_ptr<MIRParser>
|
|
createMIRParser(std::unique_ptr<MemoryBuffer> Contents, LLVMContext &Context,
|
|
std::function<void(Function &)> ProcessIRFunction = nullptr);
|
|
|
|
} // end namespace llvm
|
|
|
|
#endif // LLVM_CODEGEN_MIRPARSER_MIRPARSER_H
|