1 files changed, 257 insertions, 37 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 9b86eb85cd..48783e7021 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7024,6 +7024,70 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
            </glossdef>
        </glossentry>
+        <glossentry id='var-INITRAMFS_LINK_NAME'><glossterm>INITRAMFS_LINK_NAME</glossterm>
+            <info>
+                INITRAMFS_LINK_NAME[doc] = "The link name of the initial RAM filesystem image."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The link name of the initial RAM filesystem image.
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     INITRAMFS_LINK_NAME ?= "initramfs-${KERNEL_ARTIFACT_LINK_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variable for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-INITRAMFS_NAME'><glossterm>INITRAMFS_NAME</glossterm>
+            <info>
+                INITRAMFS_NAME[doc] = "The base name of the initial RAM filesystem image."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The base name of the initial RAM filesystem image.
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     INITRAMFS_NAME ?= "initramfs-${KERNEL_ARTIFACT_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-PKGE'><filename>PKGE</filename></link>,
+                    <link linkend='var-PKGV'><filename>PKGV</filename></link>,
+                    <link linkend='var-PKGR'><filename>PKGR</filename></link>,
+                    and
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variables for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-INITRD'><glossterm>INITRD</glossterm>
            <info>
                INITRD[doc] = "Indicates a list of filesystem images to concatenate and use as an initial RAM disk (initrd)."
@@ -7449,6 +7513,70 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
            </glossdef>
        </glossentry>
+        <glossentry id='var-KERNEL_DTB_LINK_NAME'><glossterm>KERNEL_DTB_LINK_NAME</glossterm>
+            <info>
+                KERNEL_DTB_LINK_NAME[doc] = "The link name of the kernel device tree binary (DTB)."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The link name of the kernel device tree binary (DTB).
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     KERNEL_DTB_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variable for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-KERNEL_DTB_NAME'><glossterm>KERNEL_DTB_NAME</glossterm>
+            <info>
+                KERNEL_DTB_NAME[doc] = "The base name of the kernel device tree binary (DTB)."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The base name of the kernel device tree binary (DTB).
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     KERNEL_DTB_NAME ?= "${KERNEL_ARTIFACT_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-PKGE'><filename>PKGE</filename></link>,
+                    <link linkend='var-PKGV'><filename>PKGV</filename></link>,
+                    <link linkend='var-PKGR'><filename>PKGR</filename></link>,
+                    and
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variables for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm>
            <info>
                KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel."
@@ -7513,27 +7641,55 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
            </glossdef>
        </glossentry>
-        <glossentry id='var-KERNEL_IMAGE_BASE_NAME'><glossterm>KERNEL_IMAGE_BASE_NAME</glossterm>
+        <glossentry id='var-KERNEL_FIT_LINK_NAME'><glossterm>KERNEL_FIT_LINK_NAME</glossterm>
            <info>
-                KERNEL_IMAGE_BASE_NAME[doc] = "The base name of the kernel image. Deprecated for Yocto Project 2.6 release and forward."
+                KERNEL_FIT_LINK_NAME[doc] = "The link name of the kernel flattened image tree (FIT) image."
            </info>
            <glossdef>
                <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    <note>
+                    The link name of the kernel flattened image tree (FIT) image.
-                        See the
+                    This variable is set in the
-                        <link linkend='var-KERNEL_IMAGE_NAME'><filename>KERNEL_IMAGE_NAME</filename></link>
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
-                        variable for information.
+                    file as follows:
-                        The <filename>KERNEL_IMAGE_BASE_NAME</filename>
-                        variable's name has changed for Yocto Project 2.6
-                        release and forward.
-                    </note>
-                    Prior to the 2.6 release of Yocto Project, this variable
-                    was set in the
-                    <link linkend='ref-classes-kernel'>kernel</link> class
-                    as follows:
                    <literallayout class='monospaced'>
-     KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
+     KERNEL_FIT_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variable for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-KERNEL_FIT_NAME'><glossterm>KERNEL_FIT_NAME</glossterm>
+            <info>
+                KERNEL_FIT_NAME[doc] = "The base name of the kernel flattened image tree (FIT) image."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The base name of the kernel flattened image tree (FIT) image.
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     KERNEL_FIT_NAME ?= "${KERNEL_ARTIFACT_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
                    </literallayout>
                </para>
@@ -7542,14 +7698,43 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                    <link linkend='var-PKGE'><filename>PKGE</filename></link>,
                    <link linkend='var-PKGV'><filename>PKGV</filename></link>,
                    <link linkend='var-PKGR'><filename>PKGR</filename></link>,
-                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>,
                    and
-                    <link linkend='var-DATETIME'><filename>DATETIME</filename></link>
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
                    variables for additional information.
                </para>
            </glossdef>
        </glossentry>
+        <glossentry id='var-KERNEL_IMAGE_LINK_NAME'><glossterm>KERNEL_IMAGE_LINK_NAME</glossterm>
+            <info>
+                KERNEL_IMAGE_LINK_NAME[doc] = "The link name for the kernel image."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    The link name for the kernel image.
+                    This variable is set in the
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
+                    file as follows:
+                    <literallayout class='monospaced'>
+     KERNEL_IMAGE_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variable for additional information.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-KERNEL_IMAGE_MAXSIZE'><glossterm>KERNEL_IMAGE_MAXSIZE</glossterm>
            <info>
                KERNEL_IMAGE_MAXSIZE[doc] = "The maximum allowable size in kilobytes of the kernel image file."
@@ -9028,47 +9213,82 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
            </glossdef>
        </glossentry>
-        <glossentry id='var-MODULE_IMAGE_BASE_NAME'><glossterm>MODULE_IMAGE_BASE_NAME</glossterm>
+        <glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY</glossterm>
+            <info>
+                MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    Controls creation of the <filename>modules-*.tgz</filename>
+                    file.
+                    Set this variable to "0" to disable creation of this
+                    file, which contains all of the kernel modules resulting
+                    from a kernel build.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-MODULE_TARBALL_LINK_NAME'><glossterm>MODULE_TARBALL_LINK_NAME</glossterm>
            <info>
-                MODULE_IMAGE_BASE_NAME[doc] = "The base name of the kernel modules tarball."
+                MODULE_TARBALL_LINK_NAME[doc] = "The link name of the module tarball."
            </info>
            <glossdef>
                <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    The base name of the kernel modules tarball.
+                    The link name of the module tarball.
                    This variable is set in the
-                    <link linkend='ref-classes-kernel'>kernel</link> class
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
-                    as follows:
+                    file as follows:
                    <literallayout class='monospaced'>
-     MODULE_IMAGE_BASE_NAME ?= "modules-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
+     MODULE_TARBALL_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
                    </literallayout>
                </para>
                <para>
                    See the
-                    <link linkend='var-PKGE'><filename>PKGE</filename></link>,
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
-                    <link linkend='var-PKGV'><filename>PKGV</filename></link>,
+                    variable for additional information.
-                    <link linkend='var-PKGR'><filename>PKGR</filename></link>,
-                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>,
-                    and
-                    <link linkend='var-DATETIME'><filename>DATETIME</filename></link>
-                    variables for additional information.
                </para>
            </glossdef>
        </glossentry>
-        <glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY</glossterm>
+        <glossentry id='var-MODULE_TARBALL_NAME'><glossterm>MODULE_TARBALL_NAME</glossterm>
            <info>
-                MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build."
+                MODULE_TARBALL_NAME[doc] = "The base name of the module tarball."
            </info>
            <glossdef>
                <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    Controls creation of the <filename>modules-*.tgz</filename>
+                    The base name of the module tarball.
-                    file.
+                    This variable is set in the
-                    Set this variable to "0" to disable creation of this
+                    <filename>meta/classes/kernel-artifact-names.bbclass</filename>
-                    file, which contains all of the kernel modules resulting
+                    file as follows:
-                    from a kernel build.
+                    <literallayout class='monospaced'>
+     MODULE_TARBALL_NAME ?= "${KERNEL_ARTIFACT_NAME}"
+                    </literallayout>
+                    The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
+                    variable, which is set in the same file, has the following
+                    value:
+                    <literallayout class='monospaced'>
+     KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
+                    </literallayout>
+                </para>
+                <para>
+                    See the
+                    <link linkend='var-PKGE'><filename>PKGE</filename></link>,
+                    <link linkend='var-PKGV'><filename>PKGV</filename></link>,
+                    <link linkend='var-PKGR'><filename>PKGR</filename></link>,
+                    and
+                    <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
+                    variables for additional information.
                </para>
            </glossdef>
        </glossentry>

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 9b86eb85cd..48783e7021 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml
@@ -7024,6 +7024,70 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7024	</glossdef>	7024	</glossdef>
7025	</glossentry>	7025	</glossentry>
7026		7026
		7027	<glossentry id='var-INITRAMFS_LINK_NAME'><glossterm>INITRAMFS_LINK_NAME</glossterm>
		7028	<info>
		7029	INITRAMFS_LINK_NAME[doc] = "The link name of the initial RAM filesystem image."
		7030	</info>
		7031	<glossdef>
		7032	<para role="glossdeffirst">
		7033	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7034	The link name of the initial RAM filesystem image.
		7035	This variable is set in the
		7036	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7037	file as follows:
		7038	<literallayout class='monospaced'>
		7039	INITRAMFS_LINK_NAME ?= "initramfs-${KERNEL_ARTIFACT_LINK_NAME}"
		7040	</literallayout>
		7041	The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
		7042	variable, which is set in the same file, has the following
		7043	value:
		7044	<literallayout class='monospaced'>
		7045	KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
		7046	</literallayout>
		7047	</para>
		7048
		7049	<para>
		7050	See the
		7051	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7052	variable for additional information.
		7053	</para>
		7054	</glossdef>
		7055	</glossentry>
		7056
		7057	<glossentry id='var-INITRAMFS_NAME'><glossterm>INITRAMFS_NAME</glossterm>
		7058	<info>
		7059	INITRAMFS_NAME[doc] = "The base name of the initial RAM filesystem image."
		7060	</info>
		7061	<glossdef>
		7062	<para role="glossdeffirst">
		7063	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7064	The base name of the initial RAM filesystem image.
		7065	This variable is set in the
		7066	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7067	file as follows:
		7068	<literallayout class='monospaced'>
		7069	INITRAMFS_NAME ?= "initramfs-${KERNEL_ARTIFACT_NAME}"
		7070	</literallayout>
		7071	The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
		7072	variable, which is set in the same file, has the following
		7073	value:
		7074	<literallayout class='monospaced'>
		7075	KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
		7076	</literallayout>
		7077	</para>
		7078
		7079	<para>
		7080	See the
		7081	<link linkend='var-PKGE'><filename>PKGE</filename></link>,
		7082	<link linkend='var-PKGV'><filename>PKGV</filename></link>,
		7083	<link linkend='var-PKGR'><filename>PKGR</filename></link>,
		7084	and
		7085	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7086	variables for additional information.
		7087	</para>
		7088	</glossdef>
		7089	</glossentry>
		7090
7027	<glossentry id='var-INITRD'><glossterm>INITRD</glossterm>	7091	<glossentry id='var-INITRD'><glossterm>INITRD</glossterm>
7028	<info>	7092	<info>
7029	INITRD[doc] = "Indicates a list of filesystem images to concatenate and use as an initial RAM disk (initrd)."	7093	INITRD[doc] = "Indicates a list of filesystem images to concatenate and use as an initial RAM disk (initrd)."
@@ -7449,6 +7513,70 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7449	</glossdef>	7513	</glossdef>
7450	</glossentry>	7514	</glossentry>
7451		7515
		7516	<glossentry id='var-KERNEL_DTB_LINK_NAME'><glossterm>KERNEL_DTB_LINK_NAME</glossterm>
		7517	<info>
		7518	KERNEL_DTB_LINK_NAME[doc] = "The link name of the kernel device tree binary (DTB)."
		7519	</info>
		7520	<glossdef>
		7521	<para role="glossdeffirst">
		7522	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7523	The link name of the kernel device tree binary (DTB).
		7524	This variable is set in the
		7525	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7526	file as follows:
		7527	<literallayout class='monospaced'>
		7528	KERNEL_DTB_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
		7529	</literallayout>
		7530	The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
		7531	variable, which is set in the same file, has the following
		7532	value:
		7533	<literallayout class='monospaced'>
		7534	KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
		7535	</literallayout>
		7536	</para>
		7537
		7538	<para>
		7539	See the
		7540	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7541	variable for additional information.
		7542	</para>
		7543	</glossdef>
		7544	</glossentry>
		7545
		7546	<glossentry id='var-KERNEL_DTB_NAME'><glossterm>KERNEL_DTB_NAME</glossterm>
		7547	<info>
		7548	KERNEL_DTB_NAME[doc] = "The base name of the kernel device tree binary (DTB)."
		7549	</info>
		7550	<glossdef>
		7551	<para role="glossdeffirst">
		7552	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7553	The base name of the kernel device tree binary (DTB).
		7554	This variable is set in the
		7555	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7556	file as follows:
		7557	<literallayout class='monospaced'>
		7558	KERNEL_DTB_NAME ?= "${KERNEL_ARTIFACT_NAME}"
		7559	</literallayout>
		7560	The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
		7561	variable, which is set in the same file, has the following
		7562	value:
		7563	<literallayout class='monospaced'>
		7564	KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
		7565	</literallayout>
		7566	</para>
		7567
		7568	<para>
		7569	See the
		7570	<link linkend='var-PKGE'><filename>PKGE</filename></link>,
		7571	<link linkend='var-PKGV'><filename>PKGV</filename></link>,
		7572	<link linkend='var-PKGR'><filename>PKGR</filename></link>,
		7573	and
		7574	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7575	variables for additional information.
		7576	</para>
		7577	</glossdef>
		7578	</glossentry>
		7579
7452	<glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm>	7580	<glossentry id='var-KERNEL_EXTRA_ARGS'><glossterm>KERNEL_EXTRA_ARGS</glossterm>
7453	<info>	7581	<info>
7454	KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel."	7582	KERNEL_EXTRA_ARGS[doc] = "Specifies additional make command-line arguments the OpenEmbedded build system passes on when compiling the kernel."
@@ -7513,27 +7641,55 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7513	</glossdef>	7641	</glossdef>
7514	</glossentry>	7642	</glossentry>
7515		7643
7516	<glossentry id='var-KERNEL_IMAGE_BASE_NAME'><glossterm>KERNEL_IMAGE_BASE_NAME</glossterm>	7644	<glossentry id='var-KERNEL_FIT_LINK_NAME'><glossterm>KERNEL_FIT_LINK_NAME</glossterm>
7517	<info>	7645	<info>
7518	KERNEL_IMAGE_BASE_NAME[doc] = "The base name of the kernel image. Deprecated for Yocto Project 2.6 release and forward."	7646	KERNEL_FIT_LINK_NAME[doc] = "The link name of the kernel flattened image tree (FIT) image."
7519	</info>	7647	</info>
7520	<glossdef>	7648	<glossdef>
7521	<para role="glossdeffirst">	7649	<para role="glossdeffirst">
7522	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->	7650	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
7523	<note>	7651	The link name of the kernel flattened image tree (FIT) image.
7524	See the	7652	This variable is set in the
7525	<link linkend='var-KERNEL_IMAGE_NAME'><filename>KERNEL_IMAGE_NAME</filename></link>	7653	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
7526	variable for information.	7654	file as follows:
7527	The <filename>KERNEL_IMAGE_BASE_NAME</filename>
7528	variable's name has changed for Yocto Project 2.6
7529	release and forward.
7530	</note>
7531	Prior to the 2.6 release of Yocto Project, this variable
7532	was set in the
7533	<link linkend='ref-classes-kernel'>kernel</link> class
7534	as follows:
7535	<literallayout class='monospaced'>	7655	<literallayout class='monospaced'>
7536	KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"	7656	KERNEL_FIT_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
		7657	</literallayout>
		7658	The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
		7659	variable, which is set in the same file, has the following
		7660	value:
		7661	<literallayout class='monospaced'>
		7662	KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
		7663	</literallayout>
		7664	</para>
		7665
		7666	<para>
		7667	See the
		7668	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7669	variable for additional information.
		7670	</para>
		7671	</glossdef>
		7672	</glossentry>
		7673
		7674	<glossentry id='var-KERNEL_FIT_NAME'><glossterm>KERNEL_FIT_NAME</glossterm>
		7675	<info>
		7676	KERNEL_FIT_NAME[doc] = "The base name of the kernel flattened image tree (FIT) image."
		7677	</info>
		7678	<glossdef>
		7679	<para role="glossdeffirst">
		7680	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7681	The base name of the kernel flattened image tree (FIT) image.
		7682	This variable is set in the
		7683	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7684	file as follows:
		7685	<literallayout class='monospaced'>
		7686	KERNEL_FIT_NAME ?= "${KERNEL_ARTIFACT_NAME}"
		7687	</literallayout>
		7688	The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
		7689	variable, which is set in the same file, has the following
		7690	value:
		7691	<literallayout class='monospaced'>
		7692	KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
7537	</literallayout>	7693	</literallayout>
7538	</para>	7694	</para>
7539		7695
@@ -7542,14 +7698,43 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7542	<link linkend='var-PKGE'><filename>PKGE</filename></link>,	7698	<link linkend='var-PKGE'><filename>PKGE</filename></link>,
7543	<link linkend='var-PKGV'><filename>PKGV</filename></link>,	7699	<link linkend='var-PKGV'><filename>PKGV</filename></link>,
7544	<link linkend='var-PKGR'><filename>PKGR</filename></link>,	7700	<link linkend='var-PKGR'><filename>PKGR</filename></link>,
7545	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>,
7546	and	7701	and
7547	<link linkend='var-DATETIME'><filename>DATETIME</filename></link>	7702	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
7548	variables for additional information.	7703	variables for additional information.
7549	</para>	7704	</para>
7550	</glossdef>	7705	</glossdef>
7551	</glossentry>	7706	</glossentry>
7552		7707
		7708	<glossentry id='var-KERNEL_IMAGE_LINK_NAME'><glossterm>KERNEL_IMAGE_LINK_NAME</glossterm>
		7709	<info>
		7710	KERNEL_IMAGE_LINK_NAME[doc] = "The link name for the kernel image."
		7711	</info>
		7712	<glossdef>
		7713	<para role="glossdeffirst">
		7714	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		7715	The link name for the kernel image.
		7716	This variable is set in the
		7717	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
		7718	file as follows:
		7719	<literallayout class='monospaced'>
		7720	KERNEL_IMAGE_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
		7721	</literallayout>
		7722	The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
		7723	variable, which is set in the same file, has the following
		7724	value:
		7725	<literallayout class='monospaced'>
		7726	KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
		7727	</literallayout>
		7728	</para>
		7729
		7730	<para>
		7731	See the
		7732	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		7733	variable for additional information.
		7734	</para>
		7735	</glossdef>
		7736	</glossentry>
		7737
7553	<glossentry id='var-KERNEL_IMAGE_MAXSIZE'><glossterm>KERNEL_IMAGE_MAXSIZE</glossterm>	7738	<glossentry id='var-KERNEL_IMAGE_MAXSIZE'><glossterm>KERNEL_IMAGE_MAXSIZE</glossterm>
7554	<info>	7739	<info>
7555	KERNEL_IMAGE_MAXSIZE[doc] = "The maximum allowable size in kilobytes of the kernel image file."	7740	KERNEL_IMAGE_MAXSIZE[doc] = "The maximum allowable size in kilobytes of the kernel image file."
@@ -9028,47 +9213,82 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
9028	</glossdef>	9213	</glossdef>
9029	</glossentry>	9214	</glossentry>
9030		9215
9031	<glossentry id='var-MODULE_IMAGE_BASE_NAME'><glossterm>MODULE_IMAGE_BASE_NAME</glossterm>	9216	<glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY</glossterm>
		9217	<info>
		9218	MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build."
		9219	</info>
		9220	<glossdef>
		9221	<para role="glossdeffirst">
		9222	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		9223	Controls creation of the <filename>modules-*.tgz</filename>
		9224	file.
		9225	Set this variable to "0" to disable creation of this
		9226	file, which contains all of the kernel modules resulting
		9227	from a kernel build.
		9228	</para>
		9229	</glossdef>
		9230	</glossentry>
		9231
		9232	<glossentry id='var-MODULE_TARBALL_LINK_NAME'><glossterm>MODULE_TARBALL_LINK_NAME</glossterm>
9032	<info>	9233	<info>
9033	MODULE_IMAGE_BASE_NAME[doc] = "The base name of the kernel modules tarball."	9234	MODULE_TARBALL_LINK_NAME[doc] = "The link name of the module tarball."
9034	</info>	9235	</info>
9035	<glossdef>	9236	<glossdef>
9036	<para role="glossdeffirst">	9237	<para role="glossdeffirst">
9037	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->	9238	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
9038	The base name of the kernel modules tarball.	9239	The link name of the module tarball.
9039	This variable is set in the	9240	This variable is set in the
9040	<link linkend='ref-classes-kernel'>kernel</link> class	9241	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
9041	as follows:	9242	file as follows:
9042	<literallayout class='monospaced'>	9243	<literallayout class='monospaced'>
9043	MODULE_IMAGE_BASE_NAME ?= "modules-${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"	9244	MODULE_TARBALL_LINK_NAME ?= "${KERNEL_ARTIFACT_LINK_NAME}"
		9245	</literallayout>
		9246	The value of the <filename>KERNEL_ARTIFACT_LINK_NAME</filename>
		9247	variable, which is set in the same file, has the following
		9248	value:
		9249	<literallayout class='monospaced'>
		9250	KERNEL_ARTIFACT_LINK_NAME ?= "${MACHINE}"
9044	</literallayout>	9251	</literallayout>
9045	</para>	9252	</para>
9046		9253
9047	<para>	9254	<para>
9048	See the	9255	See the
9049	<link linkend='var-PKGE'><filename>PKGE</filename></link>,	9256	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
9050	<link linkend='var-PKGV'><filename>PKGV</filename></link>,	9257	variable for additional information.
9051	<link linkend='var-PKGR'><filename>PKGR</filename></link>,
9052	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>,
9053	and
9054	<link linkend='var-DATETIME'><filename>DATETIME</filename></link>
9055	variables for additional information.
9056	</para>	9258	</para>
9057	</glossdef>	9259	</glossdef>
9058	</glossentry>	9260	</glossentry>
9059		9261
9060	<glossentry id='var-MODULE_TARBALL_DEPLOY'><glossterm>MODULE_TARBALL_DEPLOY</glossterm>	9262	<glossentry id='var-MODULE_TARBALL_NAME'><glossterm>MODULE_TARBALL_NAME</glossterm>
9061	<info>	9263	<info>
9062	MODULE_TARBALL_DEPLOY[doc] = "Controls creation of the modules-*.tgz file. Set this variable to "0" to disable creation of this file, which contains all of the kernel modules resulting from a kernel build."	9264	MODULE_TARBALL_NAME[doc] = "The base name of the module tarball."
9063	</info>	9265	</info>
9064	<glossdef>	9266	<glossdef>
9065	<para role="glossdeffirst">	9267	<para role="glossdeffirst">
9066	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->	9268	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
9067	Controls creation of the <filename>modules-*.tgz</filename>	9269	The base name of the module tarball.
9068	file.	9270	This variable is set in the
9069	Set this variable to "0" to disable creation of this	9271	<filename>meta/classes/kernel-artifact-names.bbclass</filename>
9070	file, which contains all of the kernel modules resulting	9272	file as follows:
9071	from a kernel build.	9273	<literallayout class='monospaced'>
		9274	MODULE_TARBALL_NAME ?= "${KERNEL_ARTIFACT_NAME}"
		9275	</literallayout>
		9276	The value of the <filename>KERNEL_ARTIFACT_NAME</filename>
		9277	variable, which is set in the same file, has the following
		9278	value:
		9279	<literallayout class='monospaced'>
		9280	KERNEL_ARTIFACT_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}${IMAGE_VERSION_SUFFIX}"
		9281	</literallayout>
		9282	</para>
		9283
		9284	<para>
		9285	See the
		9286	<link linkend='var-PKGE'><filename>PKGE</filename></link>,
		9287	<link linkend='var-PKGV'><filename>PKGV</filename></link>,
		9288	<link linkend='var-PKGR'><filename>PKGR</filename></link>,
		9289	and
		9290	<link linkend='var-MACHINE'><filename>MACHINE</filename></link>
		9291	variables for additional information.
9072	</para>	9292	</para>
9073	</glossdef>	9293	</glossdef>
9074	</glossentry>	9294	</glossentry>