Makefile

   1 #
   2 # Thierry Parmentelat - INRIA Sophia Antipolis
   3 #
   4 ####################
   5 # invocation:
   6 #
   7 # (*) make stage1=true
   8 #     this extracts all specfiles and computes .mk from specfiles
   9 #     you need to specify PLDISTRO here if relevant - see below
  10 # (*) make help
  11 #     for more info on how to invoke this stuff
  12 #
  13 #################### (fedora) distributions
  14 #
  15 # (*) as of nov. 2007, myplc-devel is deprecated
  16 # (*) instead, we create a fresh vserver that holds required tools (see e.g. planetlab-devel.lst)
  17 # (*) the build uses the current fedora version as a target for the produced images
  18 # (*) so you simply need to create a fedora 8 build image for building fedora-8 images
  19 #
  20 #################### (planetlab) distributions
  21 #
  22 # (*) see README-pldistros.txt
  23 # (*) then you need to run
  24 #     make stage1=true PLDISTRO=onelab
  25 #
  26 ####################
  27 # This build deals with 3 kinds of objects
  28 #
  29 # (*) packages are named upon the RPM name; they are mostly lowercase
  30 #     Add a package to ALL if you want it built as part of the default set.
  31 # (*) modules are named after the subversion or git tree; we would wish to keep
  32 #     these names lowercase as far as possible
  33 # (*) rpms are named in the spec files. A package typically defines several rpms;
  34 #     rpms are used for defining LOCAL-DEVEL-RPMS. See also package.rpmnames
  35 #
  36 # in simple cases, one package uses one module (in which case using the same name sounds right)
  37 # but others might need several modules (e.g. image-creation packages like bootstrapfs need
  38 # bootstrapfs and build); in this case the FIRST ONE is used for locating the specfile
  39 #
  40 #################### packages
  41 # basics: how to build a package - you need to define the following variables
  42 #
  43 # (*) package-MODULES
  44 #     a package needs one or several modules to build; the first one is used for
  45 #     some special purposes, like locating the specfile
  46 # (*) package-SPEC
  47 #     the package's specfile; this is relative to the FIRST module in package-MODULES
  48 #
  49 # Optional:
  50 #
  51 # (*) package-DEPEND-PACKAGES
  52 #     a set of (obviously local) *packages* that this package depends on, e.g.
  53 #     bootstrapfs-DEPEND-PACKAGES += kernel
  54 #     this impacts the order of the build
  55 # (*) package-STOCK-DEVEL-RPMS
  56 #     a set of stock rpms that this package needs at build-time
  57 #     this can also be set in config.<distro>/devel.pkgs or config.planetlab/devel.pkgs as appropriate
  58 # (*) package-LOCAL-DEVEL-RPMS
  59 #     a set of *local* rpms that the build will rpm-install before building <package>
  60 #     the build will attempt to uninstall those once the package is built, this is not fatal though
  61 #     this is intended to denote local rpms, i.e. ones that are results of our own build
  62 #     stock rpms should be mentioned in STOCK-DEVEL-RPMS or in devel.pkgs as described above
  63 # (*) package-LOCAL-DEVEL-RPMS-CRUCIAL
  64 #     like package-LOCAL-DEVEL-RPMS but for crucial packages (like autoconf) that only need an update from our build
  65 #     rpms in this area will *not* be uninstalled after the target is made, because that would ruin the build vm for good
  66 # (*) package-DEPEND-FILES
  67 #     a set of files that the package depends on - and that make needs to know about
  68 #     if this contains RPMS/yumgroups.xml, then the toplevel RPMS's index
  69 #     is refreshed with createrepo prior to running rpmbuild
  70 # (*) package-SPECVARS
  71 #     space-separated list of spec variable definitions, where you can reference make variables that
  72 #     belong to packages defined BEFORE the current one
  73 #     note: you should use = to define these (as opposed to :=)
  74 #     e.g. mydriver-SPECVARS = foo=$(kernel-rpm-release)
  75 #     would let you use the %release from the kernel's package when rpmbuild'ing mydriver
  76 #     see automatic below
  77 # (*) package-RPMFLAGS: Miscellaneous RPM flags
  78 #     this is passed to rpmbuild, as well as to spec2make for "exporting" various rpm variable
  79 #     to make; beware that some features, like --with=debug or --define 'foo bar' are not
  80 #     well handled by spec2make as of this writing, which can cause issues.
  81 #     hopefully this will be fixed...
  82 # (*) package-BUILD-FROM-SRPM: set this to any non-empty value,
  83 #     if your package is able to produce a source rpm.
  84 #     In this case the build will first invoke 'make srpm', and then rebuild binaries from that
  85 # (*) package-RPMDATE: set this to any non-empty value to get the rpm package's release field hold the current date
  86 #     this is useful for container packages, like e.g. bootstrapfs or vserver, that contains much more than the
  87 #     correspondng module
  88 #
  89 #################### modules
  90 # Required information about the various modules (set this in e.g. planetlab-tags.mk)
  91 #
  92 # (*) module-SVNPATH
  93 #     for svn modules
  94 #     the complete path where this module lies;
  95 #     you can specify the trunk or a given tag with this variable
  96 #
  97 # (*) module-GITPATH
  98 #     for git modules
  99 #     which by analogy with svn revision scheme, is expected to be <url>@<tag>
 100 #
 101 #################### automatic variables
 102 #
 103 # the build defines some make variables that are extracted from spec files
 104 # to inspect those, see for example
 105 # (*)  $ make ulogd-pkginfo
 106 #        to see the list f variables attached to a given package
 107 # (*)  $ make kernel-devel-rpminfo
 108 #        to see the list of variables attached to a given rpm
 109 #
 110 ####################
 111
 112 # exported to spec files as plrelease
 113 PLANETLAB_RELEASE = 5.2
 114
 115 #
 116 # Default values
 117 #
 118 # minimal compat with macos, just so this does not complain
 119 HOSTARCH := $(shell uname -i 2> /dev/null || uname -m 2> /dev/null)
 120 DISTRO := $(shell ./getdistro.sh)
 121 RELEASE := $(shell ./getrelease.sh)
 122 DISTRONAME := $(shell ./getdistroname.sh)
 123
 124 #################### Makefile
 125 # Default target
 126 all:
 127 .PHONY:all
 128
 129 ### default values
 130 PLDISTRO := planetlab
 131 RPMBUILD := rpmbuild
 132
 133 ########## envfrompreviousrun.mk holds PLDISTRO and others - it is generated at stage1 (see below)
 134 ifeq "$(stage1)" ""
 135 include envfrompreviousrun.mk
 136 endif
 137
 138 # when re-running the nightly build after failure, we need to gather the former values
 139 # do this by running make stage1=skip +PLDISTRO
 140 ifeq "$(stage1)" "skip"
 141 include envfrompreviousrun.mk
 142 endif
 143
 144 #################### include onelab.mk
 145 # describes the set of components
 146 PLDISTROCONTENTS := $(PLDISTRO).mk
 147 include $(PLDISTROCONTENTS)
 148
 149 #################### include <pldistro>-tags.mk
 150 # describes where to fetch components
 151 ifeq "$(PLDISTROTAGS)" ""
 152 PLDISTROTAGS := $(PLDISTRO)-tags.mk
 153 endif
 154 include $(PLDISTROTAGS)
 155
 156 # this used to be set in the -tags.mk files, but that turned out to require
 157 # error-prone duplicate changes
 158 # so now the nightly build script sets this to what it is currently using
 159 # in case we run this manually, i.e. if build-GITPATH is not set
 160 ifeq "$(build-GITPATH)" ""
 161 build-GITPATH := $(shell git config remote.origin.url)
 162 endif
 163
 164 #################### pldistros that are defined remotely
 165 # fetching with svn
 166 define remote_pldistro_fetch_svn
 167 $(1).config.SVNPATH := $(shell grep -v "^#" config.$(1).svnpath)
 168 config.$(1): config.$(1).svnpath
 169         @echo "Fetching (svn) details for remote pldistro $(1)"
 170         svn export $$($(1).config.SVNPATH) config.$(1)
 171 endef
 172
 173 # fetching with git
 174 define remote_pldistro_fetch_git
 175 $(1).config.GITPATH := $(shell grep -v "^#" config.$(1).gitpath)
 176 $(1).config.gitrepo := $$(firstword $$(subst @, ,$$($(1).config.GITPATH)))
 177 $(1).config.gittag := $$(word 2,$$(subst @, ,$$($(1).config.GITPATH)))
 178 $(1).config.gittag := $$(if $$($(1).config.gittag),$$($(1).config.gittag),master)
 179 config.$(1): GITPATH=$(shell grep -v "^#" config.$(1).gitpath)
 180 config.$(1): config.$(1).gitpath
 181         @echo "Fetching (git) details for remote pldistro $(1)"
 182         mkdir -p config.$(1)
 183         git $(GITTAG) archive --remote=$$($(1).config.gitrepo) $$($(1).config.gittag) | tar -C config.$(1) -xf -
 184 endef
 185
 186
 187 # put it together
 188 define remote_pldistro
 189 $(1).mk: config.$(1)/$(1).mk
 190         @echo 'creating $(1) from config.$(1)'
 191         cp config.$(1)/$(1).mk $(1).mk
 192
 193 $(2).mk: config.$(1)/$(2).mk
 194         @echo 'creating $(2) tags from config.$(1)'
 195         cp config.$(1)/$(2).mk $(2).mk
 196
 197 config.$(1)/$(1).mk: config.$(1)
 198 config.$(1)/$(2).mk: config.$(1)
 199
 200 DISTCLEANS += $(1).mk $(2).mk config.$(1)
 201 $(eval $(call remote_pldistro_fetch_$(3),$(1)))
 202 endef
 203
 204 ########## stage1 and stage1iter
 205 # extract specs and compute .mk files by running
 206 # make stage1=true
 207 # entering stage1, we compute all the spec files
 208 # then we use stage1iter to compute the .mk iteratively,
 209 # ensuring that the n-1 first makefiles are loaded when creating the n-th one
 210 # when stage1iter is set, it is supposed to be an index (starting at 1) in $(ALL)
 211
 212 ALLMKS := $(foreach package, $(ALL), MAKE/$(package).mk)
 213
 214 ### stage1iter : need some arithmetic, see
 215 # http://www.cmcrossroads.com/articles/ask-mr.-make/learning-gnu-make-functions-with-arithmetic.html
 216 ifneq "$(stage1iter)" ""
 217 # the first n packages
 218 packages := $(wordlist 1,$(words $(stage1iter)),$(ALL))
 219 # the n-th package
 220 package := $(word $(words $(packages)),$(packages))
 221 # the n-1 first packages
 222 stage1iter_1 := $(wordlist 2,$(words $(stage1iter)),$(stage1iter))
 223 previous := $(wordlist 1,$(words $(stage1iter_1)),$(ALL))
 224 previousmks := $(foreach package,$(previous),MAKE/$(package).mk)
 225 include $(previousmks)
 226 all: verbose
 227 verbose:
 228         @echo "========== stage1iter : $(package)"
 229 #       @echo "stage1iter : included .mk files : $(previousmks)"
 230 all: $($(package).specpath)
 231 all: MAKE/$(package).mk
 232 else
 233 ### stage1
 234 ifneq "$(stage1)" ""
 235 all : verbose
 236 verbose :
 237         @echo "========== stage1"
 238 all : spec2make
 239 all : .rpmmacros
 240 # specs and makes are done sequentially by stage1iter
 241 all : stage1iter
 242 stage1iter:
 243         arg=""; for n in $(ALL) ; do arg="$$arg x"; $(MAKE) --no-print-directory stage1iter="$$arg"; done
 244 ### regular make
 245 else
 246 ### once .mks are OK, you can run make normally
 247 include $(ALLMKS)
 248 #all : tarballs
 249 #all : sources
 250 #all : modules
 251 #all : rpms
 252 #all : srpms
 253 # mention $(ALL) here rather than rpms
 254 # this is because the inter-package dependencies are expressed like
 255 # util-vserver: util-python
 256 all: rpms
 257 all: repo
 258 endif
 259 endif
 260
 261 ### yumgroups.xml : compute from all known .pkgs files
 262 RPMS/yumgroups.xml:
 263         mkdir -p RPMS
 264         ./yumgroups.sh $(PLDISTRO) > $@
 265
 266 createrepo = createrepo --quiet -g yumgroups.xml RPMS/
 267
 268 repo: RPMS/yumgroups.xml
 269         $(createrepo)
 270
 271 .PHONY: repo
 272
 273 ####################
 274 # notes:
 275 # * we always use the first module's location (SVNPATH/GITPATH) to extract the spec file
 276 # * no matter what SCM is used, SPEC should hold a relative path from the module's root
 277 #
 278 define stage1_package_vars
 279 $(1).module := $(firstword $($(1)-MODULES))
 280 $(1).specpath := SPECS/$(notdir $($(1)-SPEC))
 281 $(1).moduledir := MODULES/$$($(1).module)
 282 $(1).codespec := MODULES/$$($(1).module)/$($(1)-SPEC)
 283 $(1).spec2makeflags := $(if $($(1)-WHITELIST-RPMS),--whitelist-rpms $($(1)-WHITELIST-RPMS),)
 284 endef
 285
 286 $(foreach package, $(ALL), $(eval $(call stage1_package_vars,$(package))))
 287
 288 # compute all modules
 289 ALL.modules := build tests
 290 $(foreach package,$(ALL), $(eval ALL.modules+=$($(package)-MODULES)))
 291 ALL.modules:=$(sort $(ALL.modules))
 292
 293 # extract revision from -SVNPATH or tag from -GITPATH
 294 define stage1_module_vars
 295 ifneq "$($(1)-SVNPATH)" ""
 296 $(1)-SVNPATH := $(strip $($(1)-SVNPATH))
 297 $(1)-SCMPATH := $(strip $($(1)-SVNPATH))
 298 else
 299 $(1)-GITPATH := $$(strip $$($(1)-GITPATH))
 300 $(1)-SCMPATH := $$(strip $$($(1)-GITPATH))
 301 $(1).gitrepo := $$(firstword $$(subst @, ,$$($(1)-GITPATH)))
 302 $(1).gittag := $$(word 2,$$(subst @, ,$$($(1)-GITPATH)))
 303 $(1).gittag := $$(if $$($(1).gittag),$$($(1).gittag),master)
 304 endif
 305 endef
 306
 307 $(foreach module,$(ALL.modules), $(eval $(call stage1_module_vars,$(module))))
 308
 309 #
 310 # for each package, compute whether we need to set date
 311 # the heuristic is that we mention the date as part of the rpm release flag if
 312 # (*) the package has requested it by setting package-RPMDATE (container packages should do that)
 313 # (*) or SVNPATH contains 'trunk' or 'branches'
 314 # (*) or GITPATH has no '@' (trunk)
 315 # (*) or GITPATH contains a '@', and the gittag part has no '-' (this is to tell a tag from a branch..)
 316 #
 317 define package_hasdate
 318 $(1).has-date = $(if $($(1)-RPMDATE),yes, \
 319                   $(if $($($(1).module)-SVNPATH), \
 320                      $(if $(findstring /trunk,$($($(1).module)-SVNPATH)),yes, \
 321                         $(if $(findstring /branches,$($($(1).module)-SVNPATH)),yes,)), \
 322                      $(if $(not $($($(1).module).gittag)), yes,\
 323                         $(if $(findstring -,$($($(1).module).gittag)),,yes))))
 324 endef
 325
 326 $(foreach package, $(ALL), $(eval $(call package_hasdate,$(package))))
 327
 328 ### the common header for generated specfiles
 329 # useful when trying new specfiles manually
 330 ###
 331 # note for fedora23 (and onwards, probably)
 332 # many rpms wouldn't build as-is and issue an weird error
 333 ##
 334 # Processing files: pl_sshd-debuginfo-1.0-11.lxc.x86_64
 335 # error: Empty %files file /longbuildroot/BUILD/pl_sshd-1.0/debugfiles.list
 336 ##
 337 # so to work around that we define debug_package as being nil
 338 # only for f23 for now, let's see what this gives us..
 339 header.spec:
 340         (echo -n "# Generated by planetlab build on " ; date) > $@
 341         echo "%define distro $(DISTRO)" >> $@
 342         echo "%define distrorelease $(RELEASE)" >> $@
 343         echo "%define distroname $(DISTRONAME)" >> $@
 344         echo "%define pldistro $(PLDISTRO)" >> $@
 345         echo "%define plrelease $(PLANETLAB_RELEASE)" >> $@
 346         echo "# use MD5 and gzip for binary and source files" >> $@
 347         echo "%global _binary_filedigest_algorithm 1" >> $@
 348         echo "%global _source_filedigest_algorithm 1" >> $@
 349         echo "%global _source_payload       w9.gzdio" >> $@
 350         echo "%global _binary_payload       w9.gzdio" >> $@
 351 ifeq "$(DISTRONAME)""$(filter $(DISTRONAME),f25 f27 f29 f31 f33)"
 352         echo "%define debug_package %{nil}" >> $@
 353 endif
 354
 355 ### make up spec file - extract module first
 356 define target_spec
 357 $($(1).specpath): header.spec $($(1).codespec)
 358         mkdir -p SPECS
 359         cat header.spec > $($(1).specpath)
 360         echo "%define SCMURL $($($(1).module)-SCMPATH)" >> $($(1).specpath)
 361         $(if $($(1).has-date),echo "%define date $(shell date +%Y.%m.%d)" >> $($(1).specpath),)
 362         $(if $($(1)-SPECVARS), \
 363           $(foreach line,$($(1)-SPECVARS), \
 364             echo "%define" $(word 1,$(subst =, ,$(line))) "$(word 2,$(subst =, ,$(line)))" >> $($(1).specpath) ;))
 365         echo "# included from $($(1)-SPEC)" >> $($(1).specpath)
 366         cat $($(1).codespec) >> $($(1).specpath)
 367
 368 $($(1).codespec): $($(1).moduledir)
 369
 370 endef
 371
 372 $(foreach package,$(ALL),$(eval $(call target_spec,$(package))))
 373
 374 ####################
 375 # fetch modules
 376 # expected input:
 377 #   $(1) is the name of a git module
 378 #     $($(1).gitrepo) and $(($1).gittag) are used to determine branch or tag name
 379 # expected result
 380 #   $(1)/ in the cwd will hold the result
 381
 382 # fetch svn module
 383 define fetch_svn_module
 384         svn export $($(1)-SVNPATH) $(1)
 385 endef
 386
 387 # git_fetch_module
 388 # as far as possible we use git-archive to fetch a git module
 389 # however if that fails we fallback to a git-clone strategy,
 390 # for when git-archive is not supported, e.g. for github
 391 # side effect
 392 #   $(1)/ gets cleaned up if job cannot be done
 393 define fetch_git_module
 394         mkdir $(1) ; \
 395         (git archive --remote=$($(1).gitrepo) $($(1).gittag) | tar -C $(1) -xf - ) || \
 396         (echo "==================== git archive FAILED, trying git clone instead" ; \
 397          git clone $($(1).gitrepo) $(1); cd $(1) ; git checkout $($(1).gittag) ; rm -rf .git ) || \
 398         { rm -rf $(1); false; }
 399 endef
 400
 401 ### module extraction
 402 define target_extract_module
 403 MODULES/$(1):
 404         @(echo -n "XXXXXXXXXXXXXXX -- BEG MODULE $(1) : $@ " ; date)
 405         mkdir -p MODULES
 406         cd MODULES && \
 407         $(if $($(1)-SVNPATH),$(call fetch_svn_module,$(1)),$(call fetch_git_module,$(1)) )
 408         @(echo -n "XXXXXXXXXXXXXXX -- END MODULE $(1) : $@ " ; date)
 409
 410 $(1)-module: MODULES/$(1)
 411 .PHONY: $(1)-module
 412 endef
 413
 414 $(foreach module,$(ALL.modules),$(eval $(call target_extract_module,$(module))))
 415
 416 ### the tests area
 417 build-clean:
 418         rm -rf MODULES/build
 419 .PHONY: build-clean
 420
 421 tests-clean:
 422         rm -rf MODULES/tests
 423 .PHONY: tests-clean
 424
 425 ###
 426 # Base rpmbuild in the current directory
 427 # issues on fedora 8 : see the following posts
 428 # http://forums.fedoraforum.org/showthread.php?t=39625 - and more specifically post#6
 429 # https://www.redhat.com/archives/fedora-devel-list/2007-November/msg00171.html
 430 REALROOT=/build
 431 FAKEROOT=/longbuildroot
 432 PWD=$(shell /bin/pwd)
 433 ifeq "$(PWD)" "$(REALROOT)"
 434 export HOME := $(FAKEROOT)
 435 else
 436 export HOME := $(PWD)
 437 endif
 438
 439 # rpm macros
 440 # build.common (getrpmmacros.sh) defines some utilities we want in place on our images
 441 # in addition to these we set a few others for the build
 442 .rpmmacros:
 443 ifeq "$(shell pwd)" "/build"
 444         rm -f $(FAKEROOT) ; ln -s $(REALROOT) $(FAKEROOT)
 445 endif
 446         rm -f $@
 447         echo "%_topdir $(HOME)" >> $@
 448         echo "%_tmppath $(HOME)/tmp" >> $@
 449         echo "%__spec_install_pre %{___build_pre}" >> $@
 450         ./getrpmmacros.sh >> $@
 451
 452 ### this utility allows to extract various info from a spec file
 453 ### and to define them in makefiles
 454 # use the C code where it works as it's the original one, use the python code otherwise
 455 spec2make: spec2make.c
 456         $(CC) -g -Wall $< -o $@ -lrpm -lrpmbuild -lrpmio -lpopt || ln -s spec2make.py $@
 457
 458 ### run spec2make on the spec file and include the result
 459 # usage: spec2make package
 460 # with old rpms (f8&c5) and too recent specfiles (the kernel), we need a patch to spec2make
 461 # so when <package-NEEDSPECK2MAKEHACK is set, we run spec2make with the --hack flag
 462 define target_mk
 463 MAKE/$(1).mk: $($(1).specpath) spec2make .rpmmacros
 464         mkdir -p MAKE
 465         ./spec2make $($(1).spec2makeflags) $($(1)-RPMFLAGS) $($(1).specpath) $(1) > MAKE/$(1).mk || { rm MAKE/$(1).mk; exit 1; }
 466 endef
 467
 468 $(foreach package,$(ALL),$(eval $(call target_mk,$(package))))
 469
 470 # stores env variables in a file
 471 # this is done at stage1. later run won't get confused
 472 STATIC_VARS=PLDISTRO PLDISTROTAGS build-GITPATH PERSONALITY MAILTO BASE WEBPATH TESTBUILDURL WEBROOT
 473 # find out names for variables set on the command line
 474 define assigned_varname
 475 $(if $(findstring =,$(1)),$(firstword $(subst =, ,$(1))) )
 476 endef
 477 ASSIGNED=$(filter-out stage1 stage1iter,$(foreach flag,$(MAKEFLAGS),$(call assigned_varname,$(flag))))
 478 SAVED_VARS=$(sort $(STATIC_VARS) $(ASSIGNED))
 479 envfrompreviousrun.mk:
 480         @echo "# do not edit" > $@
 481         @$(foreach var,$(SAVED_VARS),echo "$(var):=$($(var))" >> $@ ;)
 482         @echo "# do not edit" > aliases
 483         @echo -n "alias m=\"make " >> aliases
 484         @$(foreach var,$(SAVED_VARS),echo -n " $(var)=$($(var))" >> aliases ;)
 485         @echo "\"" >> aliases
 486         @echo "alias m1=\"m stage1=true\"" >> aliases
 487
 488 envfrompreviousrun: envfrompreviousrun.mk
 489 .PHONY: envfrompreviousrun
 490
 491 # always refresh this
 492 all: envfrompreviousrun
 493
 494 #################### regular make
 495
 496 define stage2_variables
 497 ### devel dependencies
 498 $(1).rpmbuild = $(RPMBUILD) $($(1)-RPMFLAGS)
 499 $(1).all-local-devel-rpm-paths := $(foreach rpm,$($(1)-LOCAL-DEVEL-RPMS) $($(1)-LOCAL-DEVEL-RPMS-CRUCIAL),$($(rpm).rpm-path))
 500 $(1).depend-devel-packages := $(sort $(foreach rpm,$($(1)-LOCAL-DEVEL-RPMS),$($(rpm).package)))
 501 ALL-STOCK-DEVEL-RPMS += $($(1)-LOCAL-DEVEL-RPMS)
 502 endef
 503
 504 $(foreach package,$(ALL),$(eval $(call stage2_variables,$(package))))
 505 ALL-STOCK-DEVEL-RPMS := $(sort $(ALL-STOCK-DEVEL-RPMS))
 506
 507
 508 ### pack sources into tarballs
 509 ALLTARBALLS:= $(foreach package, $(ALL), $($(package).tarballs))
 510 tarballs: $(ALLTARBALLS)
 511         @echo $(words $(ALLTARBALLS)) source tarballs OK
 512 .PHONY: tarballs
 513
 514 SOURCES/%.tar.bz2: SOURCES/%
 515         tar chpjf $@ -C SOURCES $*
 516
 517 SOURCES/%.tar.gz: SOURCES/%
 518         tar chpzf $@ -C SOURCES $*
 519
 520 SOURCES/%.tgz: SOURCES/%
 521         tar chpzf $@ -C SOURCES $*
 522
 523 ##
 524 URLS/%: url=$(subst @colon@,:,$(subst @slash@,/,$(notdir $@)))
 525 URLS/%: basename=$(notdir $(url))
 526 URLS/%:
 527         echo curl $(url) -o SOURCES/$(basename)
 528         touch $@
 529
 530 ### the directory SOURCES/<package>-<version> is made
 531 # with a (set of) copy -rl from MODULES/<module>
 532 # the former is $(package.source)
 533 ALLSOURCES:=$(foreach package, $(ALL), $($(package).source))
 534 # so that make does not use the rule below directly for creating the tarball files
 535 .SECONDARY: $(ALLSOURCES)
 536
 537 sources: $(ALLSOURCES)
 538         @echo $(words $(ALLSOURCES)) versioned source trees OK
 539 .PHONY: sources
 540
 541 # argument is a package
 542 # do things differently if multiple modules are mentioned (sigh..)
 543 define target_copy_link_modules_sources
 544 $($(1).source): $(foreach module,$($(1)-MODULES),MODULES/$(module))
 545         $(if $(word 2,$($(1)-MODULES)),\
 546          mkdir -p $($(1).source) && $(foreach module,$($(1)-MODULES), cp -rl MODULES/$(module) $($(1).source)/$(module);) ,\
 547          mkdir -p SOURCES && cp -rl MODULES/$($(1)-MODULES) $($(1).source))
 548 endef
 549
 550 $(foreach package,$(ALL),$(eval $(call target_copy_link_modules_sources,$(package))))
 551
 552 ### code extraction
 553 ALLMODULES:=$(foreach module, $(ALL.modules), MODULES/$(module))
 554 .SECONDARY: $(ALLMODULES)
 555 modules: $(ALLMODULES)
 556         @echo $(words $(ALLMODULES)) modules OK "(fetched from scm)"
 557 .PHONY: modules
 558
 559 ### source rpms
 560 ALLSRPMS:=$(foreach package,$(ALL),$($(package).srpm))
 561 srpms: $(ALLSRPMS)
 562         @echo $(words $(ALLSRPMS)) source rpms OK
 563 .PHONY: srpms
 564
 565 #################### manage build requirements
 566 # default values
 567 RPMYUM-INSTALL-LOCAL := rpm --force -Uvh
 568 RPMYUM-INSTALL-STOCK := yum -y install
 569 # uninstall -- cannot force rpm -e
 570 # need to ignore result, kernel-headers cannot be uninstalled as glibc depends on it
 571 RPMYUM-UNINSTALL-STOCK := rpm -e
 572
 573 ### these macro handles the LOCAL-DEVEL-RPMS and LOCAL-DEVEL-RPMS-CRUCIAL tags for a given package
 574 # before building : rpm-install LOCAL-DEVEL-RPMS
 575 define rpmyum_install_local_rpms
 576         $(if $($(1).all-local-devel-rpm-paths), echo "Installing for $(1)-LOCAL-DEVEL-RPMS" ; $(RPMYUM-INSTALL-LOCAL) $($(1).all-local-devel-rpm-paths))
 577 endef
 578
 579 # install stock rpms if defined
 580 define rpmyum_install_stock_rpms
 581         $(if $($(1)-STOCK-DEVEL-RPMS), echo "Installing for $(1)-STOCK-DEVEL-RPMS" ; $(RPMYUM-INSTALL-STOCK) $($(1)-STOCK-DEVEL-RPMS) || true)
 582 endef
 583
 584 define rpmyum_uninstall_stock_rpms
 585         -$(if $($(1)-STOCK-DEVEL-RPMS), echo "Unstalling for $(1)-STOCK-DEVEL-RPMS" ; $(RPMYUM-UNINSTALL-STOCK) $($(1)-STOCK-DEVEL-RPMS) || true)
 586 endef
 587
 588 # similar for debians
 589 # gdebi acts like yum localinstall; gdebi-core should be mentioned in develdeb.pkgs
 590 DPKGAPT-INSTALL-LOCAL := gdebi
 591 DPKGAPT-INSTALL-STOCK := apt-get -y install
 592 DPKGAPT-UNINSTALL-STOCK := echo WARNING uninstalling stock debs not implemented
 593
 594 define dpkgapt_install_local_debs
 595         $(if $($(1)-LOCAL-DEVEL-DEBS), echo "Installing for $(1)-LOCAL-DEVEL-DEBS" ; $(foreach debname,$($(1)-LOCAL-DEVEL-DEBS),$(DPKGAPT-INSTALL-LOCAL) $(wildcard DEBIAN/$(debname)_*.deb);))
 596 endef
 597
 598 define dpkgapt_install_stock_debs
 599         $(if $($(1)-STOCK-DEVEL-DEBS), echo "Installing for $(1)-STOCK-DEVEL-DEBS" ; $(DPKGAPT-INSTALL-STOCK) $($(1)-STOCK-DEVEL-DEBS) || true)
 600 endef
 601
 602 define dpkgapt_uninstall_stock_debs
 603         -$(if $($(1)-STOCK-DEVEL-DEBS), echo "Unstalling for $(1)-STOCK-DEVEL-DEBS" ; $(DPKGAPT-UNINSTALL-STOCK) $($(1)-STOCK-DEVEL-DEBS) || true)
 604 endef
 605
 606
 607 ####################
 608 # usage: target_source_rpm package
 609 define target_source_rpm
 610 ifeq "$($(1)-BUILD-FROM-SRPM)" ""
 611 $($(1).srpm): $($(1).specpath) .rpmmacros $($(1).tarballs)
 612         mkdir -p BUILD SRPMS tmp
 613         @(echo -n "XXXXXXXXXXXXXXX -- BEG SRPM $(1) (using SOURCES) " ; date)
 614         $(call rpmyum_install_stock_rpms,$(1))
 615         $(call rpmyum_install_local_rpms,$(1))
 616         $($(1).rpmbuild) -bs $($(1).specpath)
 617         $(call rpmyum_uninstall_stock_rpms,$(1))
 618         @(echo -n "XXXXXXXXXXXXXXX -- END SRPM $(1) " ; date)
 619 else
 620 $($(1).srpm): $($(1).specpath) .rpmmacros $($(1).source)
 621         mkdir -p BUILD SRPMS tmp
 622         @(echo -n "XXXXXXXXXXXXXXX -- BEG SRPM $(1) (using make srpm) " ; date)
 623         $(call rpmyum_install_stock_rpms,$(1))
 624         $(call rpmyum_install_local_rpms,$(1))
 625         make -C $($(1).source) srpm SPECFILE=$(HOME)/$($(1).specpath) EXPECTED_SRPM=$(notdir $($(1).srpm)) && \
 626            rm -f SRPMS/$(notdir $($(1).srpm)) && \
 627            ln $($(1).source)/$(notdir $($(1).srpm)) SRPMS/$(notdir $($(1).srpm))
 628         $(call rpmyum_uninstall_stock_rpms,$(1))
 629         @(echo -n "XXXXXXXXXXXXXXX -- END SRPM $(1) " ; date)
 630 endif
 631 endef
 632
 633 $(foreach package,$(ALL),$(eval $(call target_source_rpm,$(package))))
 634
 635 ### binary rpms are made from source rpm
 636 ALLRPMS:=$(foreach package,$(ALL),$($(package).rpms))
 637 # same as above, mention $(ALL) and not $(ALLRPMS)
 638 rpms: $(ALLRPMS)
 639         @echo $(words $(ALLRPMS)) binary rpms OK
 640 .PHONY: rpms
 641
 642 # use tmp dirs when building binary rpm so make remains idempotent
 643 # otherwise SOURCES/ or SPEC gets touched again - which leads to rebuilding
 644 RPM-USE-TMP-DIRS = --define "_sourcedir $(HOME)/tmp" --define "_specdir $(HOME)/tmp"
 645 RPM-USE-COMPILE-DIRS = --define "_sourcedir $(HOME)/COMPILE" --define "_specdir $(HOME)/COMPILE"
 646
 647 # usage: build_binary_rpm package
 648 # xxx hacky - invoke createrepo if DEPEND-FILES mentions RPMS/yumgroups.xml
 649 define target_binary_rpm
 650 $($(1).rpms): $($(1).srpm)
 651         mkdir -p RPMS tmp
 652         @(echo -n "XXXXXXXXXXXXXXX -- BEG RPM $(1) " ; date)
 653         $(if $(findstring RPMS/yumgroups.xml,$($(1)-DEPEND-FILES)), $(createrepo) , )
 654         $(call rpmyum_install_stock_rpms,$(1))
 655         $(call rpmyum_install_local_rpms,$(1))
 656         $($(1).rpmbuild) --rebuild $(RPM-USE-TMP-DIRS) $($(1).srpm)
 657         $(call rpmyum_uninstall_stock_rpms,$(1))
 658         @(echo -n "XXXXXXXXXXXXXXX -- END RPM $(1) " ; date)
 659 # for manual use only - in case we need to investigate the results of an rpmbuild
 660 $(1)-compile: $($(1).srpm)
 661         mkdir -p COMPILE tmp
 662         @(echo -n "XXXXXXXXXXXXXXX -- BEG compile $(1) " ; date)
 663         $(if $(findstring RPMS/yumgroups.xml,$($(1)-DEPEND-FILES)), $(createrepo) , )
 664         $(call rpmyum_install_stock_rpms,$(1))
 665         $(call rpmyum_install_local_rpms,$(1))
 666         $($(1).rpmbuild) --recompile $(RPM-USE-TMP-DIRS) $($(1).srpm)
 667         $(call rpmyum_uninstall_stock_rpms,$(1))
 668         @(echo -n "XXXXXXXXXXXXXXX -- END compile $(1) " ; date)
 669 .PHONY: $(1)-compile
 670 endef
 671
 672 $(foreach package,$(ALL),$(eval $(call target_binary_rpm,$(package))))
 673 ### shorthand target
 674 # e.g. make proper -> does propers rpms
 675 # usage shorthand_target package
 676 define target_shorthand
 677 $(1): $($(1).rpms)
 678 .PHONY: $(1)
 679 $(1)-spec: $($(1)-SPEC)
 680 .PHONY: $(1)-spec
 681 $(1)-mk: $($(1)-MK)
 682 .PHONY: $(1)-mk
 683 $(1)-tarball: $($(1).tarballs)
 684 .PHONY: $(1)-tarball
 685 .PHONY: $(1)-source
 686 $(1)-source: $($(1).source)
 687 $(1)-rpms: $($(1).rpms)
 688 .PHONY: $(1)-rpms
 689 $(1)-srpm: $($(1).srpm)
 690 .PHONY: $(1)-srpm
 691 endef
 692
 693 $(foreach package,$(ALL),$(eval $(call target_shorthand,$(package))))
 694
 695 ### file dependencies
 696 define package_depends_on_file
 697 $(1):$(2)
 698 $($(1).srpm):$(2)
 699 endef
 700
 701 define target_dependfiles
 702 $(foreach file,$($(1)-DEPEND-FILES),$(eval $(call package_depends_on_file,$(1),$(file))))
 703 endef
 704
 705 $(foreach package,$(ALL),$(eval $(call target_dependfiles,$(package))))
 706
 707 ### package dependencies
 708 define package_depends_on_package
 709 $(1):$(2)
 710 $(1):$($(2).rpms)
 711 $($(1).srpm):$($(2).rpms)
 712 endef
 713
 714 define target_depends
 715 $(foreach package,$($(1)-DEPEND-PACKAGES) $($(1).depend-devel-packages),$(eval $(call package_depends_on_package,$(1),$(package))))
 716 endef
 717
 718 $(foreach package,$(ALL),$(eval $(call target_depends,$(package))))
 719
 720 ####################
 721 # debian meta-target
 722 ALL-DEBIAN := $(foreach target,$(ALL),$(target)-debian)
 723 debian: $(ALL-DEBIAN)
 724
 725 ####################
 726 # very rough for now (one module per package), targets only sfa for now
 727 # the general idea here is, changing the specfile (for version number and all) is enough, and this
 728 # gets passed to "make debian" in the module
 729 # PREFIX: at one point we had passed PREFIX=/usr to this 'make debian'
 730 # however it turned out we could manage this some other way (see manifold)
 731 # so I'm reverting to simplicity
 732 define target_debian
 733 $(1)-debian: $(1)-tarball
 734         $(call dpkgapt_install_local_debs,$(1))
 735         $(call dpkgapt_install_stock_debs,$(1))
 736         mkdir -p DEBIAN/$(1)
 737         rsync -a MODULES/$($(1).module)/ DEBIAN/$(1)/
 738         make -C DEBIAN/$(1) "RPMTARBALL=$(HOME)/$($(1).tarballs)" "RPMVERSION=$($(1).rpm-version)" "RPMRELEASE=$($(1).rpm-release)" "RPMNAME=$($(1).rpm-name)" debian
 739         $(call dpkgapt_uninstall_stock_debs,$(1))
 740 endef
 741
 742 $(foreach package,$(ALL),$(eval $(call target_debian,$(package))))
 743
 744 ### clean target
 745 # usage: target_clean package
 746 define target_clean
 747 $(1)-clean-modules:
 748         $(foreach module,$($(1)-MODULES),rm -rf MODULES/$(module);)
 749 .PHONY: $(1)-clean-modules
 750 CLEANS += $(1)-clean-modules
 751 $(1)-clean-source:
 752         rm -rf $($(1).source)
 753 .PHONY: $(1)-clean-source
 754 CLEANS += $(1)-clean-source
 755 $(1)-clean-tarball:
 756         rm -rf $($(1).tarballs)
 757 .PHONY: $(1)-clean-tarball
 758 CLEANS += $(1)-clean-tarball
 759 $(1)-clean-build:
 760         rm -rf BUILD/$(notdir $($(1).source))
 761 CLEANS += $(1)-clean-build
 762 $(1)-clean-rpms:
 763         rm -rf $($(1).rpms)
 764 .PHONY: $(1)-clean-rpms
 765 CLEANS += $(1)-clean-rpms
 766 $(1)-clean-srpm:
 767         rm -rf $($(1).srpm)
 768 .PHONY: $(1)-clean-srpm
 769 CLEANS += $(1)-clean-srpm
 770 $(1)-clean-debian:
 771         rm -rf DEBIAN/$(1)
 772 .PHONY: $(1)-clean-srpm
 773 CLEANS += $(1)-clean-srpm
 774 $(1)-codeclean: $(1)-clean-source $(1)-clean-tarball $(1)-clean-build $(1)-clean-rpms $(1)-clean-srpm $(1)-clean-debian
 775 $(1)-clean: $(1)-clean-modules $(1)-codeclean
 776 .PHONY: $(1)-codeclean $(1)-clean
 777 $(1)-clean-spec:
 778         rm -rf $($(1).specpath)
 779 .PHONY: $(1)-clean-spec
 780 $(1)-clean-make:
 781         rm -rf MAKE/$(1).mk
 782 .PHONY: $(1)-clean-make
 783 $(1)-distclean: $(1)-distclean1 $(1)-distclean2
 784 $(1)-distclean1: $(1)-clean-spec $(1)-clean-make
 785 $(1)-distclean2: $(1)-clean
 786 .PHONY: $(1)-distclean $(1)-distclean1 $(1)-distclean2
 787 endef
 788
 789 $(foreach package,$(ALL),$(eval $(call target_clean,$(package))))
 790
 791 ### clean precisely
 792 clean:
 793         $(MAKE) $(CLEANS)
 794 .PHONY: clean
 795
 796 clean-help:
 797         @echo Available clean targets
 798         @echo $(CLEANS)
 799
 800 ### brute force clean
 801 distclean1:
 802         rm -rf envfrompreviousrun.mk .rpmmacros spec2make header.spec SPECS MAKE $(DISTCLEANS)
 803 distclean2:
 804         rm -rf MODULES SOURCES BUILD BUILDROOT RPMS SRPMS DEBIAN tmp
 805 distclean: distclean1 distclean2
 806 .PHONY: distclean1 distclean2 distclean
 807
 808 develclean:
 809         -$(RPMYUM-UNINSTALL-STOCK) $(ALL-STOCK-DEVEL-RPMS)
 810
 811 ####################
 812 # gather build information for the 'About' page
 813 # when run from crontab, INIT_CWD not properly set (says /root ..)
 814 # so, the nightly build passes BASE here
 815 # also store BASE in .base for any post-processing purposes
 816 myplc-release:
 817         @echo 'Creating myplc-release'
 818         rm -f $@
 819         echo "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx build info" >> $@
 820         $(MAKE) --no-print-directory version-build >> $@
 821         echo "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx svn info" >> $@
 822         $(MAKE) --no-print-directory version-tags >> $@
 823         echo "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx rpm info" >> $@
 824         $(MAKE) --no-print-directory version-rpms >> $@
 825         @echo $(BASE) > .base
 826
 827 version-build:
 828         @echo -n 'Build build-date: ' ; date '+%Y.%m.%d'
 829         @echo -n 'Build build-time: ' ; date '+%H:%M-%Z'
 830         @echo -n 'Build build-hostname: ' ; hostname
 831         @echo    "Build build-base: $(BASE)"
 832         @echo    "Build planetlab-distro: $(PLDISTRO)"
 833         @echo    "Build planetlab-tags: $(PLDISTROTAGS)"
 834         @echo    "Build target-arch: $(HOSTARCH)"
 835         @echo    "Build target-distro: $(DISTRO)"
 836         @echo    "Build target-distroname: $(DISTRONAME)"
 837         @echo    "Build target-release: $(RELEASE)"
 838         @echo    "Build target-personality: $(PERSONALITY)"
 839
 840 ####################
 841 # for a given module
 842 VFORMAT="%30s := %s\n"
 843 define print_tag_target
 844 $(1)-version-tag:
 845         @$(if $($(1)-SVNPATH),\
 846            printf $(VFORMAT) $(1)-SVNPATH "$($(1)-SVNPATH)",\
 847            printf $(VFORMAT) $(1)-GITPATH "$($(1)-GITPATH)" )
 848 endef
 849
 850 $(foreach module,$(ALL.modules), $(eval $(call print_tag_target,$(module))))
 851
 852 version-tags: $(foreach module, $(ALL.modules), $(module)-version-tag)
 853
 854 RFORMAT="%20s :: version=%s release=%s\n"
 855 define rpm_version_target
 856 $(1)-version-rpm:
 857         @printf $(RFORMAT) $($(1).rpm-name) $($(1).rpm-version) $($(1).rpm-release)
 858 version-rpms: $(1)-version-rpm
 859 endef
 860
 861 $(foreach package,$(sort $(ALL)), $(eval $(call rpm_version_target,$(package))))
 862
 863 versions: myplc-release version-build version-tags version-rpms
 864 .PHONY: versions version-build version-rpms version-tags
 865
 866 #################### package info
 867 PKGKEYS := tarballs source srpm rpms rpmnames rpm-release rpm-name rpm-version rpm-subversion
 868 %-pkginfo: package=$(subst -pkginfo,,$@)
 869 %-pkginfo:
 870         @$(foreach key,$(PKGKEYS),echo "$(package).$(key)=$($(package).$(key))";)
 871 ## rpm info
 872 RPMKEYS := rpm-path package
 873 %-rpminfo: rpm=$(subst -rpminfo,,$@)
 874 %-rpminfo:
 875         @$(foreach key,$(RPMKEYS),echo "$(rpm).$(key)=$($(rpm).$(key))";)
 876
 877 #################### various lists - designed to run with stage1=true
 878 info-packages:
 879         @$(foreach package,$(ALL), echo package=$(package) ref_module=$($(package).module) modules=$($(package)-MODULES) rpmnames=$($(package).rpmnames); )
 880
 881 info-modules:
 882         @$(foreach module,$(ALL.modules), echo module=$(module) \
 883            $(if $($(module)-SVNPATH),svnpath=$($(module)-SVNPATH),gitpath=$($(module)-GITPATH)) ; )
 884
 885 info-branches:
 886         @$(foreach module,$(ALL.modules), \
 887           $(if $($(module)-BRANCH),echo module=$(module) branch=$($(module)-BRANCH);))
 888
 889 module-tools:
 890         @$(foreach module,$(ALL.modules), \
 891          $(if $($(module)-GITPATH), \
 892           $(if $($(module)-BRANCH), \
 893              echo $(module):$($(module)-BRANCH); , \
 894              echo $(module); ), \
 895           $(if $($(module)-BRANCH), \
 896              echo $(module):$($(module)-BRANCH); , \
 897              echo $(module); )))
 898
 899 info: info-packages info-modules info-branches
 900
 901 .PHONY: info info-packages info-modules info-branches module-tools
 902
 903 show-multi-modules:
 904         @$(foreach package,$(ALL),$(if $(subst x1,,x$(words $($(package)-MODULES))), echo p=$(package) mods=$($(package)-MODULES) ;))
 905 .PHONY: show-multi-modules
 906 ####################
 907 help:
 908         @echo "********** Run make in two stages:"
 909         @echo ""
 910         @echo "make stage1=true PLDISTRO=onelab"
 911         @echo " -> extracts all spec files in SPECS/ and mk files in MAKE/"
 912         @echo "    as well as save PLDISTRO for subsequent runs"
 913         @echo ""
 914         @echo "********** Then you can use the following targets"
 915         @echo 'make'
 916         @echo "  rebuilds everything"
 917         @echo 'make util-vserver'
 918         @echo "  makes the RPMS related to util-vserver"
 919         @echo "  equivalent to 'make util-vserver-rpms'"
 920         @echo ""
 921         @echo "********** Or, vertically - step-by-step for a given package"
 922         @echo 'make util-vserver-source'
 923         @echo "  creates source link in SOURCES/util-vserver-<version>"
 924         @echo 'make util-vserver-tarball'
 925         @echo "  creates source tarball in SOURCES/util-vserver-<version>.<tarextension>"
 926         @echo 'make util-vserver-srpm'
 927         @echo "  build source rpm in SRPMS/"
 928         @echo 'make util-vserver-rpms'
 929         @echo "  build rpm(s) in RPMS/"
 930         @echo ""
 931         @echo "********** Or, horizontally, reach a step for all known packages"
 932         @echo 'make sources'
 933         @echo 'make tarballs'
 934         @echo 'make srpms'
 935         @echo 'make rpms'
 936         @echo ""
 937         @echo "********** Manual targets"
 938         @echo "make package-compile"
 939         @echo "  The regular process uses rpmbuild --rebuild, that performs"
 940         @echo "  a compilation directory cleanup upon completion. If you need to investigate"
 941         @echo "  the intermediate compilation directory, use the -compile targets"
 942         @echo "********** Cleaning examples"
 943         @echo "make clean"
 944         @echo "  removes the files made by make"
 945         @echo "make distclean"
 946         @echo "  brute-force cleaning, removes entire directories - requires a new stage1"
 947         @echo "make develclean"
 948         @echo "  rpm-uninstalls all devel packages installed during build"
 949         @echo ""
 950         @echo "make iptables-distclean"
 951         @echo "  deep clean for a given package"
 952         @echo "make iptables-codeclean"
 953         @echo "  run this if you've made a local/manual change in the MODULES area for iptables"
 954         @echo ""
 955         @echo "make util-vserver-clean"
 956         @echo "  removes codebase, source, tarball, build, rpm and srpm for util-vserver"
 957         @echo "make util-vserver-clean-modules"
 958         @echo "  and so on for source, tarball, build, rpm and srpm"
 959         @echo ""
 960         @echo "********** Info examples"
 961         @echo "make ++ALL"
 962         @echo "  Displays the value of a given variable (here ALL)"
 963         @echo "  with only a single plus sign only the value is displayed"
 964         @echo "make info"
 965         @echo "  is equivalent to make packages modules branches"
 966         @echo "  provides various info on these objects"
 967         @echo "make ulogd-pkginfo"
 968         @echo "  Displays know attributes of a package"
 969         @echo "make kernel-devel-rpminfo"
 970         @echo "  Displays know attributes of an rpm"
 971         @echo "make stage1=true PLDISTROTAGS=planetlab-tags-4.2.mk packages modules branches module-tools"
 972         @echo "  Lists mentioned items - module-tools is used in modules.update"
 973         @echo ""
 974         @echo "********** Known pakages are"
 975         @echo "$(ALL)"
 976
 977 #################### convenience, for debugging only
 978 # make +foo : prints the value of $(foo)
 979 # make ++foo : idem but verbose, i.e. foo=$(foo)
 980 ++%: varname=$(subst +,,$@)
 981 ++%:
 982         @echo "$(varname)=$($(varname))"
 983 +%: varname=$(subst +,,$@)
 984 +%:
 985         @echo "$($(varname))"