:: a typeCtrl KGHC 9.10.3 · lts/ghc-9.10.x · 248f8f0 · 2026-10-05
Moduleghc-9.10.3GHC2021
Serialization/deserialization of binary .o files for the JavaScript backend
Different kinds of object (.o) supported by the JS backend
Eq ObjectKindDefined in ghc-9.10.3 · GHC.StgToJS.ObjectOrd ObjectKindDefined in ghc-9.10.3 · GHC.StgToJS.ObjectShow ObjectKindDefined in ghc-9.10.3 · GHC.StgToJS.ObjectGet the kind of a file object, if any
Get the kind of an object stored in a bytestring, if any
Options obtained from pragmas in JS files
JSOptionsenableCPP :: !BoolEnable CPP on the JS file
emccExtraOptions :: ![String]Pass additional options to emcc at link time
emccExportedFunctions :: ![String]Arguments for `-sEXPORTED_FUNCTIONS`
emccExportedRuntimeMethods :: ![String]Arguments for `-sEXPORTED_RUNTIME_METHODS`
Parse option pragma in JS file
Write a JS object (embed some handwritten JS code)
Read a JS object from file
Read a JS object from BinHandle
Read a JS object from ByteString
putObject :: BinHandle-> ModuleNamemodule
-> BlockInfoblock infos
-> [ObjBlock]linkable units and their symbols
-> IO ()Given a handle to a Binary payload, add the module, mod_name, its
dependencies, deps, and its linkable units to the payload.
Parse object header
Parse object body. Must be called after a successful getObjectHeader
Parse object
Read object from file
The object is still in memory after this (see objHandle).
Get blocks in the object file, using the given filtering function
Read blocks in the object file, using the given filtering function
Reads only the part necessary to get the block info
we use the convention that the first block (0) is a module-global block that's always included when something from the module is loaded. everything in a module implicitly depends on the global block. The global block itself can't have dependencies
A HS object file
ObjectobjModuleName :: !ModuleNamename of the module
objHandle :: !BinHandleBinHandle that can be used to read the ObjBlocks
objPayloadOffset :: !Bin ObjBlockOffset of the payload (units)
objBlockInfo :: !BlockInfoInformation about blocks
objIndex :: !IndexBlock index: symbols per block and block offset in the object file
IndexEntryidxSymbols :: ![FastString]Symbols exported by a block
idxOffset :: !Bin ObjBlockOffset of the block in the object file
Binary IndexEntryDefined in ghc-9.10.3 · GHC.StgToJS.ObjectLocatedBlockInfolbi_loc :: !BlockLocationWhere to find the blocks
lbi_info :: !BlockInfoBlock information
Information about blocks (linkable units)
BlockInfobi_module :: !ModuleModule they were generated from
bi_must_link :: !BlockIdsblocks that always need to be linked when this object is loaded (e.g. everything that contains initializer code or foreign exports)
bi_exports :: !Map ExportedFun BlockIdexported Haskell functions -> block
bi_block_deps :: !Array BlockId BlockDepsdependencies of each block
Outputable BlockInfoDefined in ghc-9.10.3 · GHC.StgToJS.ObjectBinary BlockInfoDefined in ghc-9.10.3 · GHC.StgToJS.ObjectBlockDepsblockBlockDeps :: [BlockId]dependencies on blocks in this object
blockFunDeps :: [ExportedFun]dependencies on exported symbols in other objects , blockForeignExported :: [ExpFun] , blockForeignImported :: [ForeignRef]
Where are the blocks
ObjectFile FilePathIn an object file at path
ArchiveFile FilePathIn a Ar file at path
InMemory String ObjectIn memory
Outputable BlockLocationDefined in ghc-9.10.3 · GHC.StgToJS.ObjectA BlockRef is a pair of a module and the index of the block in the
object file
BlockRefblock_ref_mod :: !ModuleModule
block_ref_idx :: !BlockIdBlock index in the object file
Exported Functions
ExportedFunfunModule :: !ModuleThe module containing the function
funSymbol :: !LexicalFastStringThe function
Eq ExportedFunDefined in ghc-9.10.3 · GHC.StgToJS.ObjectOrd ExportedFunDefined in ghc-9.10.3 · GHC.StgToJS.ObjectOutputable ExportedFunDefined in ghc-9.10.3 · GHC.StgToJS.ObjectBinary ExportedFunDefined in ghc-9.10.3 · GHC.StgToJS.Object