From a306250d954b50aa962f18f74fbba80c967b5319 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Wed, 9 Jul 2025 09:57:29 +0200 Subject: [PATCH] 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: 60a08db99a0562a7ff0856da2287d5339d37d239) Signed-off-by: Antonin Godard (cherry picked from commit 3954eda78f22f205cbd31857f5b0992900fe7b02) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman --- documentation/dev-manual/start.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index 798bca76ef..edeee92719 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst @@ -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.