sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Updates to kernel configuration in the "Kernel Modification Workflow" section 

This section needed some more information.  It referenced the yocto-kernel
script and menuconfig.  I added references to the appropriate areas of
YP documentation for these.  I also changed wordings to that it is
apparent that .config is created by menuconfig when changes are saved.

(From yocto-docs rev: bd1a3f6fa0268635f52bc77d9b35b5110b18a9f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-05-12 08:35:41 -06:00 committed by Richard Purdie
parent 3d2f2b6bdb
commit 64d74562a1
1 changed files with 36 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
documentation/dev-manual/dev-manual-model.xml
View File

@ -491,28 +491,44 @@
changing source files. changing source files.
However, if you have to do this, you make the changes to the files in the However, if you have to do this, you make the changes to the files in the
Build Directory.</para></listitem> Build Directory.</para></listitem>
<listitem><para><emphasis>Make kernel configuration changes <listitem><para><emphasis>Make kernel configuration changes if applicable</emphasis>:
if applicable</emphasis>: If your situation calls for changing the kernel's
If your situation calls for changing the kernel's configuration, you can configuration, you can use
use the <filename>yocto-kernel</filename> script or <filename>menuconfig</filename> <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#generating-configuration-files'><filename>menuconfig</filename></ulink>,
to enable and disable kernel configurations. which allows you to interactively develop and test the
Using the script lets you interactively set up kernel configurations.
Using <filename>menuconfig</filename> allows you to interactively develop and test the
configuration changes you are making to the kernel. configuration changes you are making to the kernel.
When saved, changes using <filename>menuconfig</filename> update the kernel's Saving changes you make with
<filename>.config</filename> file. <filename>menuconfig</filename> updates
Try to resist the temptation of directly editing the <filename>.config</filename> the kernel's <filename>.config</filename> file.
file found in the Build Directory at <note><title>Warning</title>
<filename>tmp/sysroots/&lt;machine-name&gt;/kernel</filename>. Try to resist the temptation to directly edit an
Doing so, can produce unexpected results when the OpenEmbedded build system existing <filename>.config</filename> file, which is
regenerates the configuration file.</para> found in the Build Directory at
<para>Once you are satisfied with the configuration changes made using <filename>tmp/sysroots/<replaceable>machine-name</replaceable>/kernel</filename>.
<filename>menuconfig</filename>, you can directly compare the Doing so, can produce unexpected results when the
<filename>.config</filename> file against a saved original and gather those OpenEmbedded build system regenerates the configuration
changes into a config fragment to be referenced from within the kernel's file.
<filename>.bbappend</filename> file.</para></listitem> </note>
Once you are satisfied with the configuration
changes made using <filename>menuconfig</filename>
and you have saved them, you can directly compare the
resulting <filename>.config</filename> file against an
existing original and gather those changes into a
<link linkend='creating-config-fragments'>configuration fragment file</link>
to be referenced from within the kernel's
<filename>.bbappend</filename> file.</para>
<para>Additionally, if you are working in a BSP layer
and need to modify the BSP's kernel's configuration,
you can use the
<ulink url='&YOCTO_DOCS_BSP_URL;#managing-kernel-patches-and-config-items-with-yocto-kernel'><filename>yocto-kernel</filename></ulink>
script as well as <filename>menuconfig</filename>.
The <filename>yocto-kernel</filename> script lets
you interactively set up kernel configurations.
</para></listitem>
<listitem><para><emphasis>Rebuild the kernel image with your changes</emphasis>: <listitem><para><emphasis>Rebuild the kernel image with your changes</emphasis>:
Rebuilding the kernel image applies your changes.</para></listitem> Rebuilding the kernel image applies your changes.
</para></listitem>
</orderedlist> </orderedlist>
</para> </para>
</section> </section>