| Nobuhiro Iwamatsu | 9711cf6 | 2010-06-16 10:38:24 +0900 | [diff] [blame] | 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> |