sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

kernel-dev, ref-manual: Edits to KBRANCH. 

Applied some edits to the areas where KBRANCH is discussed.
Clarified that setting it is not optional any longer.

(From yocto-docs rev: 4d0b2d92140d066048d9ff36453c7ea589eebe55)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-03-02 11:10:19 -08:00 committed by Richard Purdie
parent 8ced82e8b2
commit a8f21965eb
2 changed files with 19 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
documentation/kernel-dev/kernel-dev-advanced.xml
View File

@ -24,9 +24,9 @@
<title>Using Kernel Metadata in a Recipe</title>
<para>
The kernel sources in the Yocto Project contain kernel Metadata, which is
located in the <filename>meta</filename> branches of the kernel source
Git repositories.
The kernel sources in the Yocto Project contain kernel Metadata, which
is located in the <filename>meta</filename> branches of the kernel
source Git repositories.
This Metadata defines Board Support Packages (BSPs) that
correspond to definitions in linux-yocto recipes for the same BSPs.
A BSP consists of an aggregation of kernel policy and hardware-specific
@ -60,21 +60,27 @@
for more information.
</para>
<para>
Every linux-yocto style recipe must also indicate the Linux kernel
source repository branch used to build the Linux kernel.
The <ulink url='&YOCTO_DOCS_REF_URL;#var-KBRANCH'>KBRANCH</ulink>
variable must be set to indicate the branch.
<note>
You can use the <filename>KBRANCH</filename> value to define an
alternate branch typically with a machine override as follows:
<literallayout class='monospaced'>
KBRANCH_fri2 ?= "standard/fri2"
</literallayout>
</note>
</para>
<para>
The linux-yocto style recipes can optionally define the following
variables:
<literallayout class='monospaced'>
<ulink url='&YOCTO_DOCS_REF_URL;#var-KBRANCH'>KBRANCH</ulink>
<ulink url='&YOCTO_DOCS_REF_URL;#var-KERNEL_FEATURES'>KERNEL_FEATURES</ulink>
<ulink url='&YOCTO_DOCS_REF_URL;#var-LINUX_KERNEL_TYPE'>LINUX_KERNEL_TYPE</ulink>
</literallayout>
<filename>KBRANCH</filename> defines the Linux kernel source
repository's branch to use to build the Linux kernel.
You can use the value to define an alternate branch typically with a
machine override as follows:
<literallayout class='monospaced'>
KBRANCH_fri2 ?= "standard/fri2"
</literallayout>
</para>
<para>

5
documentation/ref-manual/ref-variables.xml
View File

@ -5758,10 +5758,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<glossdef>
<para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" />
A regular expression used by the build process to explicitly
identify the kernel branch that is validated, patched
identify the kernel branch that is validated, patched,
and configured during a build.
The <filename>KBRANCH</filename> variable is optional.
You can use it to trigger checks to ensure the exact kernel
You must set this variable to ensure the exact kernel
branch you want is being used by the build process.
</para>