Message ID | 20251016-release-note-5-3-second-hunk-v1-5-20f21db1f93c@bootlin.com |
---|---|
State | New |
Headers | show |
Series | Updates for 5.3 | expand |
Hi Antonin, On 10/16/25 10:53 AM, Antonin Godard via lists.yoctoproject.org wrote: > Can be used in recipes that want to explicitly skip Ccache support when > the ccache class is enabled. > > Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de> I think this has been the case for a while already, so maybe we can backport it to other impacted branches? Thanks! Quentin
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index f10903e74..68edbc9dd 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -401,6 +401,10 @@ instead:: ASSUME_PROVIDED += "ccache-native" HOSTTOOLS += "ccache" +Recipes can also explicitly disable Ccache support even when the +:ref:`ref-classes-ccache` class is enabled, by setting the +:term:`CCACHE_DISABLE` variable to "1". + Using the :ref:`ref-classes-ccache` class can lead to unexpected side-effects. Using this class is not recommended. diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 09ea71d2f..e6b3afbfa 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -1526,6 +1526,11 @@ system and gives an overview of their function and contents. :term:`CC` The minimal command and arguments used to run the C compiler. + :term:`CCACHE_DISABLE` + When inheriting the :ref:`ref-classes-ccache` class, the + :term:`CCACHE_DISABLE` variable can be set to "1" in a recipe to disable + Ccache support. This is useful when the recipe is known to not support it. + :term:`CCLD` The minimal command and arguments used to run the linker when the C compiler is being used as the linker.
Can be used in recipes that want to explicitly skip Ccache support when the ccache class is enabled. Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> --- documentation/ref-manual/classes.rst | 4 ++++ documentation/ref-manual/variables.rst | 5 +++++ 2 files changed, 9 insertions(+)