You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
216 lines
5.7 KiB
216 lines
5.7 KiB
# Copyright 1999-2022 Gentoo Authors
|
|
# Distributed under the terms of the GNU General Public License v2
|
|
|
|
# @ECLASS: multibuild.eclass
|
|
# @MAINTAINER:
|
|
# Michał Górny <mgorny@gentoo.org>
|
|
# @AUTHOR:
|
|
# Author: Michał Górny <mgorny@gentoo.org>
|
|
# @SUPPORTED_EAPIS: 6 7 8
|
|
# @BLURB: A generic eclass for building multiple variants of packages.
|
|
# @DESCRIPTION:
|
|
# The multibuild eclass aims to provide a generic framework for building
|
|
# multiple 'variants' of a package (e.g. multilib, Python
|
|
# implementations).
|
|
|
|
case ${EAPI} in
|
|
6|7|8) ;;
|
|
*) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;;
|
|
esac
|
|
|
|
if [[ ! ${_MULTIBUILD_ECLASS} ]]; then
|
|
_MULTIBUILD_ECLASS=1
|
|
|
|
# @ECLASS_VARIABLE: MULTIBUILD_VARIANTS
|
|
# @REQUIRED
|
|
# @DESCRIPTION:
|
|
# An array specifying all enabled variants which multibuild_foreach*
|
|
# can execute the process for.
|
|
#
|
|
# In ebuild, it can be set in global scope. Eclasses should set it
|
|
# locally in function scope to support nesting properly.
|
|
#
|
|
# Example:
|
|
# @CODE
|
|
# python_foreach_impl() {
|
|
# local MULTIBUILD_VARIANTS=( python{2_5,2_6,2_7} ... )
|
|
# multibuild_foreach_variant python_compile
|
|
# }
|
|
# @CODE
|
|
|
|
# @ECLASS_VARIABLE: MULTIBUILD_VARIANT
|
|
# @OUTPUT_VARIABLE
|
|
# @DESCRIPTION:
|
|
# The current variant which the function was executed for.
|
|
#
|
|
# Example value:
|
|
# @CODE
|
|
# python2_6
|
|
# @CODE
|
|
|
|
# @ECLASS_VARIABLE: MULTIBUILD_ID
|
|
# @OUTPUT_VARIABLE
|
|
# @DESCRIPTION:
|
|
# The unique identifier for a multibuild run. In a simple run, it is
|
|
# equal to MULTIBUILD_VARIANT. In a nested multibuild environment, it
|
|
# contains the complete selection tree.
|
|
#
|
|
# It can be used to create variant-unique directories and files.
|
|
#
|
|
# Example value:
|
|
# @CODE
|
|
# amd64-double
|
|
# @CODE
|
|
|
|
# @ECLASS_VARIABLE: BUILD_DIR
|
|
# @OUTPUT_VARIABLE
|
|
# @DEFAULT_UNSET
|
|
# @DESCRIPTION:
|
|
# The current build directory. In global scope, it is supposed
|
|
# to contain an 'initial' build directory. If unset, ${S} is used.
|
|
#
|
|
# multibuild_foreach_variant() sets BUILD_DIR locally
|
|
# to variant-specific build directories based on the initial value
|
|
# of BUILD_DIR.
|
|
#
|
|
# Example value:
|
|
# @CODE
|
|
# ${WORKDIR}/foo-1.3-python2_6
|
|
# @CODE
|
|
|
|
# @FUNCTION: multibuild_foreach_variant
|
|
# @USAGE: [<argv>...]
|
|
# @DESCRIPTION:
|
|
# Run the passed command repeatedly for each of the enabled package
|
|
# variants.
|
|
#
|
|
# Each of the runs will have variant-specific BUILD_DIR set, and output
|
|
# teed to a separate log in ${T}.
|
|
#
|
|
# The function returns 0 if all commands return 0, or the first non-zero
|
|
# exit status otherwise. However, it performs all the invocations
|
|
# nevertheless. It is preferred to call 'die' inside of the passed
|
|
# function.
|
|
multibuild_foreach_variant() {
|
|
debug-print-function ${FUNCNAME} "${@}"
|
|
|
|
[[ ${MULTIBUILD_VARIANTS} ]] \
|
|
|| die "MULTIBUILD_VARIANTS need to be set"
|
|
|
|
local bdir=${BUILD_DIR:-${S}}
|
|
|
|
# Avoid writing outside WORKDIR if S=${WORKDIR}.
|
|
[[ ${bdir%%/} == ${WORKDIR%%/} ]] && bdir=${WORKDIR}/build
|
|
|
|
local prev_id=${MULTIBUILD_ID:+${MULTIBUILD_ID}-}
|
|
local ret=0 lret=0 v
|
|
|
|
debug-print "${FUNCNAME}: initial build_dir = ${bdir}"
|
|
|
|
for v in "${MULTIBUILD_VARIANTS[@]}"; do
|
|
local MULTIBUILD_VARIANT=${v}
|
|
local MULTIBUILD_ID=${prev_id}${v}
|
|
local BUILD_DIR=${bdir%%/}-${v}
|
|
|
|
_multibuild_run() {
|
|
# find the first non-private command
|
|
local i=1
|
|
while [[ ${!i} == _* ]]; do
|
|
(( i += 1 ))
|
|
done
|
|
|
|
[[ ${i} -le ${#} ]] && einfo "${v}: running ${@:${i}}"
|
|
"${@}"
|
|
}
|
|
|
|
_multibuild_run "${@}" \
|
|
> >(exec tee -a "${T}/build-${MULTIBUILD_ID}.log") 2>&1
|
|
lret=${?}
|
|
done
|
|
[[ ${ret} -eq 0 && ${lret} -ne 0 ]] && ret=${lret}
|
|
|
|
return ${ret}
|
|
}
|
|
|
|
# @FUNCTION: multibuild_for_best_variant
|
|
# @USAGE: [<argv>...]
|
|
# @DESCRIPTION:
|
|
# Run the passed command once, for the best of the enabled package
|
|
# variants.
|
|
#
|
|
# The run will have a proper, variant-specificBUILD_DIR set, and output
|
|
# teed to a separate log in ${T}.
|
|
#
|
|
# The function returns command exit status.
|
|
multibuild_for_best_variant() {
|
|
debug-print-function ${FUNCNAME} "${@}"
|
|
|
|
[[ ${MULTIBUILD_VARIANTS} ]] \
|
|
|| die "MULTIBUILD_VARIANTS need to be set"
|
|
|
|
local MULTIBUILD_VARIANTS=( "${MULTIBUILD_VARIANTS[-1]}" )
|
|
multibuild_foreach_variant "${@}"
|
|
}
|
|
|
|
# @FUNCTION: multibuild_copy_sources
|
|
# @DESCRIPTION:
|
|
# Create per-variant copies of source tree. The source tree is assumed
|
|
# to be in ${BUILD_DIR}, or ${S} if the former is unset. The copies will
|
|
# be placed in directories matching BUILD_DIRs used by
|
|
# multibuild_foreach().
|
|
multibuild_copy_sources() {
|
|
debug-print-function ${FUNCNAME} "${@}"
|
|
|
|
local _MULTIBUILD_INITIAL_BUILD_DIR=${BUILD_DIR:-${S}}
|
|
|
|
einfo "Will copy sources from ${_MULTIBUILD_INITIAL_BUILD_DIR}"
|
|
|
|
_multibuild_create_source_copy() {
|
|
einfo "${MULTIBUILD_VARIANT}: copying to ${BUILD_DIR}"
|
|
# enable reflinking if possible to make this faster
|
|
cp -p -R --reflink=auto \
|
|
"${_MULTIBUILD_INITIAL_BUILD_DIR}" "${BUILD_DIR}" || die
|
|
}
|
|
|
|
multibuild_foreach_variant _multibuild_create_source_copy
|
|
}
|
|
|
|
# @FUNCTION: run_in_build_dir
|
|
# @USAGE: <argv>...
|
|
# @DESCRIPTION:
|
|
# Run the given command in the directory pointed by BUILD_DIR.
|
|
run_in_build_dir() {
|
|
debug-print-function ${FUNCNAME} "${@}"
|
|
local ret
|
|
|
|
[[ ${#} -ne 0 ]] || die "${FUNCNAME}: no command specified."
|
|
[[ ${BUILD_DIR} ]] || die "${FUNCNAME}: BUILD_DIR not set."
|
|
|
|
mkdir -p "${BUILD_DIR}" || die
|
|
pushd "${BUILD_DIR}" >/dev/null || die
|
|
"${@}"
|
|
ret=${?}
|
|
popd >/dev/null || die
|
|
|
|
return ${ret}
|
|
}
|
|
|
|
# @FUNCTION: multibuild_merge_root
|
|
# @USAGE: <src-root> <dest-root>
|
|
# @DESCRIPTION:
|
|
# Merge the directory tree (fake root) from <src-root> to <dest-root>
|
|
# (the real root). Both directories have to be real, absolute paths
|
|
# (i.e. including ${D}). Source root will be removed.
|
|
multibuild_merge_root() {
|
|
debug-print-function ${FUNCNAME} "${@}"
|
|
|
|
local src=${1}
|
|
local dest=${2}
|
|
|
|
# enable reflinking if possible to make this faster
|
|
cp -a --reflink=auto "${src}"/. "${dest}"/ || die "${MULTIBUILD_VARIANT:-(unknown)}: merging image failed"
|
|
rm -rf "${src}" || die
|
|
}
|
|
|
|
fi
|