summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-dev/common.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/kernel-dev/common.rst')
-rw-r--r--documentation/kernel-dev/common.rst45
1 files changed, 18 insertions, 27 deletions
diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst
index 0a1819ceae..690f61110b 100644
--- a/documentation/kernel-dev/common.rst
+++ b/documentation/kernel-dev/common.rst
@@ -66,19 +66,15 @@ section:
66 (i.e. ``poky``) have been cloned using Git and the local repository is named 66 (i.e. ``poky``) have been cloned using Git and the local repository is named
67 "poky". 67 "poky".
68 68
692. *Prepare Your local.conf File:* By default, the 692. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable
70 :term:`MACHINE` variable is set to 70 is set to "qemux86-64", which is fine if you are building for the QEMU
71 "qemux86-64", which is fine if you are building for the QEMU emulator 71 emulator in 64-bit mode. However, if you are not, you need to set the
72 in 64-bit mode. However, if you are not, you need to set the
73 :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file 72 :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file
74 found in the 73 found in the :term:`Build Directory` (i.e. ``poky/build`` in this example).
75 :term:`Build Directory` (i.e.
76 ``poky/build`` in this example).
77 74
78 Also, since you are preparing to work on the kernel image, you need 75 Also, since you are preparing to work on the kernel image, you need
79 to set the 76 to set the :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` variable to include
80 :term:`MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS` 77 kernel modules.
81 variable to include kernel modules.
82 78
83 In this example we wish to build for qemux86 so we must set the 79 In this example we wish to build for qemux86 so we must set the
84 :term:`MACHINE` variable to "qemux86" and also add the "kernel-modules". 80 :term:`MACHINE` variable to "qemux86" and also add the "kernel-modules".
@@ -186,14 +182,11 @@ section:
186 (i.e. ``poky``) have been cloned using Git and the local repository is named 182 (i.e. ``poky``) have been cloned using Git and the local repository is named
187 "poky". 183 "poky".
188 184
1892. *Prepare Your local.conf File:* By default, the 1852. *Prepare Your local.conf File:* By default, the :term:`MACHINE` variable is
190 :term:`MACHINE` variable is set to 186 set to "qemux86-64", which is fine if you are building for the QEMU emulator
191 "qemux86-64", which is fine if you are building for the QEMU emulator 187 in 64-bit mode. However, if you are not, you need to set the :term:`MACHINE`
192 in 64-bit mode. However, if you are not, you need to set the 188 variable appropriately in your ``conf/local.conf`` file found in the
193 :term:`MACHINE` variable appropriately in your ``conf/local.conf`` file 189 :term:`Build Directory` (i.e. ``poky/build`` in this example).
194 found in the
195 :term:`Build Directory` (i.e.
196 ``poky/build`` in this example).
197 190
198 Also, since you are preparing to work on the kernel image, you need 191 Also, since you are preparing to work on the kernel image, you need
199 to set the 192 to set the
@@ -836,8 +829,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using \`\`devtool\`\``" Se
836 829
8378. *Build the Image With Your Modified Kernel:* You can now build an 8308. *Build the Image With Your Modified Kernel:* You can now build an
838 image that includes your kernel patches. Execute the following 831 image that includes your kernel patches. Execute the following
839 command from your 832 command from your :term:`Build Directory` in the terminal
840 :term:`Build Directory` in the terminal
841 set up to run BitBake:: 833 set up to run BitBake::
842 834
843 $ cd poky/build 835 $ cd poky/build
@@ -1057,9 +1049,8 @@ To use the ``menuconfig`` tool in the Yocto Project development
1057environment, you must do the following: 1049environment, you must do the following:
1058 1050
1059- Because you launch ``menuconfig`` using BitBake, you must be sure to 1051- Because you launch ``menuconfig`` using BitBake, you must be sure to
1060 set up your environment by running the 1052 set up your environment by running the :ref:`structure-core-script` script
1061 :ref:`structure-core-script` script found in 1053 found in the :term:`Build Directory`.
1062 the :term:`Build Directory`.
1063 1054
1064- You must be sure of the state of your build's configuration in the 1055- You must be sure of the state of your build's configuration in the
1065 :term:`Source Directory`. 1056 :term:`Source Directory`.
@@ -1111,10 +1102,10 @@ can find the option under "Processor Type and Features". To deselect
1111Multi-Processing Support" and enter "N" to clear the asterisk. When you 1102Multi-Processing Support" and enter "N" to clear the asterisk. When you
1112are finished, exit out and save the change. 1103are finished, exit out and save the change.
1113 1104
1114Saving the selections updates the ``.config`` configuration file. This 1105Saving the selections updates the ``.config`` configuration file. This is the
1115is the file that the OpenEmbedded build system uses to configure the 1106file that the OpenEmbedded build system uses to configure the kernel during
1116kernel during the build. You can find and examine this file in the Build 1107the build. You can find and examine this file in the :term:`Build Directory`
1117Directory in ``tmp/work/``. The actual ``.config`` is located in the 1108in ``tmp/work/``. The actual ``.config`` is located in the
1118area where the specific kernel is built. For example, if you were 1109area where the specific kernel is built. For example, if you were
1119building a Linux Yocto kernel based on the ``linux-yocto-4.12`` kernel 1110building a Linux Yocto kernel based on the ``linux-yocto-4.12`` kernel
1120and you were building a QEMU image targeted for ``x86`` architecture, 1111and you were building a QEMU image targeted for ``x86`` architecture,