mirror of
https://git.yoctoproject.org/poky
synced 2026-09-19 18:49:32 +02:00
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:
committed by
Richard Purdie
parent
0e8d0ecc6c
commit
3c6b2798a0
@@ -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.
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user