dumpimage.1 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  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)