summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual/concepts.rst
diff options
context:
space:
mode:
authorAntonin Godard <antonin.godard@bootlin.com>2025-07-31 15:03:56 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2025-08-08 23:41:10 +0100
commite18b593172acba38477133d64d14d27d39306b1d (patch)
treef91b56ba46e65e58c39fa01f0887ae3d1e16d36c /documentation/overview-manual/concepts.rst
parenta4d83b4986f7acc9be6f61636e31644efd6da0ee (diff)
downloadpoky-e18b593172acba38477133d64d14d27d39306b1d.tar.gz
dev-manual: add a hash equivalence server setup document
Add a small document to describe how to start a Hash Equivalence server with bitbake-hashserv, the reference server provided by BitBake. Update reference to hash equivalence in other places in the documentation to mention this document. Move the note from the concepts document to the new document, as a warning note. [YOCTO #15921] (From yocto-docs rev: 4ff998336efdc507de1311e43bf8f4a6258c610a) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual/concepts.rst')
-rw-r--r--documentation/overview-manual/concepts.rst16
1 files changed, 3 insertions, 13 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index e8569e4f53..397a8b84d0 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -2064,19 +2064,9 @@ on a Hash Equivalence server on a network, by setting::
2064 2064
2065 BB_HASHSERVE = "<HOSTNAME>:<PORT>" 2065 BB_HASHSERVE = "<HOSTNAME>:<PORT>"
2066 2066
2067.. note:: 2067Setting up a Hash Equivalence server is described in the
2068 2068:doc:`/dev-manual/hashequivserver` section of the Yocto Project Development
2069 The shared Hash Equivalence server needs to be maintained together with the 2069Tasks Manual.
2070 Shared State cache. Otherwise, the server could report Shared State hashes
2071 that only exist on specific clients.
2072
2073 We therefore recommend that one Hash Equivalence server be set up to
2074 correspond with a given Shared State cache, and to start this server
2075 in *read-only mode*, so that it doesn't store equivalences for
2076 Shared State caches that are local to clients.
2077
2078 See the :term:`BB_HASHSERVE` reference for details about starting
2079 a Hash Equivalence server.
2080 2070
2081See the `video <https://www.youtube.com/watch?v=zXEdqGS62Wc>`__ 2071See the `video <https://www.youtube.com/watch?v=zXEdqGS62Wc>`__
2082of Joshua Watt's `Hash Equivalence and Reproducible Builds 2072of Joshua Watt's `Hash Equivalence and Reproducible Builds