GHC.ExecutionStack

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: 4.9.0.0

Documentation

data Location

Location information about an address from a backtrace.

Constructors

Location

Fields

• objectName :: String
• functionName :: String
• srcLoc :: Maybe SrcLoc

data SrcLoc

A location in the original program source.

Constructors

SrcLoc

Fields

• sourceFile :: String
• sourceLine :: Int
• sourceColumn :: Int

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.