From 7105586a68d0d1ef22f7bf03f748ad57b1f849b7 Mon Sep 17 00:00:00 2001 From: Mikko Rapeli Date: Thu, 15 Jun 2023 14:26:33 +0300 Subject: reproducible-builds.rst: document OEQA_REPRODUCIBLE_TEST_TARGET and OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS They are used to fine tune build reproducibility test for different build targets than "bitbake world" and to define which recipes can be rebuild using sstate cache. These are useful when ramping up build reproducibility in complex build configurations where "bitbake world" has too many failures. (From yocto-docs rev: c74928b1a7b2f285ed70999539f0c630316ad364) Signed-off-by: Mikko Rapeli Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/test-manual/reproducible-builds.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'documentation/test-manual') diff --git a/documentation/test-manual/reproducible-builds.rst b/documentation/test-manual/reproducible-builds.rst index 50256fb197..d4b828b2d6 100644 --- a/documentation/test-manual/reproducible-builds.rst +++ b/documentation/test-manual/reproducible-builds.rst @@ -103,10 +103,12 @@ run:: oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds This defaults to including a ``world`` build so, if other layers are added, it would -also run the tests for recipes in the additional layers. The first build will be -run using :ref:`Shared State ` if +also run the tests for recipes in the additional layers. Different build targets +can be defined using the :term:`OEQA_REPRODUCIBLE_TEST_TARGET` variable in ``local.conf``. +The first build will be run using :ref:`Shared State ` if available, the second build explicitly disables -:ref:`Shared State ` and builds on the +:ref:`Shared State ` except for recipes defined in +the :term:`OEQA_REPRODUCIBLE_TEST_SSTATE_TARGETS` variable, and builds on the specific host the build is running on. This means we can test reproducibility builds between different host distributions over time on the Autobuilder. -- cgit v1.2.3-54-g00ecf