GHC.Debug.Client.Query

Pause/Resume

pause :: Debuggee -> IO ()

Pause the debuggee

fork :: Debuggee -> IO ()

pauseThen :: Debuggee -> DebugM b -> IO b

resume :: Debuggee -> IO ()

Resume the debuggee

pausePoll :: Debuggee -> IO ()

Like pause, but wait for the debuggee to pause itself. It currently impossible to resume after a pause caused by a poll.?????????? Is that true???? can we not just call resume????

withPause :: Debuggee -> IO a -> IO a

Bracketed version of pause/resume.

General Requests

precacheBlocks :: DebugM [RawBlock]

Fetch all the blocks from the debuggee and add them to the block cache

gcRoots :: DebugM [ClosurePtr]

Query the debuggee for the list of GC Roots

allBlocks :: DebugM [RawBlock]

Query the debuggee for all the blocks it knows about

getSourceInfo :: InfoTablePtr -> DebugM (Maybe SourceInformation)

Query the debuggee for source information about a specific info table. This requires your executable to be built with -finfo-table-map.

savedObjects :: DebugM [ClosurePtr]

Query the debuggee for the list of saved objects.

version :: DebugM Word32

Query the debuggee for the protocol version

Dereferencing functions

dereferenceClosures :: [ClosurePtr] -> DebugM [SizedClosure]

dereferenceClosure :: ClosurePtr -> DebugM SizedClosure

Consult the BlockCache for the block which contains a specific closure, if it's not there then try to fetch the right block, if that fails, call dereferenceClosureDirect

dereferenceClosureDirect :: ClosurePtr -> DebugM SizedClosure

Decode a closure corresponding to the given ClosurePtr You should not use this function directly unless you know what you are doing. dereferenceClosure will be much faster in general.

dereferenceClosureC :: ClosurePtr -> DebugM SizedClosureC

dereferenceStack :: StackCont -> DebugM StackFrames

Deference some StackFrames from a given StackCont

dereferencePapPayload :: PayloadCont -> DebugM PapPayload

Derference the PapPayload from the PayloadCont

dereferenceConDesc :: ConstrDescCont -> DebugM ConstrDesc

dereferenceInfoTable :: InfoTablePtr -> DebugM StgInfoTable