diff options
author | Antonin Godard <antonin.godard@bootlin.com> | 2025-07-31 15:03:56 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2025-08-08 23:41:10 +0100 |
commit | e18b593172acba38477133d64d14d27d39306b1d (patch) | |
tree | f91b56ba46e65e58c39fa01f0887ae3d1e16d36c /documentation/overview-manual | |
parent | a4d83b4986f7acc9be6f61636e31644efd6da0ee (diff) | |
download | poky-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')
-rw-r--r-- | documentation/overview-manual/concepts.rst | 16 |
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:: | 2067 | Setting 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 | 2069 | Tasks 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 | ||
2081 | See the `video <https://www.youtube.com/watch?v=zXEdqGS62Wc>`__ | 2071 | See the `video <https://www.youtube.com/watch?v=zXEdqGS62Wc>`__ |
2082 | of Joshua Watt's `Hash Equivalence and Reproducible Builds | 2072 | of Joshua Watt's `Hash Equivalence and Reproducible Builds |