manuals: add references to the "do_image" task

[YOCTO #14508]
Reported-by: Quentin Schulz <foss@0leil.net>
(From yocto-docs rev: 2f53d0a52a48f828f00d3bc3f887fd537692a256)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Michael Opdenacker
2022-09-23 17:59:23 +02:00
committed by Richard Purdie
parent 0e8d0ecc6c
commit 3c6b2798a0
3 changed files with 7 additions and 7 deletions

View File

@@ -3853,7 +3853,7 @@ to be added to the recipe that builds the ``core-image-sato`` image::
do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_rootfs" do_image[mcdepends] = "mc:x86:arm:core-image-minimal:do_rootfs"
In this example, the `from_multiconfig` is "x86". The `to_multiconfig` is "arm". The In this example, the `from_multiconfig` is "x86". The `to_multiconfig` is "arm". The
task on which the ``do_image`` task in the recipe depends is the task on which the :ref:`ref-tasks-image` task in the recipe depends is the
``do_rootfs`` task from the ``core-image-minimal`` recipe associated ``do_rootfs`` task from the ``core-image-minimal`` recipe associated
with the "arm" multiconfig. with the "arm" multiconfig.

View File

@@ -1036,7 +1036,7 @@ the
variable. This variable specifies a list of functions to call before the variable. This variable specifies a list of functions to call before the
build system creates the final image output files. build system creates the final image output files.
The build system dynamically creates ``do_image_*`` tasks as needed, The build system dynamically creates :ref:`do_image_* <ref-tasks-image>` tasks as needed,
based on the image types specified in the based on the image types specified in the
:term:`IMAGE_FSTYPES` variable. :term:`IMAGE_FSTYPES` variable.
The process turns everything into an image file or a set of image files The process turns everything into an image file or a set of image files
@@ -2162,7 +2162,7 @@ operations that are normally reserved for the root user (e.g.
:ref:`ref-tasks-install`, :ref:`ref-tasks-install`,
:ref:`do_package_write* <ref-tasks-package_write_deb>`, :ref:`do_package_write* <ref-tasks-package_write_deb>`,
:ref:`ref-tasks-rootfs`, and :ref:`ref-tasks-rootfs`, and
:ref:`do_image* <ref-tasks-image>`). For example, :ref:`do_image_* <ref-tasks-image>`). For example,
the :ref:`ref-tasks-install` task benefits from being able to set the UID and GID the :ref:`ref-tasks-install` task benefits from being able to set the UID and GID
of installed files to arbitrary values. of installed files to arbitrary values.

View File

@@ -128,15 +128,15 @@ module.
``do_image`` ``do_image``
------------ ------------
Starts the image generation process. The ``do_image`` task runs after Starts the image generation process. The :ref:`ref-tasks-image` task runs after
the OpenEmbedded build system has run the the OpenEmbedded build system has run the
:ref:`ref-tasks-rootfs` task during which packages are :ref:`ref-tasks-rootfs` task during which packages are
identified for installation into the image and the root filesystem is identified for installation into the image and the root filesystem is
created, complete with post-processing. created, complete with post-processing.
The ``do_image`` task performs pre-processing on the image through the The :ref:`ref-tasks-image` task performs pre-processing on the image through the
:term:`IMAGE_PREPROCESS_COMMAND` and :term:`IMAGE_PREPROCESS_COMMAND` and
dynamically generates supporting ``do_image_*`` tasks as needed. dynamically generates supporting :ref:`do_image_* <ref-tasks-image>` tasks as needed.
For more information on image creation, see the ":ref:`overview-manual/concepts:image generation`" For more information on image creation, see the ":ref:`overview-manual/concepts:image generation`"
section in the Yocto Project Overview and Concepts Manual. section in the Yocto Project Overview and Concepts Manual.
@@ -149,7 +149,7 @@ section in the Yocto Project Overview and Concepts Manual.
Completes the image generation process. The ``do_image_complete`` task Completes the image generation process. The ``do_image_complete`` task
runs after the OpenEmbedded build system has run the runs after the OpenEmbedded build system has run the
:ref:`ref-tasks-image` task during which image :ref:`ref-tasks-image` task during which image
pre-processing occurs and through dynamically generated ``do_image_*`` pre-processing occurs and through dynamically generated :ref:`do_image_* <ref-tasks-image>`
tasks the image is constructed. tasks the image is constructed.
The ``do_image_complete`` task performs post-processing on the image The ``do_image_complete`` task performs post-processing on the image