[yocto] Manuals for ROOT LABELS INITRD and INITRD_IMAGE

[Robert Yang]

Hi Scott,

We can find INITRD, INITRD_IMAGE, LABELS in this document:

http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html

For example LABELS:
http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-LABELS

We need update all the ROOT LABELS INITRD and INITRD_IMAGE to the _VM or
_LIVE version as I sent in the email.

For ROOT, there is already ROOT_VM, but no ROOT_LIVE.

And we can also find them in documentation/ref-manual/ref-variables.xml and
documentation/ref-manual/ref-classes.xml (I assume that these xmls are the
sources of the web), for example:

$ grep INITRD documentation/* -r
documentation/ref-manual/ref-variables.xml:        <glossentry 
id='var-INITRD'><glossterm>INITRD</glossterm>
documentation/ref-manual/ref-variables.xml:                INITRD[doc] = 
"Indicates a list of filesystem images to concatenate and use as an initial RAM 
disk (initrd)."
documentation/ref-manual/ref-variables.xml:                    The 
<filename>INITRD</filename> variable is an optional
documentation/ref-manual/ref-variables.xml:        <glossentry 
id='var-INITRD_IMAGE'><glossterm>INITRD_IMAGE</glossterm>
documentation/ref-manual/ref-variables.xml:                INITRD_IMAGE[doc] = 
"When building a "live" bootable image (i.e. when IMAGE_FSTYPES contains 
"live"), INITRD_IMAGE specifies the image recipe that should be built to provide 
the initial RAM disk image."
documentation/ref-manual/ref-variables.xml:                    contains "live"), 
<filename>INITRD_IMAGE</filename>
documentation/ref-manual/ref-classes.xml:                <link 
linkend='var-INITRD'><filename>INITRD</filename></link>:
documentation/ref-manual/ref-classes.xml:            <listitem><para><link 
linkend='var-INITRD'><filename>INITRD</filename></link>:

// Robert

On 10/22/2016 04:11 AM, Scott Rifenbark wrote:
> Hi Robert,
>
> I don't quite understand this.  Could you point to some areas in the manual that
> are needing updated?  I don't have any occurrences of ROOT_LIVE, LABELS_VM,
> LABELS_LIVE, INITRD_VM, or INITRD_LIVE in the YP manual set.  I guess I just
> need some more explanation here on how to fix this issue in the manual.
>
> Thanks,
> Scott
>
> On Thu, Oct 20, 2016 at 12:36 AM, Robert Yang <liezhi.yang at windriver.com
> <mailto:liezhi.yang at windriver.com>> wrote:
>
>     Hi Scott,
>
>     The LIVE (such as iso) and VM images (such as vmdk) can't use the same
>     settings for ROOT LABELS INITRD and INITRD_IMAGE, either of them may fail
>     to boot, so when the user uses one of them, they will get warnings like:
>
>     WARNING: core-image-minimal-1.0-r0 do_bootimg: Found potential conflicted
>     var LABELS, please use LABELS_LIVE rather than LABELS"
>
>     We should use _LIVE or _VM version to instead of, would you please update
>     the manual for them ?
>
>     ROOT_VM: Boot loader's root options for vm images, e.g., root=/dev/sda2.
>     ROOT_LIVE: Boot loader's root options for live images, e.g., root=/dev/ram0.
>
>     LABELS_VM: Boot loader's actions for vm images, e.g., "boot".
>     LABELS_LIVE: Boot loader's actions for live images, e.g., "boot install".
>
>     INITRD_VM: Path to initial RAM disk (initrd) for vm images.
>     INITRD_LIVE:  Path to initial RAM disk (initrd) for live images.
>
>     # There is no warnings when use INITRD_IMAGE, I will fix it in Yocto 2.3.
>     INITRD_IMAGE_VM: INITRD's image name (PN) for vm images
>     INITRD_IMAGE_LIVE: INITRD's image name (PN) for live images
>
>     --
>     Thanks
>
>     Robert
>
>