After several months of testing and fixing (and breaking) various parts of release/release.sh changes, it is now possible to build FreeBSD/arm images as part of the release process. When EMBEDDEDBUILD is set in the release.conf file, release.sh will create the build environment, then run a separate script in release/${XDEV}/release.sh [1]. Currently, only arm is supported. The release/${XDEV}/release.sh configures the build environment specific for the target image, such as installing gcc(1), installing additional third-party software from the ports tree, and fetching external sources. Once the build environment is set up, release/${XDEV}/release.sh runs Crochet, written by Tim Kientzle, which builds the userland and kernel, and creates an image that can be written to an SD card with dd(1). Many thanks to Tim for his work on Crochet. Sample configurations for FreeBSD/arm boards are in the release/arm/ directory, and Crochet configuration files for each board are located in release/tools/arm/. Supported boards at this time are: BEAGLEBONE, PANDABOARD, RPI-B, and WANDBOARD-QUAD. Adding support for additional boards will continue in the projects/release-embedded/ branch, and incrementally merged back to head/. Many thanks to the FreeBSD Foundation for the support and sponsorship of this project. [1] XDEV is used in order to keep the various configurations organized by architecture, but since TARGET and TARGET_ARCH are used to build the chroot, the values of those variables cannot be used. MFC after: 1 month Sponsored by: The FreeBSD Foundation
256 lines
8.4 KiB
Bash
Executable File
256 lines
8.4 KiB
Bash
Executable File
#!/bin/sh
|
|
#-
|
|
# Copyright (c) 2013, 2014 The FreeBSD Foundation
|
|
# Copyright (c) 2013 Glen Barber
|
|
# Copyright (c) 2011 Nathan Whitehorn
|
|
# All rights reserved.
|
|
#
|
|
# Portions of this software were developed by Glen Barber
|
|
# under sponsorship from the FreeBSD Foundation.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions
|
|
# are met:
|
|
# 1. Redistributions of source code must retain the above copyright
|
|
# notice, this list of conditions and the following disclaimer.
|
|
# 2. Redistributions in binary form must reproduce the above copyright
|
|
# notice, this list of conditions and the following disclaimer in the
|
|
# documentation and/or other materials provided with the distribution.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
# SUCH DAMAGE.
|
|
#
|
|
# release.sh: check out source trees, and build release components with
|
|
# totally clean, fresh trees.
|
|
# Based on release/generate-release.sh written by Nathan Whitehorn
|
|
#
|
|
# $FreeBSD$
|
|
#
|
|
|
|
PATH="/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin"
|
|
export PATH
|
|
|
|
# The directory within which the release will be built.
|
|
CHROOTDIR="/scratch"
|
|
RELENGDIR="$(realpath $(dirname $(basename ${0})))"
|
|
|
|
# The default version control system command to obtain the sources.
|
|
VCSCMD="svn checkout"
|
|
|
|
# The default svn checkout server, and svn branches for src/, doc/,
|
|
# and ports/.
|
|
SVNROOT="svn://svn.FreeBSD.org/"
|
|
SRCBRANCH="base/head@rHEAD"
|
|
DOCBRANCH="doc/head@rHEAD"
|
|
PORTBRANCH="ports/head@rHEAD"
|
|
|
|
# Set for embedded device builds.
|
|
EMBEDDEDBUILD=
|
|
|
|
# Sometimes one needs to checkout src with --force svn option.
|
|
# If custom kernel configs copied to src tree before checkout, e.g.
|
|
SRC_FORCE_CHECKOUT=
|
|
|
|
# The default make.conf and src.conf to use. Set to /dev/null
|
|
# by default to avoid polluting the chroot(8) environment with
|
|
# non-default settings.
|
|
MAKE_CONF="/dev/null"
|
|
SRC_CONF="/dev/null"
|
|
|
|
# The number of make(1) jobs, defaults to the number of CPUs available for
|
|
# buildworld, and half of number of CPUs available for buildkernel.
|
|
WORLD_FLAGS="-j$(sysctl -n hw.ncpu)"
|
|
KERNEL_FLAGS="-j$(( $(( $(sysctl -n hw.ncpu) + 1 )) / 2))"
|
|
|
|
MAKE_FLAGS="-s"
|
|
|
|
# The name of the kernel to build, defaults to GENERIC.
|
|
KERNEL="GENERIC"
|
|
|
|
# Set to non-empty value to disable checkout of doc/ and/or ports/. Disabling
|
|
# ports/ checkout also forces NODOC to be set.
|
|
NODOC=
|
|
NOPORTS=
|
|
|
|
# Set to non-empty value to build dvd1.iso as part of the release.
|
|
WITH_DVD=
|
|
|
|
usage() {
|
|
echo "Usage: $0 [-c release.conf]"
|
|
exit 1
|
|
}
|
|
|
|
while getopts c: opt; do
|
|
case ${opt} in
|
|
c)
|
|
RELEASECONF="${OPTARG}"
|
|
if [ ! -e "${RELEASECONF}" ]; then
|
|
echo "ERROR: Configuration file ${RELEASECONF} does not exist."
|
|
exit 1
|
|
fi
|
|
# Source the specified configuration file for overrides
|
|
. ${RELEASECONF}
|
|
;;
|
|
\?)
|
|
usage
|
|
;;
|
|
esac
|
|
done
|
|
shift $(($OPTIND - 1))
|
|
|
|
# Prefix the branches with the SVNROOT for the full checkout URL.
|
|
SRCBRANCH="${SVNROOT}${SRCBRANCH}"
|
|
DOCBRANCH="${SVNROOT}${DOCBRANCH}"
|
|
PORTBRANCH="${SVNROOT}${PORTBRANCH}"
|
|
|
|
if [ -n "${EMBEDDEDBUILD}" ]; then
|
|
if [ -z "${XDEV}" ] || [ -z "${XDEV_ARCH}" ]; then
|
|
echo "ERROR: XDEV and XDEV_ARCH must be set in ${RELEASECONF}."
|
|
exit 1
|
|
fi
|
|
WITH_DVD=
|
|
NODOC=yes
|
|
fi
|
|
|
|
# If PORTS is set and NODOC is unset, force NODOC=yes because the ports tree
|
|
# is required to build the documentation set.
|
|
if [ -n "${NOPORTS}" ] && [ -z "${NODOC}" ]; then
|
|
echo "*** NOTICE: Setting NODOC=1 since ports tree is required"
|
|
echo " and NOPORTS is set."
|
|
NODOC=yes
|
|
fi
|
|
|
|
# If NOPORTS and/or NODOC are unset, they must not pass to make as variables.
|
|
# The release makefile verifies definedness of NOPORTS/NODOC variables
|
|
# instead of their values.
|
|
DOCPORTS=
|
|
if [ -n "${NOPORTS}" ]; then
|
|
DOCPORTS="NOPORTS=yes "
|
|
fi
|
|
if [ -n "${NODOC}" ]; then
|
|
DOCPORTS="${DOCPORTS}NODOC=yes"
|
|
fi
|
|
|
|
# The aggregated build-time flags based upon variables defined within
|
|
# this file, unless overridden by release.conf. In most cases, these
|
|
# will not need to be changed.
|
|
CONF_FILES="__MAKE_CONF=${MAKE_CONF} SRCCONF=${SRC_CONF}"
|
|
if [ -n "${TARGET}" ] && [ -n "${TARGET_ARCH}" ]; then
|
|
ARCH_FLAGS="TARGET=${TARGET} TARGET_ARCH=${TARGET_ARCH}"
|
|
else
|
|
ARCH_FLAGS=
|
|
fi
|
|
CHROOT_MAKEENV="${CHROOT_MAKEENV} MAKEOBJDIRPREFIX=${CHROOTDIR}/tmp/obj"
|
|
CHROOT_WMAKEFLAGS="${MAKE_FLAGS} ${WORLD_FLAGS} ${CONF_FILES}"
|
|
CHROOT_IMAKEFLAGS="${CONF_FILES}"
|
|
CHROOT_DMAKEFLAGS="${CONF_FILES}"
|
|
RELEASE_WMAKEFLAGS="${MAKE_FLAGS} ${WORLD_FLAGS} ${ARCH_FLAGS} ${CONF_FILES}"
|
|
RELEASE_KMAKEFLAGS="${MAKE_FLAGS} ${KERNEL_FLAGS} KERNCONF=\"${KERNEL}\" ${ARCH_FLAGS} ${CONF_FILES}"
|
|
RELEASE_RMAKEFLAGS="${ARCH_FLAGS} KERNCONF=\"${KERNEL}\" ${CONF_FILES} \
|
|
${DOCPORTS} WITH_DVD=${WITH_DVD}"
|
|
|
|
# Force src checkout if configured
|
|
FORCE_SRC_KEY=
|
|
if [ -n "${SRC_FORCE_CHECKOUT}" ]; then
|
|
FORCE_SRC_KEY="--force"
|
|
fi
|
|
|
|
if [ -z "${CHROOTDIR}" ]; then
|
|
echo "Please set CHROOTDIR."
|
|
exit 1
|
|
fi
|
|
|
|
if [ $(id -u) -ne 0 ]; then
|
|
echo "Needs to be run as root."
|
|
exit 1
|
|
fi
|
|
|
|
set -e # Everything must succeed
|
|
|
|
mkdir -p ${CHROOTDIR}/usr
|
|
|
|
${VCSCMD} ${FORCE_SRC_KEY} ${SRCBRANCH} ${CHROOTDIR}/usr/src
|
|
if [ -z "${NODOC}" ]; then
|
|
${VCSCMD} ${DOCBRANCH} ${CHROOTDIR}/usr/doc
|
|
fi
|
|
if [ -z "${NOPORTS}" ]; then
|
|
${VCSCMD} ${PORTBRANCH} ${CHROOTDIR}/usr/ports
|
|
fi
|
|
|
|
if [ -z "${CHROOTBUILD_SKIP}" ]; then
|
|
cd ${CHROOTDIR}/usr/src
|
|
env ${CHROOT_MAKEENV} make ${CHROOT_WMAKEFLAGS} buildworld
|
|
env ${CHROOT_MAKEENV} make ${CHROOT_IMAKEFLAGS} installworld \
|
|
DESTDIR=${CHROOTDIR}
|
|
env ${CHROOT_MAKEENV} make ${CHROOT_DMAKEFLAGS} distribution \
|
|
DESTDIR=${CHROOTDIR}
|
|
fi
|
|
mount -t devfs devfs ${CHROOTDIR}/dev
|
|
cp /etc/resolv.conf ${CHROOTDIR}/etc/resolv.conf
|
|
trap "umount ${CHROOTDIR}/dev" EXIT # Clean up devfs mount on exit
|
|
|
|
# If MAKE_CONF and/or SRC_CONF are set and not character devices (/dev/null),
|
|
# copy them to the chroot.
|
|
if [ -e ${MAKE_CONF} ] && [ ! -c ${MAKE_CONF} ]; then
|
|
mkdir -p ${CHROOTDIR}/$(dirname ${MAKE_CONF})
|
|
cp ${MAKE_CONF} ${CHROOTDIR}/${MAKE_CONF}
|
|
fi
|
|
if [ -e ${SRC_CONF} ] && [ ! -c ${SRC_CONF} ]; then
|
|
mkdir -p ${CHROOTDIR}/$(dirname ${SRC_CONF})
|
|
cp ${SRC_CONF} ${CHROOTDIR}/${SRC_CONF}
|
|
fi
|
|
|
|
# Embedded builds do not use the 'make release' target.
|
|
if [ -n "${EMBEDDEDBUILD}" ]; then
|
|
# If a crochet configuration file exists in *this* checkout of
|
|
# release/, copy it to the /tmp/external directory within the chroot.
|
|
# This allows building embedded releases without relying on updated
|
|
# scripts and/or configurations to exist in the branch being built.
|
|
if [ -e ${RELENGDIR}/tools/${XDEV}/crochet-${KERNEL}.conf ] && \
|
|
[ -e ${RELENGDIR}/${XDEV}/release.sh ]; then
|
|
mkdir -p ${CHROOTDIR}/tmp/external/${XDEV}/
|
|
cp ${RELENGDIR}/tools/${XDEV}/crochet-${KERNEL}.conf \
|
|
${CHROOTDIR}/tmp/external/${XDEV}/crochet-${KERNEL}.conf
|
|
/bin/sh ${RELENGDIR}/${XDEV}/release.sh
|
|
fi
|
|
# If the script does not exist for this architecture, exit.
|
|
# This probably should be checked earlier, but allowing the rest
|
|
# of the build process to get this far will at least set up the
|
|
# chroot environment for testing.
|
|
exit 0
|
|
else
|
|
# Not embedded.
|
|
continue
|
|
fi
|
|
|
|
if [ -d ${CHROOTDIR}/usr/ports ]; then
|
|
# Run ldconfig(8) in the chroot directory so /var/run/ld-elf*.so.hints
|
|
# is created. This is needed by ports-mgmt/pkg.
|
|
chroot ${CHROOTDIR} /etc/rc.d/ldconfig forcerestart
|
|
|
|
## Trick the ports 'run-autotools-fixup' target to do the right thing.
|
|
_OSVERSION=$(sysctl -n kern.osreldate)
|
|
if [ -d ${CHROOTDIR}/usr/doc ] && [ -z "${NODOC}" ]; then
|
|
PBUILD_FLAGS="OSVERSION=${_OSVERSION} BATCH=yes"
|
|
PBUILD_FLAGS="${PBUILD_FLAGS}"
|
|
chroot ${CHROOTDIR} make -C /usr/ports/textproc/docproj \
|
|
${PBUILD_FLAGS} OPTIONS_UNSET="FOP IGOR" install clean distclean
|
|
fi
|
|
fi
|
|
|
|
eval chroot ${CHROOTDIR} make -C /usr/src ${RELEASE_WMAKEFLAGS} buildworld
|
|
eval chroot ${CHROOTDIR} make -C /usr/src ${RELEASE_KMAKEFLAGS} buildkernel
|
|
eval chroot ${CHROOTDIR} make -C /usr/src/release ${RELEASE_RMAKEFLAGS} \
|
|
release
|
|
eval chroot ${CHROOTDIR} make -C /usr/src/release ${RELEASE_RMAKEFLAGS} \
|
|
install DESTDIR=/R
|