documentation/test-manual/reproducible-builds.rst

1 .. SPDX-License-Identifier: CC-BY-SA-2.0-UK
14 run in, and regardless of the distro and tools on the underlying host system the
22 <https://reproducible-builds.org/>`__, which shares information about why
28 <migration-guides/migration-3.1:reproducible builds now enabled by default>`,
37 :ref:`overview-manual/concepts:Hash Equivalence` for
38 :ref:`overview-manual/concepts:Shared State` object reuse works much more
52 things we do within the build system to ensure reproducibility include:
54 -  Adding mappings to the compiler options to ensure debug filepaths are mapped
56    :term:`DEBUG_PREFIX_MAP` variable which sets the ``-fmacro-prefix-map`` and
57    ``-fdebug-prefix-map`` compiler options correctly to map to target paths.
58 -  Being explicit about recipe dependencies and their configuration (no floating
61    otherwise try and auto-detect host dependencies.
62 -  Using recipe specific sysroots to isolate recipes so they only see their
63    dependencies. These are visible as ``recipe-sysroot`` and
64    ``recipe-sysroot-native`` directories within the :term:`WORKDIR` of a given
66 -  Build images from a reduced package set: only packages from recipes the image
68 -  Filtering the tools available from the host's ``PATH`` to only a specific set
76 time of writing (release 3.3, "hardknott"), :term:`OpenEmbedded-Core (OE-Core)`
84    Only BitBake and :term:`OpenEmbedded-Core (OE-Core)`, which is the ``meta``
92    oe-selftest -r reproducible.ReproducibleTests.test_reproducible_builds
97 The first build will be run using :ref:`Shared State <overview-manual/concepts:Shared State>` if
99 :ref:`Shared State <overview-manual/concepts:Shared State>` except for recipes defined in
108 https://autobuilder.yocto.io/pub/repro-fail/ in the form ``oe-reproducible +
109 <date> + <random ID>``, e.g. ``oe-reproducible-20200202-1lm8o1th``.
112 :yocto_home:`/reproducible-build-results/`
114 You can also check the reproducibility status on supported host distributions:
116 -  CentOS: :yocto_ab:`/typhoon/#/builders/reproducible-centos`
117 -  Debian: :yocto_ab:`/typhoon/#/builders/reproducible-debian`
118 -  Fedora: :yocto_ab:`/typhoon/#/builders/reproducible-fedora`
119 -  Ubuntu: :yocto_ab:`/typhoon/#/builders/reproducible-ubuntu`
126 :ref:`oe-selftest <ref-manual/release-process:Testing and Quality Assurance>`
129 </openembedded-core/tree/meta/lib/oeqa/selftest/cases/reproducible.py>`.
133 You may also change ``sstate_targets`` which would allow you to "pre-cache" some
136 ``core-image-sato``, then setting ``targets`` to ``core-image-sato-sdk`` would
137 run reproducibility tests only on the targets belonging only to ``core-image-sato-sdk``.