base-4.13.0.0: Basic libraries
Copyright(c) The University of Glasgow 2013-2015
Licensesee libraries/base/LICENSE
Maintainercvs-ghc@haskell.org
Stabilityinternal
Portabilitynon-portable (GHC Extensions)
Safe HaskellNone
LanguageHaskell2010

GHC.ExecutionStack

Description

This is a module for efficient stack traces. This stack trace implementation is considered low overhead. Basic usage looks like this:

import GHC.ExecutionStack

myFunction :: IO ()
myFunction = do
     putStrLn =<< showStackTrace

Your GHC must have been built with libdw support for this to work.

user@host:~$ ghc --info | grep libdw
 ,("RTS expects libdw",YES)

Since: base-4.9.0.0

Synopsis

Documentation

data Location #

Location information about an address from a backtrace.

data SrcLoc #

A location in the original program source.

Constructors

SrcLoc 

getStackTrace :: IO (Maybe [Location]) #

Get a trace of the current execution stack state.

Returns Nothing if stack trace support isn't available on host machine.

showStackTrace :: IO (Maybe String) #

Get a string representation of the current execution stack state.