mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-11-30 00:21:06 +00:00
e297f874a1
This tool seems a bit underloved. Unfortunately, it seems to be missing
support for FIT images. Alas...
Add a man page documenting it. The example is taken from commit a804b5ce2d
("Add dumpimage, a tool to extract data from U-Boot images").
Signed-off-by: Sean Anderson <seanga2@gmail.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
103 lines
2 KiB
Groff
103 lines
2 KiB
Groff
.\" SPDX-License-Identifier: GPL-2.0
|
|
.\" Copyright (C) 2022 Sean Anderson <seanga2@gmail.com>
|
|
.TH DUMPIMAGE 1 2022-06-11 U-Boot
|
|
.SH NAME
|
|
dumpimage \- extract data from U-Boot images
|
|
.
|
|
.SH SYNOPSIS
|
|
.SY dumpimage
|
|
.OP \-T type
|
|
.BI \-l\~ image
|
|
.YS
|
|
.SY dumpimage
|
|
.OP \-T type
|
|
.OP \-p position
|
|
.BI \-o\~ outfile
|
|
.I image
|
|
.YS
|
|
.SY dumpimage
|
|
.B \-h
|
|
.YS
|
|
.SY dumpimage
|
|
.B \-V
|
|
.YS
|
|
.
|
|
.SH DESCRIPTION
|
|
.B dumpimage
|
|
lists and extracts data from U-Boot images. If
|
|
.B \-l
|
|
is specified,
|
|
.B dumpimage
|
|
lists the components in
|
|
.IR image .
|
|
Otherwise,
|
|
.B dumpimage
|
|
extracts the component at
|
|
.IR position " to " outfile .
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-h
|
|
Print usage information and exit.
|
|
.
|
|
.TP
|
|
.B \-l
|
|
Print the header information for
|
|
.IR image ,
|
|
including a list of components.
|
|
.
|
|
.TP
|
|
.BI \-o " outfile"
|
|
The file to write the dumped component to.
|
|
.TP
|
|
.BI \-p " position"
|
|
Specify the
|
|
.I position
|
|
of the component to dump. This should be a numeric index, starting at 0. If not
|
|
specified, the default
|
|
.I position
|
|
is 0.
|
|
.
|
|
.TP
|
|
.BI \-T " type"
|
|
Specify the
|
|
.I type
|
|
of the image. If not specified, the image type will be automatically detected. A
|
|
list of supported image types may be printed by running
|
|
.BR "mkimage\~\-T\~list" .
|
|
.
|
|
.TP
|
|
.B \-V
|
|
Print version information and exit.
|
|
.
|
|
.SH BUGS
|
|
Please report bugs to the
|
|
.UR https://\:source\:.denx\:.de/\:u-boot/\:u-boot/\:issues
|
|
U-Boot bug tracker
|
|
.UE .
|
|
.SH EXAMPLES
|
|
Create a multi-file image and then extract part of that image
|
|
.PP
|
|
.EX
|
|
.in +4
|
|
$ \c
|
|
.B mkimage \-A x86 \-O linux \-T multi \-n x86 \\\\\&
|
|
.in +4
|
|
.B \-d vmlinuz:initrd.img:System.map multi.img
|
|
.in
|
|
Image Name: x86
|
|
Created: Thu Jul 25 10:29:13 2013
|
|
Image Type: Intel x86 Linux Multi-File Image (gzip compressed)
|
|
Data Size: 13722956 Bytes = 13401.32 kB = 13.09 MB
|
|
Load Address: 00000000
|
|
Entry Point: 00000000
|
|
Contents:
|
|
Image 0: 4040128 Bytes = 3945.44 kB = 3.85 MB
|
|
Image 1: 7991719 Bytes = 7804.41 kB = 7.62 MB
|
|
Image 2: 1691092 Bytes = 1651.46 kB = 1.61 MB
|
|
$ \c
|
|
.B dumpimage -p 2 -o System.map multi.img
|
|
.EE
|
|
.in
|
|
.SH SEE ALSO
|
|
.BR mkimage (1)
|