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.rst47
1 files changed, 23 insertions, 24 deletions
diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst
index 58adcc9b70..0e545d1b89 100644
--- a/documentation/kernel-dev/common.rst
+++ b/documentation/kernel-dev/common.rst
@@ -57,7 +57,7 @@ section:
57 the build environment script (i.e. :ref:`structure-core-script`): 57 the build environment script (i.e. :ref:`structure-core-script`):
58 :: 58 ::
59 59
60 $ cd ~/poky 60 $ cd poky
61 $ source oe-init-build-env 61 $ source oe-init-build-env
62 62
63 .. note:: 63 .. note::
@@ -74,7 +74,7 @@ section:
74 ``MACHINE`` variable appropriately in your ``conf/local.conf`` file 74 ``MACHINE`` variable appropriately in your ``conf/local.conf`` file
75 found in the 75 found in the
76 :term:`Build Directory` (i.e. 76 :term:`Build Directory` (i.e.
77 ``~/poky/build`` in this example). 77 ``poky/build`` in this example).
78 78
79 Also, since you are preparing to work on the kernel image, you need 79 Also, since you are preparing to work on the kernel image, you need
80 to set the 80 to set the
@@ -94,7 +94,7 @@ section:
94 ``bitbake-layers create-layer`` command as follows: 94 ``bitbake-layers create-layer`` command as follows:
95 :: 95 ::
96 96
97 $ cd ~/poky/build 97 $ cd poky/build
98 $ bitbake-layers create-layer ../../meta-mylayer 98 $ bitbake-layers create-layer ../../meta-mylayer
99 NOTE: Starting bitbake server... 99 NOTE: Starting bitbake server...
100 Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' 100 Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer'
@@ -119,7 +119,7 @@ section:
119 ``bblayers.conf`` file as follows: 119 ``bblayers.conf`` file as follows:
120 :: 120 ::
121 121
122 $ cd ~/poky/build 122 $ cd poky/build
123 $ bitbake-layers add-layer ../../meta-mylayer 123 $ bitbake-layers add-layer ../../meta-mylayer
124 NOTE: Starting bitbake server... 124 NOTE: Starting bitbake server...
125 $ 125 $
@@ -128,7 +128,7 @@ section:
128 specifically for use with images to be run using QEMU: 128 specifically for use with images to be run using QEMU:
129 :: 129 ::
130 130
131 $ cd ~/poky/build 131 $ cd poky/build
132 $ bitbake core-image-minimal -c populate_sdk_ext 132 $ bitbake core-image-minimal -c populate_sdk_ext
133 133
134 Once 134 Once
@@ -136,21 +136,21 @@ section:
136 ``*.sh`` file) in the following directory: 136 ``*.sh`` file) in the following directory:
137 :: 137 ::
138 138
139 ~/poky/build/tmp/deploy/sdk 139 poky/build/tmp/deploy/sdk
140 140
141 For this example, the installer file is named 141 For this example, the installer file is named
142 ``poky-glibc-x86_64-core-image-minimal-i586-toolchain-ext-&DISTRO;.sh``. 142 ``poky-glibc-x86_64-core-image-minimal-i586-toolchain-ext-&DISTRO;.sh``.
143 143
1446. *Install the Extensible SDK:* Use the following command to install 1446. *Install the Extensible SDK:* Use the following command to install
145 the SDK. For this example, install the SDK in the default 145 the SDK. For this example, install the SDK in the default
146 ``~/poky_sdk`` directory: 146 ``poky_sdk`` directory:
147 :: 147 ::
148 148
149 $ cd ~/poky/build/tmp/deploy/sdk 149 $ cd poky/build/tmp/deploy/sdk
150 $ ./poky-glibc-x86_64-core-image-minimal-i586-toolchain-ext-&DISTRO;.sh 150 $ ./poky-glibc-x86_64-core-image-minimal-i586-toolchain-ext-&DISTRO;.sh
151 Poky (Yocto Project Reference Distro) Extensible SDK installer version &DISTRO; 151 Poky (Yocto Project Reference Distro) Extensible SDK installer version &DISTRO;
152 ============================================================================ 152 ============================================================================
153 Enter target directory for SDK (default: ~/poky_sdk): 153 Enter target directory for SDK (default: poky_sdk):
154 You are about to install the SDK to "/home/scottrif/poky_sdk". Proceed [Y/n]? Y 154 You are about to install the SDK to "/home/scottrif/poky_sdk". Proceed [Y/n]? Y
155 Extracting SDK......................................done 155 Extracting SDK......................................done
156 Setting it up... 156 Setting it up...
@@ -175,7 +175,7 @@ section:
175 directed by the output from installing the SDK: 175 directed by the output from installing the SDK:
176 :: 176 ::
177 177
178 $ source ~/poky_sdk/environment-setup-i586-poky-linux 178 $ source poky_sdk/environment-setup-i586-poky-linux
179 "SDK environment now set up; additionally you may now run devtool to perform development tasks. 179 "SDK environment now set up; additionally you may now run devtool to perform development tasks.
180 Run devtool --help for further details. 180 Run devtool --help for further details.
181 181
@@ -240,7 +240,7 @@ section:
240 section in the Yocto Project Development Tasks Manual. 240 section in the Yocto Project Development Tasks Manual.
241 :: 241 ::
242 242
243 $ cd ~/poky 243 $ cd poky
244 $ git branch 244 $ git branch
245 master 245 master
246 * &DISTRO_NAME_NO_CAP; 246 * &DISTRO_NAME_NO_CAP;
@@ -260,7 +260,7 @@ section:
260 ``MACHINE`` variable appropriately in your ``conf/local.conf`` file 260 ``MACHINE`` variable appropriately in your ``conf/local.conf`` file
261 found in the 261 found in the
262 :term:`Build Directory` (i.e. 262 :term:`Build Directory` (i.e.
263 ``~/poky/build`` in this example). 263 ``poky/build`` in this example).
264 264
265 Also, since you are preparing to work on the kernel image, you need 265 Also, since you are preparing to work on the kernel image, you need
266 to set the 266 to set the
@@ -280,7 +280,7 @@ section:
280 ``bitbake-layers create-layer`` command as follows: 280 ``bitbake-layers create-layer`` command as follows:
281 :: 281 ::
282 282
283 $ cd ~/poky/build 283 $ cd poky/build
284 $ bitbake-layers create-layer ../../meta-mylayer 284 $ bitbake-layers create-layer ../../meta-mylayer
285 NOTE: Starting bitbake server... 285 NOTE: Starting bitbake server...
286 Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer' 286 Add your new layer with 'bitbake-layers add-layer ../../meta-mylayer'
@@ -304,7 +304,7 @@ section:
304 ``bblayers.conf`` file as follows: 304 ``bblayers.conf`` file as follows:
305 :: 305 ::
306 306
307 $ cd ~/poky/build 307 $ cd poky/build
308 $ bitbake-layers add-layer ../../meta-mylayer 308 $ bitbake-layers add-layer ../../meta-mylayer
309 NOTE: Starting bitbake server ... 309 NOTE: Starting bitbake server ...
310 $ 310 $
@@ -398,7 +398,6 @@ home directory:
3981. *Create Structure*: Create the layer's structure: 3981. *Create Structure*: Create the layer's structure:
399 :: 399 ::
400 400
401 $ cd $HOME
402 $ mkdir meta-mylayer 401 $ mkdir meta-mylayer
403 $ mkdir meta-mylayer/conf 402 $ mkdir meta-mylayer/conf
404 $ mkdir meta-mylayer/recipes-kernel 403 $ mkdir meta-mylayer/recipes-kernel
@@ -819,12 +818,12 @@ the ":ref:`kernel-dev/common:getting ready to develop using \`\`devtool\`\``" Se
819 818
820 1. *Change the working directory*: In the previous step, the output 819 1. *Change the working directory*: In the previous step, the output
821 noted where you can find the source files (e.g. 820 noted where you can find the source files (e.g.
822 ``~/poky_sdk/workspace/sources/linux-yocto``). Change to where the 821 ``poky_sdk/workspace/sources/linux-yocto``). Change to where the
823 kernel source code is before making your edits to the 822 kernel source code is before making your edits to the
824 ``calibrate.c`` file: 823 ``calibrate.c`` file:
825 :: 824 ::
826 825
827 $ cd ~/poky_sdk/workspace/sources/linux-yocto 826 $ cd poky_sdk/workspace/sources/linux-yocto
828 827
829 2. *Edit the source file*: Edit the ``init/calibrate.c`` file to have 828 2. *Edit the source file*: Edit the ``init/calibrate.c`` file to have
830 the following changes: 829 the following changes:
@@ -896,7 +895,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using \`\`devtool\`\``" Se
896 and use these Git commands to stage and commit your changes: 895 and use these Git commands to stage and commit your changes:
897 :: 896 ::
898 897
899 $ cd ~/poky_sdk/workspace/sources/linux-yocto 898 $ cd poky_sdk/workspace/sources/linux-yocto
900 $ git status 899 $ git status
901 $ git add init/calibrate.c 900 $ git add init/calibrate.c
902 $ git commit -m "calibrate: Add printk example" 901 $ git commit -m "calibrate: Add printk example"
@@ -926,7 +925,7 @@ the ":ref:`kernel-dev/common:getting ready to develop using \`\`devtool\`\``" Se
926 set up to run BitBake: 925 set up to run BitBake:
927 :: 926 ::
928 927
929 $ cd ~/poky/build 928 $ cd poky/build
930 $ bitbake core-image-minimal 929 $ bitbake core-image-minimal
931 930
932Using Traditional Kernel Development to Patch the Kernel 931Using Traditional Kernel Development to Patch the Kernel
@@ -1015,7 +1014,7 @@ Section.
1015 to the following to your ``local.conf``: 1014 to the following to your ``local.conf``:
1016 :: 1015 ::
1017 1016
1018 $ cd ~/poky/build/conf 1017 $ cd poky/build/conf
1019 1018
1020 Add the following to the ``local.conf``: 1019 Add the following to the ``local.conf``:
1021 :: 1020 ::
@@ -1037,7 +1036,7 @@ Section.
1037 you can now use BitBake to build the image: 1036 you can now use BitBake to build the image:
1038 :: 1037 ::
1039 1038
1040 $ cd ~/poky/build 1039 $ cd poky/build
1041 $ bitbake core-image-minimal 1040 $ bitbake core-image-minimal
1042 1041
10435. *Boot the image*: Boot the modified image in the QEMU emulator using 10425. *Boot the image*: Boot the modified image in the QEMU emulator using
@@ -1045,7 +1044,7 @@ Section.
1045 with no password: 1044 with no password:
1046 :: 1045 ::
1047 1046
1048 $ cd ~/poky/build 1047 $ cd poky/build
1049 $ runqemu qemux86 1048 $ runqemu qemux86
1050 1049
10516. *Look for Your Changes:* As QEMU booted, you might have seen your 10506. *Look for Your Changes:* As QEMU booted, you might have seen your
@@ -1119,7 +1118,7 @@ Section.
1119 the following sequence of commands: 1118 the following sequence of commands:
1120 :: 1119 ::
1121 1120
1122 $ cd ~/poky/build 1121 $ cd poky/build
1123 $ bitbake -c cleanall yocto-linux 1122 $ bitbake -c cleanall yocto-linux
1124 $ bitbake core-image-minimal -c cleanall 1123 $ bitbake core-image-minimal -c cleanall
1125 $ bitbake core-image-minimal 1124 $ bitbake core-image-minimal
@@ -1172,7 +1171,7 @@ environment, you must do the following:
1172The following commands initialize the BitBake environment, run the 1171The following commands initialize the BitBake environment, run the
1173:ref:`ref-tasks-kernel_configme` 1172:ref:`ref-tasks-kernel_configme`
1174task, and launch ``menuconfig``. These commands assume the Source 1173task, and launch ``menuconfig``. These commands assume the Source
1175Directory's top-level folder is ``~/poky``: 1174Directory's top-level folder is ``poky``:
1176:: 1175::
1177 1176
1178 $ cd poky 1177 $ cd poky