Re: [docs] [PATCH v2] dev-manual: disk-space: mention faster "find" command to trim sstate cache

[Richard Purdie <richard.purdie@linuxfoundation.org>]

On Thu, 2023-08-17 at 16:15 +0200, Michael Opdenacker via
lists.yoctoproject.org wrote:
> From: Michael Opdenacker <michael.opdenacker@bootlin.com>
> 
> [YOCTO #15182]
> 
> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
> Reported-by: Yoann CONGAL <yoann.congal@smile.fr>
> Reported-by: Randy MacLeod <randy.macleod@windriver.com>
> Reported-by: Josef Holzmayr <jester@theyoctojester.info>
> 
> ---
> 
> - Changes in V2:
>   - Using a more universal "-mtime" option to find files to remove
>     as suggested by Richard Purdie. V1 was using "-atime" which
>     won't work with systems mounted with the "noatime" option used
>     to increase disk performance.
>   - Add more details about sstate-cache-management.sh provided by
>     Richard Purdie, perhaps not recommended but useful to document
>     as long as it is shipped in OE-core.
> ---
>  documentation/dev-manual/disk-space.rst | 31 ++++++++++++++++++-------
>  1 file changed, 22 insertions(+), 9 deletions(-)
> 
> diff --git a/documentation/dev-manual/disk-space.rst b/documentation/dev-manual/disk-space.rst
> index c63591cc7a..01cdf911c4 100644
> --- a/documentation/dev-manual/disk-space.rst
> +++ b/documentation/dev-manual/disk-space.rst
> @@ -27,19 +27,32 @@ Purging Duplicate Shared State Cache Files
>  ==========================================
>  
>  After multiple build iterations, the Shared State (sstate) cache can contain
> -duplicate cache files for a given package, while only the most recent one
> -is likely to be reusable. The following command purges all but the
> -newest sstate cache file for each package::
> +duplicate cache files for a given package, consuming a substantial amount of
> +disk space. However, only the most recent cache files are likeky to be reusable.
>  
> -   sstate-cache-management.sh --remove-duplicated --cache-dir=build/sstate-cache
> +The following command is a quick way to purge all the cache files which
> +haven't been used for a least a specified number of days::
>  
> -This command will ask you to confirm the deletions it identifies.
> +   find build/sstate-cache -type f -mtime +$DAYS -delete
>  
> -.. note::
> +The above command relies on the fact that BitBake touches the sstate cache
> +files as it accesses them, when it has write access to the cache.

Add "You could use -atime instead if the partition isn't mounted with
the noatime option for a read only cache."

?

Otherwise looks good thanks.

Cheers,

Richard