<?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>9336</bug_id>
          
          <creation_ts>2016-03-23 23:38:09 +0000</creation_ts>
          <short_desc>Clarify and update bitbake-diffsigs documentation</short_desc>
          <delta_ts>2016-05-09 14:25:15 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>2.0</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>01 April 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.1 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Randy Witt">randy.e.witt</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bogdanx.a.voiculescu</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>srifenbark</cc>
          
          <qa_contact name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>60371</commentid>
    <comment_count>0</comment_count>
    <who name="Randy Witt">randy.e.witt</who>
    <bug_when>2016-03-23 23:38:09 +0000</bug_when>
    <thetext>The https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#debugging section of the manual references using &quot;bitbake -S&quot; and &quot;bitbake-diffsigs&quot;.

I tried to follow this documentation, and the first thing I noticed was that &quot;bitbake -S&quot; doesn&apos;t work without an argument.

The second thing is that .siginfo files aren&apos;t used by bitbake-diffsigs, it uses .sigdata files.

I&apos;m not sure how to fix the documenation for sure, because I was trying to use the documentation.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60639</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-03-31 23:42:56 +0000</bug_when>
    <thetext>I talked with Richard and got some information on this.  See the http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#debugging section and let me know if this clears things up.  I added more detail about the BB command-line options and fixed the wrong file name.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60660</commentid>
    <comment_count>2</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2016-04-01 09:09:23 +0000</bug_when>
    <thetext>Scott: This needs to say &quot;Whenever a shared state package is written out into the SSTATE_DIR, so is a corresponding .siginfo file. This file contains a pickled Python database of all the metadata that went into creating the hash for a given shared state package. Whenever a stamp is written into the stamp directory STAMPS, there is also a corresponding .sigdata file containg the same data for the hash which represented the executed task.&quot;

and

&quot;There is a bitbake-diffsigs command that can process .sigdata and .siginfo files&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>60677</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-04-01 15:51:51 +0000</bug_when>
    <thetext>Hi, 

See http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#tips-and-tricks for the final.  Richard approved it so I am marking the bug RESOLVED and setting the doc flag to &quot;done.&quot;

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>62046</commentid>
    <comment_count>4</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2016-05-09 14:25:15 +0000</bug_when>
    <thetext>Information is added to manual. Marked as verified.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>