1 // SPDX-License-Identifier: GPL-2.0+
3 * (C) Copyright 2008 Semihalf
5 * (C) Copyright 2000-2004
6 * DENX Software Engineering
7 * Wolfgang Denk, wd@denx.de
9 * Updated-by: Prafulla Wadaskar <prafulla@marvell.com>
10 * FIT image specific code abstracted from mkimage.c
11 * some functions added to address abstraction
13 * All rights reserved.
16 #include "imagetool.h"
17 #include "fit_common.h"
22 #include <u-boot/crc.h>
24 static image_header_t header;
26 static int fit_add_file_data(struct image_tool_params *params, size_t size_inc,
30 void *dest_blob = NULL;
31 off_t destfd_size = 0;
36 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,
51 destfd_size = dest_sbuf.st_size;
54 /* for first image creation, add a timestamp at offset 0 i.e., root */
55 if (params->datafile) {
56 time_t time = imagetool_get_source_date(params->cmdname,
58 ret = fit_set_timestamp(ptr, 0, time);
62 ret = fit_add_verification_data(params->keydir, dest_blob, ptr,
70 munmap(dest_blob, destfd_size);
75 munmap(ptr, sbuf.st_size);
82 * fit_calc_size() - Calculate the approximate size of the FIT we will generate
84 static int fit_calc_size(struct image_tool_params *params)
86 struct content_info *cont;
89 size = imagetool_get_filesize(params, params->datafile);
94 if (params->fit_ramdisk) {
95 size = imagetool_get_filesize(params, params->fit_ramdisk);
101 for (cont = params->content_head; cont; cont = cont->next) {
102 size = imagetool_get_filesize(params, cont->fname);
106 /* Add space for properties */
107 total_size += size + 300;
110 /* Add plenty of space for headers, properties, nodes, etc. */
116 static int fdt_property_file(struct image_tool_params *params,
117 void *fdt, const char *name, const char *fname)
124 fd = open(fname, O_RDWR | O_BINARY);
126 fprintf(stderr, "%s: Can't open %s: %s\n",
127 params->cmdname, fname, strerror(errno));
131 if (fstat(fd, &sbuf) < 0) {
132 fprintf(stderr, "%s: Can't stat %s: %s\n",
133 params->cmdname, fname, strerror(errno));
137 ret = fdt_property_placeholder(fdt, "data", sbuf.st_size, &ptr);
140 ret = read(fd, ptr, sbuf.st_size);
141 if (ret != sbuf.st_size) {
142 fprintf(stderr, "%s: Can't read %s: %s\n",
143 params->cmdname, fname, strerror(errno));
154 static int fdt_property_strf(void *fdt, const char *name, const char *fmt, ...)
160 vsnprintf(str, sizeof(str), fmt, ptr);
162 return fdt_property_string(fdt, name, str);
165 static void get_basename(char *str, int size, const char *fname)
167 const char *p, *start, *end;
171 * Use the base name as the 'name' field. So for example:
173 * "arch/arm/dts/sun7i-a20-bananapro.dtb"
174 * becomes "sun7i-a20-bananapro"
176 p = strrchr(fname, '/');
177 start = p ? p + 1 : fname;
178 p = strrchr(fname, '.');
179 end = p ? p : fname + strlen(fname);
183 memcpy(str, start, len);
188 * fit_write_images() - Write out a list of images to the FIT
190 * We always include the main image (params->datafile). If there are device
191 * tree files, we include an fdt- node for each of those too.
193 static int fit_write_images(struct image_tool_params *params, char *fdt)
195 struct content_info *cont;
196 const char *typename;
201 fdt_begin_node(fdt, "images");
203 /* First the main image */
204 typename = genimg_get_type_short_name(params->fit_image_type);
205 snprintf(str, sizeof(str), "%s-1", typename);
206 fdt_begin_node(fdt, str);
207 fdt_property_string(fdt, FIT_DESC_PROP, params->imagename);
208 fdt_property_string(fdt, FIT_TYPE_PROP, typename);
209 fdt_property_string(fdt, FIT_ARCH_PROP,
210 genimg_get_arch_short_name(params->arch));
211 fdt_property_string(fdt, FIT_OS_PROP,
212 genimg_get_os_short_name(params->os));
213 fdt_property_string(fdt, FIT_COMP_PROP,
214 genimg_get_comp_short_name(params->comp));
215 fdt_property_u32(fdt, FIT_LOAD_PROP, params->addr);
216 fdt_property_u32(fdt, FIT_ENTRY_PROP, params->ep);
219 * Put data last since it is large. SPL may only load the first part
220 * of the DT, so this way it can access all the above fields.
222 ret = fdt_property_file(params, fdt, FIT_DATA_PROP, params->datafile);
227 /* Now the device tree files if available */
229 for (cont = params->content_head; cont; cont = cont->next) {
230 if (cont->type != IH_TYPE_FLATDT)
232 typename = genimg_get_type_short_name(cont->type);
233 snprintf(str, sizeof(str), "%s-%d", FIT_FDT_PROP, ++upto);
234 fdt_begin_node(fdt, str);
236 get_basename(str, sizeof(str), cont->fname);
237 fdt_property_string(fdt, FIT_DESC_PROP, str);
238 ret = fdt_property_file(params, fdt, FIT_DATA_PROP,
242 fdt_property_string(fdt, FIT_TYPE_PROP, typename);
243 fdt_property_string(fdt, FIT_ARCH_PROP,
244 genimg_get_arch_short_name(params->arch));
245 fdt_property_string(fdt, FIT_COMP_PROP,
246 genimg_get_comp_short_name(IH_COMP_NONE));
250 /* And a ramdisk file if available */
251 if (params->fit_ramdisk) {
252 fdt_begin_node(fdt, FIT_RAMDISK_PROP "-1");
254 fdt_property_string(fdt, FIT_TYPE_PROP, FIT_RAMDISK_PROP);
255 fdt_property_string(fdt, FIT_OS_PROP,
256 genimg_get_os_short_name(params->os));
257 fdt_property_string(fdt, FIT_ARCH_PROP,
258 genimg_get_arch_short_name(params->arch));
260 ret = fdt_property_file(params, fdt, FIT_DATA_PROP,
261 params->fit_ramdisk);
274 * fit_write_configs() - Write out a list of configurations to the FIT
276 * If there are device tree files, we include a configuration for each, which
277 * selects the main image (params->datafile) and its corresponding device
280 * Otherwise we just create a configuration with the main image in it.
282 static void fit_write_configs(struct image_tool_params *params, char *fdt)
284 struct content_info *cont;
285 const char *typename;
289 fdt_begin_node(fdt, "configurations");
290 fdt_property_string(fdt, FIT_DEFAULT_PROP, "conf-1");
293 for (cont = params->content_head; cont; cont = cont->next) {
294 if (cont->type != IH_TYPE_FLATDT)
296 typename = genimg_get_type_short_name(cont->type);
297 snprintf(str, sizeof(str), "conf-%d", ++upto);
298 fdt_begin_node(fdt, str);
300 get_basename(str, sizeof(str), cont->fname);
301 fdt_property_string(fdt, FIT_DESC_PROP, str);
303 typename = genimg_get_type_short_name(params->fit_image_type);
304 snprintf(str, sizeof(str), "%s-1", typename);
305 fdt_property_string(fdt, typename, str);
306 fdt_property_string(fdt, FIT_LOADABLE_PROP, str);
308 if (params->fit_ramdisk)
309 fdt_property_string(fdt, FIT_RAMDISK_PROP,
310 FIT_RAMDISK_PROP "-1");
312 snprintf(str, sizeof(str), FIT_FDT_PROP "-%d", upto);
313 fdt_property_string(fdt, FIT_FDT_PROP, str);
318 fdt_begin_node(fdt, "conf-1");
319 typename = genimg_get_type_short_name(params->fit_image_type);
320 snprintf(str, sizeof(str), "%s-1", typename);
321 fdt_property_string(fdt, typename, str);
323 if (params->fit_ramdisk)
324 fdt_property_string(fdt, FIT_RAMDISK_PROP,
325 FIT_RAMDISK_PROP "-1");
333 static int fit_build_fdt(struct image_tool_params *params, char *fdt, int size)
337 ret = fdt_create(fdt, size);
340 fdt_finish_reservemap(fdt);
341 fdt_begin_node(fdt, "");
342 fdt_property_strf(fdt, FIT_DESC_PROP,
343 "%s image with one or more FDT blobs",
344 genimg_get_type_name(params->fit_image_type));
345 fdt_property_strf(fdt, "creator", "U-Boot mkimage %s", PLAIN_VERSION);
346 fdt_property_u32(fdt, "#address-cells", 1);
347 ret = fit_write_images(params, fdt);
350 fit_write_configs(params, fdt);
352 ret = fdt_finish(fdt);
356 return fdt_totalsize(fdt);
359 static int fit_build(struct image_tool_params *params, const char *fname)
366 size = fit_calc_size(params);
371 fprintf(stderr, "%s: Out of memory (%d bytes)\n",
372 params->cmdname, size);
375 ret = fit_build_fdt(params, buf, size);
377 fprintf(stderr, "%s: Failed to build FIT image\n",
382 fd = open(fname, O_RDWR | O_CREAT | O_TRUNC | O_BINARY, 0666);
384 fprintf(stderr, "%s: Can't open %s: %s\n",
385 params->cmdname, fname, strerror(errno));
388 ret = write(fd, buf, size);
390 fprintf(stderr, "%s: Can't write %s: %s\n",
391 params->cmdname, fname, strerror(errno));
406 * fit_extract_data() - Move all data outside the FIT
408 * This takes a normal FIT file and removes all the 'data' properties from it.
409 * The data is placed in an area after the FIT so that it can be accessed
410 * using an offset into that area. The 'data' properties turn into
411 * 'data-offset' properties.
413 * This function cannot cope with FITs with 'data-offset' properties. All
414 * data must be in 'data' properties on entry.
416 static int fit_extract_data(struct image_tool_params *params, const char *fname)
420 int fit_size, new_size;
428 fd = mmap_fdt(params->cmdname, fname, 0, &fdt, &sbuf, false, false);
431 fit_size = fdt_totalsize(fdt);
433 /* Allocate space to hold the image data we will extract */
434 buf = malloc(fit_size);
441 images = fdt_path_offset(fdt, FIT_IMAGES_PATH);
443 debug("%s: Cannot find /images node: %d\n", __func__, images);
448 for (node = fdt_first_subnode(fdt, images);
450 node = fdt_next_subnode(fdt, node)) {
454 data = fdt_getprop(fdt, node, FIT_DATA_PROP, &len);
457 memcpy(buf + buf_ptr, data, len);
458 debug("Extracting data size %x\n", len);
460 ret = fdt_delprop(fdt, node, FIT_DATA_PROP);
465 if (params->external_offset > 0) {
466 /* An external offset positions the data absolutely. */
467 fdt_setprop_u32(fdt, node, FIT_DATA_POSITION_PROP,
468 params->external_offset + buf_ptr);
470 fdt_setprop_u32(fdt, node, FIT_DATA_OFFSET_PROP,
473 fdt_setprop_u32(fdt, node, FIT_DATA_SIZE_PROP, len);
475 buf_ptr += (len + 3) & ~3;
478 /* Pack the FDT and place the data after it */
481 debug("Size reduced from %x to %x\n", fit_size, fdt_totalsize(fdt));
482 debug("External data size %x\n", buf_ptr);
483 new_size = fdt_totalsize(fdt);
484 new_size = (new_size + 3) & ~3;
485 munmap(fdt, sbuf.st_size);
487 if (ftruncate(fd, new_size)) {
488 debug("%s: Failed to truncate file: %s\n", __func__,
494 /* Check if an offset for the external data was set. */
495 if (params->external_offset > 0) {
496 if (params->external_offset < new_size) {
497 debug("External offset %x overlaps FIT length %x",
498 params->external_offset, new_size);
502 new_size = params->external_offset;
504 if (lseek(fd, new_size, SEEK_SET) < 0) {
505 debug("%s: Failed to seek to end of file: %s\n", __func__,
510 if (write(fd, buf, buf_ptr) != buf_ptr) {
511 debug("%s: Failed to write external data to file %s\n",
512 __func__, strerror(errno));
521 munmap(fdt, sbuf.st_size);
529 static int fit_import_data(struct image_tool_params *params, const char *fname)
532 int fit_size, new_size, size, data_base;
539 fd = mmap_fdt(params->cmdname, fname, 0, &old_fdt, &sbuf, false, false);
542 fit_size = fdt_totalsize(old_fdt);
543 data_base = (fit_size + 3) & ~3;
545 /* Allocate space to hold the new FIT */
546 size = sbuf.st_size + 16384;
549 fprintf(stderr, "%s: Failed to allocate memory (%d bytes)\n",
554 ret = fdt_open_into(old_fdt, fdt, size);
556 debug("%s: Failed to expand FIT: %s\n", __func__,
557 fdt_strerror(errno));
562 images = fdt_path_offset(fdt, FIT_IMAGES_PATH);
564 debug("%s: Cannot find /images node: %d\n", __func__, images);
569 for (node = fdt_first_subnode(fdt, images);
571 node = fdt_next_subnode(fdt, node)) {
575 buf_ptr = fdtdec_get_int(fdt, node, "data-offset", -1);
576 len = fdtdec_get_int(fdt, node, "data-size", -1);
577 if (buf_ptr == -1 || len == -1)
579 debug("Importing data size %x\n", len);
581 ret = fdt_setprop(fdt, node, "data", fdt + data_base + buf_ptr,
584 debug("%s: Failed to write property: %s\n", __func__,
591 /* Close the old fd so we can re-use it. */
594 /* Pack the FDT and place the data after it */
597 new_size = fdt_totalsize(fdt);
598 debug("Size expanded from %x to %x\n", fit_size, new_size);
600 fd = open(fname, O_RDWR | O_CREAT | O_TRUNC | O_BINARY, 0666);
602 fprintf(stderr, "%s: Can't open %s: %s\n",
603 params->cmdname, fname, strerror(errno));
607 if (write(fd, fdt, new_size) != new_size) {
608 debug("%s: Failed to write external data to file %s\n",
609 __func__, strerror(errno));
619 munmap(old_fdt, sbuf.st_size);
625 * fit_handle_file - main FIT file processing function
627 * fit_handle_file() runs dtc to convert .its to .itb, includes
628 * binary data, updates timestamp property and calculates hashes.
630 * datafile - .its file
631 * imagefile - .itb file
634 * only on success, otherwise calls exit (EXIT_FAILURE);
636 static int fit_handle_file(struct image_tool_params *params)
638 char tmpfile[MKIMAGE_MAX_TMPFILE_LEN];
639 char cmd[MKIMAGE_MAX_DTC_CMDLINE_LEN];
643 /* Flattened Image Tree (FIT) format handling */
644 debug ("FIT format handling\n");
646 /* call dtc to include binary properties into the tmp file */
647 if (strlen (params->imagefile) +
648 strlen (MKIMAGE_TMPFILE_SUFFIX) + 1 > sizeof (tmpfile)) {
649 fprintf (stderr, "%s: Image file name (%s) too long, "
650 "can't create tmpfile",
651 params->imagefile, params->cmdname);
652 return (EXIT_FAILURE);
654 sprintf (tmpfile, "%s%s", params->imagefile, MKIMAGE_TMPFILE_SUFFIX);
656 /* We either compile the source file, or use the existing FIT image */
657 if (params->auto_its) {
658 if (fit_build(params, tmpfile)) {
659 fprintf(stderr, "%s: failed to build FIT\n",
664 } else if (params->datafile) {
665 /* dtc -I dts -O dtb -p 500 -o tmpfile datafile */
666 snprintf(cmd, sizeof(cmd), "%s %s -o \"%s\" \"%s\"",
667 MKIMAGE_DTC, params->dtc, tmpfile, params->datafile);
668 debug("Trying to execute \"%s\"\n", cmd);
670 snprintf(cmd, sizeof(cmd), "cp \"%s\" \"%s\"",
671 params->imagefile, tmpfile);
673 if (*cmd && system(cmd) == -1) {
674 fprintf (stderr, "%s: system(%s) failed: %s\n",
675 params->cmdname, cmd, strerror(errno));
679 /* Move the data so it is internal to the FIT, if needed */
680 ret = fit_import_data(params, tmpfile);
685 * Set hashes for images in the blob. Unfortunately we may need more
686 * space in either FDT, so keep trying until we succeed.
688 * Note: this is pretty inefficient for signing, since we must
689 * calculate the signature every time. It would be better to calculate
690 * all the data and then store it in a separate step. However, this
691 * would be considerably more complex to implement. Generally a few
692 * steps of this loop is enough to sign with several keys.
694 for (size_inc = 0; size_inc < 64 * 1024; size_inc += 1024) {
695 ret = fit_add_file_data(params, size_inc, tmpfile);
696 if (!ret || ret != -ENOSPC)
701 fprintf(stderr, "%s Can't add hashes to FIT blob: %d\n",
702 params->cmdname, ret);
706 /* Move the data so it is external to the FIT, if requested */
707 if (params->external_data) {
708 ret = fit_extract_data(params, tmpfile);
713 if (rename (tmpfile, params->imagefile) == -1) {
714 fprintf (stderr, "%s: Can't rename %s to %s: %s\n",
715 params->cmdname, tmpfile, params->imagefile,
718 unlink (params->imagefile);
729 * fit_image_extract - extract a FIT component image
730 * @fit: pointer to the FIT format image header
731 * @image_noffset: offset of the component image node
732 * @file_name: name of the file to store the FIT sub-image
735 * zero in case of success or a negative value if fail.
737 static int fit_image_extract(
740 const char *file_name)
742 const void *file_data;
743 size_t file_size = 0;
745 /* get the "data" property of component at offset "image_noffset" */
746 fit_image_get_data(fit, image_noffset, &file_data, &file_size);
748 /* save the "file_data" into the file specified by "file_name" */
749 return imagetool_save_subimage(file_name, (ulong) file_data, file_size);
753 * fit_extract_contents - retrieve a sub-image component from the FIT image
754 * @ptr: pointer to the FIT format image header
755 * @params: command line parameters
758 * zero in case of success or a negative value if fail.
760 static int fit_extract_contents(void *ptr, struct image_tool_params *params)
765 const void *fit = ptr;
769 /* Indent string is defined in header image.h */
770 p = IMAGE_INDENT_STRING;
772 if (!fit_check_format(fit)) {
773 printf("Bad FIT image format\n");
777 /* Find images parent node offset */
778 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
779 if (images_noffset < 0) {
780 printf("Can't find images parent node '%s' (%s)\n",
781 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
785 /* Avoid any overrun */
786 count = fit_get_subimage_count(fit, images_noffset);
787 if ((params->pflag < 0) || (count <= params->pflag)) {
788 printf("No such component at '%d'\n", params->pflag);
792 /* Process its subnodes, extract the desired component from image */
793 for (ndepth = 0, count = 0,
794 noffset = fdt_next_node(fit, images_noffset, &ndepth);
795 (noffset >= 0) && (ndepth > 0);
796 noffset = fdt_next_node(fit, noffset, &ndepth)) {
799 * Direct child node of the images parent node,
800 * i.e. component image node.
802 if (params->pflag == count) {
803 printf("Extracted:\n%s Image %u (%s)\n", p,
804 count, fit_get_name(fit, noffset, NULL));
806 fit_image_print(fit, noffset, p);
808 return fit_image_extract(fit, noffset,
819 static int fit_check_params(struct image_tool_params *params)
821 if (params->auto_its)
823 return ((params->dflag && (params->fflag || params->lflag)) ||
824 (params->fflag && (params->dflag || params->lflag)) ||
825 (params->lflag && (params->dflag || params->fflag)));
831 sizeof(image_header_t),
837 fit_extract_contents,
838 fit_check_image_types,
840 NULL /* FIT images use DTB header */