Safe Haskell	None
Language	Haskell2010

GHC.Prof

Contents

Parser
Cost-centre tree
Types

Synopsis

Documentation

decode :: Text -> Either String Profile Source #

Decode a GHC time allocation profiling report from a lazy Text

Parser

profile :: Parser Profile Source #

Parse a GHC time-allocation profiling report

Cost-centre tree

data CostCentreTree Source #

Instances

Show CostCentreTree Source #
Methods showsPrec :: Int -> CostCentreTree -> ShowS # show :: CostCentreTree -> String # showList :: [CostCentreTree] -> ShowS #

aggregateCostCentres :: Profile -> [AggregateCostCentre] Source #

Build a list of cost-centres from a profiling report ordered by the time spent and the amount of allocation.

aggregateCostCentresOrderBy Source #

Arguments

:: Ord a
=> (AggregateCostCentre -> a)	Sorting key function
-> Profile
-> [AggregateCostCentre]

Build a list of cost-centres from a profling report ordered by the given key.

costCentres :: Profile -> Maybe (Tree CostCentre) Source #

Build a tree of cost-centres from a profiling report.

costCentresOrderBy Source #

Arguments

:: Ord a
=> (CostCentre -> a)	Sorting key function
-> Profile
-> Maybe (Tree CostCentre)

Build a tree of cost-centres from a profiling report. Nodes are sorted by the given key function for each level of the tree.

aggregateCallSites Source #

Arguments

:: Text	Cost centre name
-> Text	Module name
-> Profile
-> Maybe (AggregateCostCentre, [CallSite AggregateCostCentre])

Build a list of call sites (caller functions of a cost centre) aggregated by their cost centre names and module names.

aggregateCallSitesOrderBy Source #

Arguments

:: Ord a
=> (CallSite AggregateCostCentre -> a)	Sorting key function
-> Text	Cost centre name
-> Text	Module name
-> Profile
-> Maybe (AggregateCostCentre, [CallSite AggregateCostCentre])

Build a list of call sites (caller functions of a cost centre) aggregated by their cost centre names and module names. Call sites are sorted by the given key function.

callSites Source #

Arguments

:: Text	Cost-centre name
-> Text	Module name
-> Profile
-> Maybe (AggregateCostCentre, [CallSite CostCentre])

Build a list of call-sites (caller functions) for a specified cost-centre name and module name.

callSitesOrderBy Source #

Arguments

:: Ord a
=> (CallSite CostCentre -> a)	Sorting key function
-> Text	Cost-centre name
-> Text	Module name
-> Profile
-> Maybe (AggregateCostCentre, [CallSite CostCentre])

Build a list of call-sites (caller function) for a specified cost-centre name and module name. Nodes are sorted by the given key function.

Types

data Profile Source #

Top-level profiling report

Constructors

Profile
Fields profileTimestamp :: !LocalTime profileCommandLine :: !Text profileTotalTime :: !TotalTime profileTotalAlloc :: !TotalAlloc profileTopCostCentres :: [AggregateCostCentre] profileCostCentreTree :: !CostCentreTree

Instances

Show Profile Source #
Methods showsPrec :: Int -> Profile -> ShowS # show :: Profile -> String # showList :: [Profile] -> ShowS #

data TotalTime Source #

total time in the profiling reports

Constructors

TotalTime
Fields totalTimeElapsed :: !DiffTime Total elapsed time in seconds totalTimeTicks :: !Integer Total number of ticks totalTimeResolution :: !DiffTime Duration of a tick totalTimeProcessors :: !(Maybe Int) Number of processors

Instances

Show TotalTime Source #
Methods showsPrec :: Int -> TotalTime -> ShowS # show :: TotalTime -> String # showList :: [TotalTime] -> ShowS #

newtype TotalAlloc Source #

total alloc in the profiling reports

Constructors

TotalAlloc
Fields totalAllocBytes :: Integer Total memory allocation in bytes

Instances

Show TotalAlloc Source #
Methods showsPrec :: Int -> TotalAlloc -> ShowS # show :: TotalAlloc -> String # showList :: [TotalAlloc] -> ShowS #

data AggregateCostCentre Source #

Constructors

AggregateCostCentre

Fields

aggregateCostCentreName :: !Text
Name of the cost-centre
aggregateCostCentreModule :: !Text
Module name of the cost-centre
aggregateCostCentreSrc :: !(Maybe Text)
Source location of the cost-centre
aggregateCostCentreEntries :: !(Maybe Integer)
Number of entries to the cost-centre
aggregateCostCentreTime :: !Scientific
Total time spent in the cost-centre
aggregateCostCentreAlloc :: !Scientific
Total allocation in the cost-centre
aggregateCostCentreTicks :: !(Maybe Integer)
Total ticks in the cost-centre. This number exists only if -P or -Pa option is given at run-time.
aggregateCostCentreBytes :: !(Maybe Integer)
Total memory allocation in the cost-centre. This number exists only if -P or -Pa option is given at run-time.

Instances

Eq AggregateCostCentre Source #
Methods (==) :: AggregateCostCentre -> AggregateCostCentre -> Bool # (/=) :: AggregateCostCentre -> AggregateCostCentre -> Bool #
Ord AggregateCostCentre Source #
Methods compare :: AggregateCostCentre -> AggregateCostCentre -> Ordering # (<) :: AggregateCostCentre -> AggregateCostCentre -> Bool # (<=) :: AggregateCostCentre -> AggregateCostCentre -> Bool # (>) :: AggregateCostCentre -> AggregateCostCentre -> Bool # (>=) :: AggregateCostCentre -> AggregateCostCentre -> Bool # max :: AggregateCostCentre -> AggregateCostCentre -> AggregateCostCentre # min :: AggregateCostCentre -> AggregateCostCentre -> AggregateCostCentre #
Show AggregateCostCentre Source #
Methods showsPrec :: Int -> AggregateCostCentre -> ShowS # show :: AggregateCostCentre -> String # showList :: [AggregateCostCentre] -> ShowS #

data CostCentre Source #

Cost-centre node

Constructors

CostCentre

Fields

costCentreNo :: !CostCentreNo
Identifier of the cost-centre
costCentreName :: !Text
Name of the cost-centre
costCentreModule :: !Text
Module name of the cost-centre
costCentreSrc :: !(Maybe Text)
Source location of the cost-centre
costCentreEntries :: !Integer
Number of entries to the cost-centre
costCentreIndTime :: !Scientific
Time spent in the cost-centre itself
costCentreIndAlloc :: !Scientific
Allocation incurred by the cost-centre itself
costCentreInhTime :: !Scientific
Time spent in the cost-centre's children
costCentreInhAlloc :: !Scientific
Allocation incurred by the cost-centre's children
costCentreTicks :: !(Maybe Integer)
Number of ticks in the cost-centre.
costCentreBytes :: !(Maybe Integer)
Number of allocated bytes in the cost-centre.

Instances

Eq CostCentre Source #
Methods (==) :: CostCentre -> CostCentre -> Bool # (/=) :: CostCentre -> CostCentre -> Bool #
Ord CostCentre Source #
Methods compare :: CostCentre -> CostCentre -> Ordering # (<) :: CostCentre -> CostCentre -> Bool # (<=) :: CostCentre -> CostCentre -> Bool # (>) :: CostCentre -> CostCentre -> Bool # (>=) :: CostCentre -> CostCentre -> Bool # max :: CostCentre -> CostCentre -> CostCentre # min :: CostCentre -> CostCentre -> CostCentre #
Show CostCentre Source #
Methods showsPrec :: Int -> CostCentre -> ShowS # show :: CostCentre -> String # showList :: [CostCentre] -> ShowS #

type CostCentreNo = Int Source #

data CallSite cc Source #

Constructors

CallSite

Fields

callSiteCostCentre :: cc
Metrics for the caller function
callSiteContribEntries :: !Integer
Number of entries contriubted by the caller function
callSiteContribTime :: !Scientific
Time contributed by the caller function
callSiteContribAlloc :: !Scientific
Allocation contributed by the caller function
callSiteContribTicks :: !(Maybe Integer)
Number of tikcs contributed by the caller function
callSiteContribBytes :: !(Maybe Integer)
Number of allocated bytes contributed byt hte caller function

Instances

Show cc => Show (CallSite cc) Source #
Methods showsPrec :: Int -> CallSite cc -> ShowS # show :: CallSite cc -> String # showList :: [CallSite cc] -> ShowS #