dev-manual/start.rst: mention that PERSISTENT_DIR should be shared too

In the "Development environment summary", we mention that the shared
state dir can be shared for developers, but PERSISTENT_DIR should be
shared as well, otherwise bugs described in [1] can happen.

[1]: https://bugzilla.yoctoproject.org/show_bug.cgi?id=15921

[YOCTO #15921]

(From yocto-docs rev: 3954eda78f22f205cbd31857f5b0992900fe7b02)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Antonin Godard 2025-07-09 09:57:29 +02:00 committed by Richard Purdie
parent e790ad0f3e
commit 1eab7980ae

View File

@ -228,6 +228,11 @@ particular working environment and set of practices.
used by developers in the same organization and share the same used by developers in the same organization and share the same
source directories on their machines. source directories on their machines.
If the :term:`SSTATE_DIR` directory is shared for multiple developers,
and you are using a :ref:`overview-manual/concepts:Hash Equivalence`
server with :term:`BB_HASHSERVE`, the :term:`PERSISTENT_DIR` directory
(``${TOPDIR}/cache`` by default) should be shared too.
- Set up an Autobuilder and have it populate the sstate cache and - Set up an Autobuilder and have it populate the sstate cache and
source directories. source directories.