#
# Thierry Parmentelat - INRIA Sophia Antipolis
#
-### $Id: Makefile 1088 2007-11-15 14:51:33Z thierry $
+### $Id$
#
-# run 'make help' for more info
+####################
+# invocation:
+#
+# (*) make stage1=true
+# this extracts all specfiles and computes .mk from specfiles
+# you need to specify PLDISTRO here if relevant - see below
+# (*) make help
+# for more info on how to invoke this stuff
+#
+#################### (fedora) distributions
+#
+# (*) as of nov. 2007, myplc-devel is deprecated
+# (*) instead, we create a fresh vserver that holds required tools (see e.g. planetlab-devel.lst)
+# (*) the build uses the current fedora version as a target for the produced images
+# (*) so you simply need to create a fedora 8 build image for building fedora-8 images
+#
+#################### (planetlab) distributions
+#
+# (*) the default distribution is called 'planetlab'
+# (*) you may define an alternative distribution, e.g. onelab
+# in this case you need to
+# (*) create onelab.mk that defines your *packages* (see below)
+# (*) create onelab-tags.mk that defines where to fetch your *modules*
+# (*) create your main yumgroups.xml as groups/<distro>.xml
+# (*) there are also various places where a set of modules are defined.
+# check for .lst files in the various modules that build root images
+# and mimic what's done for planetlab
+# (*) then you need to run
+# make stage1=true PLDISTRO=onelab
+#
+####################
+# This build deals with 2 kinds of objects
+#
+# (*) packages are named upon the RPM name; they are mostly lowercase
+# Add a package to ALL if you want it built as part of the default set.
+# (*) modules are named after the subversion tree; as of this writing their names
+# are mostly mixed case like MyPLC or Vserverreference
+#
+#################### packages
+# basics: how to build a package - you need/may define the following variables
+#
+# (*) package-MODULES
+# a package needs one or several modules to build.
+# to this end, define
+# (*) package-SPEC
+# the package's specfile; this is relative to the FIRST module in package-MODULES
+# see 'codebase' below
+#
+# Optional:
+#
+# (*) package-SPECVARS
+# space-separated list of spec variable definitions, where you can reference make variable that relate to
+# packages defined BEFORE the current one (note: you should use = - as opposed to := - to define these)
+# e.g. mydriver-SPECVARS = foo=$(kernel-rpm-release)
+# would let you use the %release from the kernel's package when rpmbuild'ing mydriver - see automatic below
+# (*) package-DEPENDS
+# a set of *packages* that this package depends on
+# (*) package-DEPENDDEVELRPMS
+# a set of *rpms* that the build will rpm-install before building <package>
+# (*) package-DEPENDFILES
+# a set of files that the package depends on - and that make needs to know about
+# if this contains RPMS/yumgroups.xml, then the toplevel RPMS's index
+# is refreshed with createrepo prior to running rpmbuild
+# (*) package-RPMFLAGS: Miscellaneous RPM flags
+# (*) package-RPMBUILD: If not rpmbuild - mostly used for sudo'ing rpmbuild
+#
+#################### modules
+# Required information about the various modules (set this in e.g. planetlab-tags.mk)
+#
+# (*) module-SVNPATH
+# the complete path where this module lies;
+# you can specify the trunk or a given tag with this variable
+#
+# OR if the module is managed under cvs (will be obsoleted)
+#
+# (*) module-CVSROOT
+# (*) module-TAG
+#
+#################### automatic variables
+#
+# the build defines the following make variables - these are extracted from spec files
+# (*) package-TARBALLS : from the Source<n>: declaration
+# example: kernel-i386-TARBALLS = SOURCES/linux-2.6.20.tar.bz2
+# (*) package-SOURCE :
+# example: kernel-i386-SOURCE = SOURCES/linux-2.6.20
+# (*) package-SRPM
+# example: kernel-i386-SRPM = SRPMS/kernel-2.6.20-1.2949.fc6.vs2.2.0.1.0.planetlab.src.rpm
+# (*) package-RPMS
+# example: kernel-i386-RPMS = \
+# RPMS/i686/kernel-2.6.20-1.2949.fc6.vs2.2.0.1.0.planetlab.i686.rpm \
+# RPMS/i686/kernel-devel-2.6.20-1.2949.fc6.vs2.2.0.1.0.planetlab.i686.rpm \
+# RPMS/i686/kernel-vserver-2.6.20-1.2949.fc6.vs2.2.0.1.0.planetlab.i686.rpm \
+# RPMS/i686/kernel-debuginfo-2.6.20-1.2949.fc6.vs2.2.0.1.0.planetlab.i686.rpm
+# (*) package-rpm-name
+# example: kernel-i386-rpm-name = kernel
+# (*) package-rpm-release
+# example: kernel-i386-rpm-release = 1.2949.fc6.vs2.2.0.1.0.planetlab
+# (*) package-version
+# example: kernel-i386-rpm-version = 2.6.20
+# (*) package-subversion
+# example: myplc-rpm-subversion = 15
+####################
+
+#
+# Default values
+#
+HOSTARCH := $(shell uname -i)
+DISTRO := $(shell ./getdistro.sh)
+RELEASE := $(shell ./getrelease.sh)
+RPM-INSTALL-DEVEL := rpm --force -Uvh
#################### Makefile
# Default target
.PHONY:all
### default values
-PLDISTRO := onelab
+PLDISTRO := planetlab
RPMBUILD := rpmbuild
export CVS_RSH := ssh
all: verbose
verbose:
@echo "========== stage2 : $(package)"
- @echo "stage2 : included .mk files : $(previousmks)"
+# @echo "stage2 : included .mk files : $(previousmks)"
all: $($(package)_specpath)
all: MAKE/$(package).mk
else
# mention $(ALL) here rather than rpms
# this is because the inter-package dependencies are expressed like
# util-vserver: util-python
-all: $(ALL)
-all: srpms
+all: rpms
+all: repo
endif
endif
####################
# gather build information for the 'About' page
-SOURCES/myplc-release:
+myplc-release:
@echo 'Creating myplc-release'
- mkdir -p SOURCES
rm -f $@
(echo -n 'Build bdate: ' ; date '+%Y.%m.%d') >> $@
(echo -n 'Build btime: ' ; date '+%H:%M') >> $@
echo "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx modules versions info" >> $@
$(MAKE) --no-print-directory versions >> $@
+### yumgroups.xml
+# the source
+ifndef YUMGROUPS
+YUMGROUPS := groups/$(PLDISTRO).xml
+endif
+
+RPMS/yumgroups.xml: $(YUMGROUPS)
+ mkdir -p RPMS
+ install -D -m 644 $(YUMGROUPS) $@
+
+createrepo = createrepo --quiet -g yumgroups.xml RPMS/
+
+repo: RPMS/yumgroups.xml
+ $(createrepo)
+
+.PHONY: repo
+
####################
# notes:
# * to make configuration easier, we always use the first module's
define stage1_variables
$(1)_spec = $(notdir $($(1)-SPEC))
$(1)_specpath = SPECS/$(notdir $($(1)-SPEC))
-$(1)_module = $(firstword $($(1)-MODULE))
+$(1)_module = $(firstword $($(1)-MODULES))
endef
$(foreach package, $(ALL), $(eval $(call stage1_variables,$(package))))
define target_spec
$($(1)_specpath):
mkdir -p SPECS
- echo "%define pldistro $(PLDISTRO)" > $($(1)_specpath)
+ (echo -n "# Generated by planetlab build from $($(1)-SPEC) on " ; date) > $($(1)_specpath)
+ echo "%define distroname $(DISTRO)" >> $($(1)_specpath)
+ echo "%define distrorelease $(RELEASE)" >> $($(1)_specpath)
+ echo "%define pldistro $(PLDISTRO)" >> $($(1)_specpath)
$(if $($(1)_hasdate),echo "%define date $(shell date +%Y.%m.%d)" >> $($(1)_specpath),)
+ echo "# included from codebase specfile" >> $($(1)_specpath)
$(if $($(1)-SPECVARS), \
$(foreach line,$($(1)-SPECVARS), \
echo "%define" $(word 1,$(subst =, ,$(line))) "$(word 2,$(subst =, ,$(line)))" >> $($(1)_specpath) ;))
$(foreach package,$(ALL),$(eval $(call target_spec,$(package))))
+###
+# Base rpmbuild in the current directory
+# issues on fedora 8 : see the following posts
+# http://forums.fedoraforum.org/showthread.php?t=39625 - and more specifically post#6
+# https://www.redhat.com/archives/fedora-devel-list/2007-November/msg00171.html
+REALROOT=/build
+FAKEROOT=/longbuildroot
+PWD=$(shell /bin/pwd)
+ifeq "$(PWD)" "$(REALROOT)"
+export HOME := $(FAKEROOT)
+else
+export HOME := $(PWD)
+endif
+.rpmmacros:
+ifeq "$(shell pwd)" "/build"
+ rm -f $(FAKEROOT) ; ln -s $(REALROOT) $(FAKEROOT)
+endif
+ rm -f $@
+ echo "%_topdir $(HOME)" >> $@
+ echo "%_tmppath $(HOME)/tmp" >> $@
+ echo "%_netsharedpath /proc:/dev/pts" >> $@
+ echo "%_install_langs C:de:en:es:fr" >> $@
+ echo "%_excludedocs yes" >> $@
+
### this utility allows to extract various info from a spec file
### and to define them in makefiles
spec2make: spec2make.c
$(CC) -g -Wall $< -o $@ -lrpm -lrpmbuild
-# Base rpmbuild in the current directory
-export HOME := $(shell pwd)
-.rpmmacros:
- echo "%_topdir $(HOME)" > $@
- echo "%_tmppath $(HOME)/tmp" >> $@
-
### run spec2make on the spec file and include the result
# usage: spec2make package
define target_mk
####################
### pack sources into tarballs
-ALLTARBALLS:= $(foreach package, $(ALL), $($(package)-TARBALL))
+ALLTARBALLS:= $(foreach package, $(ALL), $($(package)-TARBALLS))
tarballs: $(ALLTARBALLS)
@echo $(words $(ALLTARBALLS)) source tarballs OK
.PHONY: tarballs
SOURCES/%.tgz: SOURCES/%
tar chpzf $@ -C SOURCES $*
+##
+URLS/%: url=$(subst @colon@,:,$(subst @slash@,/,$(notdir $@)))
+URLS/%: basename=$(notdir $(url))
+URLS/%:
+ echo curl $(url) -o SOURCES/$(basename)
+ touch $@
+
### the directory SOURCES/<package>-<version> is made
# with a copy -rl from CODEBASES/<package>
# the former is $(package-SOURCE) and the latter is $(package-CODEBASE)
# usage: extract_multi_module package
define extract_multi_module
mkdir -p CODEBASES/$(1) && cd CODEBASES/$(1) && (\
- $(foreach m,$($(1)-MODULE), $(if $($(m)-SVNPATH), svn export $($(m)-SVNPATH) $(m);, cvs -d $($(m)-CVSROOT) export -r $($(m)-TAG) $(m);)))
+ $(foreach m,$($(1)-MODULES), $(if $($(m)-SVNPATH), svn export $($(m)-SVNPATH) $(m);, cvs -d $($(m)-CVSROOT) export -r $($(m)-TAG) $(m);)))
endef
CODEBASES/%: package=$(notdir $@)
-CODEBASES/%: module=$($(package)-MODULE)
-CODEBASES/%: multi_module=$(word 2,$(module))
+CODEBASES/%: multi_module=$(word 2,$($(package)-MODULES))
CODEBASES/%:
@(echo -n "XXXXXXXXXXXXXXX -- BEG CODEBASE $(package) : $@ " ; date)
$(if $(multi_module),\
$(call extract_single_module,$(package)))
@(echo -n "XXXXXXXXXXXXXXX -- END CODEBASE $(package) : $@ " ; date)
-### rpmbuild invokation
-ALLRPMS:=$(foreach package,$(ALL),$($(package)-RPM))
-# same as above, mention $(ALL) and not $(ALLRPMS)
-rpms: $(ALL)
- @echo $(words $(ALLRPMS)) binary rpms OK
-.PHONY: rpms
-
-# usage: build_binary_rpm package
-# xxx hacky - invoke createrepo if DEPENDFILES mentions RPMS/yumgroups.xml
-define target_binary_rpm
-$($(1)-RPM): $($(1)_specpath) $($(1)-TARBALL) .rpmmacros
- mkdir -p BUILD RPMS tmp
- @(echo -n "XXXXXXXXXXXXXXX -- BEG RPM $(1) " ; date)
- $(if $(findstring RPMS/yumgroups.xml,$($(1)-DEPENDFILES)), createrepo --quiet -g yumgroups.xml RPMS/ , )
- $(if $($(1)-RPMBUILD),\
- $($(1)-RPMBUILD) $($(1)-RPMFLAGS) -bb $($(1)_specpath), \
- $(RPMBUILD) $($(1)-RPMFLAGS) -bb $($(1)_specpath))
- @(echo -n "XXXXXXXXXXXXXXX -- END RPM $(1) " ; date)
-endef
-
-$(foreach package,$(ALL),$(eval $(call target_binary_rpm,$(package))))
-
### source rpms
ALLSRPMS:=$(foreach package,$(ALL),$($(package)-SRPM))
srpms: $(ALLSRPMS)
@echo $(words $(ALLSRPMS)) source rpms OK
.PHONY: srpms
-# usage: build_source_rpm package
+# usage: target_source_rpm package
+# select upon the package name, whether it contains srpm or not
define target_source_rpm
-$($(1)-SRPM): $($(1)_specpath) $($(1)-TARBALL) .rpmmacros
+$(1).all-devel-rpm-paths := $(foreach rpm,$($(1)-DEPENDDEVELRPMS),$($(rpm).rpm-path))
+ifeq "$(subst srpm,,$(1))" "$(1)"
+$($(1)-SRPM): $($(1)_specpath) .rpmmacros $($(1)-TARBALLS)
mkdir -p BUILD SRPMS tmp
@(echo -n "XXXXXXXXXXXXXXX -- BEG SRPM $(1) " ; date)
+ $(if $($(1).all-devel-rpm-paths), $(RPM-INSTALL-DEVEL) $($(1).all-devel-rpm-paths))
$(if $($(1)-RPMBUILD),\
$($(1)-RPMBUILD) $($(1)-RPMFLAGS) -bs $($(1)_specpath),
$(RPMBUILD) $($(1)-RPMFLAGS) -bs $($(1)_specpath))
@(echo -n "XXXXXXXXXXXXXXX -- END SRPM $(1) " ; date)
+else
+$($(1)-SRPM): $($(1)_specpath) .rpmmacros $($(1)-CODEBASE)
+ mkdir -p BUILD SRPMS tmp
+ @(echo -n "XXXXXXXXXXXXXXX -- BEG SRPM $(1) (using make srpm) " ; date)
+ $(if $($(1).all-devel-rpm-paths), $(RPM-INSTALL-DEVEL) $($(1).all-devel-rpm-paths))
+ make -C $($(1)-CODEBASE) srpm && \
+ rm -f SRPMS/$(notdir $($(1)-SRPM)) && \
+ ln $($(1)-CODEBASE)/$(notdir $($(1)-SRPM)) SRPMS/$(notdir $($(1)-SRPM))
+ @(echo -n "XXXXXXXXXXXXXXX -- END SRPM $(1) " ; date)
+endif
endef
$(foreach package,$(ALL),$(eval $(call target_source_rpm,$(package))))
-### RPMS/yumgroups.xml
-ifndef YUMGROUPS
-YUMGROUPS := groups/$(PLDISTRO).xml
-endif
-RPMS/yumgroups.xml: $(YUMGROUPS)
- install -D -m 644 $(YUMGROUPS) $@
+### rpmbuild invokation
+ALLRPMS:=$(foreach package,$(ALL),$($(package)-RPMS))
+# same as above, mention $(ALL) and not $(ALLRPMS)
+rpms: $(ALLRPMS)
+ @echo $(words $(ALLRPMS)) binary rpms OK
+.PHONY: rpms
+
+# use tmp dirs when building binary rpm so make remains idempotent
+# otherwise SOURCES/ or SPEC gets touched again - which leads to rebuilding
+rpm_use_tmp_dirs = --define "_sourcedir $(HOME)/tmp" --define "_specdir $(HOME)/tmp"
+
+# usage: build_binary_rpm package
+# xxx hacky - invoke createrepo if DEPENDFILES mentions RPMS/yumgroups.xml
+define target_binary_rpm
+$($(1)-RPMS): $($(1)-SRPM)
+ mkdir -p BUILD RPMS tmp
+ @(echo -n "XXXXXXXXXXXXXXX -- BEG RPM $(1) " ; date)
+ $(if $(findstring RPMS/yumgroups.xml,$($(1)-DEPENDFILES)), $(createrepo) , )
+ $(if $($(1)-RPMBUILD),\
+ $($(1)-RPMBUILD) $($(1)-RPMFLAGS) --rebuild $(rpm_use_tmp_dirs) $($(1)-SRPM), \
+ $(RPMBUILD) $($(1)-RPMFLAGS) --rebuild $(rpm_use_tmp_dirs) $($(1)-SRPM))
+ @(echo -n "XXXXXXXXXXXXXXX -- END RPM $(1) " ; date)
+endef
+
+$(foreach package,$(ALL),$(eval $(call target_binary_rpm,$(package))))
### shorthand target
# e.g. make proper -> does propers rpms
# usage shorthand_target package
define target_shorthand
-$(1): $($(package)-RPM)
+$(1): $($(package)-RPMS)
.PHONY: $(1)
$(1)-spec: $($(package)-SPEC)
.PHONY: $(1)-spec
$(1)-mk: $($(package)-MK)
.PHONY: $(1)-mk
-$(1)-tarball: $($(package)-TARBALL)
+$(1)-tarball: $($(package)-TARBALLS)
.PHONY: $(1)-tarball
$(1)-codebase: $($(package)-CODEBASE)
.PHONY: $(1)-source
$(1)-source: $($(package)-SOURCE)
.PHONY: $(1)-codebase
-$(1)-rpm: $($(package)-RPM)
-.PHONY: $(1)-rpm
+$(1)-rpms: $($(package)-RPMS)
+.PHONY: $(1)-rpms
$(1)-srpm: $($(package)-SRPM)
.PHONY: $(1)-srpm
endef
$(foreach package,$(ALL),$(eval $(call target_shorthand,$(package))))
-### dependencies
+### file dependencies
define package_depends_on_file
$(1):$(2)
-$($(1)-RPM):$(2)
+$($(1)-SRPM):$(2)
endef
define target_dependfiles
$(foreach file,$($(1)-DEPENDFILES),$(eval $(call package_depends_on_file,$(1),$(file))))
endef
+$(foreach package,$(ALL),$(eval $(call target_dependfiles,$(package))))
+
+### package dependencies
+define compute_devel_depends
+$(1).depend-devel-packages := $(foreach rpm,$($(1)-DEPENDDEVELRPMS),$($(rpm).package))
+endef
+$(foreach package,$(ALL),$(eval $(call compute_devel_depends,$(package))))
+
define package_depends_on_package
$(1):$(2)
-$(1):$($(2)-RPM)
-$($(1)-RPM):$($(2)-RPM)
+$(1):$($(2)-RPMS)
+$($(1)-SRPM):$($(2)-RPMS)
endef
define target_depends
-$(foreach package,$($(1)-DEPENDS),$(eval $(call package_depends_on_package,$(1),$(package))))
+$(foreach package,$($(1)-DEPENDS) $($(1).depend-devel-packages),$(eval $(call package_depends_on_package,$(1),$(package))))
endef
$(foreach package,$(ALL),$(eval $(call target_depends,$(package))))
-$(foreach package,$(ALL),$(eval $(call target_dependfiles,$(package))))
-
### clean target
# usage: target_clean package
.PHONY: $(1)-clean-source
CLEANS += $(1)-clean-source
$(1)-clean-tarball:
- rm -rf $($(1)-TARBALL)
+ rm -rf $($(1)-TARBALLS)
.PHONY: $(1)-clean-tarball
CLEANS += $(1)-clean-tarball
-$(1)-clean-rpm:
- rm -rf $($(1)-RPM)
-.PHONY: $(1)-clean-rpm
-CLEANS += $(1)-clean-rpm
+$(1)-clean-build:
+ rm -rf BUILD/$(notdir $($(1)-SOURCE))
+CLEANS += $(1)-clean-build
+$(1)-clean-rpms:
+ rm -rf $($(1)-RPMS)
+.PHONY: $(1)-clean-rpms
+CLEANS += $(1)-clean-rpms
$(1)-clean-srpm:
rm -rf $($(1)-SRPM)
.PHONY: $(1)-clean-srpm
CLEANS += $(1)-clean-srpm
-$(1)-clean: $(1)-clean-codebase $(1)-clean-source $(1)-clean-tarball $(1)-clean-rpm $(1)-clean-srpm
-.PHONY: $(1)-clean
+$(1)-codeclean: $(1)-clean-source $(1)-clean-tarball $(1)-clean-build $(1)-clean-rpms $(1)-clean-srpm
+$(1)-clean: $(1)-clean-codebase $(1)-codeclean
+.PHONY: $(1)-codeclean $(1)-clean
+$(1)-clean-spec:
+ rm -rf $($(1)_specpath)
+.PHONY: $(1)-clean-spec
+$(1)-clean-make:
+ rm -rf MAKE/$(1).mk
+.PHONY: $(1)-clean-make
+$(1)-distclean: $(1)-distclean1 $(1)-distclean2
+$(1)-distclean1: $(1)-clean-spec $(1)-clean-make
+$(1)-distclean2: $(1)-clean
+.PHONY: $(1)-distclean $(1)-distclean1 $(1)-distclean2
endef
$(foreach package,$(ALL),$(eval $(call target_clean,$(package))))
# compute all modules
ALL-MODULES :=
-$(foreach package,$(ALL), $(eval ALL-MODULES+=$($(package)-MODULE)))
+$(foreach package,$(ALL), $(eval ALL-MODULES+=$($(package)-MODULES)))
ALL-MODULES:=$(sort $(ALL-MODULES))
$(foreach module,$(ALL-MODULES), $(eval $(call print_version,$(module))))
@echo " rebuilds everything"
@echo '$ make util-vserver'
@echo " makes the RPMS related to util-vserver"
- @echo " equivalent to 'make util-vserver-rpm'"
+ @echo " equivalent to 'make util-vserver-rpms'"
@echo ""
@echo "Or, vertically - step-by-step for a given package"
@echo '$ make util-vserver-codebase'
@echo " creates source link in SOURCES/util-vserver-<version>"
@echo '$ make util-vserver-tarball'
@echo " creates source tarball in SOURCES/util-vserver-<version>.<tarextension>"
- @echo '$ make util-vserver-rpm'
+ @echo '$ make util-vserver-rpms'
@echo " build rpm(s) in RPMS/"
@echo '$ make util-vserver-srpm'
@echo " build source rpm in SRPMS/"
@echo " removes the files made by make"
@echo "$ make distclean"
@echo " brute-force cleaning, removes entire directories - requires a new stage1"
+ @echo ""
+ @echo "$ make iptables-distclean"
+ @echo "$ make iptables-codeclean"
+ @echo " run this if you've made a change in the CODEBASES area for iptables"
+ @echo ""
@echo "$ make util-vserver-clean"
- @echo " removes codebase, source, tarball, rpm and srpm for util-vserver"
+ @echo " removes codebase, source, tarball, build, rpm and srpm for util-vserver"
@echo "$ make util-vserver-clean-codebase"
- @echo " and so on"
-
+ @echo " and so on for source, tarball, build, rpm and srpm"
#################### convenience, for debugging only
# make +foo : prints the value of $(foo)