1MKIMAGE(1)                  General Commands Manual                 MKIMAGE(1)
2
3
4

NAME

6       mkimage - Generate image for U-Boot
7

SYNOPSIS

9       mkimage [options]
10

DESCRIPTION

12       The  mkimage  command  is used to create images for use with the U-Boot
13       boot loader.  Thes eimages can contain the linux  kernel,  device  tree
14       blob,  root file system image, firmware images etc., either separate or
15       combined.
16
17       mkimage supports two different formats:
18
19       The old, legacy image format concatenates  the  individual  parts  (for
20       example,  kernel  image, device tree blob and ramdisk image) and adds a
21       64 bytes header containing information about target architecture, oper‐
22       ating system, image type, compression method, entry points, time stamp,
23       checksums, etc.
24
25       The new, FIT (Flattened Image Tree) format allows for more  flexibility
26       in handling images of various and also enhances integrity protection of
27       images with stronger checksums.
28
29

OPTIONS

31       List image information:
32
33
34       -l [uimage file name]
35              mkimage lists the information contained  in  the  header  of  an
36              existing U-Boot image.
37
38
39       Create old legacy image:
40
41
42       -A [architecture]
43              Set architecture. Pass -h as the architecture to see the list of
44              supported architectures.
45
46
47       -O [os]
48              Set operating system.  bootm  command  of  u-boot  changes  boot
49              method  by  os  type.  Pass -h as the OS to see the list of sup‐
50              ported OS.
51
52
53       -T [image type]
54              Set image type.  Pass -h as the image to see the  list  of  sup‐
55              ported image type.
56
57
58       -C [compression type]
59              Set  compression  type.   Pass  -h as the compression to see the
60              list of supported compression type.
61
62
63       -a [load addess]
64              Set load address with a hex number.
65
66
67       -e [entry point]
68              Set entry point with a hex number.
69
70
71       -n [image name]
72              Set image name to 'image name'.
73
74
75       -d [image data file]
76              Use image data from 'image data file'.
77
78
79       -x     Set XIP (execute in place) flag.
80
81
82       Create FIT image:
83
84
85       -D dtcoption"
86              Provide special options to the device tree compiler that is used
87              to create the image.
88
89
90       -f fit-image.its"
91              Image  tree source fine that descbres the structure and contents
92              of the FIT image.
93
94

EXMAPLES

96       List image information:
97       mkimage -l uImage
98
99       Create legacy image with compressed PowerPC Linux kernel:
100       mkimage -A powerpc -O linux -T kernel -C gzip \
101       -a 0 -e 0 -n Linux -d vmlinux.gz uImage
102
103       Create FIT image with compressed PowerPC Linux kernel:
104       mkimage -f kernel.its kernel.itb
105
106

HOMEPAGE

108       http://www.denx.de/wiki/U-Boot/WebHome
109

AUTHOR

111       This   manual   page   was   written   by   Nobuhiro   Iwamatsu   <iwa‐
112       matsu@nigauri.org> and Wolfgang Denk <wd@denx.de>
113
114
115
116                                  2010-05-16                        MKIMAGE(1)
Impressum