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
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
source directories.