1# SPDX-License-Identifier: BSD-2-Clause 2# 3# $Id: dirdeps-options.mk,v 1.22 2024/02/17 17:26:57 sjg Exp $ 4# 5# @(#) Copyright (c) 2018-2022, Simon J. Gerraty 6# 7# This file is provided in the hope that it will 8# be of use. There is absolutely NO WARRANTY. 9# Permission to copy, redistribute or otherwise 10# use this file is hereby granted provided that 11# the above copyright notice and this notice are 12# left intact. 13# 14# Please send copies of changes and bug-fixes to: 15# sjg@crufty.net 16# 17 18## 19# 20# This makefile is used to deal with optional DIRDEPS. 21# 22# It is to be included by Makefile.depend.options in a 23# directory which has DIRDEPS affected by optional features. 24# Makefile.depend.options should set DIRDEPS_OPTIONS and 25# may also set specific DIRDEPS.* for those options. 26# 27# If a Makefile.depend.options file exists, it will be included by 28# dirdeps.mk and meta.autodep.mk 29# 30# We include local.dirdeps-options.mk which may also define DIRDEPS.* 31# for options. 32# 33# Thus a directory, that is affected by an option FOO would have 34# a Makefile.depend.options that sets 35# DIRDEPS_OPTIONS= FOO 36# It can also set either/both of 37# DIRDEPS.FOO.yes 38# DIRDEPS.FOO.no 39# to whatever applies for that dir, or it can rely on globals 40# set in local.dirdeps-options.mk 41# Either way, we will .undef DIRDEPS.* when done. 42# 43# In some cases the value of MK_FOO might depend on TARGET_SPEC 44# so we qualify MK_FOO with .${TARGET_SPEC} and each component 45# TARGET_SPEC_VAR (in reverse order) before using MK_FOO. 46# 47# Because Makefile.depend.options are processed at both level 0 (when 48# computing DIRDEPS to build) and higher (when updating 49# Makefile.depend* after successful build), it is important that 50# all references to TARGET_SPEC_VARs should use the syntax 51# ${DEP_${TARGET_SPEC_VAR}:U${TARGET_SPEC_VAR}} to ensure correct 52# behavior. 53# 54 55# This should have been set by Makefile.depend.options 56# before including us 57DIRDEPS_OPTIONS ?= 58 59# pickup any DIRDEPS.* we need 60.-include <local.dirdeps-options.mk> 61 62.if ${.MAKE.LEVEL} == 0 63# :U below avoids potential errors when we := 64# some options can depend on TARGET_SPEC! 65DIRDEPS_OPTIONS_QUALIFIER_LIST ?= \ 66 ${DEP_RELDIR} \ 67 ${DEP_TARGET_SPEC:U${TARGET_SPEC}} \ 68 ${TARGET_SPEC_VARSr:U${TARGET_SPEC_VARS}:@v@${DEP_$v:U${$v}}@} 69# note that we need to include $o in the variable _o$o 70# to ensure correct evaluation. 71.for o in ${DIRDEPS_OPTIONS} 72.undef _o$o 73.undef _v$o 74.for x in ${DIRDEPS_OPTIONS_QUALIFIER_LIST:S,^,${DEP_RELDIR}.,} \ 75 ${DIRDEPS_OPTIONS_QUALIFIER_LIST} 76#.info MK_$o.$x=${MK_$o.$x:Uundefined} 77.if defined(MK_$o.$x) 78_o$o ?= MK_$o.$x 79_v$o ?= ${MK_$o.$x} 80.endif 81.endfor 82_v$o ?= ${MK_$o} 83.if ${_debug_reldir:U0} 84.info ${DEP_RELDIR:U${RELDIR}}.${DEP_TARGET_SPEC:U${TARGET_SPEC}}: o=$o ${_o$o:UMK_$o}=${_v$o:U} DIRDEPS += ${DIRDEPS.$o.${_v$o:U}:U} 85.endif 86DIRDEPS += ${DIRDEPS.$o.${_v$o:U}:U} 87.endfor 88DIRDEPS := ${DIRDEPS:O:u} 89.if ${_debug_reldir:U0} 90.info ${DEP_RELDIR:U${RELDIR}}: DIRDEPS=${DIRDEPS} 91.endif 92# avoid cross contamination 93.for o in ${DIRDEPS_OPTIONS} 94.undef DIRDEPS.$o.yes 95.undef DIRDEPS.$o.no 96.undef _o$o 97.undef _v$o 98.endfor 99.else 100# whether options are enabled or not, 101# we want to filter out the relevant DIRDEPS.* 102# we should only be included by meta.autodep.mk 103# if dependencies are to be updated 104.for o in ${DIRDEPS_OPTIONS} 105.for d in ${DIRDEPS.$o.yes} ${DIRDEPS.$o.no} 106.if exists(${SRCTOP}/$d) 107GENDIRDEPS_FILTER += N$d* 108.elif exists(${SRCTOP}/${d:R}) 109GENDIRDEPS_FILTER += N${d:R}* 110.endif 111.endfor 112.endfor 113.endif 114