2 * Copyright (c) 2013, Google Inc.
4 * (C) Copyright 2008 Semihalf
6 * (C) Copyright 2000-2006
9 * SPDX-License-Identifier: GPL-2.0+
18 * fit_set_hash_value - set hash value in requested has node
19 * @fit: pointer to the FIT format image header
20 * @noffset: hash node offset
21 * @value: hash value to be set
22 * @value_len: hash value length
24 * fit_set_hash_value() attempts to set hash value in a node at offset
25 * given and returns operation status to the caller.
31 static int fit_set_hash_value(void *fit, int noffset, uint8_t *value,
36 ret = fdt_setprop(fit, noffset, FIT_VALUE_PROP, value, value_len);
38 printf("Can't set hash '%s' property for '%s' node(%s)\n",
39 FIT_VALUE_PROP, fit_get_name(fit, noffset, NULL),
41 return ret == -FDT_ERR_NOSPACE ? -ENOSPC : -EIO;
48 * fit_image_process_hash - Process a single subnode of the images/ node
50 * Check each subnode and process accordingly. For hash nodes we generate
51 * a hash of the supplised data and store it in the node.
53 * @fit: pointer to the FIT format image header
54 * @image_name: name of image being processes (used to display errors)
55 * @noffset: subnode offset
56 * @data: data to process
57 * @size: size of data in bytes
58 * @return 0 if ok, -1 on error
60 static int fit_image_process_hash(void *fit, const char *image_name,
61 int noffset, const void *data, size_t size)
63 uint8_t value[FIT_MAX_HASH_LEN];
64 const char *node_name;
69 node_name = fit_get_name(fit, noffset, NULL);
71 if (fit_image_hash_get_algo(fit, noffset, &algo)) {
72 printf("Can't get hash algo property for '%s' hash node in '%s' image node\n",
73 node_name, image_name);
77 if (calculate_hash(data, size, algo, value, &value_len)) {
78 printf("Unsupported hash algorithm (%s) for '%s' hash node in '%s' image node\n",
79 algo, node_name, image_name);
80 return -EPROTONOSUPPORT;
83 ret = fit_set_hash_value(fit, noffset, value, value_len);
85 printf("Can't set hash value for '%s' hash node in '%s' image node\n",
86 node_name, image_name);
94 * fit_image_write_sig() - write the signature to a FIT
96 * This writes the signature and signer data to the FIT.
98 * @fit: pointer to the FIT format image header
99 * @noffset: hash node offset
100 * @value: signature value to be set
101 * @value_len: signature value length
102 * @comment: Text comment to write (NULL for none)
106 * -FDT_ERR_..., on failure
108 static int fit_image_write_sig(void *fit, int noffset, uint8_t *value,
109 int value_len, const char *comment, const char *region_prop,
116 * Get the current string size, before we update the FIT and add
119 string_size = fdt_size_dt_strings(fit);
121 ret = fdt_setprop(fit, noffset, FIT_VALUE_PROP, value, value_len);
123 ret = fdt_setprop_string(fit, noffset, "signer-name",
127 ret = fdt_setprop_string(fit, noffset, "signer-version",
131 ret = fdt_setprop_string(fit, noffset, "comment", comment);
133 ret = fit_set_timestamp(fit, noffset, time(NULL));
134 if (region_prop && !ret) {
137 ret = fdt_setprop(fit, noffset, "hashed-nodes",
138 region_prop, region_proplen);
140 strdata[1] = cpu_to_fdt32(string_size);
142 ret = fdt_setprop(fit, noffset, "hashed-strings",
143 strdata, sizeof(strdata));
150 static int fit_image_setup_sig(struct image_sign_info *info,
151 const char *keydir, void *fit, const char *image_name,
152 int noffset, const char *require_keys)
154 const char *node_name;
157 node_name = fit_get_name(fit, noffset, NULL);
158 if (fit_image_hash_get_algo(fit, noffset, &algo_name)) {
159 printf("Can't get algo property for '%s' signature node in '%s' image node\n",
160 node_name, image_name);
164 memset(info, '\0', sizeof(*info));
165 info->keydir = keydir;
166 info->keyname = fdt_getprop(fit, noffset, "key-name-hint", NULL);
168 info->node_offset = noffset;
169 info->name = algo_name;
170 info->checksum = image_get_checksum_algo(algo_name);
171 info->crypto = image_get_crypto_algo(algo_name);
172 info->require_keys = require_keys;
173 if (!info->checksum || !info->crypto) {
174 printf("Unsupported signature algorithm (%s) for '%s' signature node in '%s' image node\n",
175 algo_name, node_name, image_name);
183 * fit_image_process_sig- Process a single subnode of the images/ node
185 * Check each subnode and process accordingly. For signature nodes we
186 * generate a signed hash of the supplised data and store it in the node.
188 * @keydir: Directory containing keys to use for signing
189 * @keydest: Destination FDT blob to write public keys into
190 * @fit: pointer to the FIT format image header
191 * @image_name: name of image being processes (used to display errors)
192 * @noffset: subnode offset
193 * @data: data to process
194 * @size: size of data in bytes
195 * @comment: Comment to add to signature nodes
196 * @require_keys: Mark all keys as 'required'
197 * @return 0 if ok, -1 on error
199 static int fit_image_process_sig(const char *keydir, void *keydest,
200 void *fit, const char *image_name,
201 int noffset, const void *data, size_t size,
202 const char *comment, int require_keys)
204 struct image_sign_info info;
205 struct image_region region;
206 const char *node_name;
211 if (fit_image_setup_sig(&info, keydir, fit, image_name, noffset,
212 require_keys ? "image" : NULL))
215 node_name = fit_get_name(fit, noffset, NULL);
218 ret = info.crypto->sign(&info, ®ion, 1, &value, &value_len);
220 printf("Failed to sign '%s' signature node in '%s' image node: %d\n",
221 node_name, image_name, ret);
223 /* We allow keys to be missing */
229 ret = fit_image_write_sig(fit, noffset, value, value_len, comment,
232 if (ret == -FDT_ERR_NOSPACE)
234 printf("Can't write signature for '%s' signature node in '%s' conf node: %s\n",
235 node_name, image_name, fdt_strerror(ret));
240 /* Get keyname again, as FDT has changed and invalidated our pointer */
241 info.keyname = fdt_getprop(fit, noffset, "key-name-hint", NULL);
244 ret = info.crypto->add_verify_data(&info, keydest);
249 * Write the public key into the supplied FDT file; this might fail
250 * several times, since we try signing with successively increasing
260 * fit_image_add_verification_data() - calculate/set verig. data for image node
262 * This adds hash and signature values for an component image node.
264 * All existing hash subnodes are checked, if algorithm property is set to
265 * one of the supported hash algorithms, hash value is computed and
266 * corresponding hash node property is set, for example:
268 * Input component image node structure:
270 * o image@1 (at image_noffset)
271 * | - data = [binary data]
275 * Output component image node structure:
277 * o image@1 (at image_noffset)
278 * | - data = [binary data]
281 * |- value = sha1(data)
283 * For signature details, please see doc/uImage.FIT/signature.txt
285 * @keydir Directory containing *.key and *.crt files (or NULL)
286 * @keydest FDT Blob to write public keys into (NULL if none)
287 * @fit: Pointer to the FIT format image header
288 * @image_noffset: Requested component image node
289 * @comment: Comment to add to signature nodes
290 * @require_keys: Mark all keys as 'required'
291 * @return: 0 on success, <0 on failure
293 int fit_image_add_verification_data(const char *keydir, void *keydest,
294 void *fit, int image_noffset, const char *comment,
297 const char *image_name;
302 /* Get image data and data length */
303 if (fit_image_get_data(fit, image_noffset, &data, &size)) {
304 printf("Can't get image data/size\n");
308 image_name = fit_get_name(fit, image_noffset, NULL);
310 /* Process all hash subnodes of the component image node */
311 for (noffset = fdt_first_subnode(fit, image_noffset);
313 noffset = fdt_next_subnode(fit, noffset)) {
314 const char *node_name;
318 * Check subnode name, must be equal to "hash" or "signature".
319 * Multiple hash nodes require unique unit node
320 * names, e.g. hash@1, hash@2, signature@1, etc.
322 node_name = fit_get_name(fit, noffset, NULL);
323 if (!strncmp(node_name, FIT_HASH_NODENAME,
324 strlen(FIT_HASH_NODENAME))) {
325 ret = fit_image_process_hash(fit, image_name, noffset,
327 } else if (IMAGE_ENABLE_SIGN && keydir &&
328 !strncmp(node_name, FIT_SIG_NODENAME,
329 strlen(FIT_SIG_NODENAME))) {
330 ret = fit_image_process_sig(keydir, keydest,
331 fit, image_name, noffset, data, size,
332 comment, require_keys);
346 static void strlist_init(struct strlist *list)
348 memset(list, '\0', sizeof(*list));
351 static void strlist_free(struct strlist *list)
355 for (i = 0; i < list->count; i++)
356 free(list->strings[i]);
360 static int strlist_add(struct strlist *list, const char *str)
365 list->strings = realloc(list->strings,
366 (list->count + 1) * sizeof(char *));
369 list->strings[list->count++] = dup;
374 static const char *fit_config_get_image_list(void *fit, int noffset,
375 int *lenp, int *allow_missingp)
377 static const char default_list[] = FIT_KERNEL_PROP "\0"
381 /* If there is an "image" property, use that */
382 prop = fdt_getprop(fit, noffset, "sign-images", lenp);
385 return *lenp ? prop : NULL;
388 /* Default image list */
390 *lenp = sizeof(default_list);
395 static int fit_config_get_hash_list(void *fit, int conf_noffset,
396 int sig_offset, struct strlist *node_inc)
399 const char *prop, *iname, *end;
400 const char *conf_name, *sig_name;
401 char name[200], path[200];
405 conf_name = fit_get_name(fit, conf_noffset, NULL);
406 sig_name = fit_get_name(fit, sig_offset, NULL);
409 * Build a list of nodes we need to hash. We always need the root
410 * node and the configuration.
412 strlist_init(node_inc);
413 snprintf(name, sizeof(name), "%s/%s", FIT_CONFS_PATH, conf_name);
414 if (strlist_add(node_inc, "/") ||
415 strlist_add(node_inc, name))
418 /* Get a list of images that we intend to sign */
419 prop = fit_config_get_image_list(fit, sig_offset, &len,
424 /* Locate the images */
427 for (iname = prop; iname < end; iname += strlen(iname) + 1) {
432 image_noffset = fit_conf_get_prop_node(fit, conf_noffset,
434 if (image_noffset < 0) {
435 printf("Failed to find image '%s' in configuration '%s/%s'\n",
436 iname, conf_name, sig_name);
443 ret = fdt_get_path(fit, image_noffset, path, sizeof(path));
446 if (strlist_add(node_inc, path))
449 snprintf(name, sizeof(name), "%s/%s", FIT_CONFS_PATH,
452 /* Add all this image's hashes */
454 for (noffset = fdt_first_subnode(fit, image_noffset);
456 noffset = fdt_next_subnode(fit, noffset)) {
457 const char *name = fit_get_name(fit, noffset, NULL);
459 if (strncmp(name, FIT_HASH_NODENAME,
460 strlen(FIT_HASH_NODENAME)))
462 ret = fdt_get_path(fit, noffset, path, sizeof(path));
465 if (strlist_add(node_inc, path))
471 printf("Failed to find any hash nodes in configuration '%s/%s' image '%s' - without these it is not possible to verify this image\n",
472 conf_name, sig_name, iname);
480 printf("Failed to find any images for configuration '%s/%s'\n",
481 conf_name, sig_name);
488 printf("Out of memory processing configuration '%s/%s'\n", conf_name,
493 printf("Failed to get path for image '%s' in configuration '%s/%s': %s\n",
494 iname, conf_name, sig_name, fdt_strerror(ret));
498 static int fit_config_get_data(void *fit, int conf_noffset, int noffset,
499 struct image_region **regionp, int *region_countp,
500 char **region_propp, int *region_proplen)
502 char * const exc_prop[] = {"data"};
503 struct strlist node_inc;
504 struct image_region *region;
505 struct fdt_region fdt_regions[100];
506 const char *conf_name, *sig_name;
512 conf_name = fit_get_name(fit, conf_noffset, NULL);
513 sig_name = fit_get_name(fit, conf_noffset, NULL);
514 debug("%s: conf='%s', sig='%s'\n", __func__, conf_name, sig_name);
516 /* Get a list of nodes we want to hash */
517 ret = fit_config_get_hash_list(fit, conf_noffset, noffset, &node_inc);
521 /* Get a list of regions to hash */
522 count = fdt_find_regions(fit, node_inc.strings, node_inc.count,
523 exc_prop, ARRAY_SIZE(exc_prop),
524 fdt_regions, ARRAY_SIZE(fdt_regions),
525 path, sizeof(path), 1);
527 printf("Failed to hash configuration '%s/%s': %s\n", conf_name,
528 sig_name, fdt_strerror(ret));
532 printf("No data to hash for configuration '%s/%s': %s\n",
533 conf_name, sig_name, fdt_strerror(ret));
537 /* Build our list of data blocks */
538 region = fit_region_make_list(fit, fdt_regions, count, NULL);
540 printf("Out of memory hashing configuration '%s/%s'\n",
541 conf_name, sig_name);
545 /* Create a list of all hashed properties */
546 debug("Hash nodes:\n");
547 for (i = len = 0; i < node_inc.count; i++) {
548 debug(" %s\n", node_inc.strings[i]);
549 len += strlen(node_inc.strings[i]) + 1;
551 region_prop = malloc(len);
553 printf("Out of memory setting up regions for configuration '%s/%s'\n",
554 conf_name, sig_name);
557 for (i = len = 0; i < node_inc.count;
558 len += strlen(node_inc.strings[i]) + 1, i++)
559 strcpy(region_prop + len, node_inc.strings[i]);
560 strlist_free(&node_inc);
562 *region_countp = count;
564 *region_propp = region_prop;
565 *region_proplen = len;
570 static int fit_config_process_sig(const char *keydir, void *keydest,
571 void *fit, const char *conf_name, int conf_noffset,
572 int noffset, const char *comment, int require_keys)
574 struct image_sign_info info;
575 const char *node_name;
576 struct image_region *region;
584 node_name = fit_get_name(fit, noffset, NULL);
585 if (fit_config_get_data(fit, conf_noffset, noffset, ®ion,
586 ®ion_count, ®ion_prop, ®ion_proplen))
589 if (fit_image_setup_sig(&info, keydir, fit, conf_name, noffset,
590 require_keys ? "conf" : NULL))
593 ret = info.crypto->sign(&info, region, region_count, &value,
597 printf("Failed to sign '%s' signature node in '%s' conf node\n",
598 node_name, conf_name);
600 /* We allow keys to be missing */
606 ret = fit_image_write_sig(fit, noffset, value, value_len, comment,
607 region_prop, region_proplen);
609 if (ret == -FDT_ERR_NOSPACE)
611 printf("Can't write signature for '%s' signature node in '%s' conf node: %s\n",
612 node_name, conf_name, fdt_strerror(ret));
618 /* Get keyname again, as FDT has changed and invalidated our pointer */
619 info.keyname = fdt_getprop(fit, noffset, "key-name-hint", NULL);
621 /* Write the public key into the supplied FDT file */
623 ret = info.crypto->add_verify_data(&info, keydest);
627 printf("Failed to add verification data for '%s' signature node in '%s' image node\n",
628 node_name, conf_name);
636 static int fit_config_add_verification_data(const char *keydir, void *keydest,
637 void *fit, int conf_noffset, const char *comment,
640 const char *conf_name;
643 conf_name = fit_get_name(fit, conf_noffset, NULL);
645 /* Process all hash subnodes of the configuration node */
646 for (noffset = fdt_first_subnode(fit, conf_noffset);
648 noffset = fdt_next_subnode(fit, noffset)) {
649 const char *node_name;
652 node_name = fit_get_name(fit, noffset, NULL);
653 if (!strncmp(node_name, FIT_SIG_NODENAME,
654 strlen(FIT_SIG_NODENAME))) {
655 ret = fit_config_process_sig(keydir, keydest,
656 fit, conf_name, conf_noffset, noffset, comment,
666 int fit_add_verification_data(const char *keydir, void *keydest, void *fit,
667 const char *comment, int require_keys)
669 int images_noffset, confs_noffset;
673 /* Find images parent node offset */
674 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
675 if (images_noffset < 0) {
676 printf("Can't find images parent node '%s' (%s)\n",
677 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
678 return images_noffset;
681 /* Process its subnodes, print out component images details */
682 for (noffset = fdt_first_subnode(fit, images_noffset);
684 noffset = fdt_next_subnode(fit, noffset)) {
686 * Direct child node of the images parent node,
687 * i.e. component image node.
689 ret = fit_image_add_verification_data(keydir, keydest,
690 fit, noffset, comment, require_keys);
695 /* If there are no keys, we can't sign configurations */
696 if (!IMAGE_ENABLE_SIGN || !keydir)
699 /* Find configurations parent node offset */
700 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
701 if (confs_noffset < 0) {
702 printf("Can't find images parent node '%s' (%s)\n",
703 FIT_CONFS_PATH, fdt_strerror(confs_noffset));
707 /* Process its subnodes, print out component images details */
708 for (noffset = fdt_first_subnode(fit, confs_noffset);
710 noffset = fdt_next_subnode(fit, noffset)) {
711 ret = fit_config_add_verification_data(keydir, keydest,
712 fit, noffset, comment,
721 #ifdef CONFIG_FIT_SIGNATURE
722 int fit_check_sign(const void *fit, const void *key)
727 cfg_noffset = fit_conf_get_node(fit, NULL);
731 printf("Verifying Hash Integrity ... ");
732 ret = fit_config_verify(fit, cfg_noffset);
735 ret = bootm_host_load_images(fit, cfg_noffset);