Marek VasutandHeinrich Schuchardt
dc3765ede5
The "env" command is the recommended environment management command, its "set" subcommand is the equivalent replacement for legacy "setenv" command. Update the documentation to use the contemporary "env set" command instead of legacy "setenv" command. Note that the "setenv" command is unlikely to be removed from U-Boot in the near future due to it being integral part of the command line ABI. Implemented using: $ sed -i 's@\<setenv\>@env set@g' $(git grep -li '\<setenv\>' doc/) README Signed-off-by: Marek Vasut <marek.vasut+renesas@mailbox.org>
79 lines
1.9 KiB
ReStructuredText
79 lines
1.9 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+:
|
|
|
|
.. index::
|
|
single: imxtract (command)
|
|
|
|
imxtract command
|
|
================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
imxtract addr part [dest]
|
|
imxtract addr uname [dest]
|
|
|
|
Description
|
|
-----------
|
|
|
|
The imxtract command is used to extract a part of a multi-image file.
|
|
|
|
Two different file formats are supported:
|
|
|
|
* FIT images
|
|
* legacy U-Boot images
|
|
|
|
addr
|
|
Address of the multi-image file from which a part shall be extracted
|
|
|
|
part
|
|
Index (hexadecimal) of the part of a legacy U-Boot image to be extracted
|
|
|
|
uname
|
|
Name of the part of a FIT image to be extracted
|
|
|
|
dest
|
|
Destination address (defaults to 0x0)
|
|
|
|
The value of environment variable *verify* controls if the hashes and
|
|
signatures of FIT images or the check sums of legacy U-Boot images are checked.
|
|
To enable checking set *verify* to one of the values *1*, *yes*, *true*.
|
|
(Actually only the first letter is checked disregarding the case.)
|
|
|
|
To list the parts of an image the *iminfo* command can be used.
|
|
|
|
Examples
|
|
--------
|
|
|
|
With verify=no incorrect hashes, signatures, or check sums don't stop the
|
|
extraction. But correct hashes are still indicated in the output
|
|
(here: sha256, sha512).
|
|
|
|
.. code-block:: console
|
|
|
|
=> env set verify no
|
|
=> imxtract $loadaddr kernel-1 $kernel_addr_r
|
|
## Copying 'kernel-1' subimage from FIT image at 40200000 ...
|
|
sha256+ sha512+ Loading part 0 ... OK
|
|
=>
|
|
|
|
With verify=yes incorrect hashes, signatures, or check sums stop the extraction.
|
|
|
|
.. code-block:: console
|
|
|
|
=> env set verify yes
|
|
=> imxtract $loadaddr kernel-1 $kernel_addr_r
|
|
## Copying 'kernel-1' subimage from FIT image at 40200000 ...
|
|
sha256 error!
|
|
Bad hash value for 'hash-1' hash node in 'kernel-1' image node
|
|
Bad Data Hash
|
|
=>
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The imxtract command is only available if CONFIG_CMD_XIMG=y. Support for FIT
|
|
images requires CONFIG_FIT=y. Support for legacy U-Boot images requires
|
|
CONFIG_LEGACY_IMAGE_FORMAT=y.
|