From d03d151093ff79c5c5761c7ce5f7c65ae909f9af Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Tue, 19 Oct 2021 14:34:18 +0200 Subject: ref-manual: document BUILD_REPRODUCIBLE_BINARIES (From yocto-docs rev: 9855ed9b35acede2f6e56509709000796a3927f3) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/migration-guides/migration-3.4.rst | 2 +- documentation/ref-manual/variables.rst | 13 +++++++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) (limited to 'documentation') diff --git a/documentation/migration-guides/migration-3.4.rst b/documentation/migration-guides/migration-3.4.rst index 9ef1982026..592dbc57c4 100644 --- a/documentation/migration-guides/migration-3.4.rst +++ b/documentation/migration-guides/migration-3.4.rst @@ -243,7 +243,7 @@ Miscellaneous re-enable it, set ``AVAHI_GTK = "gtk3"`` in a bbappend for the ``avahi`` recipe or in your custom distro configuration file. -- Setting the ``BUILD_REPRODUCIBLE_BINARIES`` variable to "0" no longer +- Setting the :term:`BUILD_REPRODUCIBLE_BINARIES` variable to "0" no longer uses a strangely old fallback date of April 2011, it instead disables building reproducible binaries as you would logically expect. diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 85f65cae35..9daf230a59 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -906,6 +906,19 @@ system and gives an overview of their function and contents. :term:`TARGET_PREFIX` when building for ``native`` recipes. + :term:`BUILD_REPRODUCIBLE_BINARIES` + This variable allows the image building classes and recipes to produce + :ref:`reproducible binaries ` + + If you inherit the + :ref:`reproducible-build ` class, + which is the case of the Poky reference distribution, this sets this + variable to "1". + + If your build inherits this classs but you wish to disable reproducible + binary generation for specific packages or images, you can set this + variable to "0" in the corresponding recipes. + :term:`BUILD_STRIP` Specifies the command to be used to strip debugging symbols from binaries produced for the build host. By default, :term:`BUILD_STRIP` -- cgit v1.2.3-54-g00ecf