From 431ceaea6c7786df0b78bf441752229515ac5f0d Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 30 Jun 2017 14:51:55 -0700 Subject: kernel-dev, dev-manual: Moved Kernel workflow section to kernel-dev Fixes [YOCTO #11630] The overview section of modifying the kernel needed to be in the kernel-dev manual and not in the dev-manual. I moved it and took care of all the links and external references throughout the YP doc set. One figure was involved that had to be moved to the figures folder in kernel-dev from dev-manual. That is why the Makefile had to be edited. (From yocto-docs rev: 3a704b64544678785b883f82d6e82aedac6790c5) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-model.xml | 147 -------------------------- 1 file changed, 147 deletions(-) (limited to 'documentation/dev-manual/dev-manual-model.xml') diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 0055bccfed..b1b5efa82c 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml @@ -41,153 +41,6 @@ -
- System Development Workflow - - - System development involves modification or creation of an image that you want to run on - a specific hardware target. - Usually, when you want to create an image that runs on embedded hardware, the image does - not require the same number of features that a full-fledged Linux distribution provides. - Thus, you can create a much smaller image that is designed to use only the - features for your particular hardware. - - - - To help you understand how system development works in the Yocto Project, this section - covers two types of image development: BSP creation and kernel modification or - configuration. - - -
- <anchor id='kernel-spot' />Modifying the Kernel - - - Kernel modification involves changing the Yocto Project kernel, which could involve changing - configuration options as well as adding new kernel recipes. - Configuration changes can be added in the form of configuration fragments, while recipe - modification comes through the kernel's recipes-kernel area - in a kernel layer you create. - - - - The remainder of this section presents a high-level overview of the Yocto Project - kernel architecture and the steps to modify the kernel. - You can reference the - "Patching the Kernel" section - for an example that changes the source code of the kernel. - For information on how to configure the kernel, see the - "Configuring the Kernel" section. - For more information on the kernel and on modifying the kernel, see the - Yocto Project Linux Kernel Development Manual. - - -
- Kernel Modification Workflow - - - This illustration and the following list summarizes the kernel modification general workflow. - - - - - - - - - Set up your host development system to support - development using the Yocto Project: See - "The Linux Distribution" and - "The Build Host Packages" sections both - in the Yocto Project Quick Start for requirements. - Establish a local copy of project files on your - system: Having the - Source Directory - on your system gives you access to the build process and tools - you need. - For information on how to get these files, see the - "Cloning the poky Repository" - section. - - Establish the temporary kernel source files: - Temporary kernel source files are kept in the - Build Directory - created by the - OpenEmbedded build system when you run BitBake. - If you have never built the kernel in which you are - interested, you need to run an initial build to - establish local kernel source files. - If you are building an image for the first time, you need to get the build - environment ready by sourcing an environment setup script - (i.e. oe-init-build-env or - oe-init-build-env-memres). - You also need to be sure two key configuration files - (local.conf and bblayers.conf) - are configured appropriately. - The entire process for building an image is overviewed in the - "Building Images" - section of the Yocto Project Quick Start. - You might want to reference this information. - You can find more information on BitBake in the - BitBake User Manual. - - The build process supports several types of images to satisfy different needs. - See the "Images" chapter in - the Yocto Project Reference Manual for information on supported images. - - Make changes to the kernel source code if - applicable: Modifying the kernel does not always mean directly - changing source files. - However, if you have to do this, you make the changes to the files in the - Build Directory. - Make kernel configuration changes if applicable: - If your situation calls for changing the kernel's - configuration, you can use - menuconfig, - which allows you to interactively develop and test the - configuration changes you are making to the kernel. - Saving changes you make with - menuconfig updates - the kernel's .config file. - Warning - Try to resist the temptation to directly edit an - existing .config file, which is - found in the Build Directory among the source code - used for the build (e.g. see the workflow illustration - in the - "Kernel Modification Workflow" - section). - Doing so, can produce unexpected results when the - OpenEmbedded build system regenerates the configuration - file. - - Once you are satisfied with the configuration - changes made using menuconfig - and you have saved them, you can directly compare the - resulting .config file against an - existing original and gather those changes into a - configuration fragment file - to be referenced from within the kernel's - .bbappend file. - - Additionally, if you are working in a BSP layer - and need to modify the BSP's kernel's configuration, - you can use the - yocto-kernel - script as well as menuconfig. - The yocto-kernel script lets - you interactively set up kernel configurations. - - Rebuild the kernel image with your changes: - Rebuilding the kernel image applies your changes. - - - -
-
-
-
Modifying Source Code -- cgit v1.2.3-54-g00ecf