]>
Commit | Line | Data |
---|---|---|
cd153556 NI |
1 | .TH MKIMAGE 1 "2010-05-16" |
2 | ||
3 | .SH NAME | |
4 | mkimage \- Generate image for U-Boot | |
5 | .SH SYNOPSIS | |
6 | .B mkimage | |
7 | .RB [\fIoptions\fP] | |
8 | .SH "DESCRIPTION" | |
9 | The | |
10 | .B mkimage | |
11 | command is used to create images for use with the U-Boot boot loader. | |
12 | Thes eimages can contain the linux kernel, device tree blob, root file | |
13 | system image, firmware images etc., either separate or combined. | |
14 | ||
15 | .B mkimage | |
16 | supports two different formats: | |
17 | ||
18 | The old, | |
19 | .I legacy image | |
20 | format concatenates the individual parts (for example, kernel image, | |
21 | device tree blob and ramdisk image) and adds a 64 bytes header | |
22 | containing information about target architecture, operating system, | |
23 | image type, compression method, entry points, time stamp, checksums, | |
24 | etc. | |
25 | ||
26 | The new, | |
27 | .I FIT (Flattened Image Tree) format | |
28 | allows for more flexibility in handling images of various and also | |
29 | enhances integrity protection of images with stronger checksums. | |
30 | ||
31 | .SH "OPTIONS" | |
32 | ||
33 | .B List image information: | |
34 | ||
35 | .TP | |
36 | .BI "\-l [" "uimage file name" "]" | |
37 | mkimage lists the information contained in the header of an existing U-Boot image. | |
38 | ||
39 | .P | |
40 | .B Create old legacy image: | |
41 | ||
42 | .TP | |
43 | .BI "\-A [" "architecture" "]" | |
44 | Set architecture. Pass -h as the architecture to see the list of supported architectures. | |
45 | ||
46 | .TP | |
47 | .BI "\-O [" "os" "]" | |
48 | Set operating system. bootm command of u-boot changes boot method by os type. | |
49 | Pass -h as the OS to see the list of supported OS. | |
50 | ||
51 | .TP | |
52 | .BI "\-T [" "image type" "]" | |
53 | Set image type. | |
54 | Pass -h as the image to see the list of supported image type. | |
55 | ||
56 | .TP | |
57 | .BI "\-C [" "compression type" "]" | |
58 | Set compression type. | |
59 | Pass -h as the compression to see the list of supported compression type. | |
60 | ||
61 | .TP | |
62 | .BI "\-a [" "load addess" "]" | |
63 | Set load address with a hex number. | |
64 | ||
65 | .TP | |
66 | .BI "\-e [" "entry point" "]" | |
67 | Set entry point with a hex number. | |
68 | ||
69 | .TP | |
70 | .BI "\-n [" "image name" "]" | |
71 | Set image name to 'image name'. | |
72 | ||
73 | .TP | |
74 | .BI "\-d [" "image data file" "]" | |
75 | Use image data from 'image data file'. | |
76 | ||
77 | .TP | |
78 | .BI "\-x" | |
79 | Set XIP (execute in place) flag. | |
80 | ||
81 | .P | |
82 | .B Create FIT image: | |
83 | ||
84 | .TP | |
85 | .BI "\-D "dtc option" | |
86 | Provide special options to the device tree compiler that is used to | |
87 | create the image. | |
88 | ||
89 | .TP | |
90 | .BI "\-f "fit-image.its" | |
91 | Image tree source fine that descbres the structure and contents of the | |
92 | FIT image. | |
93 | ||
94 | .SH EXMAPLES | |
95 | ||
96 | List image information: | |
97 | .nf | |
98 | .B mkimage -l uImage | |
99 | .fi | |
100 | .P | |
101 | Create legacy image with compressed PowerPC Linux kernel: | |
102 | .nf | |
103 | .B mkimage -A powerpc -O linux -T kernel -C gzip \\\\ | |
104 | .br | |
105 | .B -a 0 -e 0 -n Linux -d vmlinux.gz uImage | |
106 | .fi | |
107 | .P | |
108 | Create FIT image with compressed PowerPC Linux kernel: | |
109 | .nf | |
110 | .B mkimage -f kernel.its kernel.itb | |
111 | .fi | |
112 | ||
113 | .SH HOMEPAGE | |
114 | http://www.denx.de/wiki/U-Boot/WebHome | |
115 | .PP | |
116 | .SH AUTHOR | |
117 | This manual page was written by Nobuhiro Iwamatsu <iwamatsu@nigauri.org> | |
118 | and Wolfgang Denk <wd@denx.de> |