bdisk/docs/manual/dev/functions/PREP.adoc

prep.py

This contains functions that download the base tarball releases, preps them for [code_bchroot_py_code], builds necessary directory structures, and performs the overlay preparations.

dirChk(conf)

This function creates extra directories if needed.

conf

See [conf].

downloadTarball(conf)

This function downloads the tarball ([code_mirrorfile_code]) from the [code_mirror_code], and performs verifications (SHA1 and GPG signature if enabled). Returns the full/absolute path to the downloaded tarball.

conf

See [conf].

unpackTarball(tarball_path, build, keep = False)

This function extracts the tarball downloaded via downloadTarball().

tarball_path

The full/absolute path to the downloaded tarball.

build

See [build].

keep

True or False. Whether we should keep the downloaded tarball after unpacking/extracting. If your upstream tarball changes often enough, it’s recommended to set this to False. However, setting it to True can speed up the build process if you’re on a slower Internet connection.

buildChroot(conf, keep = False)

This incorporates donwloading and extracting into one function, as well as applying the [pre_build_d] directory (and the pre-build.d templates).

conf

See [conf].

keep

See [keep].

prepChroot(conf)

Returns a modified/updated [build]. This function:

1. Prepares some variables that pre-build.sh needs inside the chroot(s)

2. Builds the VERSION_INFO.txt file

3. Updates the build number

4. Imports the signing GPG key

conf

See [conf].

postChroot(conf)

This function applies the [overlay_2] directory (and the overlay templates).

conf

See [conf].