doc/dumpimage.1

   1 .\" SPDX-License-Identifier: GPL-2.0
   2 .\" Copyright (C) 2022 Sean Anderson <seanga2@gmail.com>
   3 .TH DUMPIMAGE 1 2022-06-11 U-Boot
   4 .SH NAME
   5 dumpimage \- extract data from U-Boot images
   6 .
   7 .SH SYNOPSIS
   8 .SY dumpimage
   9 .OP \-T type
  10 .BI \-l\~ image
  11 .YS
  12 .SY dumpimage
  13 .OP \-T type
  14 .OP \-p position
  15 .BI \-o\~ outfile
  16 .I image
  17 .YS
  18 .SY dumpimage
  19 .B \-h
  20 .YS
  21 .SY dumpimage
  22 .B \-V
  23 .YS
  24 .
  25 .SH DESCRIPTION
  26 .B dumpimage
  27 lists and extracts data from U-Boot images. If
  28 .B \-l
  29 is specified,
  30 .B dumpimage
  31 lists the components in
  32 .IR image .
  33 Otherwise,
  34 .B dumpimage
  35 extracts the component at
  36 .IR position " to " outfile .
  37 .
  38 .SH OPTIONS
  39 .TP
  40 .B \-h
  41 Print usage information and exit.
  42 .
  43 .TP
  44 .B \-l
  45 Print the header information for
  46 .IR image ,
  47 including a list of components.
  48 .
  49 .TP
  50 .BI \-o " outfile"
  51 The file to write the dumped component to.
  52 .TP
  53 .BI \-p " position"
  54 Specify the
  55 .I position
  56 of the component to dump. This should be a numeric index, starting at 0. If not
  57 specified, the default
  58 .I position
  59 is 0.
  60 .
  61 .TP
  62 .BI \-T " type"
  63 Specify the
  64 .I type
  65 of the image. If not specified, the image type will be automatically detected. A
  66 list of supported image types may be printed by running
  67 .BR "mkimage\~\-T\~list" .
  68 .
  69 .TP
  70 .B \-V
  71 Print version information and exit.
  72 .
  73 .SH BUGS
  74 Please report bugs to the
  75 .UR https://\:source\:.denx\:.de/\:u-boot/\:u-boot/\:issues
  76 U-Boot bug tracker
  77 .UE .
  78 .SH EXAMPLES
  79 Create a multi-file image and then extract part of that image
  80 .PP
  81 .EX
  82 .in +4
  83 $ \c
  84 .B mkimage \-A x86 \-O linux \-T multi \-n x86 \\\\\&
  85 .in +4
  86 .B \-d vmlinuz:initrd.img:System.map multi.img
  87 .in
  88 Image Name:   x86
  89 Created:      Thu Jul 25 10:29:13 2013
  90 Image Type:   Intel x86 Linux Multi-File Image (gzip compressed)
  91 Data Size:    13722956 Bytes = 13401.32 kB = 13.09 MB
  92 Load Address: 00000000
  93 Entry Point:  00000000
  94 Contents:
  95    Image 0: 4040128 Bytes = 3945.44 kB = 3.85 MB
  96    Image 1: 7991719 Bytes = 7804.41 kB = 7.62 MB
  97    Image 2: 1691092 Bytes = 1651.46 kB = 1.61 MB
  98 $ \c
  99 .B dumpimage -p 2 -o System.map multi.img
 100 .EE
 101 .in
 102 .SH SEE ALSO
 103 .BR mkimage (1)