Copyright | (c) The University of Glasgow 2011 |
---|---|
License | see libraries/base/LICENSE |
Maintainer | [email protected] |
Stability | internal |
Portability | non-portable (GHC Extensions) |
Safe Haskell | Trustworthy |
Language | Haskell2010 |
Access to GHC's call-stack simulation
Since: base-4.5.0.0
currentCallStack :: IO [String] Source
Returns a [String]
representing the current call stack. This can be useful for debugging.
The implementation uses the call-stack simulation maintained by the profiler, so it only works if the program was compiled with -prof
and contains suitable SCC annotations (e.g. by using -fprof-auto
). Otherwise, the list returned is likely to be empty or uninformative.
Since: base-4.5.0.0
whoCreated :: a -> IO [String] Source
Get the stack trace attached to an object.
Since: base-4.5.0.0
data CostCentreStack Source
A cost-centre stack from GHC's cost-center profiler.
data CostCentre Source
A cost-centre from GHC's cost-center profiler.
getCurrentCCS :: dummy -> IO (Ptr CostCentreStack) Source
Returns the current CostCentreStack
(value is nullPtr
if the current program was not compiled with profiling support). Takes a dummy argument which can be used to avoid the call to getCurrentCCS
being floated out by the simplifier, which would result in an uninformative stack (CAF).
getCCSOf :: a -> IO (Ptr CostCentreStack) Source
Get the CostCentreStack
associated with the given value.
clearCCS :: IO a -> IO a Source
Run a computation with an empty cost-center stack. For example, this is used by the interpreter to run an interpreted computation without the call stack showing that it was invoked from GHC.
ccsCC :: Ptr CostCentreStack -> IO (Ptr CostCentre) Source
Get the CostCentre
at the head of a CostCentreStack
.
ccsParent :: Ptr CostCentreStack -> IO (Ptr CostCentreStack) Source
Get the tail of a CostCentreStack
.
ccLabel :: Ptr CostCentre -> IO CString Source
Get the label of a CostCentre
.
ccModule :: Ptr CostCentre -> IO CString Source
Get the module of a CostCentre
.
ccSrcSpan :: Ptr CostCentre -> IO CString Source
Get the source span of a CostCentre
.
ccsToStrings :: Ptr CostCentreStack -> IO [String] Source
Format a CostCentreStack
as a list of lines.
renderStack :: [String] -> String Source
© The University of Glasgow and others
Licensed under a BSD-style license (see top of the page).
https://downloads.haskell.org/~ghc/8.8.3/docs/html/libraries/base-4.13.0.0/GHC-Stack-CCS.html