profiterole: Restructure GHC profile reports

[ bsd3, development, program ] [ Propose Tags ] [ Report a vulnerability ]

Given a GHC profile output, this tool generates alternative views on the data, which are typically more concise and may reveal new insights.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1
Change log CHANGES.txt
Dependencies base (>=4.6 && <5), containers, directory, extra, filepath, ghc-prof, hashable, scientific, text [details]
Tested with ghc ==8.0.2, ghc ==7.10.3, ghc ==7.8.4, ghc ==7.6.3
License BSD-3-Clause
Copyright Neil Mitchell 2017
Author Neil Mitchell <ndmitchell@gmail.com>
Maintainer Neil Mitchell <ndmitchell@gmail.com>
Category Development
Home page https://github.com/ndmitchell/profiterole#readme
Bug tracker https://github.com/ndmitchell/profiterole/issues
Source repo head: git clone https://github.com/ndmitchell/profiterole.git
Uploaded by NeilMitchell at 2017-06-02T21:25:09Z
Distributions NixOS:0.1
Reverse Dependencies 1 direct, 0 indirect [details]
Executables profiterole
Downloads 1545 total (9 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2017-06-02 [all 3 reports]

Readme for profiterole-0.1

[back to package description]

Profiterole Hackage version Stackage version Linux Build Status Windows Build Status

Script for reading and restructring a GHC profile script.

The Goal

Given profile data, different ways of looking at it reveal different insights. This tool provides one of those insights - in addition to reading the standard profile output and using other tools such as Profiteur.

Profiterole aims to make the profile shorter by combining common subtrees and lifting them to the root - e.g. if you call parseFile from 7 places in the code, instead of having 7 pieces of parseFile profiling, Profiterole will give you one.

As an example compare HLint profile input to HLint Profiterole output.

Usage

To run, first install (cabal update && cabal install profiterole), generate a GHC profile the normal way, then run:

profiterole myprogram.prof

Profiterole will generate myprogram.profiterole.txt and myprogram.profiterole.html - both contain the same information, but the HTML has hyperlinks. There are three columns of numbers:

  • TOT is the total time spent in any item under this code, what GHC calls inherited time.
  • INH is the total time spent in the items that Profiterole did not move out to the top level.
  • IND is the individual time, just like GHC profiles.

For large programs, using +RTS -P (instead of the common -p) will give more accurate results.