u-boot/doc/mkimage.1

1 .TH MKIMAGE 1 "2010-05-16"
4 mkimage \- Generate image for U-Boot
7 .RB "\-l [" "uimage file name" "]"
10 .RB [\fIoptions\fP] " \-f [" "image tree source file" "]" " [" "uimage file name" "]"
13 .RB [\fIoptions\fP] " \-F [" "uimage file name" "]"
21 command is used to create images for use with the U-Boot boot loader.
40 supports verified boot.
47 .BI "\-l [" "uimage file name" "]"
48 mkimage lists the information contained in the header of an existing U-Boot image.
54 .BI "\-A [" "architecture" "]"
55 Set architecture. Pass \-h as the architecture to see the list of supported architectures.
58 .BI "\-O [" "os" "]"
59 Set operating system. bootm command of u-boot changes boot method by os type.
60 Pass \-h as the OS to see the list of supported OS.
63 .BI "\-T [" "image type" "]"
65 Pass \-h as the image to see the list of supported image type.
68 .BI "\-C [" "compression type" "]"
70 Pass \-h as the compression to see the list of supported compression type.
73 .BI "\-a [" "load address" "]"
77 .BI "\-e [" "entry point" "]"
81 .BI "\-l"
85 .BI "\-n [" "image name" "]"
89 .BI "\-d [" "image data file" "]"
93 .BI "\-x"
100 .BI "\-b [" "device tree file" "]
104 .BI "\-c [" "comment" "]"
110 .BI "\-D [" "dtc options" "]"
115 .BI "\-E
118 FIT, with each one aligned to a 4-byte boundary. The existing 'data' property
119 in each image will be replaced with 'data-offset' and 'data-size' properties.
120 A 'data-offset' of 0 indicates that it starts in the first (4-byte aligned)
124 .BI "\-f [" "image tree source file" " | " "auto" "]"
129 Use "-f auto" for this. In that case the arguments -d, -A, -O, -T, -C, -a
130 and -e are used to specify the image to include in the FIT and its attributes.
134 .BI "\-F"
136 compilation is performed and the \-f flag should not be given.
141 .BI "\-i [" "ramdisk_file" "]"
145 .BI "\-k [" "key_directory" "]"
151 .BI "\-K [" "key_destination" "]"
154 the corresponding public key is written into this file for for run-time
156 CONFIG_OF_CONTROL in U-Boot.
159 .BI "\-p [" "external position" "]"
160 Place external data at a static external position. See \-E. Instead of writing
161 a 'data-offset' property defining the offset from the end of the FIT, \-p will
162 use 'data-position' as the absolute position from the base of the FIT.
165 .BI "\-r
167 must be verified for the image to boot. Without this option, the verification
174 .B mkimage -l uImage
179 .B mkimage -A powerpc -O linux -T kernel -C gzip \\\\
181 .B -a 0 -e 0 -n Linux -d vmlinux.gz uImage
186 .B mkimage -f kernel.its kernel.itb
190 /public/signing-keys directory. Add corresponding public keys into u-boot.dtb,
193 .B mkimage -f kernel.its -k /public/signing-keys -K u-boot.dtb \\\\
195 .B -c """Kernel 3.8 image for production devices""" kernel.itb
200 Add corresponding public keys into u-boot.dtb. This will resign all images
204 .B mkimage -F -k /secret/signing-keys -K u-boot.dtb \\\\
206 .B -c """Kernel 3.8 image for production devices""" kernel.itb
213 .B mkimage -f auto -A arm -O linux -T kernel -C none -a 43e00000 -e 0 \\\\
215 .B -c """Kernel 4.4 image for production devices""" -d vmlinuz kernel.itb
221 .B mkimage -f auto -A arm -O linux -T kernel -C none -a 43e00000 -e 0 \\\\
223 .B -c """Kernel 4.4 image for production devices""" -d vmlinuz \\\\
224 .B -b /path/to/rk3288-firefly.dtb -b /path/to/rk3288-jerry.dtb kernel.itb
228 http://www.denx.de/wiki/U-Boot/WebHome