<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>15727</bug_id>
          
          <creation_ts>2025-01-25 12:15:04 +0000</creation_ts>
          <short_desc>PERSISTENT_DIR might need some additions regarding hash equivalence server</short_desc>
          <delta_ts>2025-10-31 08:43:51 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>BitBake User Manual</product>
          <component>bitbake-manual</component>
          <version>5.2</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>5.3 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Robert Berger">pokylinux</reporter>
          <assigned_to name="Antonin Godard">antonin.godard</assigned_to>
          <cc>JPEWhacker</cc>
    
    <cc>randy.macleod</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>100743</commentid>
    <comment_count>0</comment_count>
    <who name="Robert Berger">pokylinux</who>
    <bug_when>2025-01-25 12:15:04 +0000</bug_when>
    <thetext>PERSISTENT_DIR
Specifies the directory BitBake uses to store data that should be preserved between builds. In particular, the data stored is the data that uses BitBake’s persistent data API and the data used by the PR Server and PR Service.[1]

[1] https://docs.yoctoproject.org/bitbake/dev/bitbake-user-manual/bitbake-user-manual-ref-variables.html#term-PERSISTENT_DIR

If BB_HASHSERVE is set to auto, BitBake automatically starts its own hash equivalence server locally over a UNIX domain socket on demand.

In this case, in addition to prserv.sqlite3 also bb_unihashes.dat and hashserv.db are stored in PERSISTENT_DIR. So it&apos;s not just data for the PR Server and the PR Service, but also for the hash equivalence server.

It might be beneficial to share PERSISTENT_DIR between local builds.

------------

Please review and probably rephrase some things here.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>100773</commentid>
    <comment_count>1</comment_count>
    <who name="Joshua Watt">JPEWhacker</who>
    <bug_when>2025-01-30 15:38:31 +0000</bug_when>
    <thetext>PERSISTENT_DIR is not intended to be shared between multiple builders in general; otherwise please send a patch to the documents to mention that the hash equivalence data is stored here by default</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>100780</commentid>
    <comment_count>2</comment_count>
    <who name="Robert Berger">pokylinux</who>
    <bug_when>2025-01-30 16:01:39 +0000</bug_when>
    <thetext>1)

My point is, that the doc talks only about the PR Server and PR Service. The hash equivalence server&apos;s data end up there as well. And this should probably be added to the doc.

As you mention, I could add to the docs, that the hash equivalence data is stored here by default.

2) 

I currently share PERSISTENT_DIR between different builds on the same machine. Maybe I should mention, that I only run one build at a time on the same machine. What would be the potential problem, if PERSISTENT_DIR is shared between multiple local builds?

I could also add something like &quot;PERSISTENT_DIR is not intended to be shared between multiple builders in general&quot;, but curious, as I am, I would also like to add some reasons ;)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101152</commentid>
    <comment_count>3</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2025-02-18 21:17:20 +0000</bug_when>
    <thetext>Taking out of NEEDINFO since at least some work can happen to document this variable now.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101751</commentid>
    <comment_count>4</comment_count>
    <who name="Robert Berger">pokylinux</who>
    <bug_when>2025-04-24 20:09:16 +0000</bug_when>
    <thetext>As far as I can see, the documentation of PERSISTENT_DIR is still the same and I am still confused how it should be used.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>102196</commentid>
    <comment_count>5</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-06-06 07:45:00 +0000</bug_when>
    <thetext>Bulk move of bugs I am assigned to from Milestone 5.2 to 5.3M1.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>102455</commentid>
    <comment_count>6</comment_count>
    <who name="Robert Berger">pokylinux</who>
    <bug_when>2025-07-12 20:18:47 +0000</bug_when>
    <thetext>PERSISTENT_DIR should never be shared?

https://bugzilla.yoctoproject.org/show_bug.cgi?id=15921

https://lists.yoctoproject.org/g/docs/message/7316
https://lists.yoctoproject.org/g/docs/message/7317
https://lists.yoctoproject.org/g/docs/message/7318
https://lists.yoctoproject.org/g/docs/message/7319</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>103030</commentid>
    <comment_count>7</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-10-23 08:36:53 +0000</bug_when>
    <thetext>With https://git.yoctoproject.org/yocto-docs/commit/?id=0ff0233770b77f9e74f4241dfb555dac2741d8b9 the description of PERSISTENT_DIR should be complete. It is also backed up by recent hash equivalence documentation updates: https://git.yoctoproject.org/yocto-docs/commit/?id=4ff998336efdc507de1311e43bf8f4a6258c610a.

If there are no objections I will close this bug soon.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>103162</commentid>
    <comment_count>8</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-10-31 08:43:51 +0000</bug_when>
    <thetext>Moving to Resolved Fixed as per comment #7.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>