summaryrefslogtreecommitdiff
path: root/doc/README.distro
diff options
context:
space:
mode:
authorAtish Patra <atish.patra@wdc.com>2020-03-05 16:24:23 -0800
committerTom Rini <trini@konsulko.com>2020-04-17 12:32:36 -0400
commit414c34ed555b8ce5c260cf641261ecf45beca251 (patch)
tree9c61e50fe37396b9c1800003f0a14f13d4cad27b /doc/README.distro
parent155d6a3575470c1a735b8cf368d9e987930910a8 (diff)
downloadu-boot-414c34ed555b8ce5c260cf641261ecf45beca251.tar.gz
image: Add compressed Image parsing support in booti.
Add compressed Image parsing support so that booti can parse both flat and compressed Image to boot Linux. Currently, it is difficult to calculate a safe address for every board where the compressed image can be decompressed. It is also not possible to figure out the size of the compressed file as well. Thus, user need to set two additional environment variables kernel_comp_addr_r and filesize to make this work. Following compression methods are supported for now. lzma, lzo, bzip2, gzip. lz4 support is not added as ARM64 kernel generates a lz4 compressed image with legacy header which U-Boot doesn't know how to parse and decompress. Tested on HiFive Unleashed and Qemu for RISC-V. Tested on Qemu for ARM64. Signed-off-by: Atish Patra <atish.patra@wdc.com> Reviewed-by: Tom Rini <trini@konsulko.com> [trini: Fix minor rST formatting problems] Signed-off-by: Tom Rini <trini@konsulko.com>
Diffstat (limited to 'doc/README.distro')
-rw-r--r--doc/README.distro12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/README.distro b/doc/README.distro
index ab6e6f4e74..5076bebd18 100644
--- a/doc/README.distro
+++ b/doc/README.distro
@@ -246,6 +246,18 @@ kernel_addr_r:
A size of 16MB for the kernel is likely adequate.
+kernel_comp_addr_r:
+ Optional. This is only required if user wants to boot Linux from a compressed
+ Image(.gz, .bz2, .lzma, .lzo) using booti command. It represents the location
+ in RAM where the compressed Image will be decompressed temporarily. Once the
+ decompression is complete, decompressed data will be moved kernel_addr_r for
+ booting.
+
+kernel_comp_size:
+ Optional. This is only required if user wants to boot Linux from a compressed
+ Image using booti command. It represents the size of the compressed file. The
+ size has to at least the size of loaded image for decompression to succeed.
+
pxefile_addr_r:
Mandatory. The location in RAM where extlinux.conf will be loaded to prior