Skip to content

Latest commit

 

History

History
 
 

bootstrap

README.md

Bootstrapping cabal-install

This utility is only intended for use in building cabal-install on a new platform. If you already have a functional (if dated) cabal-install please rather run cabal v2-install.

The typical usage is porting to a new linux architecture, then the linux-{ghc-ver}.json file is available in the bootstrap/ folder:

On a (linux) system you are bootstrapping, run

./bootstrap/bootstrap.py -d ./bootstrap/linux-ghcver.json -w /path/to-ghc

from the top directory of the source checkout.

For offline builds, you can first run

./bootstrap/bootstrap.py -d ./bootstrap/linux-ghcver.json -w /path/to-ghc fetch

to fetch tarballs for all the dependencies. These can then be used by a further bootstrap command by way of the --bootstrap-sources argument:

./bootstrap/bootstrap.py -w /path/to-ghc --bootstrap-sources bootstrap-sources.tar.gz

To generate the platform-{ghc-ver} files for other platforms, do:

  1. On a system with functional cabal-install, install the same GHC version as you will use to bootstrap on the host system.

  2. Build a dependency description file ($PLATFORM-$GHCVER.json, e.g. linux-8.8.4.json) by running:

    cabal v2-build --with-compiler=/path/to/ghc --dry-run cabal-install:exe:cabal
cp dist-newstyle/cache/plan.json bootstrap/$PLATFORM-$GHCVER.plan.json
cd bootstrap
cabal v2-run -v0 cabal-bootstrap-gen -- $PLATFORM-$GHCVER.plan.json | tee $PLATFORM-$GHCVER.json

  3. You may need to tweak bootstrap/$PLATFORM-$GHCVER.json file manually, for example toggle flags.

There are rules in the top-level Makefile for generation of these files.