summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-dev
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2017-10-02 12:59:32 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-10-06 12:06:33 +0100
commit99151aef7765d8d33d0746fbea131ad2ca1387ec (patch)
treefb51e120a8bfb44f1b62a7bf6eefc8fbe6c2e201 /documentation/kernel-dev
parent94e71dea32850cad56466130e09458c957e2bc2d (diff)
downloadpoky-99151aef7765d8d33d0746fbea131ad2ca1387ec.tar.gz
kernel-dev: Updates to "Using Kernel Metadata in a Recipe"
This section had some old emenlo examples and was a little confusing. I removed the old examples and inserted some new wordings to help smooth it out. (From yocto-docs rev: 365129e0cd37772f404d96a51eb498210e4f1ee9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-dev')
-rw-r--r--documentation/kernel-dev/kernel-dev-advanced.xml31
1 files changed, 10 insertions, 21 deletions
diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml
index 812c77547b..29052de9c1 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.xml
+++ b/documentation/kernel-dev/kernel-dev-advanced.xml
@@ -44,20 +44,18 @@
44 <title>Using Kernel Metadata in a Recipe</title> 44 <title>Using Kernel Metadata in a Recipe</title>
45 45
46 <para> 46 <para>
47 The kernel sources in the Yocto Project contain kernel Metadata, which 47 As mentioned in the introduction, the Yocto Project contains kernel
48 is located in the <filename>meta</filename> branches of the kernel 48 Metadata, which is located in the
49 source Git repositories. 49 <filename>yocto-kernel-cache</filename> Git repository.
50 This Metadata defines Board Support Packages (BSPs) that 50 This Metadata defines Board Support Packages (BSPs) that
51 correspond to definitions in linux-yocto recipes for the same BSPs. 51 correspond to definitions in linux-yocto recipes for corresponding BSPs.
52 A BSP consists of an aggregation of kernel policy and enabled 52 A BSP consists of an aggregation of kernel policy and enabled
53 hardware-specific features. 53 hardware-specific features.
54 The BSP can be influenced from within the linux-yocto recipe. 54 The BSP can be influenced from within the linux-yocto recipe.
55 <note> 55 <note>
56 Linux kernel source that contains kernel Metadata is said to be 56 A Linux kernel recipe that contains kernel Metadata (e.g.
57 "linux-yocto style" kernel source. 57 inherits from the <filename>linux-yocto.inc</filename> file)
58 A Linux kernel recipe that inherits from the 58 is said to be a "linux-yocto style" recipe.
59 <filename>linux-yocto.inc</filename> include file is said to be a
60 "linux-yocto style" recipe.
61 </note> 59 </note>
62 </para> 60 </para>
63 61
@@ -92,9 +90,9 @@
92 <note> 90 <note>
93 You can use the <filename>KBRANCH</filename> value to define an 91 You can use the <filename>KBRANCH</filename> value to define an
94 alternate branch typically with a machine override as shown here 92 alternate branch typically with a machine override as shown here
95 from the <filename>meta-emenlow</filename> layer: 93 from the <filename>meta-yocto-bsp</filename> layer:
96 <literallayout class='monospaced'> 94 <literallayout class='monospaced'>
97 KBRANCH_emenlow-noemgd = "standard/base" 95 KBRANCH_edgerouter = "standard/edgerouter"
98 </literallayout> 96 </literallayout>
99 </note> 97 </note>
100 </para> 98 </para>
@@ -133,16 +131,7 @@
133 recipe. 131 recipe.
134 The tools use the first BSP description it finds that match 132 The tools use the first BSP description it finds that match
135 both variables. 133 both variables.
136 If the tools cannot find a match, they issue a warning such as 134 If the tools cannot find a match, they issue a warning.
137 the following:
138 <literallayout class='monospaced'>
139 WARNING: Can't find any BSP hardware or required configuration fragments.
140 WARNING: Looked at meta/cfg/broken/emenlow-broken/hdw_frags.txt and
141 meta/cfg/broken/emenlow-broken/required_frags.txt in directory:
142 meta/cfg/broken/emenlow-broken
143 </literallayout>
144 In this example, <filename>KMACHINE</filename> was set to "emenlow-broken"
145 and <filename>LINUX_KERNEL_TYPE</filename> was set to "broken".
146 </para> 135 </para>
147 136
148 <para> 137 <para>