| Copyright | (c) The University of Glasgow 1994-2023 |
|---|---|
| License | see libraries/base/LICENSE |
| Maintainer | ghc-devs@haskell.org |
| Stability | internal |
| Portability | non-portable (GHC Extensions) |
| Safe Haskell | None |
| Language | Haskell2010 |
Control.Exception.Backtrace
Description
Mechanisms for collecting diagnostic backtraces and their representation.
Synopsis
- data BacktraceMechanism
- getBacktraceMechanismState :: BacktraceMechanism -> IO Bool
- setBacktraceMechanismState :: BacktraceMechanism -> Bool -> IO ()
- data Backtraces
- displayBacktraces :: Backtraces -> String
- collectBacktraces :: (?callStack :: CallStack) => IO Backtraces
Backtrace mechanisms
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 |
| ExecutionBacktrace | collect backtraces from native execution stack unwinding |
| IPEBacktrace | collect backtraces from Info Table Provenance Entries |
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?
Collecting backtraces
data Backtraces Source #
A collection of backtraces.
Instances
| ExceptionAnnotation Backtraces | |
Defined in GHC.Internal.Exception.Backtrace Methods | |
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.