Interpreter
Constructors
InterpinterpInstance :: !InterpInstanceInterpreter instance (internal, external)
interpLoader :: !LoaderInterpreter loader
interpSymbolCache :: !InterpSymbolCacheLookupSymbol cache
Moduleghc-lib-parser-9.14.1.20251220GHC2021
GHC.Runtime.Interpreter.Types
Types used by the runtime interpreter
Contents
Synopsis
- data Interp
- data InterpInstance
- data InterpProcess
- data ExtInterp
- type ExtInterpStatusVar
- data ExtInterpInstance
- data ExtInterpState
- data InterpStatus
- data InterpSymbolCache
- value mkInterpSymbolCache
- value lookupInterpSymbolCache
- value updateInterpSymbolCache
- value purgeInterpSymbolCache
- data InterpSymbol
- data SuffixOrInterpreted
- value interpSymbolName
- value interpSymbolSuffix
- value eliminateInterpSymbol
- value interpretedInterpSymbol
- value interpreterProfiled
- value interpreterDynamic
- type IServ
- data IServConfig
- type JSInterp
- data JSInterpExtra
- data JSInterpConfig
- data JSState
- data NodeJsSettings
- value defaultNodeJsSettings
- type WasmInterp
- data WasmInterpConfig
- Packageghc-lib-parser-9.14.1.20251220
- Exports31
- LanguageGHC2021
- LicenceBSD-3-Clause
- SourceTypes.hs
Constructors
ExternalInterp !ExtInterpExternal interpreter
Constructors
InterpProcessinterpPipe :: !PipePipe to communicate with the server
interpHandle :: !ProcessHandleProcess handle of the server
interpLock :: !MVar ()Lock to prevent concurrent access to the stream
Common field between native external interpreter and the JS one
Constructors
ExtInterpInstanceinstProcess :: !InterpProcessExternal interpreter process and its pipe (communication channel)
instPendingFrees :: !MVar [HValueRef]Values that need to be freed before the next command is sent. Finalizers for ForeignRefs can append values to this list asynchronously.
instExtra :: !cInstance specific extra fields
External interpreter
The external interpreter is spawned lazily (on first use) to avoid slowing down sessions that don't require it. The contents of the MVar reflects the state of the interpreter (running or not).
Constructors
ExtInterpStateinterpConfig :: !cfginterpStatus :: !ExtInterpStatusVar details
Status of an external interpreter
Constructors
InterpPendingNot spawned yet
InterpRunning !instRunning
InterpSymbolCache
Constructors
InterpSymbolCacheinterpClosureCache :: MVar (SymbolCache"closure"
)interpConInfoCache :: MVar (SymbolCache"con_info"
)interpStaticInfoCache :: MVar (SymbolCache"static_info"
)interpBytesCache :: MVar (SymbolCache"bytes"
)interpFaststringCache :: MVar (UniqFM FastString (Ptr ()))
Clear all symbol caches.
Constructors
IClosureSymbol :: Name -> InterpSymbol ('Suffix"closure"
)IConInfoSymbol :: Name -> InterpSymbol ('Suffix"con_info"
)IStaticInfoSymbol :: Name -> InterpSymbol ('Suffix"static_info"
)IBytesSymbol :: Name -> InterpSymbol ('Suffix"bytes"
)IFaststringSymbol :: FastString -> InterpSymbol 'Interpreted
Instances1Outputable
Outputable (InterpSymbol s)Defined in ghc-lib-parser-9.14.1.20251220 · GHC.Runtime.Interpreter.Types.SymbolCache
Constructors
Interpreter uses Profiling way
Interpreter uses Dynamic way
IServ
Configuration needed to spawn an external interpreter
Constructors
IServConfigiservConfProgram :: !StringExternal program to run
iservConfOpts :: ![String]Command-line options
iservConfProfiled :: !BoolUse Profiling way
iservConfDynamic :: !BoolUse Dynamic way
iservConfHook :: !Maybe (CreateProcess -> IO ProcessHandle)Hook
iservConfTrace :: IO ()Trace action executed after spawn
JSInterp
Constructors
JSInterpExtrainstStdIn :: !HandleStdin for the process
instFinderCache :: !FinderCacheinstFinderOpts :: !FinderOptsinstJSState :: !MVar JSStateMutable state
instGhciUnitId :: !UnitIdGHCi unit-id
Constructors
JSInterpConfigjsInterpNodeConfig :: !NodeJsSettingsNodeJS settings
jsInterpScript :: !FilePathPath to "ghc-interp.js" script
jsInterpTmpFs :: !TmpFsjsInterpTmpDir :: !TempDirjsInterpLogger :: !LoggerjsInterpCodegenCfg :: !StgToJSConfigjsInterpUnitEnv :: !UnitEnvjsInterpFinderOpts :: !FinderOptsjsInterpFinderCache :: !FinderCache
Constructors
JSStatejsLinkState :: !LinkPlanLinker state of the interpreter
jsServerStarted :: !BoolIs the Haskell server started?
NodeJs configuration
Constructors
NodeJsSettingsnodeProgram :: FilePathlocation of node.js program
nodePath :: Maybe FilePathvalue of NODE_PATH environment variable (search path for Node modules; GHCJS used to provide some)
nodeExtraArgs :: [String]extra arguments to pass to node.js
nodeKeepAliveMaxMem :: Integerkeep node.js (TH, GHCJSi) processes alive if they don't use more than this
Constructors
WasmInterpConfigwasmInterpDyLD :: !FilePathLocation of dyld.mjs script
wasmInterpLibDir :: FilePathwasi-sdk sysroot libdir containing libc.so, etc
wasmInterpOpts :: ![String]Additional command line arguments for iserv
wasmInterpBrowser :: !BoolwasmInterpBrowserHost :: !StringwasmInterpBrowserPort :: !IntwasmInterpBrowserRedirectWasiConsole :: !BoolwasmInterpBrowserPuppeteerLaunchOpts :: !Maybe StringwasmInterpBrowserPlaywrightBrowserType :: !Maybe StringwasmInterpBrowserPlaywrightLaunchOpts :: !Maybe StringwasmInterpTargetPlatform :: !PlatformwasmInterpProfiled :: !BoolAre we profiling yet?
wasmInterpHsSoSuffix :: !StringShared lib filename common suffix sans .so, e.g. p-ghc9.13.20241001
wasmInterpUnitState :: !UnitState