Makefile: release: make manual build reproducible
PATCH 1/3 Makefile: release: make manual build reproducible
The manual contains build timestamps like:
Buildroot 2025.08-rc1 manual generated on 2025-08-12 06:43:37 UTC
Making it not reproducible. Luckily asciidoc respects SOURCE_DATE_EPOCH, so use that to use the timestamp of the latest git commit instead.
Notice: The release and manual targets are marked as noconfig targets (and need to stay like that for make release), so we cannot use the BR2_REPRODUCIBLE logic. Instead manually set SOURCE_DATE_EPOCH.
--- Makefile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
Makefile +2 -1
@@ -1250,7 +1250,8 @@ release: OUT = buildroot-$(BR2_VERSION) # documentation to the git output release: git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar - $(MAKE) O=$(OUT) manual-html manual-text manual-pdf + SOURCE_DATE_EPOCH=$$(git log -1 --format=%at 2> /dev/null) \ + $(MAKE) O=$(OUT) manual-html manual-text manual-pdf $(MAKE) O=$(OUT) distclean tar rf $(OUT).tar $(OUT) gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
Signature · 6 lines
2.39.5 _______________________________________________ buildroot mailing list [email protected] https://lists.buildroot.org/mailman/listinfo/buildroot
PATCH 2/3 Makefile: release: make tarball reproducible
The tarball created by git archive is reproducible, but when we append the generated manual we leak current time and the username/uid of the person running make release:
tar tvf buildroot-2025.08-rc1.tar.gz | tail
-rwxrwxr-x root/root 5512 2025-08-11 13:22 buildroot-2025.08-rc1/utils/update-rust
drwxr-xr-x peko/peko 0 2025-08-11 17:39 buildroot-2025.08-rc1/ drwxr-xr-x peko/peko 0 2025-08-11 17:38 buildroot-2025.08-rc1/docs/ drwxr-xr-x peko/peko 0 2025-08-11 17:39 buildroot-2025.08-rc1/docs/manual/ -rw-r--r-- peko/peko 5738 2025-08-11 17:38 buildroot-2025.08-rc1/docs/manual/docbook-xsl.css -rw-r--r-- peko/peko 19029 2025-08-11 17:38 buildroot-2025.08-rc1/docs/manual/github_hash_mongrel2.png -rw-r--r-- peko/peko 638866 2025-08-11 17:39 buildroot-2025.08-rc1/docs/manual/manual.pdf -rw-r--r-- peko/peko 587892 2025-08-11 17:38 buildroot-2025.08-rc1/docs/manual/manual.html -rw-r--r-- peko/peko 393514 2025-08-11 17:39 buildroot-2025.08-rc1/docs/manual/manual.text -rw-r--r-- peko/peko 117499 2025-08-11 17:38 buildroot-2025.08-rc1/docs/manual/logo.png
Fix that by forcing uid as root and setting mtime to the latest commit, similar to how we do it in support/download/{git,helpers}.
Notice that we do not use --numeric-owner to match the output of git archive, so it does rely on uid 0=root, which is very likely but not guaranteed.
--- Makefile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
Makefile +2 -1
@@ -1253,7 +1253,8 @@ release: SOURCE_DATE_EPOCH=$$(git log -1 --format=%at 2> /dev/null) \ $(MAKE) O=$(OUT) manual-html manual-text manual-pdf $(MAKE) O=$(OUT) distclean - tar rf $(OUT).tar $(OUT) + tar rf $(OUT).tar --owner=0 --group=0 \ + --mtime="$$(git log -1 --pretty=format:%ci)" $(OUT) gzip -9 -c < $(OUT).tar > $(OUT).tar.gz xz -9 -c < $(OUT).tar > $(OUT).tar.xz rm -rf $(OUT) $(OUT).tar
Signature · 6 lines
2.39.5 _______________________________________________ buildroot mailing list [email protected] https://lists.buildroot.org/mailman/listinfo/buildroot
PATCH 3/3 Makefile: release: make .tar.gz reproducible
In reply to Peter KorsgaardDrop the timestamp from the .tar.gz to make it reproducible, similar to how it is done in support/download/helpers.
Notice: .xz files do not contain a timestamp
--- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
Makefile +1 -1
@@ -1255,7 +1255,7 @@ release: $(MAKE) O=$(OUT) distclean tar rf $(OUT).tar --owner=0 --group=0 \ --mtime="$$(git log -1 --pretty=format:%ci)" $(OUT) - gzip -9 -c < $(OUT).tar > $(OUT).tar.gz + gzip -9 -n -c < $(OUT).tar > $(OUT).tar.gz xz -9 -c < $(OUT).tar > $(OUT).tar.xz rm -rf $(OUT) $(OUT).tar
Signature · 6 lines
2.39.5 _______________________________________________ buildroot mailing list [email protected] https://lists.buildroot.org/mailman/listinfo/buildroot
Quoted 4 lines · Peter Korsgaard
The manual contains build timestamps like:
Buildroot 2025.08-rc1 manual generated on 2025-08-12 06:43:37 UTC
Quoted 8 lines
Making it not reproducible. Luckily asciidoc respects
SOURCE_DATE_EPOCH, so use that to use the timestamp of the latest git commit instead.Notice: The release and manual targets are marked as noconfig targets (and need to stay like that for make release), so we cannot use the
BR2_REPRODUCIBLElogic. Instead manually setSOURCE_DATE_EPOCH.Signed-off-by Peter Korsgaard <[email protected]>
Series applied to master, thanks.
_______________________________________________
buildroot mailing list
[email protected]
https://lists.buildroot.org/mailman/listinfo/buildroot
Thomas Perale via buildroot
AppliedIn reply of:
Quoted 4 lines
The manual contains build timestamps like:
Buildroot 2025.08-rc1 manual generated on 2025-08-12 06:43:37 UTC
Quoted 8 lines
Making it not reproducible. Luckily asciidoc respects
SOURCE_DATE_EPOCH, so use that to use the timestamp of the latest git commit instead.Notice: The release and manual targets are marked as noconfig targets (and need to stay like that for make release), so we cannot use the
BR2_REPRODUCIBLElogic. Instead manually setSOURCE_DATE_EPOCH.Signed-off-by Peter Korsgaard <[email protected]>
Applied to 2025.02.x & 2025.05.x. Thanks
Quoted 25 lines
--- Makefile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)Makefile +2
-1@@ -1250,7 +1250,8 @@ release: OUT = buildroot-$(BR2_VERSION) # documentation to the git output release: git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar - $(MAKE) O=$(OUT) manual-html manual-text manual-pdf + SOURCE_DATE_EPOCH=$$(git log -1 --format=%at 2> /dev/null) \ + $(MAKE) O=$(OUT) manual-html manual-text manual-pdf $(MAKE) O=$(OUT) distclean tar rf $(OUT).tar $(OUT) gzip -9 -c < $(OUT).tar > $(OUT).tar.gzSignature · 6 lines
2.39.5 _______________________________________________ buildroot mailing list [email protected] https://lists.buildroot.org/mailman/listinfo/buildroot
_______________________________________________
buildroot mailing list
[email protected]
https://lists.buildroot.org/mailman/listinfo/buildroot