diff options
Diffstat (limited to 'documentation/kernel-dev/common.rst')
| -rw-r--r-- | documentation/kernel-dev/common.rst | 47 |
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 | ||
| 144 | 6. *Install the Extensible SDK:* Use the following command to install | 144 | 6. *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: | |||
| 398 | 1. *Create Structure*: Create the layer's structure: | 398 | 1. *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 | ||
| 932 | Using Traditional Kernel Development to Patch the Kernel | 931 | Using 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 | ||
| 1043 | 5. *Boot the image*: Boot the modified image in the QEMU emulator using | 1042 | 5. *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 | ||
| 1051 | 6. *Look for Your Changes:* As QEMU booted, you might have seen your | 1050 | 6. *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: | |||
| 1172 | The following commands initialize the BitBake environment, run the | 1171 | The following commands initialize the BitBake environment, run the |
| 1173 | :ref:`ref-tasks-kernel_configme` | 1172 | :ref:`ref-tasks-kernel_configme` |
| 1174 | task, and launch ``menuconfig``. These commands assume the Source | 1173 | task, and launch ``menuconfig``. These commands assume the Source |
| 1175 | Directory's top-level folder is ``~/poky``: | 1174 | Directory's top-level folder is ``poky``: |
| 1176 | :: | 1175 | :: |
| 1177 | 1176 | ||
| 1178 | $ cd poky | 1177 | $ cd poky |
