<?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>10717</bug_id>
          
          <creation_ts>2016-11-23 21:44:52 +0000</creation_ts>
          <short_desc>KERNEL_IMAGE_BASE_NAME: morty definition does not match poky&apos;s code</short_desc>
          <delta_ts>2017-04-07 16:39:12 +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.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>31 Jan 2017: NEEDINFO</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.3 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Joe Konno">joe.konno</reporter>
          <assigned_to name="Joe Konno">joe.konno</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</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>68559</commentid>
    <comment_count>0</comment_count>
    <who name="Joe Konno">joe.konno</who>
    <bug_when>2016-11-23 21:44:52 +0000</bug_when>
    <thetext>See: http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-KERNEL_IMAGE_BASE_NAME

In the Morty/2.2 release, there were changes make to poky (kernel.bbclass), to KERNEL_IMAGE_BASE_NAME and the handling thereof, that don&apos;t match up with the reference guide for Morty. Specifically by KERNEL_IMAGE_BASE_NAME, but I&apos;ll let those more knowledgeable speak to greater impact of those changes (if there are any).

With commit 0437a59e3c29 (&quot;kernel: Add KERNEL_IMAGETYPES to build multi types kernel at one time&quot;), handling for building multiple kernel image types was added. This new feature effectively changed the definition and application of KERNEL_IMAGE_BASE_NAME (and at least one other var):

-KERNEL_IMAGE_BASE_NAME ?= &quot;${KERNEL_IMAGETYPE}-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}&quot;                                             
+KERNEL_IMAGE_BASE_NAME ?= &quot;${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}&quot;

As of this change, the Morty documentation is no longer accurate for the variable.

I maintain a local bitbake recipe for the kernel, which copies the kernel config to DEPLOYDIR. My do_deploy changes, which had worked for krogoth, became problematic because of:

  KERNEL_IMAGE_BASE_NAME=&quot;-4.9-rc6+gitAUTOINC+&lt;...snip...&gt;&quot;

instead of what I expected per the documentation, which ought to be:

  KERNEL_IMAGE_BASE_NAME=&quot;bzImage--4.9-rc6+gitAUTOINC+&lt;...snip...&gt;&quot;

Inspecting the code, I do have a work-around. I had to re-use this pattern, adapted to my purposes:

&lt;snip&gt;
    install -m 0644 ${KERNEL_OUTPUT} ${DEPLOYDIR}/${KERNEL_IMAGE_BASE_NAME}.bin                                                         
    for type in ${KERNEL_IMAGETYPES} ; do                                                                                               
        base_name=${type}-${KERNEL_IMAGE_BASE_NAME}                                                                                 
        install -m 0644 ${KERNEL_OUTPUT_DIR}/${type} ${DEPLOYDIR}/${base_name}.bin                                                  
    done
&lt;/snip&gt;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68669</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-11-29 03:01:35 +0000</bug_when>
    <thetext>Hi Joe, 

So I have made updates to two places: the variable description itself and the migration section.  

See http://www.yoctoproject.org/docs/2.3/ref-manual/ref-manual.html#var-KERNEL_IMAGE_BASE_NAME for the variable description change.

See http://www.yoctoproject.org/docs/2.3/ref-manual/ref-manual.html#migration-2.2-kernel-image-base-name-no-longer-uses-kernel-imagetype for the new entry in the migration section.

The above changes are in the master branch of the yocto-docs repository.  I will back port them into the yocto-docs/morty branch so that they are on the tip of that development branch for the documentation.  You can see the changes there using the same two URLs above except with &quot;2.2&quot; as part of the URL and not &quot;2.3&quot;.

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>70290</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-01-31 16:33:28 +0000</bug_when>
    <thetext>Needs review.  I moved to 2.3 M3.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>71771</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-03-27 19:43:13 +0000</bug_when>
    <thetext>Moved to 2.3 M4... still needs a review.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72047</commentid>
    <comment_count>4</comment_count>
    <who name="Joe Konno">joe.konno</who>
    <bug_when>2017-04-03 19:57:10 +0000</bug_when>
    <thetext>Thanks Scott. Looks good to me. I&apos;ll go ahead and &quot;resolve&quot; this-- I&apos;ll let someone more deeply invested in Yocto &quot;close&quot; this, if it looks good to them.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72048</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-04-03 20:20:13 +0000</bug_when>
    <thetext>Joe, 

Thanks for marking it RESOLVED after looking the fix.  I am going to put the doc flag to &quot;Done&quot; for the bug. 

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>