share/mk/dirdeps.mk

   1 # $FreeBSD$
   2 # $Id: dirdeps.mk,v 1.96 2018/06/20 22:26:39 sjg Exp $
   3
   4 # Copyright (c) 2010-2013, Juniper Networks, Inc.
   5 # All rights reserved.
   6 #
   7 # Redistribution and use in source and binary forms, with or without
   8 # modification, are permitted provided that the following conditions
   9 # are met:
  10 # 1. Redistributions of source code must retain the above copyright
  11 #    notice, this list of conditions and the following disclaimer.
  12 # 2. Redistributions in binary form must reproduce the above copyright
  13 #    notice, this list of conditions and the following disclaimer in the
  14 #    documentation and/or other materials provided with the distribution.
  15 #
  16 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  17 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  18 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  19 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  20 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  26 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27
  28 # Much of the complexity here is for supporting cross-building.
  29 # If a tree does not support that, simply using plain Makefile.depend
  30 # should provide sufficient clue.
  31 # Otherwise the recommendation is to use Makefile.depend.${MACHINE}
  32 # as expected below.
  33
  34 # Note: this file gets multiply included.
  35 # This is what we do with DIRDEPS
  36
  37 # DIRDEPS:
  38 #       This is a list of directories - relative to SRCTOP, it is
  39 #       normally only of interest to .MAKE.LEVEL 0.
  40 #       In some cases the entry may be qualified with a .<machine>
  41 #       or .<target_spec> suffix (see TARGET_SPEC_VARS below),
  42 #       for example to force building something for the pseudo
  43 #       machines "host" or "common" regardless of current ${MACHINE}.
  44 #
  45 #       All unqualified entries end up being qualified with .${TARGET_SPEC}
  46 #       and partially qualified (if TARGET_SPEC_VARS has multiple
  47 #       entries) are also expanded to a full .<target_spec>.
  48 #       The  _DIRDEP_USE target uses the suffix to set TARGET_SPEC
  49 #       correctly when visiting each entry.
  50 #
  51 #       The fully qualified directory entries are used to construct a
  52 #       dependency graph that will drive the build later.
  53 #
  54 #       Also, for each fully qualified directory target, we will search
  55 #       using ${.MAKE.DEPENDFILE_PREFERENCE} to find additional
  56 #       dependencies.  We use Makefile.depend (default value for
  57 #       .MAKE.DEPENDFILE_PREFIX) to refer to these makefiles to
  58 #       distinguish them from others.
  59 #
  60 #       Before each Makefile.depend file is read, we set
  61 #       DEP_RELDIR to be the RELDIR (path relative to SRCTOP) for
  62 #       its directory, and DEP_MACHINE etc according to the .<target_spec>
  63 #       represented by the suffix of the corresponding target.
  64 #
  65 #       Since each Makefile.depend file includes dirdeps.mk, this
  66 #       processing is recursive and results in .MAKE.LEVEL 0 learning the
  67 #       dependencies of the tree wrt the initial directory (_DEP_RELDIR).
  68 #
  69 # BUILD_AT_LEVEL0
  70 #       Indicates whether .MAKE.LEVEL 0 builds anything:
  71 #       if "no" sub-makes are used to build everything,
  72 #       if "yes" sub-makes are only used to build for other machines.
  73 #       It is best to use "no", but this can require fixing some
  74 #       makefiles to not do anything at .MAKE.LEVEL 0.
  75 #
  76 # TARGET_SPEC_VARS
  77 #       The default value is just MACHINE, and for most environments
  78 #       this is sufficient.  The _DIRDEP_USE target actually sets
  79 #       both MACHINE and TARGET_SPEC to the suffix of the current
  80 #       target so that in the general case TARGET_SPEC can be ignored.
  81 #
  82 #       If more than MACHINE is needed then sys.mk needs to decompose
  83 #       TARGET_SPEC and set the relevant variables accordingly.
  84 #       It is important that MACHINE be included in and actually be
  85 #       the first member of TARGET_SPEC_VARS.  This allows other
  86 #       variables to be considered optional, and some of the treatment
  87 #       below relies on MACHINE being the first entry.
  88 #       Note: TARGET_SPEC cannot contain any '.'s so the target
  89 #       triple used by compiler folk won't work (directly anyway).
  90 #
  91 #       For example:
  92 #
  93 #               # Always list MACHINE first,
  94 #               # other variables might be optional.
  95 #               TARGET_SPEC_VARS = MACHINE TARGET_OS
  96 #               .if ${TARGET_SPEC:Uno:M*,*} != ""
  97 #               _tspec := ${TARGET_SPEC:S/,/ /g}
  98 #               MACHINE := ${_tspec:[1]}
  99 #               TARGET_OS := ${_tspec:[2]}
 100 #               # etc.
 101 #               # We need to stop that TARGET_SPEC affecting any submakes
 102 #               # and deal with MACHINE=${TARGET_SPEC} in the environment.
 103 #               TARGET_SPEC =
 104 #               # export but do not track
 105 #               .export-env TARGET_SPEC
 106 #               .export ${TARGET_SPEC_VARS}
 107 #               .for v in ${TARGET_SPEC_VARS:O:u}
 108 #               .if empty($v)
 109 #               .undef $v
 110 #               .endif
 111 #               .endfor
 112 #               .endif
 113 #               # make sure we know what TARGET_SPEC is
 114 #               # as we may need it to find Makefile.depend*
 115 #               TARGET_SPEC = ${TARGET_SPEC_VARS:@v@${$v:U}@:ts,}
 116 #
 117 #       The following variables can influence the initial DIRDEPS
 118 #       computation with regard to the TARGET_SPECs that will be
 119 #       built.
 120 #       Most should also be considered by init.mk
 121 #
 122 #       ONLY_TARGET_SPEC_LIST
 123 #               Defines a list of TARGET_SPECs for which the current
 124 #               directory can be built.
 125 #               If ALL_MACHINES is defined, we build for all the
 126 #               TARGET_SPECs listed.
 127 #
 128 #       ONLY_MACHINE_LIST
 129 #               As for ONLY_TARGET_SPEC_LIST but only specifies
 130 #               MACHINEs.
 131 #
 132 #       NOT_TARGET_SPEC_LIST
 133 #               A list of TARGET_SPECs for which the current
 134 #               directory should not be built.
 135 #
 136 #       NOT_MACHINE_LIST
 137 #               A list of MACHINEs the current directory should not be
 138 #               built for.
 139 #
 140
 141 .if !target(bootstrap) && (make(bootstrap) || \
 142         make(bootstrap-this) || \
 143         make(bootstrap-recurse) || \
 144         make(bootstrap-empty))
 145 # disable most of below
 146 .MAKE.LEVEL = 1
 147 .endif
 148
 149 # touch this at your peril
 150 _DIRDEP_USE_LEVEL?= 0
 151 .if ${.MAKE.LEVEL} == ${_DIRDEP_USE_LEVEL}
 152 # only the first instance is interested in all this
 153
 154 .if !target(_DIRDEP_USE)
 155
 156 # do some setup we only need once
 157 _CURDIR ?= ${.CURDIR}
 158 _OBJDIR ?= ${.OBJDIR}
 159
 160 now_utc = ${%s:L:gmtime}
 161 .if !defined(start_utc)
 162 start_utc := ${now_utc}
 163 .endif
 164
 165 .if ${MAKEFILE:T} == ${.PARSEFILE} && empty(DIRDEPS) && ${.TARGETS:Uall:M*/*} != ""
 166 # This little trick let's us do
 167 #
 168 # mk -f dirdeps.mk some/dir.${TARGET_SPEC}
 169 #
 170 all:
 171 ${.TARGETS:Nall}: all
 172 DIRDEPS := ${.TARGETS:M*[/.]*}
 173 # so that -DNO_DIRDEPS works
 174 DEP_RELDIR := ${DIRDEPS:[1]:R}
 175 # this will become DEP_MACHINE below
 176 TARGET_MACHINE := ${DIRDEPS:[1]:E:C/,.*//}
 177 .if ${TARGET_MACHINE:N*/*} == ""
 178 TARGET_MACHINE := ${MACHINE}
 179 .endif
 180 # disable DIRDEPS_CACHE as it does not like this trick
 181 MK_DIRDEPS_CACHE = no
 182 .endif
 183
 184 # make sure we get the behavior we expect
 185 .MAKE.SAVE_DOLLARS = no
 186
 187 # make sure these are empty to start with
 188 _DEP_TARGET_SPEC =
 189
 190 # If TARGET_SPEC_VARS is other than just MACHINE
 191 # it should be set by sys.mk or similar by now.
 192 # TARGET_SPEC must not contain any '.'s.
 193 TARGET_SPEC_VARS ?= MACHINE
 194 # this is what we started with
 195 TARGET_SPEC = ${TARGET_SPEC_VARS:@v@${$v:U}@:ts,}
 196 # this is what we mostly use below
 197 DEP_TARGET_SPEC = ${TARGET_SPEC_VARS:S,^,DEP_,:@v@${$v:U}@:ts,}
 198 # make sure we have defaults
 199 .for v in ${TARGET_SPEC_VARS}
 200 DEP_$v ?= ${$v}
 201 .endfor
 202
 203 .if ${TARGET_SPEC_VARS:[#]} > 1
 204 # Ok, this gets more complex (putting it mildly).
 205 # In order to stay sane, we need to ensure that all the build_dirs
 206 # we compute below are fully qualified wrt DEP_TARGET_SPEC.
 207 # The makefiles may only partially specify (eg. MACHINE only),
 208 # so we need to construct a set of modifiers to fill in the gaps.
 209 .if ${MAKE_VERSION} >= 20170130
 210 _tspec_x := ${TARGET_SPEC_VARS:range}
 211 .elif ${TARGET_SPEC_VARS:[#]} > 10
 212 # seriously? better have jot(1) or equivalent to produce suitable sequence
 213 _tspec_x := ${${JOT:Ujot} ${TARGET_SPEC_VARS:[#]}:L:sh}
 214 .else
 215 # we can provide the sequence ourselves
 216 _tspec_x := ${1 2 3 4 5 6 7 8 9 10:L:[1..${TARGET_SPEC_VARS:[#]}]}
 217 .endif
 218 # this handles unqualified entries
 219 M_dep_qual_fixes = C;(/[^/.,]+)$$;\1.$${DEP_TARGET_SPEC};
 220 # there needs to be at least one item missing for these to make sense
 221 .for i in ${_tspec_x:[2..-1]}
 222 _tspec_m$i := ${TARGET_SPEC_VARS:[2..$i]:@w@[^,]+@:ts,}
 223 _tspec_a$i := ,${TARGET_SPEC_VARS:[$i..-1]:@v@$$$${DEP_$v}@:ts,}
 224 M_dep_qual_fixes += C;(\.${_tspec_m$i})$$;\1${_tspec_a$i};
 225 .endfor
 226 .else
 227 # A harmless? default.
 228 M_dep_qual_fixes = U
 229 .endif
 230
 231 .if !defined(.MAKE.DEPENDFILE_PREFERENCE)
 232 # .MAKE.DEPENDFILE_PREFERENCE makes the logic below neater?
 233 # you really want this set by sys.mk or similar
 234 .MAKE.DEPENDFILE_PREFERENCE = ${_CURDIR}/${.MAKE.DEPENDFILE:T}
 235 .if ${.MAKE.DEPENDFILE:E} == "${TARGET_SPEC}"
 236 .if ${TARGET_SPEC} != ${MACHINE}
 237 .MAKE.DEPENDFILE_PREFERENCE += ${_CURDIR}/${.MAKE.DEPENDFILE:T:R}.$${MACHINE}
 238 .endif
 239 .MAKE.DEPENDFILE_PREFERENCE += ${_CURDIR}/${.MAKE.DEPENDFILE:T:R}
 240 .endif
 241 .endif
 242
 243 _default_dependfile := ${.MAKE.DEPENDFILE_PREFERENCE:[1]:T}
 244 _machine_dependfiles := ${.MAKE.DEPENDFILE_PREFERENCE:T:M*${MACHINE}*}
 245
 246 # for machine specific dependfiles we require ${MACHINE} to be at the end
 247 # also for the sake of sanity we require a common prefix
 248 .if !defined(.MAKE.DEPENDFILE_PREFIX)
 249 # knowing .MAKE.DEPENDFILE_PREFIX helps
 250 .if !empty(_machine_dependfiles)
 251 .MAKE.DEPENDFILE_PREFIX := ${_machine_dependfiles:[1]:T:R}
 252 .else
 253 .MAKE.DEPENDFILE_PREFIX := ${_default_dependfile:T}
 254 .endif
 255 .endif
 256
 257
 258 # this is how we identify non-machine specific dependfiles
 259 N_notmachine := ${.MAKE.DEPENDFILE_PREFERENCE:E:N*${MACHINE}*:${M_ListToSkip}}
 260
 261 .endif                          # !target(_DIRDEP_USE)
 262
 263 # First off, we want to know what ${MACHINE} to build for.
 264 # This can be complicated if we are using a mixture of ${MACHINE} specific
 265 # and non-specific Makefile.depend*
 266
 267 # if we were included recursively _DEP_TARGET_SPEC should be valid.
 268 .if empty(_DEP_TARGET_SPEC)
 269 # we may or may not have included a dependfile yet
 270 .if defined(.INCLUDEDFROMFILE)
 271 _last_dependfile := ${.INCLUDEDFROMFILE:M${.MAKE.DEPENDFILE_PREFIX}*}
 272 .else
 273 _last_dependfile := ${.MAKE.MAKEFILES:M*/${.MAKE.DEPENDFILE_PREFIX}*:[-1]}
 274 .endif
 275 .if ${_debug_reldir:U0}
 276 .info ${DEP_RELDIR}.${DEP_TARGET_SPEC}: _last_dependfile='${_last_dependfile}'
 277 .endif
 278
 279 .if empty(_last_dependfile) || ${_last_dependfile:E:${N_notmachine}} == ""
 280 # this is all we have to work with
 281 DEP_MACHINE = ${TARGET_MACHINE:U${MACHINE}}
 282 _DEP_TARGET_SPEC := ${DEP_TARGET_SPEC}
 283 .else
 284 _DEP_TARGET_SPEC = ${_last_dependfile:${M_dep_qual_fixes:ts:}:E}
 285 .endif
 286 .if !empty(_last_dependfile)
 287 # record that we've read dependfile for this
 288 _dirdeps_checked.${_CURDIR}.${TARGET_SPEC}:
 289 .endif
 290 .endif
 291
 292 # by now _DEP_TARGET_SPEC should be set, parse it.
 293 .if ${TARGET_SPEC_VARS:[#]} > 1
 294 # we need to parse DEP_MACHINE may or may not contain more info
 295 _tspec := ${_DEP_TARGET_SPEC:S/,/ /g}
 296 .for i in ${_tspec_x}
 297 DEP_${TARGET_SPEC_VARS:[$i]} := ${_tspec:[$i]}
 298 .endfor
 299 .for v in ${TARGET_SPEC_VARS:O:u}
 300 .if empty(DEP_$v)
 301 .undef DEP_$v
 302 .endif
 303 .endfor
 304 .else
 305 DEP_MACHINE := ${_DEP_TARGET_SPEC}
 306 .endif
 307
 308 # reset each time through
 309 _build_all_dirs =
 310
 311 # the first time we are included the _DIRDEP_USE target will not be defined
 312 # we can use this as a clue to do initialization and other one time things.
 313 .if !target(_DIRDEP_USE)
 314 # make sure this target exists
 315 dirdeps: beforedirdeps .WAIT
 316 beforedirdeps:
 317
 318 # We normally expect to be included by Makefile.depend.*
 319 # which sets the DEP_* macros below.
 320 DEP_RELDIR ?= ${RELDIR}
 321
 322 # this can cause lots of output!
 323 # set to a set of glob expressions that might match RELDIR
 324 DEBUG_DIRDEPS ?= no
 325
 326 # remember the initial value of DEP_RELDIR - we test for it below.
 327 _DEP_RELDIR := ${DEP_RELDIR}
 328
 329 .endif
 330
 331 # DIRDEPS_CACHE can be very handy for debugging.
 332 # Also if repeatedly building the same target,
 333 # we can avoid the overhead of re-computing the tree dependencies.
 334 MK_DIRDEPS_CACHE ?= no
 335 BUILD_DIRDEPS_CACHE ?= no
 336 BUILD_DIRDEPS ?= yes
 337
 338 .if ${MK_DIRDEPS_CACHE} == "yes"
 339 # this is where we will cache all our work
 340 DIRDEPS_CACHE ?= ${_OBJDIR:tA}/dirdeps.cache${.TARGETS:Nall:O:u:ts-:S,/,_,g:S,^,.,:N.}
 341 .endif
 342
 343 # pickup customizations
 344 # as below you can use !target(_DIRDEP_USE) to protect things
 345 # which should only be done once.
 346 .-include <local.dirdeps.mk>
 347
 348 .if !target(_DIRDEP_USE)
 349 # things we skip for host tools
 350 SKIP_HOSTDIR ?=
 351
 352 NSkipHostDir = ${SKIP_HOSTDIR:N*.host*:S,$,.host*,:N.host*:S,^,${SRCTOP}/,:${M_ListToSkip}}
 353
 354 # things we always skip
 355 # SKIP_DIRDEPS allows for adding entries on command line.
 356 SKIP_DIR += .host *.WAIT ${SKIP_DIRDEPS}
 357 SKIP_DIR.host += ${SKIP_HOSTDIR}
 358
 359 DEP_SKIP_DIR = ${SKIP_DIR} \
 360         ${SKIP_DIR.${DEP_TARGET_SPEC}:U} \
 361         ${TARGET_SPEC_VARS:@v@${SKIP_DIR.${DEP_$v}:U}@} \
 362         ${SKIP_DIRDEPS.${DEP_TARGET_SPEC}:U} \
 363         ${TARGET_SPEC_VARS:@v@${SKIP_DIRDEPS.${DEP_$v}:U}@}
 364
 365
 366 NSkipDir = ${DEP_SKIP_DIR:${M_ListToSkip}}
 367
 368 .if defined(NODIRDEPS) || defined(WITHOUT_DIRDEPS)
 369 NO_DIRDEPS =
 370 .elif defined(WITHOUT_DIRDEPS_BELOW)
 371 NO_DIRDEPS_BELOW =
 372 .endif
 373
 374 .if defined(NO_DIRDEPS)
 375 # confine ourselves to the original dir and below.
 376 DIRDEPS_FILTER += M${_DEP_RELDIR}*
 377 .elif defined(NO_DIRDEPS_BELOW)
 378 DIRDEPS_FILTER += M${_DEP_RELDIR}
 379 .endif
 380
 381 # this is what we run below
 382 DIRDEP_MAKE?= ${.MAKE}
 383
 384 # we suppress SUBDIR when visiting the leaves
 385 # we assume sys.mk will set MACHINE_ARCH
 386 # you can add extras to DIRDEP_USE_ENV
 387 # if there is no makefile in the target directory, we skip it.
 388 _DIRDEP_USE:    .USE .MAKE
 389         @for m in ${.MAKE.MAKEFILE_PREFERENCE}; do \
 390                 test -s ${.TARGET:R}/$$m || continue; \
 391                 echo "${TRACER}Checking ${.TARGET:R} for ${.TARGET:E} ..."; \
 392                 MACHINE_ARCH= NO_SUBDIR=1 ${DIRDEP_USE_ENV} \
 393                 TARGET_SPEC=${.TARGET:E} \
 394                 MACHINE=${.TARGET:E} \
 395                 ${DIRDEP_MAKE} -C ${.TARGET:R} || exit 1; \
 396                 break; \
 397         done
 398
 399 .ifdef ALL_MACHINES
 400 # this is how you limit it to only the machines we have been built for
 401 # previously.
 402 .if empty(ONLY_TARGET_SPEC_LIST) && empty(ONLY_MACHINE_LIST)
 403 .if !empty(ALL_MACHINE_LIST)
 404 # ALL_MACHINE_LIST is the list of all legal machines - ignore anything else
 405 _machine_list != cd ${_CURDIR} && 'ls' -1 ${ALL_MACHINE_LIST:O:u:@m@${.MAKE.DEPENDFILE:T:R}.$m@} 2> /dev/null; echo
 406 .else
 407 _machine_list != 'ls' -1 ${_CURDIR}/${.MAKE.DEPENDFILE_PREFIX}.* 2> /dev/null; echo
 408 .endif
 409 _only_machines := ${_machine_list:${NIgnoreFiles:UN*.bak}:E:O:u}
 410 .else
 411 _only_machines := ${ONLY_TARGET_SPEC_LIST:U} ${ONLY_MACHINE_LIST:U}
 412 .endif
 413
 414 .if empty(_only_machines)
 415 # we must be boot-strapping
 416 _only_machines := ${TARGET_MACHINE:U${ALL_MACHINE_LIST:U${DEP_MACHINE}}}
 417 .endif
 418
 419 .else                           # ! ALL_MACHINES
 420 # if ONLY_TARGET_SPEC_LIST or ONLY_MACHINE_LIST is set, we are limited to that.
 421 # Note that ONLY_TARGET_SPEC_LIST should be fully qualified.
 422 # if TARGET_MACHINE is set - it is really the same as ONLY_MACHINE_LIST
 423 # otherwise DEP_MACHINE is it - so DEP_MACHINE will match.
 424 _only_machines := ${ONLY_TARGET_SPEC_LIST:U:M${DEP_MACHINE},*}
 425 .if empty(_only_machines)
 426 _only_machines := ${ONLY_MACHINE_LIST:U${TARGET_MACHINE:U${DEP_MACHINE}}:M${DEP_MACHINE}}
 427 .endif
 428 .endif
 429
 430 .if !empty(NOT_MACHINE_LIST)
 431 _only_machines := ${_only_machines:${NOT_MACHINE_LIST:${M_ListToSkip}}}
 432 .endif
 433 .if !empty(NOT_TARGET_SPEC_LIST)
 434 # we must first qualify
 435 _dm := ${DEP_MACHINE}
 436 _only_machines := ${_only_machines:M*,*} ${_only_machines:N*,*:@DEP_MACHINE@${DEP_TARGET_SPEC}@:S,^,.,:${M_dep_qual_fixes:ts:}:O:u:S,^.,,}
 437 DEP_MACHINE := ${_dm}
 438 _only_machines := ${_only_machines:${NOT_TARGET_SPEC_LIST:${M_ListToSkip}}}
 439 .endif
 440 # clean up
 441 _only_machines := ${_only_machines:O:u}
 442
 443 # make sure we have a starting place?
 444 DIRDEPS ?= ${RELDIR}
 445 .endif                          # target
 446
 447 .if !defined(NO_DIRDEPS) && !defined(NO_DIRDEPS_BELOW)
 448 .if ${MK_DIRDEPS_CACHE} == "yes"
 449
 450 # just ensure this exists
 451 build-dirdeps:
 452
 453 M_oneperline = @x@\\${.newline} $$x@
 454
 455 .if ${BUILD_DIRDEPS_CACHE} == "no"
 456 .if !target(dirdeps-cached)
 457 # we do this via sub-make
 458 BUILD_DIRDEPS = no
 459
 460 # ignore anything but these
 461 .MAKE.META.IGNORE_FILTER = M*/${.MAKE.DEPENDFILE_PREFIX}*
 462
 463 dirdeps: dirdeps-cached
 464 dirdeps-cached: ${DIRDEPS_CACHE} .MAKE
 465         @echo "${TRACER}Using ${DIRDEPS_CACHE}"
 466         @MAKELEVEL=${.MAKE.LEVEL} ${.MAKE} -C ${_CURDIR} -f ${DIRDEPS_CACHE} \
 467                 dirdeps MK_DIRDEPS_CACHE=no BUILD_DIRDEPS=no
 468
 469 # these should generally do
 470 BUILD_DIRDEPS_MAKEFILE ?= ${MAKEFILE}
 471 BUILD_DIRDEPS_TARGETS ?= ${.TARGETS}
 472
 473 # we need the .meta file to ensure we update if
 474 # any of the Makefile.depend* changed.
 475 # We do not want to compare the command line though.
 476 ${DIRDEPS_CACHE}:       .META .NOMETA_CMP
 477         +@{ echo '# Autogenerated - do NOT edit!'; echo; \
 478         echo 'BUILD_DIRDEPS=no'; echo; \
 479         echo '.include <dirdeps.mk>'; \
 480         } > ${.TARGET}.new
 481         +@MAKELEVEL=${.MAKE.LEVEL} DIRDEPS_CACHE=${DIRDEPS_CACHE} \
 482         DIRDEPS="${DIRDEPS}" \
 483         TARGET_SPEC=${TARGET_SPEC} \
 484         MAKEFLAGS= ${.MAKE} -C ${_CURDIR} -f ${BUILD_DIRDEPS_MAKEFILE} \
 485         ${BUILD_DIRDEPS_TARGETS} BUILD_DIRDEPS_CACHE=yes \
 486         .MAKE.DEPENDFILE=.none \
 487         ${.MAKEFLAGS:tW:S,-D ,-D,g:tw:M*WITH*} \
 488         3>&1 1>&2 | sed 's,${SRCTOP},$${SRCTOP},g' >> ${.TARGET}.new && \
 489         mv ${.TARGET}.new ${.TARGET}
 490
 491 .endif
 492 .elif !target(_count_dirdeps)
 493 # we want to capture the dirdeps count in the cache
 494 .END: _count_dirdeps
 495 _count_dirdeps: .NOMETA
 496         @echo '.info $${.newline}$${TRACER}Makefiles read: total=${.MAKE.MAKEFILES:[#]} depend=${.MAKE.MAKEFILES:M*depend*:[#]} dirdeps=${.ALLTARGETS:M${SRCTOP}*:O:u:[#]}' >&3
 497
 498 .endif
 499 .elif !make(dirdeps) && !target(_count_dirdeps)
 500 beforedirdeps: _count_dirdeps
 501 _count_dirdeps: .NOMETA
 502         @echo "${TRACER}Makefiles read: total=${.MAKE.MAKEFILES:[#]} depend=${.MAKE.MAKEFILES:M*depend*:[#]} dirdeps=${.ALLTARGETS:M${SRCTOP}*:O:u:[#]} seconds=`expr ${now_utc} - ${start_utc}`"
 503
 504 .endif
 505 .endif
 506
 507 .if ${BUILD_DIRDEPS} == "yes"
 508 .if ${DEBUG_DIRDEPS:@x@${DEP_RELDIR:M$x}${${DEP_RELDIR}.${DEP_MACHINE}:L:M$x}@} != ""
 509 _debug_reldir = 1
 510 .else
 511 _debug_reldir = 0
 512 .endif
 513 .if ${DEBUG_DIRDEPS:@x@${DEP_RELDIR:M$x}${${DEP_RELDIR}.depend:L:M$x}@} != ""
 514 _debug_search = 1
 515 .else
 516 _debug_search = 0
 517 .endif
 518
 519 # the rest is done repeatedly for every Makefile.depend we read.
 520 # if we are anything but the original dir we care only about the
 521 # machine type we were included for..
 522
 523 .if ${DEP_RELDIR} == "."
 524 _this_dir := ${SRCTOP}
 525 .else
 526 _this_dir := ${SRCTOP}/${DEP_RELDIR}
 527 .endif
 528
 529 # on rare occasions, there can be a need for extra help
 530 _dep_hack := ${_this_dir}/${.MAKE.DEPENDFILE_PREFIX}.inc
 531 .-include <${_dep_hack}>
 532 .-include <${_dep_hack:R}.options>
 533
 534 .if ${DEP_RELDIR} != ${_DEP_RELDIR} || ${DEP_TARGET_SPEC} != ${TARGET_SPEC}
 535 # this should be all
 536 _machines := ${DEP_MACHINE}
 537 .else
 538 # this is the machine list we actually use below
 539 _machines := ${_only_machines}
 540
 541 .if defined(HOSTPROG) || ${DEP_MACHINE:Nhost*} == ""
 542 # we need to build this guy's dependencies for host as well.
 543 .if ${DEP_MACHINE:Nhost*} == ""
 544 _machines += ${DEP_MACHINE}
 545 .else
 546 _machines += host
 547 .endif
 548 .endif
 549
 550 _machines := ${_machines:O:u}
 551 .endif
 552
 553 .if ${TARGET_SPEC_VARS:[#]} > 1
 554 # we need to tweak _machines
 555 _dm := ${DEP_MACHINE}
 556 # apply the same filtering that we do when qualifying DIRDEPS.
 557 # M_dep_qual_fixes expects .${MACHINE}* so add (and remove) '.'
 558 # Again we expect that any already qualified machines are fully qualified.
 559 _machines := ${_machines:M*,*} ${_machines:N*,*:@DEP_MACHINE@${DEP_TARGET_SPEC}@:S,^,.,:${M_dep_qual_fixes:ts:}:O:u:S,^.,,}
 560 DEP_MACHINE := ${_dm}
 561 _machines := ${_machines:O:u}
 562 .endif
 563
 564 # reset each time through
 565 _build_dirs =
 566
 567 .if ${DEP_RELDIR} == ${_DEP_RELDIR}
 568 # pickup other machines for this dir if necessary
 569 .if ${BUILD_AT_LEVEL0:Uyes} == "no"
 570 _build_dirs += ${_machines:@m@${_CURDIR}.$m@}
 571 .else
 572 _build_dirs += ${_machines:N${DEP_TARGET_SPEC}:@m@${_CURDIR}.$m@}
 573 .if ${DEP_TARGET_SPEC} == ${TARGET_SPEC}
 574 # pickup local dependencies now
 575 .if ${MAKE_VERSION} < 20160220
 576 .-include <.depend>
 577 .else
 578 .dinclude <.depend>
 579 .endif
 580 .endif
 581 .endif
 582 .endif
 583
 584 .if ${_debug_reldir}
 585 .info ${DEP_RELDIR}.${DEP_TARGET_SPEC}: DIRDEPS='${DIRDEPS}'
 586 .info ${DEP_RELDIR}.${DEP_TARGET_SPEC}: _machines='${_machines}'
 587 .endif
 588
 589 .if !empty(DIRDEPS)
 590 # these we reset each time through as they can depend on DEP_MACHINE
 591 DEP_DIRDEPS_FILTER = \
 592         ${DIRDEPS_FILTER.${DEP_TARGET_SPEC}:U} \
 593         ${TARGET_SPEC_VARS:@v@${DIRDEPS_FILTER.${DEP_$v}:U}@} \
 594         ${DIRDEPS_FILTER:U}
 595 .if empty(DEP_DIRDEPS_FILTER)
 596 # something harmless
 597 DEP_DIRDEPS_FILTER = U
 598 .endif
 599
 600 # this is what we start with
 601 __depdirs := ${DIRDEPS:${NSkipDir}:${DEP_DIRDEPS_FILTER:ts:}:C,//+,/,g:O:u:@d@${SRCTOP}/$d@}
 602
 603 # some entries may be qualified with .<machine>
 604 # the :M*/*/*.* just tries to limit the dirs we check to likely ones.
 605 # the ${d:E:M*/*} ensures we don't consider junos/usr.sbin/mgd
 606 __qual_depdirs := ${__depdirs:M*/*/*.*:@d@${exists($d):?:${"${d:E:M*/*}":?:${exists(${d:R}):?$d:}}}@}
 607 __unqual_depdirs := ${__depdirs:${__qual_depdirs:Uno:${M_ListToSkip}}}
 608
 609 .if ${DEP_RELDIR} == ${_DEP_RELDIR}
 610 # if it was called out - we likely need it.
 611 __hostdpadd := ${DPADD:U.:M${HOST_OBJTOP}/*:S,${HOST_OBJTOP}/,,:H:${NSkipDir}:${DIRDEPS_FILTER:ts:}:S,$,.host,:N.*:@d@${SRCTOP}/$d@} \
 612         ${DPADD:U.:M${HOST_OBJTOP32:Uno}/*:S,${HOST_OBJTOP32:Uno}/,,:H:${NSkipDir}:${DIRDEPS_FILTER:ts:}:S,$,.host32,:N.*:@d@${SRCTOP}/$d@}
 613 __qual_depdirs += ${__hostdpadd}
 614 .endif
 615
 616 .if ${_debug_reldir}
 617 .info depdirs=${__depdirs}
 618 .info qualified=${__qual_depdirs}
 619 .info unqualified=${__unqual_depdirs}
 620 .endif
 621
 622 # _build_dirs is what we will feed to _DIRDEP_USE
 623 _build_dirs += \
 624         ${__qual_depdirs:M*.host:${NSkipHostDir}:N.host} \
 625         ${__qual_depdirs:N*.host} \
 626         ${_machines:Mhost*:@m@${__unqual_depdirs:@d@$d.$m@}@:${NSkipHostDir}:N.host} \
 627         ${_machines:Nhost*:@m@${__unqual_depdirs:@d@$d.$m@}@}
 628
 629 # qualify everything now
 630 _build_dirs := ${_build_dirs:${M_dep_qual_fixes:ts:}:O:u}
 631
 632 .endif                          # empty DIRDEPS
 633
 634 _build_all_dirs += ${_build_dirs}
 635 _build_all_dirs := ${_build_all_dirs:O:u}
 636
 637 # Normally if doing make -V something,
 638 # we do not want to waste time chasing DIRDEPS
 639 # but if we want to count the number of Makefile.depend* read, we do.
 640 .if ${.MAKEFLAGS:M-V${_V_READ_DIRDEPS}} == ""
 641 .if !empty(_build_all_dirs)
 642 .if ${BUILD_DIRDEPS_CACHE} == "yes"
 643 x!= { echo; echo '\# ${DEP_RELDIR}.${DEP_TARGET_SPEC}'; \
 644         echo 'dirdeps: ${_build_all_dirs:${M_oneperline}}'; echo; } >&3; echo
 645 x!= { ${_build_all_dirs:@x@${target($x):?:echo '$x: _DIRDEP_USE';}@} echo; } >&3; echo
 646 .if !empty(DEP_EXPORT_VARS)
 647 # Discouraged, but there are always exceptions.
 648 # Handle it here rather than explain how.
 649 x!= { echo; ${DEP_EXPORT_VARS:@v@echo '$v=${$v}';@} echo '.export ${DEP_EXPORT_VARS}'; echo; } >&3; echo
 650 .endif
 651 .else
 652 # this makes it all happen
 653 dirdeps: ${_build_all_dirs}
 654 .endif
 655 ${_build_all_dirs}:     _DIRDEP_USE
 656
 657 .if ${_debug_reldir}
 658 .info ${DEP_RELDIR}.${DEP_TARGET_SPEC}: needs: ${_build_dirs}
 659 .endif
 660
 661 .if !empty(DEP_EXPORT_VARS)
 662 .export ${DEP_EXPORT_VARS}
 663 DEP_EXPORT_VARS=
 664 .endif
 665
 666 # this builds the dependency graph
 667 .for m in ${_machines}
 668 # it would be nice to do :N${.TARGET}
 669 .if !empty(__qual_depdirs)
 670 .for q in ${__qual_depdirs:${M_dep_qual_fixes:ts:}:E:O:u:N$m}
 671 .if ${_debug_reldir} || ${DEBUG_DIRDEPS:@x@${${DEP_RELDIR}.$m:L:M$x}${${DEP_RELDIR}.$q:L:M$x}@} != ""
 672 .info ${DEP_RELDIR}.$m: graph: ${_build_dirs:M*.$q}
 673 .endif
 674 .if ${BUILD_DIRDEPS_CACHE} == "yes"
 675 x!= { echo; echo '${_this_dir}.$m: ${_build_dirs:M*.$q:${M_oneperline}}'; echo; } >&3; echo
 676 .else
 677 ${_this_dir}.$m: ${_build_dirs:M*.$q}
 678 .endif
 679 .endfor
 680 .endif
 681 .if ${_debug_reldir}
 682 .info ${DEP_RELDIR}.$m: graph: ${_build_dirs:M*.$m:N${_this_dir}.$m}
 683 .endif
 684 .if ${BUILD_DIRDEPS_CACHE} == "yes"
 685 x!= { echo; echo '${_this_dir}.$m: ${_build_dirs:M*.$m:N${_this_dir}.$m:${M_oneperline}}'; echo; } >&3; echo
 686 .else
 687 ${_this_dir}.$m: ${_build_dirs:M*.$m:N${_this_dir}.$m}
 688 .endif
 689 .endfor
 690
 691 .endif
 692
 693 # Now find more dependencies - and recurse.
 694 .for d in ${_build_all_dirs}
 695 .if !target(_dirdeps_checked.$d)
 696 # once only
 697 _dirdeps_checked.$d:
 698 .if ${_debug_search}
 699 .info checking $d
 700 .endif
 701 # Note: _build_all_dirs is fully qualifed so d:R is always the directory
 702 .if exists(${d:R})
 703 # we pass _DEP_TARGET_SPEC to tell the next step what we want
 704 _DEP_TARGET_SPEC := ${d:E}
 705 # some makefiles may still look at this
 706 _DEP_MACHINE := ${d:E:C/,.*//}
 707 # set these too in case Makefile.depend* uses them
 708 .if ${TARGET_SPEC_VARS:[#]} > 1
 709 _dtspec := ${_DEP_TARGET_SPEC:S/,/ /g}
 710 .for i in ${_tspec_x}
 711 DEP_${TARGET_SPEC_VARS:[$i]} := ${_dtspec:[$i]}
 712 .endfor
 713 .else
 714 DEP_MACHINE := ${_DEP_MACHINE}
 715 .endif
 716 # Warning: there is an assumption here that MACHINE is always
 717 # the first entry in TARGET_SPEC_VARS.
 718 # If TARGET_SPEC and MACHINE are insufficient, you have a problem.
 719 _m := ${.MAKE.DEPENDFILE_PREFERENCE:T:S;${TARGET_SPEC}$;${d:E};:S;${MACHINE};${d:E:C/,.*//};:@m@${exists(${d:R}/$m):?${d:R}/$m:}@:[1]}
 720 .if !empty(_m)
 721 # M_dep_qual_fixes isn't geared to Makefile.depend
 722 _qm := ${_m:C;(\.depend)$;\1.${d:E};:${M_dep_qual_fixes:ts:}}
 723 .if ${_debug_search}
 724 .info Looking for ${_qm}
 725 .endif
 726 # set this "just in case"
 727 # we can skip :tA since we computed the path above
 728 DEP_RELDIR := ${_m:H:S,${SRCTOP}/,,}
 729 # and reset this
 730 DIRDEPS =
 731 .if ${_debug_reldir} && ${_qm} != ${_m}
 732 .info loading ${_m} for ${d:E}
 733 .endif
 734 .include <${_m}>
 735 .else
 736 .-include <local.dirdeps-missing.mk>
 737 .endif
 738 .endif
 739 .endif
 740 .endfor
 741
 742 .endif                          # -V
 743 .endif                          # BUILD_DIRDEPS
 744
 745 .elif ${.MAKE.LEVEL} > 42
 746 .error You should have stopped recursing by now.
 747 .else
 748 # we are building something
 749 DEP_RELDIR := ${RELDIR}
 750 _DEP_RELDIR := ${RELDIR}
 751 # Since we are/should be included by .MAKE.DEPENDFILE
 752 # This is a final opportunity to add/hook global rules.
 753 .-include <local.dirdeps-build.mk>
 754
 755 # pickup local dependencies
 756 .if ${MAKE_VERSION} < 20160220
 757 .-include <.depend>
 758 .else
 759 .dinclude <.depend>
 760 .endif
 761 .endif
 762
 763 # bootstrapping new dependencies made easy?
 764 .if !target(bootstrap) && (make(bootstrap) || \
 765         make(bootstrap-this) || \
 766         make(bootstrap-recurse) || \
 767         make(bootstrap-empty))
 768
 769 # if we are bootstrapping create the default
 770 _want = ${.CURDIR}/${.MAKE.DEPENDFILE_DEFAULT:T}
 771
 772 .if exists(${_want})
 773 # stop here
 774 ${.TARGETS:Mboot*}:
 775 .elif !make(bootstrap-empty)
 776 # find a Makefile.depend to use as _src
 777 _src != cd ${.CURDIR} && for m in ${.MAKE.DEPENDFILE_PREFERENCE:T:S,${MACHINE},*,}; do test -s $$m || continue; echo $$m; break; done; echo
 778 .if empty(_src)
 779 .error cannot find any of ${.MAKE.DEPENDFILE_PREFERENCE:T}${.newline}Use: bootstrap-empty
 780 .endif
 781
 782 _src?= ${.MAKE.DEPENDFILE}
 783
 784 .MAKE.DEPENDFILE_BOOTSTRAP_SED+= -e 's/${_src:E:C/,.*//}/${MACHINE}/g'
 785
 786 # just create Makefile.depend* for this dir
 787 bootstrap-this: .NOTMAIN
 788         @echo Bootstrapping ${RELDIR}/${_want:T} from ${_src:T}; \
 789         echo You need to build ${RELDIR} to correctly populate it.
 790 .if ${_src:T} != ${.MAKE.DEPENDFILE_PREFIX:T}
 791         (cd ${.CURDIR} && sed ${.MAKE.DEPENDFILE_BOOTSTRAP_SED} ${_src} > ${_want:T})
 792 .else
 793         cp ${.CURDIR}/${_src:T} ${_want}
 794 .endif
 795
 796 # create Makefile.depend* for this dir and its dependencies
 797 bootstrap: bootstrap-recurse
 798 bootstrap-recurse: bootstrap-this
 799
 800 _mf := ${.PARSEFILE}
 801 bootstrap-recurse:      .NOTMAIN .MAKE
 802         @cd ${SRCTOP} && \
 803         for d in `cd ${RELDIR} && ${.MAKE} -B -f ${"${.MAKEFLAGS:M-n}":?${_src}:${.MAKE.DEPENDFILE:T}} -V DIRDEPS`; do \
 804                 test -d $$d || d=$${d%.*}; \
 805                 test -d $$d || continue; \
 806                 echo "Checking $$d for bootstrap ..."; \
 807                 (cd $$d && ${.MAKE} -f ${_mf} bootstrap-recurse); \
 808         done
 809
 810 .endif
 811
 812 # create an empty Makefile.depend* to get the ball rolling.
 813 bootstrap-empty: .NOTMAIN .NOMETA
 814         @echo Creating empty ${RELDIR}/${_want:T}; \
 815         echo You need to build ${RELDIR} to correctly populate it.
 816         @{ echo DIRDEPS=; echo ".include <dirdeps.mk>"; } > ${_want}
 817
 818 .endif