summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-dev/faq.rst
diff options
context:
space:
mode:
authorNicolas Dechesne <nicolas.dechesne@linaro.org>2020-12-03 22:38:39 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-12-09 12:21:27 +0000
commita0afa48859def9f6410ad1d3b1296683e14fc2b7 (patch)
tree17ffdd77f568ab53fb28f031e37dfce82e22243b /documentation/kernel-dev/faq.rst
parentaf6f5d821d39b50c3c4b45a593324346fce0d723 (diff)
downloadpoky-a0afa48859def9f6410ad1d3b1296683e14fc2b7.tar.gz
kernel-dev: remove 'kernel-dev' from filenames
All filenames duplicate the 'manual name', which is not needed, and make all references longer than they should. Rename all files to be as consise as possible, and fix all references (From yocto-docs rev: 3d7eb2c5e1d230290c97dd8e5b528086e1d8034a) Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-dev/faq.rst')
-rw-r--r--documentation/kernel-dev/faq.rst78
1 files changed, 78 insertions, 0 deletions
diff --git a/documentation/kernel-dev/faq.rst b/documentation/kernel-dev/faq.rst
new file mode 100644
index 0000000000..c2106f81e1
--- /dev/null
+++ b/documentation/kernel-dev/faq.rst
@@ -0,0 +1,78 @@
1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
2
3**********************
4Kernel Development FAQ
5**********************
6
7Common Questions and Solutions
8==============================
9
10The following lists some solutions for common questions.
11
12How do I use my own Linux kernel ``.config`` file?
13--------------------------------------------------
14
15Refer to the
16":ref:`kernel-dev/common:changing the configuration`"
17section for information.
18
19How do I create configuration fragments?
20----------------------------------------
21
22A: Refer to the
23":ref:`kernel-dev/common:creating configuration fragments`"
24section for information.
25
26How do I use my own Linux kernel sources?
27-----------------------------------------
28
29Refer to the
30":ref:`kernel-dev/common:working with your own sources`"
31section for information.
32
33How do I install/not-install the kernel image on the rootfs?
34------------------------------------------------------------
35
36The kernel image (e.g. ``vmlinuz``) is provided by the
37``kernel-image`` package. Image recipes depend on ``kernel-base``. To
38specify whether or not the kernel image is installed in the generated
39root filesystem, override ``RDEPENDS_${KERNEL_PACKAGE_NAME}-base`` to include or not
40include "kernel-image". See the
41":ref:`dev-manual/common-tasks:using .bbappend files in your layer`"
42section in the
43Yocto Project Development Tasks Manual for information on how to use an
44append file to override metadata.
45
46How do I install a specific kernel module?
47------------------------------------------
48
49Linux kernel modules are packaged individually. To ensure a
50specific kernel module is included in an image, include it in the
51appropriate machine :term:`RRECOMMENDS` variable.
52These other variables are useful for installing specific modules:
53- :term:`MACHINE_ESSENTIAL_EXTRA_RDEPENDS`
54- :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS`
55- :term:`MACHINE_EXTRA_RDEPENDS`
56- :term:`MACHINE_EXTRA_RRECOMMENDS`
57
58For example, set the following in the ``qemux86.conf`` file to include
59the ``ab123`` kernel modules with images built for the ``qemux86``
60machine:
61::
62
63 MACHINE_EXTRA_RRECOMMENDS += "kernel-module-ab123"
64
65For more information, see the
66":ref:`kernel-dev/common:incorporating out-of-tree modules`" section.
67
68How do I change the Linux kernel command line?
69----------------------------------------------
70
71The Linux kernel command line is
72typically specified in the machine config using the ``APPEND`` variable.
73For example, you can add some helpful debug information doing the
74following:
75::
76
77 APPEND += "printk.time=y initcall_debug debug"
78