GHC.Debug.Profile

Functions for performing whole heap census in the style of the normal - heap profiling

Documentation

censusClosureType :: [ClosurePtr] -> DebugM CensusByClosureType

Perform a heap census in the same style as the -hT profile.

census2LevelClosureType :: [ClosurePtr] -> DebugM CensusByClosureType

Perform a 2-level census where the keys are the type of the closure in addition to the type of ptrs of the closure. This can be used to distinguish between lists of different type for example.

closureCensusBy :: forall k v. (Semigroup v, Ord k) => (ClosurePtr -> SizedClosure -> DebugM (Maybe (k, v))) -> [ClosurePtr] -> DebugM (Map k v)

General function for performing a heap census in constant memory

type CensusByClosureType = Map (ProfileKey, ProfileKeyArgs) CensusStats

writeCensusByClosureType :: FilePath -> CensusByClosureType -> IO ()

data CensusStats

Constructors

CS

Fields

• cscount :: !Count
• cssize :: !Size
• csmax :: !(Max Size)
• sample :: !Sample

Instances

Monoid CensusStats

Defined in GHC.Debug.Profile.Types

Methods

mempty :: CensusStats

mappend :: CensusStats -> CensusStats -> CensusStats

mconcat :: [CensusStats] -> CensusStats

Semigroup CensusStats

Defined in GHC.Debug.Profile.Types

Methods

(<>) :: CensusStats -> CensusStats -> CensusStats

sconcat :: NonEmpty CensusStats -> CensusStats

stimes :: Integral b => b -> CensusStats -> CensusStats

Show CensusStats

Defined in GHC.Debug.Profile.Types

Methods

showsPrec :: Int -> CensusStats -> ShowS

show :: CensusStats -> String

showList :: [CensusStats] -> ShowS

Eq CensusStats

Defined in GHC.Debug.Profile.Types

Methods

(==) :: CensusStats -> CensusStats -> Bool

(/=) :: CensusStats -> CensusStats -> Bool

data ProfileKey

Constructors

ProfileConstrDesc !ConstrDescText

ProfileClosureDesc !Text

Instances

Show ProfileKey

Defined in GHC.Debug.Profile

Methods

showsPrec :: Int -> ProfileKey -> ShowS

show :: ProfileKey -> String

showList :: [ProfileKey] -> ShowS

Eq ProfileKey

Defined in GHC.Debug.Profile

Methods

(==) :: ProfileKey -> ProfileKey -> Bool

(/=) :: ProfileKey -> ProfileKey -> Bool

Ord ProfileKey

Defined in GHC.Debug.Profile

Methods

compare :: ProfileKey -> ProfileKey -> Ordering

(<) :: ProfileKey -> ProfileKey -> Bool

(<=) :: ProfileKey -> ProfileKey -> Bool

(>) :: ProfileKey -> ProfileKey -> Bool

(>=) :: ProfileKey -> ProfileKey -> Bool

max :: ProfileKey -> ProfileKey -> ProfileKey

min :: ProfileKey -> ProfileKey -> ProfileKey

data ProfileKeyArgs

Constructors

ArrKeyArgs !ProfileKey !Int

AllKeyArgs !(Vector ProfileKey)

NoArgs

Instances

Show ProfileKeyArgs

Defined in GHC.Debug.Profile

Methods

showsPrec :: Int -> ProfileKeyArgs -> ShowS

show :: ProfileKeyArgs -> String

showList :: [ProfileKeyArgs] -> ShowS

Eq ProfileKeyArgs

Defined in GHC.Debug.Profile

Methods

(==) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

(/=) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

Ord ProfileKeyArgs

Defined in GHC.Debug.Profile

Methods

compare :: ProfileKeyArgs -> ProfileKeyArgs -> Ordering

(<) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

(<=) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

(>) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

(>=) :: ProfileKeyArgs -> ProfileKeyArgs -> Bool

max :: ProfileKeyArgs -> ProfileKeyArgs -> ProfileKeyArgs

min :: ProfileKeyArgs -> ProfileKeyArgs -> ProfileKeyArgs

prettyProfileKey :: ProfileKey -> Text

Show the full ProfileKey, including package and module locations if available.

prettyShortProfileKey :: ProfileKey -> Text

Show the ProfileKey in a shortened form if possible. For example, it omits package and module locations for ProfileConstrDesc.

prettyProfileKeyArgs :: ProfileKeyArgs -> Text

prettyProfileKeyArgs' :: (ProfileKey -> Text) -> ProfileKeyArgs -> Text

prettyShortProfileKeyArgs :: ProfileKeyArgs -> Text

mkCS :: ClosurePtr -> Size -> CensusStats

newtype Count

Constructors

Count

Fields

• getCount :: Int

Instances

Monoid Count

Defined in GHC.Debug.Profile.Types

Methods

mempty :: Count

mappend :: Count -> Count -> Count

mconcat :: [Count] -> Count

Semigroup Count

Defined in GHC.Debug.Profile.Types

Methods

(<>) :: Count -> Count -> Count

sconcat :: NonEmpty Count -> Count

stimes :: Integral b => b -> Count -> Count

Num Count

Defined in GHC.Debug.Profile.Types

Methods

(+) :: Count -> Count -> Count

(-) :: Count -> Count -> Count

(*) :: Count -> Count -> Count

negate :: Count -> Count

abs :: Count -> Count

signum :: Count -> Count

fromInteger :: Integer -> Count

Show Count

Defined in GHC.Debug.Profile.Types

Methods

showsPrec :: Int -> Count -> ShowS

show :: Count -> String

showList :: [Count] -> ShowS

Eq Count

Defined in GHC.Debug.Profile.Types

Methods

(==) :: Count -> Count -> Bool

(/=) :: Count -> Count -> Bool

Ord Count

Defined in GHC.Debug.Profile.Types

Methods

compare :: Count -> Count -> Ordering

(<) :: Count -> Count -> Bool

(<=) :: Count -> Count -> Bool

(>) :: Count -> Count -> Bool

(>=) :: Count -> Count -> Bool

max :: Count -> Count -> Count

min :: Count -> Count -> Count

closureToKey :: DebugClosure ccs srt a ConstrDesc c d -> Text

data ConstrDescText

ConstrDescText wraps a ConstrDesc but is backed by a Text.

More efficient to keep around than ConstrDesc.

Instances

Show ConstrDescText

Defined in GHC.Debug.Profile

Methods

showsPrec :: Int -> ConstrDescText -> ShowS

show :: ConstrDescText -> String

showList :: [ConstrDescText] -> ShowS

Eq ConstrDescText

Defined in GHC.Debug.Profile

Methods

(==) :: ConstrDescText -> ConstrDescText -> Bool

(/=) :: ConstrDescText -> ConstrDescText -> Bool

Ord ConstrDescText

Defined in GHC.Debug.Profile

Methods

compare :: ConstrDescText -> ConstrDescText -> Ordering

(<) :: ConstrDescText -> ConstrDescText -> Bool

(<=) :: ConstrDescText -> ConstrDescText -> Bool

(>) :: ConstrDescText -> ConstrDescText -> Bool

(>=) :: ConstrDescText -> ConstrDescText -> Bool

max :: ConstrDescText -> ConstrDescText -> ConstrDescText

min :: ConstrDescText -> ConstrDescText -> ConstrDescText

packConstrDesc :: ConstrDesc -> ConstrDescText

pkgsText :: ConstrDescText -> Text

modlText :: ConstrDescText -> Text

nameText :: ConstrDescText -> Text