From ac5cee5ea11c348f80a4713d90bc93244bb9da28 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 11 Jan 2013 19:47:30 -0800 Subject: kernel-dev: transitory edits. (From yocto-docs rev: 89e6335e0e9d23a6df581ccd5f55c2a7673050cf) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/kernel-dev/kernel-dev-common.xml | 72 ++------------------------ 1 file changed, 3 insertions(+), 69 deletions(-) (limited to 'documentation') diff --git a/documentation/kernel-dev/kernel-dev-common.xml b/documentation/kernel-dev/kernel-dev-common.xml index 1b19c08524..3645a5acdd 100644 --- a/documentation/kernel-dev/kernel-dev-common.xml +++ b/documentation/kernel-dev/kernel-dev-common.xml @@ -437,7 +437,7 @@ still make use of the Yocto Project Linux kernel tooling by working with your own sources. When you use your own sources, you will not be able to - leverage the existing + leverage the existing kernel Metadata and stabilization work of the linux-yocto sources. However, you will be able to manage your own Metadata in the same @@ -448,7 +448,8 @@ To help you use your own sources, the Yocto Project provides a - linux-yocto custom recipe that uses + linux-yocto custom recipe + linux-yocto-custom.bb that uses kernel.org sources and the Yocto Project Linux kernel tools for managing Metadata. You can find this recipe in the @@ -539,73 +540,6 @@ - - - Original Text: - -If you find yourself unable to work with one of the Linux kernel versions -supported by existing linux-yocto recipes, you can still make use of the Yocto -Project Linux kernel tooling while working with your own sources. You will not -be able to leverage the existing meta-data and stabilization work of the -linux-yocto sources, but you will be able to manage your own meta-data in the -same format as the linux-yocto sources which will facilitate converging with -linux-yocto on a future mutually-supported kernel version. - -The linux-yocto-custom recipe, located in the poky repository at: - - meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb - -is provided as an example recipe which uses kernel.org sources and the Yocto -Project Linux kernel tools for managing meta-data. To get started, copy this -recipe to your layer and provide it with a meaningful name, such as -linux-yocto-myproject_3.5.bb, where 3.5 is the base version of the Linux kernel -you will be working with. In the same directory, create a matching directory, -e.g. linux-yocto-myproject to store your patches and configuration files. - -Edit the following variables in the recipe as appropriate for your project: - - o SRC_URI - o LINUX_VERSION - o LINUX_VERSION_EXTENSION - o SRCREV - o PR - o PV - o COMPATIBLE_MACHINE - -The SRC_URI should be a git repository, using one of the supported git fetcher -protocols (file, git, http, etc.). The skeleton recipe provides an example -SRC_URI as a syntax reference. - -Set LINUX_VERSION to the Linux kernel version you are using, such as "3.6.3". - -LINUX_VERSION_EXTENSION is used to define the Linux kernel CONFIG_LOCALVERSION -which will be compiled in to the resulting kernel and visible via the uname -command. - -Set SRCREV to the commit ID you wish to build from. - -Treat the PR as you would the PR of any other recipe. Increment it to indicate -to the build system that the recipe has changed. - -The default PV assignment is typically adequate. It combines the LINUX_VERSION -with the SCM revision (from the SRCPV variable) and results in a string -something like: - -"3.4.11+git1+68a635bf8dfb64b02263c1ac80c948647cc76d5f_1+218bd8d2022b9852c60d32f0d770931e3cf343e2" - -While lengthy, this extra verbosity helps ensure you are building from the exact -sources you intend. - -Finally, the default COMPATIBLE_MACHINE assignment for linux-yocto-custom is set -to a regular expression matching only the empty string, "(^$)". This will -trigger an explicit build failure. You must change it to match a list of the -machines supported by your new recipe, such as "(qemux86|qemux86-64)" - -With that in place, you can continue to customize this recipe as you would the -existing linux-yocto recipes. See Section 2.2 Modifying an Existing Recipe for -details. - -
-- cgit v1.2.3-54-g00ecf