ref-manual: Added CONFIG_INITRAMFS_SOURCE and edited INITRAMFS_IMAGE_BUNDLE variables.

Fixes [YOCTO #4072]

Added the new variable CONFIG_INITRAMFS_SOURCE, which points to the
initramfs source.  I also added information to the
INITRAMFS_IMAGE_BUNDLE variable noting how its use can avoid
circular dependencies as described by the bug.

(From yocto-docs rev: 73267642299d1164eeee5866e7ca7006c56260e5)

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 2014-03-07 16:46:01 -06:00 committed by Richard Purdie
parent bcd9917f8d
commit a41113c94f
1 changed files with 39 additions and 0 deletions

View File

@ -1293,6 +1293,38 @@
</glossdef>
</glossentry>
<glossentry id='var-CONFIG_INITRAMFS_SOURCE'><glossterm>CONFIG_INITRAMFS_SOURCE</glossterm>
<glossdef>
<para>
Identifies the initial RAM disk (initramfs) source files.
The OpenEmbedded build system receives and uses
this kernel Kconfig variable as an environment variable.
By default, the variable is set to null ("").
</para>
<para>
The <filename>CONFIG_INITRAMFS_SOURCE</filename> can be
either a single cpio archive with a
<filename>.cpio</filename> suffix or a
space-separated list of directories and files for building
the initramfs image.
A cpio archive should contain a filesystem archive
to be used as an initramfs image.
Directories should contain a filesystem layout to be
included in the initramfs image.
Files should contain entries according to the format
described by the
<filename>usr/gen_init_cpio</filename> program in the
kernel tree.
</para>
<para>
If you specify multiple directories and files, the
initramfs image will be the aggregate of all of them.
</para>
</glossdef>
</glossentry>
<glossentry id='var-CONFIG_SITE'><glossterm>CONFIG_SITE</glossterm>
<glossdef>
<para>
@ -3312,6 +3344,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
is run through an extra pass during kernel compilation
in order to build a single binary that contains both the
kernel image and the initial RAM disk (initramfs).
Using an extra compilation pass ensures that when a kernel
attempts to use an initramfs, it does not encounter
circular dependencies should the initramfs include kernel
modules.
</para>
<para>
The combined binary is deposited into the
<filename>tmp/deploy</filename> directory, which is part
of the