<?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>5521</bug_id>
          
          <creation_ts>2013-11-13 16:26:39 +0000</creation_ts>
          <short_desc>Document file checksums</short_desc>
          <delta_ts>2014-06-19 04:54:29 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Development Manual</product>
          <component>development</component>
          <version>unspecified</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>02 June 2014: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>1.7 M2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Paul Eggleton">bluelightning</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>sgw</cc>
    
    <cc>srifenbark</cc>
          
          
          <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>38743</commentid>
    <comment_count>0</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2013-11-13 16:26:39 +0000</bug_when>
    <thetext>It seems we don&apos;t currently document that we take a checksum of every local file mentioned in SRC_URI for a recipe, and insert those checksums into the signature for do_fetch, thus if one of those files is modified, do_fetch and all tasks that depend on it will be re-executed.

I&apos;m not sure where in the documentation this would fit in, but it might be something we can squeeze into the new &quot;creating a new recipe workflow&quot; section.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38885</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-11-18 18:13:33 +0000</bug_when>
    <thetext>Paul, 

We could also mention this in the &quot;Closer Look&quot; section where we discuss fetching source files.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>39644</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-01-02 19:52:56 +0000</bug_when>
    <thetext>Paul, 

I mention these checksums in the new &quot;Writing a New Recipe&quot; section now.  See http://www.yoctoproject.org/docs/1.6/dev-manual/dev-manual.html#new-recipe-fetching-code.  It is down towards the end of the section.

Also, in the same overall section in &quot;Licensing&quot;, there is some discussion of checksums.  See http://www.yoctoproject.org/docs/1.6/dev-manual/dev-manual.html#new-recipe-licensing.

Additionally, there is stuff in http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#usingpoky-configuring-LIC_FILES_CHKSUM.

I am not sure how much (if any of this) you would consider contributing to this bug.  Maybe you can comment on that.  I think one area that we could mention this is in the SRC_URI variable description of the glossary.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>39646</commentid>
    <comment_count>3</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2014-01-02 20:35:20 +0000</bug_when>
    <thetext>I&apos;m afraid this is not related to LIC_FILES_CHKSUM at all; these checksums are internal ones taken for local files so we can detect when they are changed and force a fetch to occur.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>39647</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-01-02 21:29:41 +0000</bug_when>
    <thetext>What about the stuff in the &quot;Writing a New Recipe&quot; section?  Don&apos;t those have to do with SRC_URI?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>39650</commentid>
    <comment_count>5</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2014-01-02 21:40:50 +0000</bug_when>
    <thetext>They do have to do with SRC_URI yes, but those explicit SRC_URI checksums are for *remote* files.

Other than that a checksum is being used, and SRC_URI is involved, this feature is not related to either SRC_URI[md5sum]/SRC_URI[sha256sum] or LIC_FILES_CHKSUM.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>39651</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-01-02 21:56:10 +0000</bug_when>
    <thetext>Okay - I will go back to square one on this.

Thanks</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>42073</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-04-01 22:36:46 +0000</bug_when>
    <thetext>Enhancement - moving to 1.7.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43704</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-02 14:21:48 +0000</bug_when>
    <thetext>Hi, 

I have inserted a brief note here to deal with how the build system uses checksums during do_fetch to re-execute stuff if a file:// listed in the SRC_URI has had its contents modified.  Paul has reviewed the note and approved.  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>44084</commentid>
    <comment_count>9</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-06-19 04:54:29 +0000</bug_when>
    <thetext>Set to M2 to get it off the lists.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>