diff options
Diffstat (limited to 'documentation/ref-manual/classes.rst')
-rw-r--r-- | documentation/ref-manual/classes.rst | 38 |
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:: | |||
3178 | See the :term:`UBOOT_CONFIG` and :term:`UBOOT_MACHINE` variables for additional | 3178 | See the :term:`UBOOT_CONFIG` and :term:`UBOOT_MACHINE` variables for additional |
3179 | information. | 3179 | information. |
3180 | 3180 | ||
3181 | .. _ref-classes-uboot-sign: | ||
3182 | |||
3183 | ``uboot-sign`` | ||
3184 | ============== | ||
3185 | |||
3186 | The :ref:`ref-classes-uboot-sign` class provides support for U-Boot verified boot. | ||
3187 | It is intended to be inherited from U-Boot recipes. | ||
3188 | |||
3189 | Here 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 | |||
3211 | See 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>`__ | ||
3213 | and the `signature process | ||
3214 | <https://source.denx.de/u-boot/u-boot/-/blob/master/doc/uImage.FIT/signature.txt>`__. | ||
3215 | |||
3216 | See also the description of :ref:`ref-classes-kernel-fitimage` class, which this class | ||
3217 | imitates. | ||
3218 | |||
3181 | .. _ref-classes-uninative: | 3219 | .. _ref-classes-uninative: |
3182 | 3220 | ||
3183 | ``uninative`` | 3221 | ``uninative`` |