Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • gdb-srts
  • 9.2-release
  • lldb
  • wip/ci
  • alp/con-names
  • pretty
7 results
Compare
Forked from Ben Gamari / ghc-utils
223 commits behind, 1 commit ahead of the upstream repository.
Name Last commit Last update
analytics
build-all
calling-convs
compare-ticks
gdb
gitlab-utils
library-versions
list-c-functions
nix
perf-analysis
rel-eng
.gitignore
README.md
TopoSortCommits.hs
add-upstream-remotes.py
build-cabal.sh
build-stackage.sh
check-uniques.py
compare-env.sh
configure-cross.nix
debug-ghc
default.nix
diff-objcode.sh
diff-submodules.py
eventlog-sort.sh
extract-ar.py
find-dead-branches.sh
ghc-docker.sh
ghc-submodules
ghc_perf.py
ghc_timings.py
ghci-env
git-clone-workdir
make-ghc-tags.sh
merge.py
nofib-commits.sh
parallel-rr.py
perf-compare.py
push
re-boot.sh
review-submodules
rts_stats.py
run-until-crash
sample_proc.py
setup-msys.sh
shell.nix
split-core2core.py
threadscope.nix
update-win32-tarballs.sh
utils.sh
validate-all
README.md

ghc-utils

There are utilities that I find useful while working on GHC. It's quite a mixed bag; a few are for performance analysis, some for general development, and others for release management. Some are useful; all are hacky.

Usage

You can build the scripts using nix-build . and enter into a shell where the scripts are available using nix-shell.

Day-to-day maintenance

  • push: A script which I use to look over and push upstream my local branches
  • review-submodules: A script for reviewing and optionally reverting submodule changes in a commit
  • add-upstream-remotes.py: A script which adds git remotes (named upstream) to all submodules pointing to the upstream repository.

Development tools

  • run-until-crash: A tool to run a process until it crashes; useful for reproducing and collecting core dumps from hard-to-trigger crashers.
  • make-ghc-tags.sh: A script for generating emacs TAGS files for a GHC tree (e.g. ghc-utils/make-ghc-tags.sh)
  • debug-ghc: A script for running an in-place installation of GHC (e.g. inplace/bin/ghc-stage2) in gdb
  • validate-all: A script for validating a range of GHC commits.
  • ghc-docker: A convenient script for bringing up a Docker image from the gitlab.haskell.org Docker registry with configured GHC tree.

Understanding performance

  • ghc_perf.py: A handy utility for collecting runtime and perf statistics from programs compiled by GHC (with the -rtsopts flag).
  • rts_stats.py: A handy utility for comparing statistics from the GHC runtime's +RTS -t --machine-readable output (which requires that the program have been built with GHC's -rtsopts flag)
  • split-core2core.py: An extremely useful script for splitting up the output of GHC's -dverbose-core2core dump option, placing the output of each pass in a separate file (e.g. ghc-utils/split-core2core.py my-program.verbose-core2core)
  • compare-ticks/: A hack for comparing reports from GHC's ticky-ticky profiler.
  • eventlog-sort: A hack to dump the events from a GHC eventlog with relative timestamps (in milliseconds).
  • ghc_timings.py: A small hack to turn -ddump-timings output into a Markdown table.

Release engineering

  • rel-eng:
    • source-release.sh: The script that I use to build source distribution tarballs.
    • bin-release.sh: The script that I use to build binary distributions.
    • upload.sh: The script that I use to collect, hash, sign, and upload documentation and distribution tarballs.
    • mkchroot-debian.sh: A script for preparing clean Debian container environments for GHC building with systemd-nspawn.
    • download
      • process.py: The script that I use to generate GHC download pages
    • update-autoconf.sh: Update the autoconf sources in the GHC source tree
  • library-versions: A set of scripts used to generate the Commentary/Libraries/VersionHistory page on the GHC Wiki. See library-versions/README.mkd.

Other

  • new-contribs.hs: A tool I use to generate new-contributor statistics for GHC community status updates.