mirror of
git://git.yoctoproject.org/poky.git
synced 2025-07-19 12:39:02 +02:00

Since commit f6d963fa6d
("kernel: make kernel-base recommend
kernel-image, not depend"), present in Kirkstone 4.0, one should
set RRECOMMENDS and not RDEPENDS to avoid including the kernel in the
image, so let's update the documentation to reflect that.
Reported-by: Konstantin Kletschke <konstantin.kletschke@inside-m2m.de>
Cc: Quentin Schulz <foss+yocto@0leil.net>
(From yocto-docs rev: 7806a5d7ee986b92d4b8e438b14c18759e4421e5)
Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
77 lines
2.5 KiB
ReStructuredText
77 lines
2.5 KiB
ReStructuredText
.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
|
|
|
|
**********************
|
|
Kernel Development FAQ
|
|
**********************
|
|
|
|
Common Questions and Solutions
|
|
==============================
|
|
|
|
Here are some solutions for common questions.
|
|
|
|
How do I use my own Linux kernel ``.config`` file?
|
|
--------------------------------------------------
|
|
|
|
Refer to the
|
|
":ref:`kernel-dev/common:changing the configuration`"
|
|
section for information.
|
|
|
|
How do I create configuration fragments?
|
|
----------------------------------------
|
|
|
|
A: Refer to the
|
|
":ref:`kernel-dev/common:creating configuration fragments`"
|
|
section for information.
|
|
|
|
How do I use my own Linux kernel sources?
|
|
-----------------------------------------
|
|
|
|
Refer to the
|
|
":ref:`kernel-dev/common:working with your own sources`"
|
|
section for information.
|
|
|
|
How do I install/not-install the kernel image on the root filesystem?
|
|
---------------------------------------------------------------------
|
|
|
|
The kernel image (e.g. ``vmlinuz``) is provided by the
|
|
``kernel-image`` package. Image recipes depend on ``kernel-base``. To
|
|
specify whether or not the kernel image is installed in the generated
|
|
root filesystem, override ``RRECOMMENDS:${KERNEL_PACKAGE_NAME}-base`` to include or not
|
|
include "kernel-image". See the
|
|
":ref:`dev-manual/layers:appending other layers metadata with your layer`"
|
|
section in the
|
|
Yocto Project Development Tasks Manual for information on how to use an
|
|
append file to override metadata.
|
|
|
|
How do I install a specific kernel module?
|
|
------------------------------------------
|
|
|
|
Linux kernel modules are packaged individually. To ensure a
|
|
specific kernel module is included in an image, include it in the
|
|
appropriate machine :term:`RRECOMMENDS` variable.
|
|
These other variables are useful for installing specific modules:
|
|
- :term:`MACHINE_ESSENTIAL_EXTRA_RDEPENDS`
|
|
- :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS`
|
|
- :term:`MACHINE_EXTRA_RDEPENDS`
|
|
- :term:`MACHINE_EXTRA_RRECOMMENDS`
|
|
|
|
For example, set the following in the ``qemux86.conf`` file to include
|
|
the ``ab123`` kernel modules with images built for the ``qemux86``
|
|
machine::
|
|
|
|
MACHINE_EXTRA_RRECOMMENDS += "kernel-module-ab123"
|
|
|
|
For more information, see the
|
|
":ref:`kernel-dev/common:incorporating out-of-tree modules`" section.
|
|
|
|
How do I change the Linux kernel command line?
|
|
----------------------------------------------
|
|
|
|
The Linux kernel command line is
|
|
typically specified in the machine config using the :term:`APPEND` variable.
|
|
For example, you can add some helpful debug information doing the
|
|
following::
|
|
|
|
APPEND += "printk.time=y initcall_debug debug"
|
|
|