Update Build Functions

Detailed

setup_chroot

setup_chroot() prepares and populates a chroot environment for building or installing a system:

  • Ensures ${CHROOTDIR}/dev exists and mounts devfs there if it isn’t already mounted.

  • Changes to the source directory ${SRCDIR}.

  • If WANT_CHROOT_BUILD is enabled:

    • Checks out (clones) the system source tree.

    • Builds a “bootstrap” world using make buildworld, honoring parallel jobs, silent mode, and a development-mode flag.

  • Installs the built system into the chroot using make installworld distribution DESTDIR=${CHROOTDIR}.

  • Aborts and returns a nonzero status if installation fails.

  • Creates ${CHROOTDIR}/usr/obj for build artifacts.

  • Returns success (0) on completion.

In short, it mounts required device support, optionally builds the system, installs it into a chroot, and ensures required directories exist.

clone_source

clone_source() ensures a Git source tree exists and is up to date under a given destination directory:

  • Takes an optional argument destdir (defaults to /), and works in ${destdir}/usr/src.

  • If ${destdir}/usr/src is not already a Git repository:

    • Clones the repository from ${REPO} into ${destdir}/usr/src.

    • Checks out the specified branch ${BRANCH} (creating it from origin/${BRANCH} if needed).

  • If the repository already exists:

    • Changes into ${destdir}/usr/src and updates it with git pull.

  • Propagates any Git errors by returning a non-zero status.

  • Returns 0 on success.

In short, it clones the source tree if missing, switches to the desired branch, or pulls updates if it already exists.