summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2021-10-19 12:35:58 (GMT)
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-10-20 19:22:20 (GMT)
commit90b29420c7006fae131d835e0f372fd2755153e7 (patch)
tree290e69f2b01fcad5df5aa2140a5eaff8f8f07821
parent07108739ce3283576e2041d6b399c9a21b579f6d (diff)
downloadpoky-90b29420c7006fae131d835e0f372fd2755153e7.tar.gz
ref-manual: document SOURCE_DATE_EPOCH
(From yocto-docs rev: 160d672641c52338ba499edfb66339a10b088490) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/variables.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index cc55f33..53a8ee5 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -6925,6 +6925,23 @@ system and gives an overview of their function and contents.
6925 You will see this variable referenced in the default values of 6925 You will see this variable referenced in the default values of
6926 ``FILES:${PN}-dev``. 6926 ``FILES:${PN}-dev``.
6927 6927
6928 :term:`SOURCE_DATE_EPOCH`
6929 This defines a date expressed in number of seconds since
6930 the UNIX EPOCH (01 Jan 1970 00:00:00 UTC), which is used by
6931 multiple build systems to force a timestamp in built binaries.
6932 Many upstream projects already support this variable.
6933
6934 You will find more details in the `official specifications
6935 <https://reproducible-builds.org/specs/source-date-epoch/>`__.
6936
6937 A value for each recipe is computed from the sources by
6938 the :ref:`reproducible-build <ref-classes-reproducible-build>` class.
6939
6940 If a recipe wishes to override the default behavior, it should set its
6941 own :term:`SOURCE_DATE_EPOCH` value::
6942
6943 SOURCE_DATE_EPOCH = "1613559011"
6944
6928 :term:`SOURCE_MIRROR_FETCH` 6945 :term:`SOURCE_MIRROR_FETCH`
6929 When you are fetching files to create a mirror of sources (i.e. 6946 When you are fetching files to create a mirror of sources (i.e.
6930 creating a source mirror), setting :term:`SOURCE_MIRROR_FETCH` to "1" in 6947 creating a source mirror), setting :term:`SOURCE_MIRROR_FETCH` to "1" in