xref: /openbmc/u-boot/tools/dumpimage.c (revision 1b0769f2ed17ffc1cf9b32ad057bc8b160cbcbae)
183d290c5STom Rini // SPDX-License-Identifier: GPL-2.0+
2a804b5ceSGuilherme Maciel Ferreira /*
3a804b5ceSGuilherme Maciel Ferreira  * Based on mkimage.c.
4a804b5ceSGuilherme Maciel Ferreira  *
5a804b5ceSGuilherme Maciel Ferreira  * Written by Guilherme Maciel Ferreira <guilherme.maciel.ferreira@gmail.com>
6a804b5ceSGuilherme Maciel Ferreira  */
7a804b5ceSGuilherme Maciel Ferreira 
8a804b5ceSGuilherme Maciel Ferreira #include "dumpimage.h"
9a804b5ceSGuilherme Maciel Ferreira #include <image.h>
10a804b5ceSGuilherme Maciel Ferreira #include <version.h>
11a804b5ceSGuilherme Maciel Ferreira 
12a804b5ceSGuilherme Maciel Ferreira static void usage(void);
13a804b5ceSGuilherme Maciel Ferreira 
14a804b5ceSGuilherme Maciel Ferreira /* parameters initialized by core will be used by the image type code */
15a804b5ceSGuilherme Maciel Ferreira static struct image_tool_params params = {
16a804b5ceSGuilherme Maciel Ferreira 	.type = IH_TYPE_KERNEL,
17a804b5ceSGuilherme Maciel Ferreira };
18a804b5ceSGuilherme Maciel Ferreira 
19a804b5ceSGuilherme Maciel Ferreira /*
2067f946cdSGuilherme Maciel Ferreira  * dumpimage_extract_subimage -
21a804b5ceSGuilherme Maciel Ferreira  *
22a804b5ceSGuilherme Maciel Ferreira  * It scans all registered image types,
23a804b5ceSGuilherme Maciel Ferreira  * verifies image_header for each supported image type
24a804b5ceSGuilherme Maciel Ferreira  * if verification is successful, it extracts the desired file,
25a804b5ceSGuilherme Maciel Ferreira  * indexed by pflag, from the image
26a804b5ceSGuilherme Maciel Ferreira  *
27a804b5ceSGuilherme Maciel Ferreira  * returns negative if input image format does not match with any of
28a804b5ceSGuilherme Maciel Ferreira  * supported image types
29a804b5ceSGuilherme Maciel Ferreira  */
dumpimage_extract_subimage(struct image_type_params * tparams,void * ptr,struct stat * sbuf)3067f946cdSGuilherme Maciel Ferreira static int dumpimage_extract_subimage(struct image_type_params *tparams,
31f41f5b7cSGuilherme Maciel Ferreira 		void *ptr, struct stat *sbuf)
32a804b5ceSGuilherme Maciel Ferreira {
33a804b5ceSGuilherme Maciel Ferreira 	int retval = -1;
34a804b5ceSGuilherme Maciel Ferreira 
35f41f5b7cSGuilherme Maciel Ferreira 	if (tparams->verify_header) {
36f41f5b7cSGuilherme Maciel Ferreira 		retval = tparams->verify_header((unsigned char *)ptr,
37a804b5ceSGuilherme Maciel Ferreira 				sbuf->st_size, &params);
38a804b5ceSGuilherme Maciel Ferreira 		if (retval != 0)
39f41f5b7cSGuilherme Maciel Ferreira 			return -1;
40a804b5ceSGuilherme Maciel Ferreira 		/*
41a804b5ceSGuilherme Maciel Ferreira 		 * Extract the file from the image
42a804b5ceSGuilherme Maciel Ferreira 		 * if verify is successful
43a804b5ceSGuilherme Maciel Ferreira 		 */
4467f946cdSGuilherme Maciel Ferreira 		if (tparams->extract_subimage) {
4567f946cdSGuilherme Maciel Ferreira 			retval = tparams->extract_subimage(ptr, &params);
46a804b5ceSGuilherme Maciel Ferreira 		} else {
47a804b5ceSGuilherme Maciel Ferreira 			fprintf(stderr,
4867f946cdSGuilherme Maciel Ferreira 				"%s: extract_subimage undefined for %s\n",
49f41f5b7cSGuilherme Maciel Ferreira 				params.cmdname, tparams->name);
50f41f5b7cSGuilherme Maciel Ferreira 			return -2;
51a804b5ceSGuilherme Maciel Ferreira 		}
52a804b5ceSGuilherme Maciel Ferreira 	}
53a804b5ceSGuilherme Maciel Ferreira 
54a804b5ceSGuilherme Maciel Ferreira 	return retval;
55a804b5ceSGuilherme Maciel Ferreira }
56a804b5ceSGuilherme Maciel Ferreira 
main(int argc,char ** argv)57a804b5ceSGuilherme Maciel Ferreira int main(int argc, char **argv)
58a804b5ceSGuilherme Maciel Ferreira {
59a804b5ceSGuilherme Maciel Ferreira 	int opt;
60a804b5ceSGuilherme Maciel Ferreira 	int ifd = -1;
61a804b5ceSGuilherme Maciel Ferreira 	struct stat sbuf;
62a804b5ceSGuilherme Maciel Ferreira 	char *ptr;
6311e3c1fdSMartyn Welch 	int retval = EXIT_SUCCESS;
64a804b5ceSGuilherme Maciel Ferreira 	struct image_type_params *tparams = NULL;
65a804b5ceSGuilherme Maciel Ferreira 
66a804b5ceSGuilherme Maciel Ferreira 	params.cmdname = *argv;
67a804b5ceSGuilherme Maciel Ferreira 
6865a80b43SMartyn Welch 	while ((opt = getopt(argc, argv, "hlo:T:p:V")) != -1) {
69a804b5ceSGuilherme Maciel Ferreira 		switch (opt) {
70a804b5ceSGuilherme Maciel Ferreira 		case 'l':
71a804b5ceSGuilherme Maciel Ferreira 			params.lflag = 1;
72a804b5ceSGuilherme Maciel Ferreira 			break;
73a804b5ceSGuilherme Maciel Ferreira 		case 'o':
74a804b5ceSGuilherme Maciel Ferreira 			params.outfile = optarg;
7512b83187SMartyn Welch 			params.iflag = 1;
76a804b5ceSGuilherme Maciel Ferreira 			break;
77f41f5b7cSGuilherme Maciel Ferreira 		case 'T':
78f41f5b7cSGuilherme Maciel Ferreira 			params.type = genimg_get_type_id(optarg);
79f41f5b7cSGuilherme Maciel Ferreira 			if (params.type < 0) {
8057a608e9SMartyn Welch 				fprintf(stderr, "%s: Invalid type\n",
8157a608e9SMartyn Welch 					params.cmdname);
8265a80b43SMartyn Welch 				exit(EXIT_FAILURE);
83f41f5b7cSGuilherme Maciel Ferreira 			}
84f41f5b7cSGuilherme Maciel Ferreira 			break;
85a804b5ceSGuilherme Maciel Ferreira 		case 'p':
86a804b5ceSGuilherme Maciel Ferreira 			params.pflag = strtoul(optarg, &ptr, 10);
87a804b5ceSGuilherme Maciel Ferreira 			if (*ptr) {
88a804b5ceSGuilherme Maciel Ferreira 				fprintf(stderr,
89a804b5ceSGuilherme Maciel Ferreira 					"%s: invalid file position %s\n",
90a804b5ceSGuilherme Maciel Ferreira 					params.cmdname, *argv);
91a804b5ceSGuilherme Maciel Ferreira 				exit(EXIT_FAILURE);
92a804b5ceSGuilherme Maciel Ferreira 			}
93a804b5ceSGuilherme Maciel Ferreira 			break;
94a804b5ceSGuilherme Maciel Ferreira 		case 'V':
95a804b5ceSGuilherme Maciel Ferreira 			printf("dumpimage version %s\n", PLAIN_VERSION);
96a804b5ceSGuilherme Maciel Ferreira 			exit(EXIT_SUCCESS);
9765a80b43SMartyn Welch 		case 'h':
9865a80b43SMartyn Welch 			usage();
99a804b5ceSGuilherme Maciel Ferreira 		default:
100a804b5ceSGuilherme Maciel Ferreira 			usage();
101f41f5b7cSGuilherme Maciel Ferreira 			break;
102a804b5ceSGuilherme Maciel Ferreira 		}
103a804b5ceSGuilherme Maciel Ferreira 	}
104a804b5ceSGuilherme Maciel Ferreira 
10565a80b43SMartyn Welch 	if (argc < 2)
10665a80b43SMartyn Welch 		usage();
10765a80b43SMartyn Welch 
10857a608e9SMartyn Welch 	if (optind >= argc) {
10957a608e9SMartyn Welch 		fprintf(stderr, "%s: image file missing\n", params.cmdname);
11065a80b43SMartyn Welch 		exit(EXIT_FAILURE);
11157a608e9SMartyn Welch 	}
112a804b5ceSGuilherme Maciel Ferreira 
11312b83187SMartyn Welch 	params.imagefile = argv[optind];
11412b83187SMartyn Welch 
115a804b5ceSGuilherme Maciel Ferreira 	/* set tparams as per input type_id */
116a93648d1SGuilherme Maciel Ferreira 	tparams = imagetool_get_type(params.type);
117a804b5ceSGuilherme Maciel Ferreira 	if (tparams == NULL) {
118f41f5b7cSGuilherme Maciel Ferreira 		fprintf(stderr, "%s: unsupported type: %s\n",
119a804b5ceSGuilherme Maciel Ferreira 			params.cmdname, genimg_get_type_name(params.type));
120a804b5ceSGuilherme Maciel Ferreira 		exit(EXIT_FAILURE);
121a804b5ceSGuilherme Maciel Ferreira 	}
122a804b5ceSGuilherme Maciel Ferreira 
123a804b5ceSGuilherme Maciel Ferreira 	/*
124a804b5ceSGuilherme Maciel Ferreira 	 * check the passed arguments parameters meets the requirements
125a804b5ceSGuilherme Maciel Ferreira 	 * as per image type to be generated/listed
126a804b5ceSGuilherme Maciel Ferreira 	 */
127a804b5ceSGuilherme Maciel Ferreira 	if (tparams->check_params) {
12857a608e9SMartyn Welch 		if (tparams->check_params(&params)) {
12957a608e9SMartyn Welch 			fprintf(stderr, "%s: Parameter check failed\n",
13057a608e9SMartyn Welch 				params.cmdname);
13165a80b43SMartyn Welch 			exit(EXIT_FAILURE);
132a804b5ceSGuilherme Maciel Ferreira 		}
13357a608e9SMartyn Welch 	}
134a804b5ceSGuilherme Maciel Ferreira 
13512b83187SMartyn Welch 	if (!params.lflag && !params.outfile) {
13612b83187SMartyn Welch 		fprintf(stderr, "%s: No output file provided\n",
13712b83187SMartyn Welch 			params.cmdname);
13812b83187SMartyn Welch 		exit(EXIT_FAILURE);
13912b83187SMartyn Welch 	}
140a804b5ceSGuilherme Maciel Ferreira 
141a804b5ceSGuilherme Maciel Ferreira 	ifd = open(params.imagefile, O_RDONLY|O_BINARY);
142a804b5ceSGuilherme Maciel Ferreira 	if (ifd < 0) {
14311e3c1fdSMartyn Welch 		fprintf(stderr, "%s: Can't open \"%s\": %s\n", params.cmdname,
14411e3c1fdSMartyn Welch 			params.imagefile, strerror(errno));
145a804b5ceSGuilherme Maciel Ferreira 		exit(EXIT_FAILURE);
146a804b5ceSGuilherme Maciel Ferreira 	}
147a804b5ceSGuilherme Maciel Ferreira 
148a804b5ceSGuilherme Maciel Ferreira 	if (fstat(ifd, &sbuf) < 0) {
14911e3c1fdSMartyn Welch 		fprintf(stderr, "%s: Can't stat \"%s\": %s\n", params.cmdname,
15011e3c1fdSMartyn Welch 			params.imagefile, strerror(errno));
151a804b5ceSGuilherme Maciel Ferreira 		exit(EXIT_FAILURE);
152a804b5ceSGuilherme Maciel Ferreira 	}
153a804b5ceSGuilherme Maciel Ferreira 
154f41f5b7cSGuilherme Maciel Ferreira 	if ((uint32_t)sbuf.st_size < tparams->header_size) {
15511e3c1fdSMartyn Welch 		fprintf(stderr, "%s: Bad size: \"%s\" is not valid image\n",
156a804b5ceSGuilherme Maciel Ferreira 			params.cmdname, params.imagefile);
157a804b5ceSGuilherme Maciel Ferreira 		exit(EXIT_FAILURE);
158a804b5ceSGuilherme Maciel Ferreira 	}
159a804b5ceSGuilherme Maciel Ferreira 
160a804b5ceSGuilherme Maciel Ferreira 	ptr = mmap(0, sbuf.st_size, PROT_READ, MAP_SHARED, ifd, 0);
161a804b5ceSGuilherme Maciel Ferreira 	if (ptr == MAP_FAILED) {
16211e3c1fdSMartyn Welch 		fprintf(stderr, "%s: Can't read \"%s\": %s\n", params.cmdname,
16311e3c1fdSMartyn Welch 			params.imagefile, strerror(errno));
164a804b5ceSGuilherme Maciel Ferreira 		exit(EXIT_FAILURE);
165a804b5ceSGuilherme Maciel Ferreira 	}
166a804b5ceSGuilherme Maciel Ferreira 
167a804b5ceSGuilherme Maciel Ferreira 	/*
168a804b5ceSGuilherme Maciel Ferreira 	 * Both calls bellow scan through dumpimage registry for all
169a804b5ceSGuilherme Maciel Ferreira 	 * supported image types and verify the input image file
170a804b5ceSGuilherme Maciel Ferreira 	 * header for match
171a804b5ceSGuilherme Maciel Ferreira 	 */
172a804b5ceSGuilherme Maciel Ferreira 	if (params.iflag) {
173a804b5ceSGuilherme Maciel Ferreira 		/*
174a804b5ceSGuilherme Maciel Ferreira 		 * Extract the data files from within the matched
175a804b5ceSGuilherme Maciel Ferreira 		 * image type. Returns the error code if not matched
176a804b5ceSGuilherme Maciel Ferreira 		 */
17711e3c1fdSMartyn Welch 		retval = dumpimage_extract_subimage(tparams, ptr, &sbuf);
178a804b5ceSGuilherme Maciel Ferreira 	} else {
179a804b5ceSGuilherme Maciel Ferreira 		/*
180a804b5ceSGuilherme Maciel Ferreira 		 * Print the image information for matched image type
181a804b5ceSGuilherme Maciel Ferreira 		 * Returns the error code if not matched
182a804b5ceSGuilherme Maciel Ferreira 		 */
18311e3c1fdSMartyn Welch 		retval = imagetool_verify_print_header(ptr, &sbuf, tparams,
18411e3c1fdSMartyn Welch 						       &params);
185a804b5ceSGuilherme Maciel Ferreira 	}
186a804b5ceSGuilherme Maciel Ferreira 
187a804b5ceSGuilherme Maciel Ferreira 	(void)munmap((void *)ptr, sbuf.st_size);
188a804b5ceSGuilherme Maciel Ferreira 	(void)close(ifd);
189a804b5ceSGuilherme Maciel Ferreira 
190a804b5ceSGuilherme Maciel Ferreira 	return retval;
191a804b5ceSGuilherme Maciel Ferreira }
192a804b5ceSGuilherme Maciel Ferreira 
usage(void)193a804b5ceSGuilherme Maciel Ferreira static void usage(void)
194a804b5ceSGuilherme Maciel Ferreira {
195a804b5ceSGuilherme Maciel Ferreira 	fprintf(stderr, "Usage: %s -l image\n"
196a804b5ceSGuilherme Maciel Ferreira 		"          -l ==> list image header information\n",
197a804b5ceSGuilherme Maciel Ferreira 		params.cmdname);
198a804b5ceSGuilherme Maciel Ferreira 	fprintf(stderr,
199*e3b4fc95SMartyn Welch 		"       %s [-T type] [-p position] [-o outfile] image\n"
200*e3b4fc95SMartyn Welch 		"          -T ==> declare image type as 'type'\n"
201*e3b4fc95SMartyn Welch 		"          -p ==> 'position' (starting at 0) of the component to extract from image\n"
202*e3b4fc95SMartyn Welch 		"          -o ==> extract component to file 'outfile'\n",
203a804b5ceSGuilherme Maciel Ferreira 		params.cmdname);
204a804b5ceSGuilherme Maciel Ferreira 	fprintf(stderr,
20565a80b43SMartyn Welch 		"       %s -h ==> print usage information and exit\n",
20665a80b43SMartyn Welch 		params.cmdname);
20765a80b43SMartyn Welch 	fprintf(stderr,
208a804b5ceSGuilherme Maciel Ferreira 		"       %s -V ==> print version information and exit\n",
209a804b5ceSGuilherme Maciel Ferreira 		params.cmdname);
210a804b5ceSGuilherme Maciel Ferreira 
21165a80b43SMartyn Welch 	exit(EXIT_SUCCESS);
212a804b5ceSGuilherme Maciel Ferreira }
213