[v3] sphinx: ref-variables: Added entry for IMAGE_EFI_BOOT_FILES

Submitted by khairul.rohaizzat.jamaluddin@intel.com on Sept. 21, 2020, 11:26 a.m. | Patch ID: 176662

Details

Message ID 1600687615-18331-1-git-send-email-khairul.rohaizzat.jamaluddin@intel.com
State New
Headers show

Commit Message

khairul.rohaizzat.jamaluddin@intel.com Sept. 21, 2020, 11:26 a.m.
From: Khairul Rohaizzat Jamaluddin <khairul.rohaizzat.jamaluddin@intel.com>

IMAGE_EFI_BOOT_FILES created to help differentiate files needed between
bootimg-efi and bootimg-partition when creating the installer/.wic file.

Signed-off-by: Khairul Rohaizzat Jamaluddin <khairul.rohaizzat.jamaluddin@intel.com>
---
 documentation/ref-manual/ref-variables.rst | 38 +++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

Patch hide | download patch | download mbox

diff --git a/documentation/ref-manual/ref-variables.rst b/documentation/ref-manual/ref-variables.rst
index 625a37c..c09809e 100644
--- a/documentation/ref-manual/ref-variables.rst
+++ b/documentation/ref-manual/ref-variables.rst
@@ -2902,10 +2902,46 @@  system and gives an overview of their function and contents.
       The base name of image output files. This variable defaults to the
       recipe name (``${``\ :term:`PN`\ ``}``).
 
+   IMAGE_EFI_BOOT_FILES
+      A space-separated list of files installed into the boot partition
+      when preparing an image using the Wic tool with the
+      ``bootimg-efi`` source plugin. By default,
+      the files are
+      installed under the same name as the source files. To change the
+      installed name, separate it from the original name with a semi-colon
+      (;). Source files need to be located in
+      :term:`DEPLOY_DIR_IMAGE`. Here are two
+      examples:
+      ::
+
+         IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE};bz2"
+         IMAGE_EFI_BOOT_FILES = "${KERNEL_IMAGETYPE} microcode.cpio"
+ 
+      Alternatively, source files can be picked up using a glob pattern. In
+      this case, the destination file must have the same name as the base
+      name of the source file path. To install files into a directory
+      within the target location, pass its name after a semi-colon (;).
+      Here are two examples:
+      ::
+
+         IMAGE_EFI_BOOT_FILES = "boot/loader/*"
+         IMAGE_EFI_BOOT_FILES = "boot/loader/*;boot/"
+
+      The first example
+      installs all files from ``${DEPLOY_DIR_IMAGE}/boot/loader/``
+      into the root of the target partition. The second example installs
+      the same files into a ``boot`` directory within the target partition.
+
+      You can find information on how to use the Wic tool in the
+      ":ref:`dev-manual/dev-manual-common-tasks:creating partitioned images using wic`"
+      section of the Yocto Project Development Tasks Manual. Reference
+      material for Wic is located in the
+      ":doc:`../ref-manual/ref-kickstart`" chapter.
+
    IMAGE_BOOT_FILES
       A space-separated list of files installed into the boot partition
       when preparing an image using the Wic tool with the
-      ``bootimg-partition`` or ``bootimg-efi`` source plugin. By default,
+      ``bootimg-partition`` source plugin. By default,
       the files are
       installed under the same name as the source files. To change the
       installed name, separate it from the original name with a semi-colon

Comments

khairul.rohaizzat.jamaluddin@intel.com Sept. 28, 2020, 2:39 a.m.
Hi,

Does anyone have any updates on this patch? Does it pass for merge?


Thank you & Kind regards,
Khairul

-----Original Message-----
From: Jamaluddin, Khairul Rohaizzat <khairul.rohaizzat.jamaluddin@intel.com> 
Sent: Monday, September 21, 2020 7:27 PM
To: docs@lists.yoctoproject.org
Cc: Jamaluddin, Khairul Rohaizzat <khairul.rohaizzat.jamaluddin@intel.com>
Subject: [PATCH v3] sphinx: ref-variables: Added entry for IMAGE_EFI_BOOT_FILES

From: Khairul Rohaizzat Jamaluddin <khairul.rohaizzat.jamaluddin@intel.com>

IMAGE_EFI_BOOT_FILES created to help differentiate files needed between bootimg-efi and bootimg-partition when creating the installer/.wic file.

Signed-off-by: Khairul Rohaizzat Jamaluddin <khairul.rohaizzat.jamaluddin@intel.com>
---
 documentation/ref-manual/ref-variables.rst | 38 +++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

--
2.7.4
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#403): https://lists.yoctoproject.org/g/docs/message/403
Mute This Topic: https://lists.yoctoproject.org/mt/76988170/3617530
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [oe-patchwork@oe-patch.openembedded.org]
-=-=-=-=-=-=-=-=-=-=-=-
Richard Purdie Sept. 29, 2020, 10:30 p.m.
On Mon, 2020-09-28 at 02:39 +0000, Jamaluddin, Khairul Rohaizzat wrote:
> Hi,
> 
> Does anyone have any updates on this patch? Does it pass for merge?

Sorry, there was some confusion over who was merging patches. Its in
now, thanks!

Cheers,

Richard
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#404): https://lists.yoctoproject.org/g/docs/message/404
Mute This Topic: https://lists.yoctoproject.org/mt/76988170/3617530
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [oe-patchwork@oe-patch.openembedded.org]
-=-=-=-=-=-=-=-=-=-=-=-
khairul.rohaizzat.jamaluddin@intel.com Sept. 30, 2020, 2:22 a.m.
Thanks for the help, Richard!

Thank you & Kind regards,
Khairul

-----Original Message-----
From: docs@lists.yoctoproject.org <docs@lists.yoctoproject.org> On Behalf Of Richard Purdie

Sent: Wednesday, September 30, 2020 6:30 AM
To: Jamaluddin, Khairul Rohaizzat <khairul.rohaizzat.jamaluddin@intel.com>; docs@lists.yoctoproject.org
Subject: Re: [docs] [PATCH v3] sphinx: ref-variables: Added entry for IMAGE_EFI_BOOT_FILES

On Mon, 2020-09-28 at 02:39 +0000, Jamaluddin, Khairul Rohaizzat wrote:
> Hi,

> 

> Does anyone have any updates on this patch? Does it pass for merge?


Sorry, there was some confusion over who was merging patches. Its in now, thanks!

Cheers,

Richard
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#405): https://lists.yoctoproject.org/g/docs/message/405
Mute This Topic: https://lists.yoctoproject.org/mt/76988170/3617530
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [oe-patchwork@oe-patch.openembedded.org]
-=-=-=-=-=-=-=-=-=-=-=-