summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-05-12 06:45:00 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-07-28 18:02:29 +0100
commit72169b2928524636df2e62f5382761c9546f3eb8 (patch)
tree29944cb46be2389d56e8efef79e4321af9d2e8a8
parent6e12a35e3d912f76c8ad88504b4fdf6ceaf1d6c5 (diff)
downloadpoky-72169b2928524636df2e62f5382761c9546f3eb8.tar.gz
ref-manual: Added new glossary description for KBUILD_DEFCONFIG.
(From yocto-docs rev: 4ec945a5567df4f561bc8bed679becbd3f2b9def) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/ref-manual/ref-variables.xml51
1 files changed, 51 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index e70445762f..fac6d9046b 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -6276,6 +6276,57 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
6276 </glossdef> 6276 </glossdef>
6277 </glossentry> 6277 </glossentry>
6278 6278
6279 <glossentry id='var-KBUILD_DEFCONFIG'><glossterm>KBUILD_DEFCONFIG</glossterm>
6280 <info>
6281 KBUILD_DEFCONFIG[doc] = "Specifies an "in-tree" kernel configuration file for use during a kernel build."
6282 </info>
6283 <glossdef>
6284 <para role="glossdeffirst">
6285<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
6286 When used with the
6287 <link linkend='ref-classes-kernel-yocto'><filename>kernel-yocto</filename></link>
6288 class, specifies an "in-tree" kernel configuration file
6289 for use during a kernel build.
6290 </para>
6291
6292 <para>
6293 Typically, when using a <filename>defconfig</filename> to
6294 configure a kernel during a build, you place the
6295 file in your layer in the same manner as you would
6296 patch files and configuration fragment files (i.e.
6297 "out-of-tree").
6298 However, if you want to use a <filename>defconfig</filename>
6299 file that is part of the kernel tree (i.e. "in-tree"),
6300 you can use the
6301 <filename>KBUILD_DEFCONFIG</filename> variable to point
6302 to the <filename>defconfig</filename> file.
6303 </para>
6304
6305 <para>
6306 To use the variable, set it in the append file for your
6307 kernel recipe using the following form:
6308 <literallayout class='monospaced'>
6309 KBUILD_DEFCONFIG_<link linkend='var-KMACHINE'>KMACHINE</link> ?= <replaceable>defconfig_file</replaceable>
6310 </literallayout>
6311 Here is an example from a "raspberrypi2"
6312 <filename>KMACHINE</filename> build that uses a
6313 <filename>defconfig</filename> file named
6314 "bcm2709_defconfig":
6315 <literallayout class='monospaced'>
6316 KBUILD_DEFCONFIG_raspberrypi2 = "bcm2709_defconfig"
6317 </literallayout>
6318 As an alternative, you can use the following within your
6319 append file:
6320 <literallayout class='monospaced'>
6321 KBUILD_DEFCONFIG_pn-linux-yocto ?= <replaceable>defconfig_file</replaceable>
6322 </literallayout>
6323 For more information on how to use the
6324 <filename>KBUILD_DEFCONFIG</filename> variable, see the
6325 "TBD" section.
6326 </para>
6327 </glossdef>
6328 </glossentry>
6329
6279 <glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm> 6330 <glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm>
6280 <info> 6331 <info>
6281 KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel." 6332 KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel."