From ea4ca5422a5aee50142f2b98d5f171c302c0f7d8 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Wed, 9 Jul 2025 09:57:28 +0200 Subject: ref-manual/structure.rst: update with info on PERSISTENT_DIR Since we mention that SSTATE_DIR can be shared for multiple builds, also mention that PERSISTENT_DIR should be shared alongside SSTATE_DIR. [YOCTO #15921] (From yocto-docs rev: b2774467ed327baeddcc9161fe7ffee797f9158d) Signed-off-by: Antonin Godard (cherry picked from commit 741aa29898dc7f34ebd423ff7565334b2c89e18c) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman --- documentation/ref-manual/structure.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'documentation') diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index 2190f5b90e..58ca97ba55 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst @@ -246,7 +246,8 @@ section in the Yocto Project Development Tasks Manual. ---------------- This directory contains several internal files used by the OpenEmbedded -build system. +build system. The path to this directory is defined by the +:term:`PERSISTENT_DIR` variable. It also contains ``sanity_info``, a text file keeping track of important build information such as the values of :term:`TMPDIR`, :term:`SSTATE_DIR`, @@ -364,6 +365,13 @@ directory for multiple builds or move the directory to another location. You can control the location of this directory through the :term:`SSTATE_DIR` variable. +.. note:: + + If you are sharing the :term:`SSTATE_DIR` directory for multiple builds and + you are using a :ref:`overview-manual/concepts:Hash Equivalence` server with + :term:`BB_HASHSERVE` you should also share the :term:`PERSISTENT_DIR` + directory. See :ref:`structure-build-cache` below. + .. _structure-build-tmp: ``build/tmp/`` @@ -403,6 +411,10 @@ modification time (mtime) changes and hashing of file contents. If no changes to the file are detected, then the parsed result stored in the cache is reused. If the file has changed, it is reparsed. +This directory and the :term:`SSTATE_DIR` directory can be shared for multiple +builds when using a :ref:`overview-manual/concepts:Hash Equivalence` server +with :term:`BB_HASHSERVE`. + .. _structure-build-tmp-deploy: ``build/tmp/deploy/`` -- cgit v1.2.3-54-g00ecf