ghc-internal-9.1003.0: Basic libraries

Safe Haskell	None
Language	Haskell2010

GHC.Internal.Exception.Backtrace

Synopsis

data BacktraceMechanism
data EnabledBacktraceMechanisms = EnabledBacktraceMechanisms {
- costCentreBacktraceEnabled :: !Bool
- hasCallStackBacktraceEnabled :: !Bool
- executionBacktraceEnabled :: !Bool
- ipeBacktraceEnabled :: !Bool
}
defaultEnabledBacktraceMechanisms :: EnabledBacktraceMechanisms
backtraceMechanismEnabled :: BacktraceMechanism -> EnabledBacktraceMechanisms -> Bool
setBacktraceMechanismEnabled :: BacktraceMechanism -> Bool -> EnabledBacktraceMechanisms -> EnabledBacktraceMechanisms
enabledBacktraceMechanismsRef :: IORef EnabledBacktraceMechanisms
getEnabledBacktraceMechanisms :: IO EnabledBacktraceMechanisms
getBacktraceMechanismState :: BacktraceMechanism -> IO Bool
setBacktraceMechanismState :: BacktraceMechanism -> Bool -> IO ()
data Backtraces = Backtraces {
- btrCostCentre :: Maybe (Ptr CostCentreStack)
- btrHasCallStack :: Maybe CallStack
- btrExecutionStack :: Maybe [Location]
- btrIpe :: Maybe [StackEntry]
}
displayBacktraces :: Backtraces -> String
collectBacktraces :: (?callStack :: CallStack) => IO Backtraces
collectBacktraces' :: (?callStack :: CallStack) => EnabledBacktraceMechanisms -> IO Backtraces

Documentation

data BacktraceMechanism Source #

How to collect a backtrace when an exception is thrown.

Constructors

CostCentreBacktrace	collect cost-centre stack backtraces (only available when built with profiling)
HasCallStackBacktrace	collect `HasCallStack` backtraces
ExecutionBacktrace	collect backtraces via native execution stack unwinding (e.g. using DWARF debug information)
IPEBacktrace	collect backtraces from Info Table Provenance Entries

data EnabledBacktraceMechanisms Source #

Constructors

EnabledBacktraceMechanisms
Fields costCentreBacktraceEnabled :: !Bool hasCallStackBacktraceEnabled :: !Bool executionBacktraceEnabled :: !Bool ipeBacktraceEnabled :: !Bool

defaultEnabledBacktraceMechanisms :: EnabledBacktraceMechanisms Source #

backtraceMechanismEnabled :: BacktraceMechanism -> EnabledBacktraceMechanisms -> Bool Source #

setBacktraceMechanismEnabled :: BacktraceMechanism -> Bool -> EnabledBacktraceMechanisms -> EnabledBacktraceMechanisms Source #

enabledBacktraceMechanismsRef :: IORef EnabledBacktraceMechanisms Source #

getEnabledBacktraceMechanisms :: IO EnabledBacktraceMechanisms Source #

Returns the currently enabled BacktraceMechanisms.

getBacktraceMechanismState :: BacktraceMechanism -> IO Bool Source #

Will the given BacktraceMechanism be used when collecting backtraces?

setBacktraceMechanismState :: BacktraceMechanism -> Bool -> IO () Source #

Set whether the given BacktraceMechanism will be used when collecting backtraces?

data Backtraces Source #

A collection of backtraces.

Constructors

Backtraces
Fields btrCostCentre :: Maybe (Ptr CostCentreStack) btrHasCallStack :: Maybe CallStack btrExecutionStack :: Maybe [Location] btrIpe :: Maybe [StackEntry]

Instances

Instances details

ExceptionAnnotation Backtraces Source #
Instance details Defined in GHC.Internal.Exception.Backtrace Methods displayExceptionAnnotation :: Backtraces -> String Source #

displayBacktraces :: Backtraces -> String Source #

Render a set of backtraces to a human-readable string.

collectBacktraces :: (?callStack :: CallStack) => IO Backtraces Source #

Collect a set of Backtraces.

collectBacktraces' :: (?callStack :: CallStack) => EnabledBacktraceMechanisms -> IO Backtraces Source #