diff options
Diffstat (limited to 'documentation/kernel-manual/kernel-concepts.xml')
-rw-r--r-- | documentation/kernel-manual/kernel-concepts.xml | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/documentation/kernel-manual/kernel-concepts.xml b/documentation/kernel-manual/kernel-concepts.xml index 830042a495..922f9b312d 100644 --- a/documentation/kernel-manual/kernel-concepts.xml +++ b/documentation/kernel-manual/kernel-concepts.xml @@ -303,6 +303,76 @@ </section> </section> + <section id='kernel-configuration'> + <title>Kernel Configuration</title> + <para> + Kernel configuration, along with kernel features, defines how a kernel image is + built. + Through configuration settings, you can customize a Linux Yocto kernel to be + specific to particular hardware. + For example, you can specify sound support or networking support. + This section describes basic concepts behind Kernel configuration within the + Yocto Project. + </para> + + <para> + WRITER NOTES: + </para> + + <para> + Explain how <filename>.config</filename> is used when the kernel image is built. + Describe the role of <filename>menuconfig</filename> regarding the + <filename>.config</filename>. + Locate the <filename>.config</filename> for the user. + Not recommended to edit the <filename>.config</filename> file directly. + You can use BitBake to build and invoke the <filename>menuconfig</filename> + tool. + </para> + + <para> + Introduce the configuration fragment. + Step through the life of a configuration fragment from idea or need to + change something in the kernel to how it is used when the kernel image is built. + Describe how configuration fragments are created and where they live. + Make sure the syntax of configuration fragments is understood. + </para> + + <para> + Talk in general how the user creates a configuration fragment. + Point to example B.2 of the YP Development Manual as a way to use + <filename>menuconfig</filename>. + </para> + + <para> + The tool <filename>menuconfig</filename> allows you to choose the features of the + Linux Yocto kernel that will be compiled. + This tool is a convenient method to alter the <filename>.config</filename> file. + You can use a simple interface to scroll through kernel features and disable + and enable configruation variables. + When you save your changes, the contents of the <filename>.config</filename> + are altered. + You can get general information on <filename>menuconfig</filename> at + <ulink url='http://en.wikipedia.org/wiki/Menuconfig'></ulink>. + </para> + + <para> + The Yocto Project employs <filename>menuconfig</filename> by invoking it through + BitBake as follows after making sure the environment setup script has been sourced: + <literallayout class='monospaced'> + $ bitbake linux-yocto -c menuconfig + </literallayout> + You can see how <filename>menuconfig</filename> is used to change a simple + kernel configuration in the + "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#changing-the-config-smp-configuration-using-menuconfig'>Changing the <filename>CONFIG_SMP</filename> + Configuration Using <filename>menuconfig</filename></ulink>" section of + The Yocto Project Development Manual. + </para> + + <para> + END WRITER NOTES + </para> + </section> + <section id='kernel-tools'> <title>Kernel Tools</title> <para> |