2 * (C) Copyright 2008 Semihalf
4 * (C) Copyright 2000-2004
5 * DENX Software Engineering
6 * Wolfgang Denk, wd@denx.de
8 * Updated-by: Prafulla Wadaskar <prafulla@marvell.com>
9 * FIT image specific code abstracted from mkimage.c
10 * some functions added to address abstraction
12 * All rights reserved.
14 * SPDX-License-Identifier: GPL-2.0+
17 #include "imagetool.h"
18 #include "fit_common.h"
23 #include <u-boot/crc.h>
25 static image_header_t header
;
27 static int fit_add_file_data(struct image_tool_params
*params
, size_t size_inc
,
31 void *dest_blob
= NULL
;
32 off_t destfd_size
= 0;
37 tfd
= mmap_fdt(params
->cmdname
, tmpfile
, size_inc
, &ptr
, &sbuf
, true);
41 if (params
->keydest
) {
42 struct stat dest_sbuf
;
44 destfd
= mmap_fdt(params
->cmdname
, params
->keydest
, size_inc
,
45 &dest_blob
, &dest_sbuf
, false);
50 destfd_size
= dest_sbuf
.st_size
;
53 /* for first image creation, add a timestamp at offset 0 i.e., root */
55 ret
= fit_set_timestamp(ptr
, 0, sbuf
.st_mtime
);
58 ret
= fit_add_verification_data(params
->keydir
, dest_blob
, ptr
,
60 params
->require_keys
);
64 munmap(dest_blob
, destfd_size
);
69 munmap(ptr
, sbuf
.st_size
);
76 * fit_calc_size() - Calculate the approximate size of the FIT we will generate
78 static int fit_calc_size(struct image_tool_params
*params
)
80 struct content_info
*cont
;
83 size
= imagetool_get_filesize(params
, params
->datafile
);
88 for (cont
= params
->content_head
; cont
; cont
= cont
->next
) {
89 size
= imagetool_get_filesize(params
, cont
->fname
);
93 /* Add space for properties */
94 total_size
+= size
+ 300;
97 /* Add plenty of space for headers, properties, nodes, etc. */
103 static int fdt_property_file(struct image_tool_params
*params
,
104 void *fdt
, const char *name
, const char *fname
)
111 fd
= open(fname
, O_RDWR
| O_BINARY
);
113 fprintf(stderr
, "%s: Can't open %s: %s\n",
114 params
->cmdname
, fname
, strerror(errno
));
118 if (fstat(fd
, &sbuf
) < 0) {
119 fprintf(stderr
, "%s: Can't stat %s: %s\n",
120 params
->cmdname
, fname
, strerror(errno
));
124 ret
= fdt_property_placeholder(fdt
, "data", sbuf
.st_size
, &ptr
);
127 ret
= read(fd
, ptr
, sbuf
.st_size
);
128 if (ret
!= sbuf
.st_size
) {
129 fprintf(stderr
, "%s: Can't read %s: %s\n",
130 params
->cmdname
, fname
, strerror(errno
));
141 static int fdt_property_strf(void *fdt
, const char *name
, const char *fmt
, ...)
147 vsnprintf(str
, sizeof(str
), fmt
, ptr
);
149 return fdt_property_string(fdt
, name
, str
);
152 static void get_basename(char *str
, int size
, const char *fname
)
154 const char *p
, *start
, *end
;
158 * Use the base name as the 'name' field. So for example:
160 * "arch/arm/dts/sun7i-a20-bananapro.dtb"
161 * becomes "sun7i-a20-bananapro"
163 p
= strrchr(fname
, '/');
164 start
= p
? p
+ 1 : fname
;
165 p
= strrchr(fname
, '.');
166 end
= p
? p
: fname
+ strlen(fname
);
170 memcpy(str
, start
, len
);
175 * fit_write_images() - Write out a list of images to the FIT
177 * We always include the main image (params->datafile). If there are device
178 * tree files, we include an fdt@ node for each of those too.
180 static int fit_write_images(struct image_tool_params
*params
, char *fdt
)
182 struct content_info
*cont
;
183 const char *typename
;
188 fdt_begin_node(fdt
, "images");
190 /* First the main image */
191 typename
= genimg_get_type_short_name(params
->fit_image_type
);
192 snprintf(str
, sizeof(str
), "%s@1", typename
);
193 fdt_begin_node(fdt
, str
);
194 fdt_property_string(fdt
, "description", params
->imagename
);
195 fdt_property_string(fdt
, "type", typename
);
196 fdt_property_string(fdt
, "arch", genimg_get_arch_name(params
->arch
));
197 fdt_property_string(fdt
, "os", genimg_get_os_short_name(params
->os
));
198 fdt_property_string(fdt
, "compression",
199 genimg_get_comp_short_name(params
->comp
));
200 fdt_property_u32(fdt
, "load", params
->addr
);
201 fdt_property_u32(fdt
, "entry", params
->ep
);
204 * Put data last since it is large. SPL may only load the first part
205 * of the DT, so this way it can access all the above fields.
207 ret
= fdt_property_file(params
, fdt
, "data", params
->datafile
);
212 /* Now the device tree files if available */
214 for (cont
= params
->content_head
; cont
; cont
= cont
->next
) {
215 if (cont
->type
!= IH_TYPE_FLATDT
)
217 snprintf(str
, sizeof(str
), "%s@%d", FIT_FDT_PROP
, ++upto
);
218 fdt_begin_node(fdt
, str
);
220 get_basename(str
, sizeof(str
), cont
->fname
);
221 fdt_property_string(fdt
, "description", str
);
222 ret
= fdt_property_file(params
, fdt
, "data", cont
->fname
);
225 fdt_property_string(fdt
, "type", typename
);
226 fdt_property_string(fdt
, "arch",
227 genimg_get_arch_short_name(params
->arch
));
228 fdt_property_string(fdt
, "compression",
229 genimg_get_comp_short_name(IH_COMP_NONE
));
239 * fit_write_configs() - Write out a list of configurations to the FIT
241 * If there are device tree files, we include a configuration for each, which
242 * selects the main image (params->datafile) and its corresponding device
245 * Otherwise we just create a configuration with the main image in it.
247 static void fit_write_configs(struct image_tool_params
*params
, char *fdt
)
249 struct content_info
*cont
;
250 const char *typename
;
254 fdt_begin_node(fdt
, "configurations");
255 fdt_property_string(fdt
, "default", "conf@1");
258 for (cont
= params
->content_head
; cont
; cont
= cont
->next
) {
259 if (cont
->type
!= IH_TYPE_FLATDT
)
261 typename
= genimg_get_type_short_name(cont
->type
);
262 snprintf(str
, sizeof(str
), "conf@%d", ++upto
);
263 fdt_begin_node(fdt
, str
);
265 get_basename(str
, sizeof(str
), cont
->fname
);
266 fdt_property_string(fdt
, "description", str
);
268 typename
= genimg_get_type_short_name(params
->fit_image_type
);
269 snprintf(str
, sizeof(str
), "%s@1", typename
);
270 fdt_property_string(fdt
, typename
, str
);
272 snprintf(str
, sizeof(str
), FIT_FDT_PROP
"@%d", upto
);
273 fdt_property_string(fdt
, FIT_FDT_PROP
, str
);
277 fdt_begin_node(fdt
, "conf@1");
278 typename
= genimg_get_type_short_name(params
->fit_image_type
);
279 snprintf(str
, sizeof(str
), "%s@1", typename
);
280 fdt_property_string(fdt
, typename
, str
);
287 static int fit_build_fdt(struct image_tool_params
*params
, char *fdt
, int size
)
291 ret
= fdt_create(fdt
, size
);
294 fdt_finish_reservemap(fdt
);
295 fdt_begin_node(fdt
, "");
296 fdt_property_strf(fdt
, "description",
297 "%s image with one or more FDT blobs",
298 genimg_get_type_name(params
->fit_image_type
));
299 fdt_property_strf(fdt
, "creator", "U-Boot mkimage %s", PLAIN_VERSION
);
300 fdt_property_u32(fdt
, "#address-cells", 1);
301 ret
= fit_write_images(params
, fdt
);
304 fit_write_configs(params
, fdt
);
306 ret
= fdt_finish(fdt
);
310 return fdt_totalsize(fdt
);
313 static int fit_build(struct image_tool_params
*params
, const char *fname
)
320 size
= fit_calc_size(params
);
325 fprintf(stderr
, "%s: Out of memory (%d bytes)\n",
326 params
->cmdname
, size
);
329 ret
= fit_build_fdt(params
, buf
, size
);
331 fprintf(stderr
, "%s: Failed to build FIT image\n",
336 fd
= open(fname
, O_RDWR
| O_CREAT
| O_TRUNC
| O_BINARY
, 0666);
338 fprintf(stderr
, "%s: Can't open %s: %s\n",
339 params
->cmdname
, fname
, strerror(errno
));
342 ret
= write(fd
, buf
, size
);
344 fprintf(stderr
, "%s: Can't write %s: %s\n",
345 params
->cmdname
, fname
, strerror(errno
));
360 * fit_extract_data() - Move all data outside the FIT
362 * This takes a normal FIT file and removes all the 'data' properties from it.
363 * The data is placed in an area after the FIT so that it can be accessed
364 * using an offset into that area. The 'data' properties turn into
365 * 'data-offset' properties.
367 * This function cannot cope with FITs with 'data-offset' properties. All
368 * data must be in 'data' properties on entry.
370 static int fit_extract_data(struct image_tool_params
*params
, const char *fname
)
374 int fit_size
, new_size
;
382 fd
= mmap_fdt(params
->cmdname
, fname
, 0, &fdt
, &sbuf
, false);
385 fit_size
= fdt_totalsize(fdt
);
387 /* Allocate space to hold the image data we will extract */
388 buf
= malloc(fit_size
);
395 images
= fdt_path_offset(fdt
, FIT_IMAGES_PATH
);
397 debug("%s: Cannot find /images node: %d\n", __func__
, images
);
402 for (node
= fdt_first_subnode(fdt
, images
);
404 node
= fdt_next_subnode(fdt
, node
)) {
408 data
= fdt_getprop(fdt
, node
, "data", &len
);
411 memcpy(buf
+ buf_ptr
, data
, len
);
412 debug("Extracting data size %x\n", len
);
414 ret
= fdt_delprop(fdt
, node
, "data");
419 if (params
->external_offset
> 0) {
420 /* An external offset positions the data absolutely. */
421 fdt_setprop_u32(fdt
, node
, "data-position",
422 params
->external_offset
+ buf_ptr
);
424 fdt_setprop_u32(fdt
, node
, "data-offset", buf_ptr
);
426 fdt_setprop_u32(fdt
, node
, "data-size", len
);
428 buf_ptr
+= (len
+ 3) & ~3;
431 /* Pack the FDT and place the data after it */
434 debug("Size reduced from %x to %x\n", fit_size
, fdt_totalsize(fdt
));
435 debug("External data size %x\n", buf_ptr
);
436 new_size
= fdt_totalsize(fdt
);
437 new_size
= (new_size
+ 3) & ~3;
438 munmap(fdt
, sbuf
.st_size
);
440 if (ftruncate(fd
, new_size
)) {
441 debug("%s: Failed to truncate file: %s\n", __func__
,
447 /* Check if an offset for the external data was set. */
448 if (params
->external_offset
> 0) {
449 if (params
->external_offset
< new_size
) {
450 debug("External offset %x overlaps FIT length %x",
451 params
->external_offset
, new_size
);
455 new_size
= params
->external_offset
;
457 if (lseek(fd
, new_size
, SEEK_SET
) < 0) {
458 debug("%s: Failed to seek to end of file: %s\n", __func__
,
463 if (write(fd
, buf
, buf_ptr
) != buf_ptr
) {
464 debug("%s: Failed to write external data to file %s\n",
465 __func__
, strerror(errno
));
473 munmap(fdt
, sbuf
.st_size
);
481 static int fit_import_data(struct image_tool_params
*params
, const char *fname
)
484 int fit_size
, new_size
, size
, data_base
;
491 fd
= mmap_fdt(params
->cmdname
, fname
, 0, &old_fdt
, &sbuf
, false);
494 fit_size
= fdt_totalsize(old_fdt
);
495 data_base
= (fit_size
+ 3) & ~3;
497 /* Allocate space to hold the new FIT */
498 size
= sbuf
.st_size
+ 16384;
501 fprintf(stderr
, "%s: Failed to allocate memory (%d bytes)\n",
506 ret
= fdt_open_into(old_fdt
, fdt
, size
);
508 debug("%s: Failed to expand FIT: %s\n", __func__
,
509 fdt_strerror(errno
));
514 images
= fdt_path_offset(fdt
, FIT_IMAGES_PATH
);
516 debug("%s: Cannot find /images node: %d\n", __func__
, images
);
521 for (node
= fdt_first_subnode(fdt
, images
);
523 node
= fdt_next_subnode(fdt
, node
)) {
527 buf_ptr
= fdtdec_get_int(fdt
, node
, "data-offset", -1);
528 len
= fdtdec_get_int(fdt
, node
, "data-size", -1);
529 if (buf_ptr
== -1 || len
== -1)
531 debug("Importing data size %x\n", len
);
533 ret
= fdt_setprop(fdt
, node
, "data", fdt
+ data_base
+ buf_ptr
,
536 debug("%s: Failed to write property: %s\n", __func__
,
543 munmap(old_fdt
, sbuf
.st_size
);
546 /* Pack the FDT and place the data after it */
549 new_size
= fdt_totalsize(fdt
);
550 debug("Size expanded from %x to %x\n", fit_size
, new_size
);
552 fd
= open(fname
, O_RDWR
| O_CREAT
| O_TRUNC
| O_BINARY
, 0666);
554 fprintf(stderr
, "%s: Can't open %s: %s\n",
555 params
->cmdname
, fname
, strerror(errno
));
559 if (write(fd
, fdt
, new_size
) != new_size
) {
560 debug("%s: Failed to write external data to file %s\n",
561 __func__
, strerror(errno
));
575 * fit_handle_file - main FIT file processing function
577 * fit_handle_file() runs dtc to convert .its to .itb, includes
578 * binary data, updates timestamp property and calculates hashes.
580 * datafile - .its file
581 * imagefile - .itb file
584 * only on success, otherwise calls exit (EXIT_FAILURE);
586 static int fit_handle_file(struct image_tool_params
*params
)
588 char tmpfile
[MKIMAGE_MAX_TMPFILE_LEN
];
589 char cmd
[MKIMAGE_MAX_DTC_CMDLINE_LEN
];
593 /* Flattened Image Tree (FIT) format handling */
594 debug ("FIT format handling\n");
596 /* call dtc to include binary properties into the tmp file */
597 if (strlen (params
->imagefile
) +
598 strlen (MKIMAGE_TMPFILE_SUFFIX
) + 1 > sizeof (tmpfile
)) {
599 fprintf (stderr
, "%s: Image file name (%s) too long, "
600 "can't create tmpfile",
601 params
->imagefile
, params
->cmdname
);
602 return (EXIT_FAILURE
);
604 sprintf (tmpfile
, "%s%s", params
->imagefile
, MKIMAGE_TMPFILE_SUFFIX
);
606 /* We either compile the source file, or use the existing FIT image */
607 if (params
->auto_its
) {
608 if (fit_build(params
, tmpfile
)) {
609 fprintf(stderr
, "%s: failed to build FIT\n",
614 } else if (params
->datafile
) {
615 /* dtc -I dts -O dtb -p 500 datafile > tmpfile */
616 snprintf(cmd
, sizeof(cmd
), "%s %s %s > %s",
617 MKIMAGE_DTC
, params
->dtc
, params
->datafile
, tmpfile
);
618 debug("Trying to execute \"%s\"\n", cmd
);
620 snprintf(cmd
, sizeof(cmd
), "cp %s %s",
621 params
->imagefile
, tmpfile
);
623 if (*cmd
&& system(cmd
) == -1) {
624 fprintf (stderr
, "%s: system(%s) failed: %s\n",
625 params
->cmdname
, cmd
, strerror(errno
));
629 /* Move the data so it is internal to the FIT, if needed */
630 ret
= fit_import_data(params
, tmpfile
);
635 * Set hashes for images in the blob. Unfortunately we may need more
636 * space in either FDT, so keep trying until we succeed.
638 * Note: this is pretty inefficient for signing, since we must
639 * calculate the signature every time. It would be better to calculate
640 * all the data and then store it in a separate step. However, this
641 * would be considerably more complex to implement. Generally a few
642 * steps of this loop is enough to sign with several keys.
644 for (size_inc
= 0; size_inc
< 64 * 1024; size_inc
+= 1024) {
645 ret
= fit_add_file_data(params
, size_inc
, tmpfile
);
646 if (!ret
|| ret
!= -ENOSPC
)
651 fprintf(stderr
, "%s Can't add hashes to FIT blob\n",
656 /* Move the data so it is external to the FIT, if requested */
657 if (params
->external_data
) {
658 ret
= fit_extract_data(params
, tmpfile
);
663 if (rename (tmpfile
, params
->imagefile
) == -1) {
664 fprintf (stderr
, "%s: Can't rename %s to %s: %s\n",
665 params
->cmdname
, tmpfile
, params
->imagefile
,
668 unlink (params
->imagefile
);
679 * fit_image_extract - extract a FIT component image
680 * @fit: pointer to the FIT format image header
681 * @image_noffset: offset of the component image node
682 * @file_name: name of the file to store the FIT sub-image
685 * zero in case of success or a negative value if fail.
687 static int fit_image_extract(
690 const char *file_name
)
692 const void *file_data
;
693 size_t file_size
= 0;
695 /* get the "data" property of component at offset "image_noffset" */
696 fit_image_get_data(fit
, image_noffset
, &file_data
, &file_size
);
698 /* save the "file_data" into the file specified by "file_name" */
699 return imagetool_save_subimage(file_name
, (ulong
) file_data
, file_size
);
703 * fit_extract_contents - retrieve a sub-image component from the FIT image
704 * @ptr: pointer to the FIT format image header
705 * @params: command line parameters
708 * zero in case of success or a negative value if fail.
710 static int fit_extract_contents(void *ptr
, struct image_tool_params
*params
)
715 const void *fit
= ptr
;
719 /* Indent string is defined in header image.h */
720 p
= IMAGE_INDENT_STRING
;
722 if (!fit_check_format(fit
)) {
723 printf("Bad FIT image format\n");
727 /* Find images parent node offset */
728 images_noffset
= fdt_path_offset(fit
, FIT_IMAGES_PATH
);
729 if (images_noffset
< 0) {
730 printf("Can't find images parent node '%s' (%s)\n",
731 FIT_IMAGES_PATH
, fdt_strerror(images_noffset
));
735 /* Avoid any overrun */
736 count
= fit_get_subimage_count(fit
, images_noffset
);
737 if ((params
->pflag
< 0) || (count
<= params
->pflag
)) {
738 printf("No such component at '%d'\n", params
->pflag
);
742 /* Process its subnodes, extract the desired component from image */
743 for (ndepth
= 0, count
= 0,
744 noffset
= fdt_next_node(fit
, images_noffset
, &ndepth
);
745 (noffset
>= 0) && (ndepth
> 0);
746 noffset
= fdt_next_node(fit
, noffset
, &ndepth
)) {
749 * Direct child node of the images parent node,
750 * i.e. component image node.
752 if (params
->pflag
== count
) {
753 printf("Extracted:\n%s Image %u (%s)\n", p
,
754 count
, fit_get_name(fit
, noffset
, NULL
));
756 fit_image_print(fit
, noffset
, p
);
758 return fit_image_extract(fit
, noffset
,
769 static int fit_check_params(struct image_tool_params
*params
)
771 if (params
->auto_its
)
773 return ((params
->dflag
&& (params
->fflag
|| params
->lflag
)) ||
774 (params
->fflag
&& (params
->dflag
|| params
->lflag
)) ||
775 (params
->lflag
&& (params
->dflag
|| params
->fflag
)));
781 sizeof(image_header_t
),
787 fit_extract_contents
,
788 fit_check_image_types
,
790 NULL
/* FIT images use DTB header */