ghc-internal-9.1001.0: Basic libraries
Safe HaskellNone



This module exposes an interface for capturing the state of a thread's execution stack for diagnostics purposes: cloneMyStack, cloneThreadStack.

Such a "cloned" stack can be decoded with decode to a stack trace, given that the -finfo-table-map is enabled.

@since base-



data StackSnapshot Source #

A frozen snapshot of the state of an execution stack.

@since base-

data StackEntry Source #

Representation for the source location where a return frame was pushed on the stack. This happens every time when a case ... of scrutinee is evaluated.

cloneMyStack :: IO StackSnapshot Source #

Clone the stack of the executing thread

@since base-

cloneThreadStack :: ThreadId -> IO StackSnapshot Source #

Clone the stack of a thread identified by its ThreadId

@since base-

decode :: StackSnapshot -> IO [StackEntry] Source #

Decode a StackSnapshot to a stacktrace (a list of StackEntry). The stack trace is created from return frames with according InfoProvEnt entries. To generate them, use the GHC flag -finfo-table-map. If there are no InfoProvEnt entries, an empty list is returned.

Please note:

  • To gather StackEntry from libraries, these have to be compiled with -finfo-table-map, too.
  • Due to optimizations by GHC (e.g. inlining) the stacktrace may change with different GHC parameters and versions.
  • The stack trace is empty (by design) if there are no return frames on the stack. (These are pushed every time when a case ... of scrutinee is evaluated.)

@since base-