Safe Haskell	None
Language	GHC2024

GHC.ByteCode.Serialize

Contents

Orphan instances

Description

This module implements the serialization of bytecode objects to and from disk.

Synopsis

writeBinByteCode :: FilePath -> ModuleByteCode -> IO ()
readBinByteCode :: HscEnv -> FilePath -> IO ModuleByteCode
data ModuleByteCode = ModuleByteCode {
- gbc_module :: Module
- gbc_compiled_byte_code :: CompiledByteCode
- gbc_foreign_files :: [FilePath]
}
data BytecodeLibX a = BytecodeLib {
- bytecodeLibUnitId :: UnitId
- bytecodeLibFiles :: [CompiledByteCode]
- bytecodeLibForeign :: a
}
type BytecodeLib = BytecodeLibX (Maybe InterpreterLibrary)
type OnDiskBytecodeLib = BytecodeLibX (Maybe InterpreterLibraryContents)
data InterpreterLibrary
- = InterpreterSharedObject {
  }
- | InterpreterStaticObjects {
  - getStaticObjects :: [FilePath]
  }
data InterpreterLibraryContents
- = InterpreterLibrarySharedContents {
  - interpreterLibraryContents :: ByteString
  }
- | InterpreterLibraryStaticContents {
  - interpreterLibraryStaticContents :: [ByteString]
  }
writeBytecodeLib :: BytecodeLib -> FilePath -> IO ()
readBytecodeLib :: HscEnv -> FilePath -> IO OnDiskBytecodeLib
decodeOnDiskModuleByteCode :: HscEnv -> OnDiskModuleByteCode -> IO ModuleByteCode
decodeOnDiskBytecodeLib :: HscEnv -> OnDiskBytecodeLib -> IO BytecodeLib

Documentation

writeBinByteCode :: FilePath -> ModuleByteCode -> IO () Source #

Write a ModuleByteCode to a file.

readBinByteCode :: HscEnv -> FilePath -> IO ModuleByteCode Source #

Read a ModuleByteCode from a file.

data ModuleByteCode Source #

The in-memory representation of a bytecode object These are stored on-disk as .gbc files.

Constructors

ModuleByteCode
Fields gbc_module :: Module gbc_compiled_byte_code :: CompiledByteCode gbc_foreign_files :: [FilePath] Path to object files

Instances

Instances details

Outputable ModuleByteCode Source #
Instance details Defined in GHC.Linker.Types Methods ppr :: ModuleByteCode -> SDoc Source #

data BytecodeLibX a Source #

A bytecode library is a collection of CompiledByteCode objects and a .so file containing the combination of foreign stubs

Constructors

BytecodeLib
Fields bytecodeLibUnitId :: UnitId bytecodeLibFiles :: [CompiledByteCode] bytecodeLibForeign :: a

Instances

Instances details

Binary OnDiskBytecodeLib Source #
Instance details Defined in GHC.ByteCode.Serialize Methods put_ :: WriteBinHandle -> OnDiskBytecodeLib -> IO () Source # put :: WriteBinHandle -> OnDiskBytecodeLib -> IO (Bin OnDiskBytecodeLib) Source # get :: ReadBinHandle -> IO OnDiskBytecodeLib Source #
Outputable a => Outputable (BytecodeLibX a) Source #
Instance details Defined in GHC.ByteCode.Serialize Methods ppr :: BytecodeLibX a -> SDoc Source #

type BytecodeLib = BytecodeLibX (Maybe InterpreterLibrary) Source #

type OnDiskBytecodeLib = BytecodeLibX (Maybe InterpreterLibraryContents) Source #

data InterpreterLibrary Source #

Constructors

InterpreterSharedObject
Fields getSharedObjectFilePath :: FilePath getSharedObjectDir :: FilePath getSharedObjectLibName :: String
InterpreterStaticObjects
Fields getStaticObjects :: [FilePath]

Instances

Instances details

Outputable InterpreterLibrary Source #
Instance details Defined in GHC.ByteCode.Serialize Methods ppr :: InterpreterLibrary -> SDoc Source #

data InterpreterLibraryContents Source #

Constructors

InterpreterLibrarySharedContents
Fields interpreterLibraryContents :: ByteString
InterpreterLibraryStaticContents
Fields interpreterLibraryStaticContents :: [ByteString]

Instances

Instances details

Binary InterpreterLibraryContents Source #
Instance details Defined in GHC.ByteCode.Serialize Methods put_ :: WriteBinHandle -> InterpreterLibraryContents -> IO () Source # put :: WriteBinHandle -> InterpreterLibraryContents -> IO (Bin InterpreterLibraryContents) Source # get :: ReadBinHandle -> IO InterpreterLibraryContents Source #
Binary OnDiskBytecodeLib Source #
Instance details Defined in GHC.ByteCode.Serialize Methods put_ :: WriteBinHandle -> OnDiskBytecodeLib -> IO () Source # put :: WriteBinHandle -> OnDiskBytecodeLib -> IO (Bin OnDiskBytecodeLib) Source # get :: ReadBinHandle -> IO OnDiskBytecodeLib Source #

writeBytecodeLib :: BytecodeLib -> FilePath -> IO () Source #

readBytecodeLib :: HscEnv -> FilePath -> IO OnDiskBytecodeLib Source #

decodeOnDiskModuleByteCode :: HscEnv -> OnDiskModuleByteCode -> IO ModuleByteCode Source #

Convert an OnDiskModuleByteCode to an ModuleByteCode. OnDiskModuleByteCode is the representation which we read from a file, the ModuleByteCode is the representation which is manipulated by program logic.

This notably writes the object files to temporary files. They are written to temporary files so that the normal object file loading code paths (which expect object files to exist as on-disk files) can be used in the loader.

decodeOnDiskBytecodeLib :: HscEnv -> OnDiskBytecodeLib -> IO BytecodeLib Source #

Orphan instances

Binary BCONPtr Source #
Instance details Methods put_ :: WriteBinHandle -> BCONPtr -> IO () Source # put :: WriteBinHandle -> BCONPtr -> IO (Bin BCONPtr) Source # get :: ReadBinHandle -> IO BCONPtr Source #
Binary BCOPtr Source #
Instance details Methods put_ :: WriteBinHandle -> BCOPtr -> IO () Source # put :: WriteBinHandle -> BCOPtr -> IO (Bin BCOPtr) Source # get :: ReadBinHandle -> IO BCOPtr Source #
Binary CompiledByteCode Source #
Instance details Methods put_ :: WriteBinHandle -> CompiledByteCode -> IO () Source # put :: WriteBinHandle -> CompiledByteCode -> IO (Bin CompiledByteCode) Source # get :: ReadBinHandle -> IO CompiledByteCode Source #
Binary UnlinkedBCO Source #
Instance details Methods put_ :: WriteBinHandle -> UnlinkedBCO -> IO () Source # put :: WriteBinHandle -> UnlinkedBCO -> IO (Bin UnlinkedBCO) Source # get :: ReadBinHandle -> IO UnlinkedBCO Source #