Skip to contentSkip to conversation

docs: add CONVERSION_CMD definition

PATCH In review Aatir Manzur 2 participants 2 messages Jun 28, 2022 – Jun 29, 2022

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: add CONVERSION_CMD definition

Signed-off-by Aatir Manzur <[email protected]>

---
 documentation/migration-guides/migration-2.2.rst | 2 +-
 documentation/migration-guides/migration-2.4.rst | 2 +-
 documentation/migration-guides/migration-3.4.rst | 2 +-
 documentation/ref-manual/variables.rst           | 9 +++++++++
 4 files changed, 12 insertions(+), 3 deletions(-)
documentation/migration-guides/migration-2.2.rst +1 -1
index fe7bc2cf5..16e48cc87 100644
@@ -442,7 +442,7 @@ The following miscellaneous changes have occurred:
 -  :ref:`ref-classes-image`: Renamed COMPRESS(ION) to CONVERSION. This change
    means that ``COMPRESSIONTYPES``, ``COMPRESS_DEPENDS`` and
    ``COMPRESS_CMD`` are deprecated in favor of ``CONVERSIONTYPES``,
-   ``CONVERSION_DEPENDS`` and ``CONVERSION_CMD``. The ``COMPRESS*``
+   ``CONVERSION_DEPENDS`` and :term:`CONVERSION_CMD`. The ``COMPRESS*``
    variable names will still work in the 2.2 release but metadata that
    does not need to be backwards-compatible should be changed to use the
    new names as the ``COMPRESS*`` ones will be removed in a future
documentation/migration-guides/migration-2.4.rst +1 -1
index ef5f32e6e..964ed9293 100644
@@ -301,7 +301,7 @@ The following are additional changes:
    likely be removed in the next Yocto Project release.
 
 -  The ``vmdk``, ``vdi``, and ``qcow2`` image file types are now used in
-   conjunction with the "wic" image type through ``CONVERSION_CMD``.
+   conjunction with the "wic" image type through :term:`CONVERSION_CMD`.
    Consequently, the equivalent image types are now ``wic.vmdk``,
    ``wic.vdi``, and ``wic.qcow2``, respectively.
 
documentation/migration-guides/migration-3.4.rst +1 -1
index 8db43a145..c600129ec 100644
@@ -252,7 +252,7 @@ Miscellaneous
 
 - The previously deprecated ``COMPRESS_CMD`` and
   ``CVE_CHECK_CVE_WHITELIST`` variables have been removed. Use
-  ``CONVERSION_CMD`` and ``CVE_CHECK_WHITELIST`` (replaced by
+  :term:`CONVERSION_CMD` and ``CVE_CHECK_WHITELIST`` (replaced by
   :term:`CVE_CHECK_IGNORE` in version 3.5) respectively
   instead.
 
documentation/ref-manual/variables.rst +9 -0
index 8f7b01c12..bc59b574d 100644
@@ -1297,6 +1297,15 @@ system and gives an overview of their function and contents.
       the recipe will be skipped, and if the build system attempts to build
       the recipe then an error will be triggered.
 
+   :term:`CONVERSION_CMD`
+      This variable is used for storing image conversion commands. 
+      Image conversion can convert an image into different objects like:
+      - compressed version of the image
+      - checksums for the image
+      An exmple of :term:`CONVERSION_CMD` 
+      from :ref:`image-types <ref-classes-image_types>` class is:
+      CONVERSION_CMD:lzo = "lzop -9 ${IMAGE_NAME}${IMAGE_NAME_SUFFIX}.${type}"
+
    :term:`COPY_LIC_DIRS`
       If set to "1" along with the
       :term:`COPY_LIC_MANIFEST` variable, the
Signature · 1 line
2.31.0
Reviewed-by on v1 1/1
#1 lore raw

Hi Aatir

Quoted 7 lines · aatir

Signed-off-by Aatir Manzur <[email protected]>

---
  documentation/migration-guides/migration-2.2.rst | 2 +-
  documentation/migration-guides/migration-2.4.rst | 2 +-
  documentation/migration-guides/migration-3.4.rst | 2 +-
  documentation/ref-manual/variables.rst           | 9 +++++++++
  4 files changed, 12 insertions(+), 3 deletions(-)

Many thanks for this update. I just made a few tweaks (mainly fixing a typo with "exmple" and introducing the example with "::" and leading spaces).

... and merged into master-next.

Thanks again!
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com