mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-08-21 03:29:40 +00:00
Remove exception throwing/handling from lib/Bytecode, and adjust its users to compensate for changes in the interface. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@29875 91177308-0d34-0410-b5e6-96231b3b80d8
120 lines
5.3 KiB
C++
120 lines
5.3 KiB
C++
//===-- llvm/Bytecode/Reader.h - Reader for VM bytecode files ---*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file was developed by the LLVM research group and is distributed under
|
|
// the University of Illinois Open Source License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This functionality is implemented by the lib/Bytecode/Reader library.
|
|
// This library is used to read VM bytecode files from an iostream.
|
|
//
|
|
// Note that performance of this library is _crucial_ for performance of the
|
|
// JIT type applications, so we have designed the bytecode format to support
|
|
// quick reading.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_BYTECODE_READER_H
|
|
#define LLVM_BYTECODE_READER_H
|
|
|
|
#include "llvm/System/Path.h"
|
|
#include "llvm/ModuleProvider.h"
|
|
#include "llvm/Module.h"
|
|
#include <string>
|
|
|
|
namespace llvm {
|
|
|
|
// Forward declare the handler class
|
|
class BytecodeHandler;
|
|
|
|
/// This function returns a ModuleProvider that can be used to do lazy
|
|
/// function-at-a-time loading from a bytecode file.
|
|
/// @returns NULL on error
|
|
/// @returns ModuleProvider* if successful
|
|
/// @brief Get a ModuleProvide for a bytecode file.
|
|
ModuleProvider *getBytecodeModuleProvider(
|
|
const std::string &Filename, ///< Name of file to be read
|
|
std::string* ErrMsg, ///< Optional error message holder
|
|
BytecodeHandler* H = 0 ///< Optional handler for reader events
|
|
);
|
|
|
|
/// This function returns a ModuleProvider that can be used to do lazy
|
|
/// function function-at-a-time loading from a bytecode buffer.
|
|
/// @returns NULL on error
|
|
/// @returns ModuleProvider* if successful
|
|
/// @brief Get a ModuleProvider for a bytecode buffer.
|
|
ModuleProvider *getBytecodeBufferModuleProvider(
|
|
const unsigned char *Buffer, ///< Start of buffer to parse
|
|
unsigned BufferSize, ///< Size of the buffer
|
|
const std::string &ModuleID, ///< Name to give the module
|
|
std::string* ErrMsg, ///< Optional place to return an error message
|
|
BytecodeHandler* H ///< Optional handler for reader events
|
|
);
|
|
|
|
/// This is the main interface to bytecode parsing. It opens the file specified
|
|
/// by \p Filename and parses the entire file, returing the corresponding Module
|
|
/// object if successful.
|
|
/// @returns NULL on error
|
|
/// @returns the module corresponding to the bytecode file, if successful
|
|
/// @brief Parse the given bytecode file
|
|
Module* ParseBytecodeFile(
|
|
const std::string &Filename, ///< Name of file to parse
|
|
std::string *ErrMsg = 0 ///< Optional place to return an error message
|
|
);
|
|
|
|
/// Parses a bytecode buffer specified by \p Buffer and \p BufferSize.
|
|
/// @returns NULL on error
|
|
/// @returns the module corresponding to the bytecode buffer, if successful
|
|
/// @brief Parse a given bytecode buffer
|
|
Module* ParseBytecodeBuffer(
|
|
const unsigned char *Buffer, ///< Start of buffer to parse
|
|
unsigned BufferSize, ///< Size of the buffer
|
|
const std::string &ModuleID="", ///< Name to give the module
|
|
std::string *ErrMsg = 0 ///< Optional place to return an error message
|
|
);
|
|
|
|
/// This function will read only the necessary parts of a bytecode file in order
|
|
/// to determine the list of dependent libraries encoded within it. The \p
|
|
/// deplibs parameter will contain a vector of strings of the bytecode module's
|
|
/// dependent libraries.
|
|
/// @returns true on error, false otherwise
|
|
/// @brief Get the list of dependent libraries from a bytecode file.
|
|
bool GetBytecodeDependentLibraries(
|
|
const std::string &fileName, ///< File name to read bytecode from
|
|
Module::LibraryListType& deplibs, ///< List of dependent libraries extracted
|
|
std::string* ErrMsg ///< Optional error message holder
|
|
);
|
|
|
|
/// This function will read only the necessary parts of a bytecode file in order
|
|
/// to obtain a list of externally visible global symbols that the bytecode
|
|
/// module defines. This is used for archiving and linking when only the list
|
|
/// of symbols the module defines is needed.
|
|
/// @returns true on error, false otherwise
|
|
/// @brief Get a bytecode file's externally visibile defined global symbols.
|
|
bool GetBytecodeSymbols(
|
|
const sys::Path& fileName, ///< Filename to read bytecode from
|
|
std::vector<std::string>& syms, ///< Vector to return symbols in
|
|
std::string* ErrMsg ///< Optional error message holder
|
|
);
|
|
|
|
/// This function will read only the necessary parts of a bytecode buffer in
|
|
/// order to obtain a list of externally visible global symbols that the
|
|
/// bytecode module defines. This is used for archiving and linking when only
|
|
/// the list of symbols the module defines is needed and the bytecode is
|
|
/// already in memory.
|
|
/// @returns the ModuleProvider on success, 0 if the bytecode can't be parsed
|
|
/// @brief Get a bytecode file's externally visibile defined global symbols.
|
|
ModuleProvider* GetBytecodeSymbols(
|
|
const unsigned char*Buffer, ///< The buffer to be parsed
|
|
unsigned Length, ///< The length of \p Buffer
|
|
const std::string& ModuleID, ///< An identifier for the module
|
|
std::vector<std::string>& symbols, ///< The symbols defined in the module
|
|
std::string* ErrMsg ///< Optional error message holder
|
|
);
|
|
|
|
} // End llvm namespace
|
|
|
|
#endif
|