poky/documentation/dev-manual
Antonin Godard 6e5d021cd6 dev-manual/start.rst: remove basic setup for hash equivalence
Quoting Alexander Kanavin [1]:

> 1. BB_HASHSERVE and BB_SIGNATURE_HANDLER do not set up or start a
> server, they set up the hash equivalence client built into bitbake.
>
> 2. The above client configuration (used by poky) also starts a private
> server that is specific to a particular build directory. So hash equiv
> information would not be shared between multiple build directories,
> and this will cause sstate mismatches (as reported in the bug), if
> sstate is shared.

This setup does not shed light on the potential of the hash equivalence
feature. So for now, remove this basic setup, and later rework the
concepts (or create a new) document that explains how to set up a hash
equivalence server shared between builds.

[1]: https://lore.kernel.org/r/CANNYZj_kvLsZG3sgH+nPu9B=pqWBU785w0SGHGdQqB4UW-DtmA@mail.gmail.com

Suggested-by: Alexander Kanavin <alex.kanavin@gmail.com>
(From yocto-docs rev: 231fc9e710ab34db60263f8ae01d4f5970579203)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2025-08-01 11:59:18 +01:00
..
figures Move devtool doc from extensible to dev manual 2025-02-07 17:52:48 +00:00
bblock.rst dev-manual: bblock: use warning block instead of attention 2024-11-15 11:16:58 +00:00
bmaptool.rst dev-manual/bmaptool.rst: simplify and fix instructions 2024-12-20 12:47:59 +00:00
build-quality.rst Remove debug-tweaks references 2024-12-28 10:57:47 +00:00
building.rst dev-manual: fix broken rendering of bullet point 2025-06-30 17:44:22 +01:00
custom-distribution.rst dev-manual: update custom distribution section 2024-04-16 07:55:42 +01:00
custom-template-configuration-directory.rst dev/ref-manual: document conf-summary.txt together with conf-notes.txt 2024-03-19 15:22:27 +00:00
customizing-images.rst Remove all mention of core-image-lsb 2025-03-07 17:04:26 +00:00
debugging.rst tree-wide: make the :doc: directive use absolute paths 2025-06-20 09:48:15 +01:00
development-shell.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
device-manager.rst manuals: document VIRTUAL-RUNTIME variables 2024-03-06 16:54:54 +00:00
devtool.rst sphinx-lint: various fixes 2025-05-19 15:54:10 +01:00
disk-space.rst dev-manual: correct misspelled reference to sstate-cache-management.py 2025-06-30 17:44:22 +01:00
efficiently-fetching-sources.rst dev-manual: correct statements that source is always tarballs 2025-06-30 17:44:22 +01:00
error-reporting-tool.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
external-scm.rst Update the documentation for SRCPV 2024-12-20 12:47:59 +00:00
external-toolchain.rst manual: improve documentation about using external toolchains 2022-12-18 10:41:21 +00:00
gobject-introspection.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
index.rst Add a document on limiting host resources 2025-07-11 13:30:44 +01:00
init-manager.rst dev-manual: replace "on the contrary" with "by contrast" 2025-06-30 17:44:22 +01:00
intro.rst dev-manual: various pedantic nitpickery 2021-09-04 08:46:35 +01:00
layers.rst dev manual, CH 3: update code snippets to be more current 2025-06-30 17:44:22 +01:00
libraries.rst dev-manual: shorten bitbake.conf snippet related to static libs 2025-06-30 17:44:22 +01:00
licenses.rst dev-manual: replace WORKDIR with UNPACKDIR where appropriate 2025-06-30 17:44:21 +01:00
limiting-resources.rst Add a document on limiting host resources 2025-07-11 13:30:44 +01:00
multiconfig.rst dev-manual/multiconfig: add suggested best practices and baremetal sections 2025-02-26 14:49:28 +00:00
new-machine.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
new-recipe.rst dev-manual: update list of recipe files showing version numbers 2025-06-30 17:44:22 +01:00
packages.rst dev-manual: replace WORKDIR with UNPACKDIR where appropriate 2025-06-30 17:44:21 +01:00
prebuilt-libraries.rst dev-manual: fix rendering of ${PN} 2025-06-30 17:44:22 +01:00
python-development-shell.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
qemu.rst Fix dead links that use the DISTRO macro 2025-04-21 21:15:29 +01:00
quilt.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
read-only-rootfs.rst manuals: simplify references to classes 2023-01-06 17:39:09 +00:00
sbom.rst Add SPDX_INCLUDE_COMPILED_SOURCES documentation 2025-06-20 09:48:15 +01:00
securing-images.rst Remove debug-tweaks references 2024-12-28 10:57:47 +00:00
security-subjects.rst dev-manual: add security team processes 2023-10-30 11:11:16 +00:00
speeding-up-build.rst manuals: suppress excess use of "following" word 2024-02-24 16:13:28 +00:00
start.rst dev-manual/start.rst: remove basic setup for hash equivalence 2025-08-01 11:59:18 +01:00
temporary-source-code.rst dev-manual: replace WORKDIR with UNPACKDIR where appropriate 2025-06-30 17:44:21 +01:00
upgrading-recipes.rst sphinx-lint: unbalanced inline literal markup 2025-05-26 13:02:49 +01:00
vulnerabilities.rst tree-wide: make the :doc: directive use absolute paths 2025-06-20 09:48:15 +01:00
wayland.rst manuals: define proper numbered lists 2022-12-18 10:41:21 +00:00
wic.rst dev-manual: fix styling of references to bmaptool 2024-12-20 12:47:59 +00:00
x32-psabi.rst manuals: split dev-manual/common-tasks.rst 2022-12-01 19:20:29 +00:00