summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-05-12 08:35:41 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-10-21 23:11:36 +0100
commitf23f27d47ee85c76e4f7b004a3ad09e1220cac4f (patch)
treedb507721a8ae1a26cb463747bbfdd55e16035fdb
parent45c4f14dcbde5b44d3e9dd600a98910a890cbee1 (diff)
downloadast2050-yocto-poky-f23f27d47ee85c76e4f7b004a3ad09e1220cac4f.zip
ast2050-yocto-poky-f23f27d47ee85c76e4f7b004a3ad09e1220cac4f.tar.gz
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: aa01fd8d5917fac6c14f69aaa0a26200b3e67968) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/dev-manual/dev-manual-model.xml56
1 files changed, 36 insertions, 20 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index fd0d156..03eb5f1 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -491,28 +491,44 @@
changing source files.
However, if you have to do this, you make the changes to the files in the
Build Directory.</para></listitem>
- <listitem><para><emphasis>Make kernel configuration changes
- if applicable</emphasis>:
- If your situation calls for changing the kernel's configuration, you can
- use the <filename>yocto-kernel</filename> script or <filename>menuconfig</filename>
- to enable and disable kernel configurations.
- Using the script lets you interactively set up kernel configurations.
- Using <filename>menuconfig</filename> allows you to interactively develop and test the
+ <listitem><para><emphasis>Make kernel configuration changes if applicable</emphasis>:
+ If your situation calls for changing the kernel's
+ configuration, you can use
+ <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#generating-configuration-files'><filename>menuconfig</filename></ulink>,
+ which allows you to interactively develop and test the
configuration changes you are making to the kernel.
- When saved, changes using <filename>menuconfig</filename> update the kernel's
- <filename>.config</filename> file.
- Try to resist the temptation of directly editing the <filename>.config</filename>
- file found in the Build Directory at
- <filename>tmp/sysroots/&lt;machine-name&gt;/kernel</filename>.
- Doing so, can produce unexpected results when the OpenEmbedded build system
- regenerates the configuration file.</para>
- <para>Once you are satisfied with the configuration changes made using
- <filename>menuconfig</filename>, you can directly compare the
- <filename>.config</filename> file against a saved original and gather those
- changes into a config fragment to be referenced from within the kernel's
- <filename>.bbappend</filename> file.</para></listitem>
+ Saving changes you make with
+ <filename>menuconfig</filename> updates
+ the kernel's <filename>.config</filename> file.
+ <note><title>Warning</title>
+ Try to resist the temptation to directly edit an
+ existing <filename>.config</filename> file, which is
+ found in the Build Directory at
+ <filename>tmp/sysroots/<replaceable>machine-name</replaceable>/kernel</filename>.
+ Doing so, can produce unexpected results when the
+ OpenEmbedded build system regenerates the configuration
+ file.
+ </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>:
- Rebuilding the kernel image applies your changes.</para></listitem>
+ Rebuilding the kernel image applies your changes.
+ </para></listitem>
</orderedlist>
</para>
</section>
OpenPOWER on IntegriCloud