summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/classes.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/classes.rst')
-rw-r--r--documentation/ref-manual/classes.rst38
1 files changed, 38 insertions, 0 deletions
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 2f96ffb82f..78174d51d1 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -3178,6 +3178,44 @@ You can also specify the machine using this method::
3178See the :term:`UBOOT_CONFIG` and :term:`UBOOT_MACHINE` variables for additional 3178See the :term:`UBOOT_CONFIG` and :term:`UBOOT_MACHINE` variables for additional
3179information. 3179information.
3180 3180
3181.. _ref-classes-uboot-sign:
3182
3183``uboot-sign``
3184==============
3185
3186The :ref:`ref-classes-uboot-sign` class provides support for U-Boot verified boot.
3187It is intended to be inherited from U-Boot recipes.
3188
3189Here are variables used by this class:
3190
3191- :term:`SPL_MKIMAGE_DTCOPTS`: DTC options for U-Boot ``mkimage`` when
3192 building the FIT image.
3193- :term:`SPL_SIGN_ENABLE`: enable signing the FIT image.
3194- :term:`SPL_SIGN_KEYDIR`: directory containing the signing keys.
3195- :term:`SPL_SIGN_KEYNAME`: base filename of the signing keys.
3196- :term:`UBOOT_FIT_ADDRESS_CELLS`: ``#address-cells`` value for the FIT image.
3197- :term:`UBOOT_FIT_DESC`: description string encoded into the FIT image.
3198- :term:`UBOOT_FIT_GENERATE_KEYS`: generate the keys if they don't exist yet.
3199- :term:`UBOOT_FIT_HASH_ALG`: hash algorithm for the FIT image.
3200- :term:`UBOOT_FIT_KEY_GENRSA_ARGS`: ``openssl genrsa`` arguments.
3201- :term:`UBOOT_FIT_KEY_REQ_ARGS`: ``openssl req`` arguments.
3202- :term:`UBOOT_FIT_SIGN_ALG`: signature algorithm for the FIT image.
3203- :term:`UBOOT_FIT_SIGN_NUMBITS`: size of the private key for FIT image
3204 signing.
3205- :term:`UBOOT_FIT_KEY_SIGN_PKCS`: algorithm for the public key certificate
3206 for FIT image signing.
3207- :term:`UBOOT_FITIMAGE_ENABLE`: enable the generation of a U-Boot FIT image.
3208- :term:`UBOOT_MKIMAGE_DTCOPTS`: DTC options for U-Boot ``mkimage`` when
3209 rebuilding the FIT image containing the kernel.
3210
3211See U-Boot's documentation for details about `verified boot
3212<https://source.denx.de/u-boot/u-boot/-/blob/master/doc/uImage.FIT/verified-boot.txt>`__
3213and the `signature process
3214<https://source.denx.de/u-boot/u-boot/-/blob/master/doc/uImage.FIT/signature.txt>`__.
3215
3216See also the description of :ref:`ref-classes-kernel-fitimage` class, which this class
3217imitates.
3218
3181.. _ref-classes-uninative: 3219.. _ref-classes-uninative:
3182 3220
3183``uninative`` 3221``uninative``