[people/ms/u-boot.git] / tools / mkenvimage.c

/*
 * (C) Copyright 2011 Free Electrons
 * David Wagner <david.wagner@free-electrons.com>
 *
 * Inspired from envcrc.c:
 * (C) Copyright 2001
 * Paolo Scaffardi, AIRVENT SAM s.p.a - RIMINI(ITALY), arsenio@tin.it
 *
 * See file CREDITS for list of people who contributed to this
 * project.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 * MA 02111-1307 USA
 */

/* We want the GNU version of basename() */
#define _GNU_SOURCE

#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <string.h>
#include <unistd.h>
#include <libgen.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/mman.h>

#include "compiler.h"
#include <u-boot/crc.h>
#include <version.h>

#define CRC_SIZE sizeof(uint32_t)

static void usage(const char *exec_name)
{
	fprintf(stderr, "%s [-h] [-r] [-b] [-p <byte>] -s <environment partition size> -o <output> <input file>\n"
	       "\n"
	       "This tool takes a key=value input file (same as would a `printenv' show) and generates the corresponding environment image, ready to be flashed.\n"
	       "\n"
	       "\tThe input file is in format:\n"
	       "\t\tkey1=value1\n"
	       "\t\tkey2=value2\n"
	       "\t\t...\n"
	       "\t-r : the environment has multiple copies in flash\n"
	       "\t-b : the target is big endian (default is little endian)\n"
	       "\t-p <byte> : fill the image with <byte> bytes instead of 0xff bytes\n"
	       "\t-V : print version information and exit\n"
	       "\n"
	       "If the input file is \"-\", data is read from standard input\n",
	       exec_name);
}

long int xstrtol(const char *s)
{
	long int tmp;

	errno = 0;
	tmp = strtol(s, NULL, 0);
	if (!errno)
		return tmp;

	if (errno == ERANGE)
		fprintf(stderr, "Bad integer format: %s\n",  s);
	else
		fprintf(stderr, "Error while parsing %s: %s\n", s,
				strerror(errno));

	exit(EXIT_FAILURE);
}

int main(int argc, char **argv)
{
	uint32_t crc, targetendian_crc;
	const char *txt_filename = NULL, *bin_filename = NULL;
	int txt_fd, bin_fd;
	unsigned char *dataptr, *envptr;
	unsigned char *filebuf = NULL;
	unsigned int filesize = 0, envsize = 0, datasize = 0;
	int bigendian = 0;
	int redundant = 0;
	unsigned char padbyte = 0xff;

	int option;
	int ret = EXIT_SUCCESS;

	struct stat txt_file_stat;

	int fp, ep;
	const char *prg;

	prg = basename(argv[0]);

	/* Turn off getopt()'s internal error message */
	opterr = 0;

	/* Parse the cmdline */
	while ((option = getopt(argc, argv, ":s:o:rbp:hV")) != -1) {
		switch (option) {
		case 's':
			datasize = xstrtol(optarg);
			break;
		case 'o':
			bin_filename = strdup(optarg);
			if (!bin_filename) {
				fprintf(stderr, "Can't strdup() the output filename\n");
				return EXIT_FAILURE;
			}
			break;
		case 'r':
			redundant = 1;
			break;
		case 'b':
			bigendian = 1;
			break;
		case 'p':
			padbyte = xstrtol(optarg);
			break;
		case 'h':
			usage(prg);
			return EXIT_SUCCESS;
		case 'V':
			printf("%s version %s\n", prg, PLAIN_VERSION);
			return EXIT_SUCCESS;
		case ':':
			fprintf(stderr, "Missing argument for option -%c\n",
				optopt);
			usage(prg);
			return EXIT_FAILURE;
		default:
			fprintf(stderr, "Wrong option -%c\n", optopt);
			usage(prg);
			return EXIT_FAILURE;
		}
	}

	/* Check datasize and allocate the data */
	if (datasize == 0) {
		fprintf(stderr, "Please specify the size of the environment partition.\n");
		usage(prg);
		return EXIT_FAILURE;
	}

	dataptr = malloc(datasize * sizeof(*dataptr));
	if (!dataptr) {
		fprintf(stderr, "Can't alloc %d bytes for dataptr.\n",
				datasize);
		return EXIT_FAILURE;
	}

	/*
	 * envptr points to the beginning of the actual environment (after the
	 * crc and possible `redundant' byte
	 */
	envsize = datasize - (CRC_SIZE + redundant);
	envptr = dataptr + CRC_SIZE + redundant;

	/* Pad the environment with the padding byte */
	memset(envptr, padbyte, envsize);

	/* Open the input file ... */
	if (optind >= argc || strcmp(argv[optind], "-") == 0) {
		int readbytes = 0;
		int readlen = sizeof(*envptr) * 4096;
		txt_fd = STDIN_FILENO;

		do {
			filebuf = realloc(filebuf, readlen);
			if (!filebuf) {
				fprintf(stderr, "Can't realloc memory for the input file buffer\n");
				return EXIT_FAILURE;
			}
			readbytes = read(txt_fd, filebuf + filesize, readlen);
			if (errno) {
				fprintf(stderr, "Error while reading stdin: %s\n",
						strerror(errno));
				return EXIT_FAILURE;
			}
			filesize += readbytes;
		} while (readbytes == readlen);

	} else {
		txt_filename = argv[optind];
		txt_fd = open(txt_filename, O_RDONLY);
		if (txt_fd == -1) {
			fprintf(stderr, "Can't open \"%s\": %s\n",
					txt_filename, strerror(errno));
			return EXIT_FAILURE;
		}
		/* ... and check it */
		ret = fstat(txt_fd, &txt_file_stat);
		if (ret == -1) {
			fprintf(stderr, "Can't stat() on \"%s\": %s\n",
					txt_filename, strerror(errno));
			return EXIT_FAILURE;
		}

		filesize = txt_file_stat.st_size;

		filebuf = mmap(NULL, sizeof(*envptr) * filesize, PROT_READ,
			       MAP_PRIVATE, txt_fd, 0);
		if (filebuf == MAP_FAILED) {
			fprintf(stderr, "mmap (%zu bytes) failed: %s\n",
					sizeof(*envptr) * filesize,
					strerror(errno));
			fprintf(stderr, "Falling back to read()\n");

			filebuf = malloc(sizeof(*envptr) * filesize);
			ret = read(txt_fd, filebuf, sizeof(*envptr) * filesize);
			if (ret != sizeof(*envptr) * filesize) {
				fprintf(stderr, "Can't read the whole input file (%zu bytes): %s\n",
					sizeof(*envptr) * filesize,
					strerror(errno));

				return EXIT_FAILURE;
			}
		}
		ret = close(txt_fd);
	}
	/* The +1 is for the additionnal ending \0. See below. */
	if (filesize + 1 > envsize) {
		fprintf(stderr, "The input file is larger than the environment partition size\n");
		return EXIT_FAILURE;
	}

	/* Replace newlines separating variables with \0 */
	for (fp = 0, ep = 0 ; fp < filesize ; fp++) {
		if (filebuf[fp] == '\n') {
			if (ep == 0) {
				/*
				 * Newlines at the beginning of the file ?
				 * Ignore them.
				 */
				continue;
			} else if (filebuf[fp-1] == '\\') {
				/*
				 * Embedded newline in a variable.
				 *
				 * The backslash was added to the envptr; rewind
				 * and replace it with a newline
				 */
				ep--;
				envptr[ep++] = '\n';
			} else {
				/* End of a variable */
				envptr[ep++] = '\0';
			}
		} else {
			envptr[ep++] = filebuf[fp];
		}
	}
	/*
	 * Make sure there is a final '\0'
	 * And do it again on the next byte to mark the end of the environment.
	 */
	if (envptr[ep-1] != '\0') {
		envptr[ep++] = '\0';
		/*
		 * The text file doesn't have an ending newline.  We need to
		 * check the env size again to make sure we have room for two \0
		 */
		if (ep >= envsize) {
			fprintf(stderr, "The environment file is too large for the target environment storage\n");
			return EXIT_FAILURE;
		}
		envptr[ep] = '\0';
	} else {
		envptr[ep] = '\0';
	}

	/* Computes the CRC and put it at the beginning of the data */
	crc = crc32(0, envptr, envsize);
	targetendian_crc = bigendian ? cpu_to_be32(crc) : cpu_to_le32(crc);

	memcpy(dataptr, &targetendian_crc, sizeof(targetendian_crc));
	if (redundant)
		dataptr[sizeof(targetendian_crc)] = 1;

	if (!bin_filename || strcmp(bin_filename, "-") == 0) {
		bin_fd = STDOUT_FILENO;
	} else {
		bin_fd = creat(bin_filename, S_IRUSR | S_IWUSR | S_IRGRP |
					     S_IWGRP);
		if (bin_fd == -1) {
			fprintf(stderr, "Can't open output file \"%s\": %s\n",
					bin_filename, strerror(errno));
			return EXIT_FAILURE;
		}
	}

	if (write(bin_fd, dataptr, sizeof(*dataptr) * datasize) !=
			sizeof(*dataptr) * datasize) {
		fprintf(stderr, "write() failed: %s\n", strerror(errno));
		return EXIT_FAILURE;
	}

	ret = close(bin_fd);

	return ret;
}
Commit	Line	Data
a6337e6f DW	1	/*
	2	* (C) Copyright 2011 Free Electrons
	3	* David Wagner <david.wagner@free-electrons.com>
	4	*
	5	* Inspired from envcrc.c:
	6	* (C) Copyright 2001
	7	* Paolo Scaffardi, AIRVENT SAM s.p.a - RIMINI(ITALY), arsenio@tin.it
	8	*
	9	* See file CREDITS for list of people who contributed to this
	10	* project.
	11	*
	12	* This program is free software; you can redistribute it and/or
	13	* modify it under the terms of the GNU General Public License as
	14	* published by the Free Software Foundation; either version 2 of
	15	* the License, or (at your option) any later version.
	16	*
	17	* This program is distributed in the hope that it will be useful,
	18	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	20	* GNU General Public License for more details.
	21	*
	22	* You should have received a copy of the GNU General Public License
	23	* along with this program; if not, write to the Free Software
	24	* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
	25	* MA 02111-1307 USA
	26	*/
	27
af44f4b2 HK	28	/* We want the GNU version of basename() */
	29	#define _GNU_SOURCE
	30
a6337e6f DW	31	#include <errno.h>
	32	#include <fcntl.h>
	33	#include <stdio.h>
d1acdae9	34	#include <stdlib.h>
a6337e6f DW	35	#include <stdint.h>
	36	#include <string.h>
	37	#include <unistd.h>
558cd995	38	#include <libgen.h>
a6337e6f DW	39	#include <sys/types.h>
a6337e6f DW	40	#include <sys/stat.h>
6ee39f80	41	#include <sys/mman.h>
a6337e6f	42
d1acdae9	43	#include "compiler.h"
a6337e6f	44	#include <u-boot/crc.h>
1895420b	45	#include <version.h>
a6337e6f DW	46
	47	#define CRC_SIZE sizeof(uint32_t)
	48
	49	static void usage(const char *exec_name)
	50	{
8a1b8fc7	51	fprintf(stderr, "%s [-h] [-r] [-b] [-p <byte>] -s <environment partition size> -o <output> <input file>\n"
a6337e6f	52	"\n"
8a1b8fc7	53	"This tool takes a key=value input file (same as would a `printenv' show) and generates the corresponding environment image, ready to be flashed.\n"
a6337e6f DW	54	"\n"
	55	"\tThe input file is in format:\n"
	56	"\t\tkey1=value1\n"
	57	"\t\tkey2=value2\n"
	58	"\t\t...\n"
	59	"\t-r : the environment has multiple copies in flash\n"
	60	"\t-b : the target is big endian (default is little endian)\n"
8a1b8fc7	61	"\t-p <byte> : fill the image with <byte> bytes instead of 0xff bytes\n"
1895420b	62	"\t-V : print version information and exit\n"
a6337e6f DW	63	"\n"
	64	"If the input file is \"-\", data is read from standard input\n",
	65	exec_name);
	66	}
	67
3d0f9bd0 DW	68	long int xstrtol(const char *s)
	69	{
	70	long int tmp;
	71
	72	errno = 0;
	73	tmp = strtol(s, NULL, 0);
	74	if (!errno)
	75	return tmp;
	76
	77	if (errno == ERANGE)
	78	fprintf(stderr, "Bad integer format: %s\n", s);
	79	else
	80	fprintf(stderr, "Error while parsing %s: %s\n", s,
	81	strerror(errno));
	82
	83	exit(EXIT_FAILURE);
	84	}
	85
a6337e6f DW	86	int main(int argc, char **argv)
	87	{
	88	uint32_t crc, targetendian_crc;
	89	const char txt_filename = NULL, bin_filename = NULL;
	90	int txt_fd, bin_fd;
	91	unsigned char dataptr, envptr;
	92	unsigned char *filebuf = NULL;
	93	unsigned int filesize = 0, envsize = 0, datasize = 0;
	94	int bigendian = 0;
	95	int redundant = 0;
	96	unsigned char padbyte = 0xff;
	97
	98	int option;
	99	int ret = EXIT_SUCCESS;
	100
	101	struct stat txt_file_stat;
	102
	103	int fp, ep;
af44f4b2 HK	104	const char *prg;
	105
	106	prg = basename(argv[0]);
a6337e6f	107
5e0c63e2 HK	108	/* Turn off getopt()'s internal error message */
	109	opterr = 0;
	110
a6337e6f	111	/* Parse the cmdline */
1895420b	112	while ((option = getopt(argc, argv, ":s:o:rbp:hV")) != -1) {
a6337e6f DW	113	switch (option) {
a6337e6f DW	114	case 's':
3d0f9bd0	115	datasize = xstrtol(optarg);
a6337e6f DW	116	break;
	117	case 'o':
	118	bin_filename = strdup(optarg);
	119	if (!bin_filename) {
8a1b8fc7	120	fprintf(stderr, "Can't strdup() the output filename\n");
a6337e6f DW	121	return EXIT_FAILURE;
	122	}
	123	break;
	124	case 'r':
	125	redundant = 1;
	126	break;
	127	case 'b':
	128	bigendian = 1;
	129	break;
	130	case 'p':
3d0f9bd0	131	padbyte = xstrtol(optarg);
a6337e6f DW	132	break;
a6337e6f DW	133	case 'h':
af44f4b2	134	usage(prg);
a6337e6f	135	return EXIT_SUCCESS;
1895420b HK	136	case 'V':
	137	printf("%s version %s\n", prg, PLAIN_VERSION);
	138	return EXIT_SUCCESS;
5e0c63e2 HK	139	case ':':
5e0c63e2 HK	140	fprintf(stderr, "Missing argument for option -%c\n",
72ebafbe	141	optopt);
e758a5c4	142	usage(prg);
5e0c63e2	143	return EXIT_FAILURE;
a6337e6f	144	default:
72ebafbe	145	fprintf(stderr, "Wrong option -%c\n", optopt);
af44f4b2	146	usage(prg);
a6337e6f DW	147	return EXIT_FAILURE;
	148	}
	149	}
	150
	151	/* Check datasize and allocate the data */
	152	if (datasize == 0) {
8a1b8fc7	153	fprintf(stderr, "Please specify the size of the environment partition.\n");
af44f4b2	154	usage(prg);
a6337e6f DW	155	return EXIT_FAILURE;
	156	}
	157
	158	dataptr = malloc(datasize * sizeof(*dataptr));
	159	if (!dataptr) {
8a1b8fc7 DW	160	fprintf(stderr, "Can't alloc %d bytes for dataptr.\n",
8a1b8fc7 DW	161	datasize);
a6337e6f DW	162	return EXIT_FAILURE;
	163	}
	164
	165	/*
	166	* envptr points to the beginning of the actual environment (after the
8a1b8fc7	167	* crc and possible `redundant' byte
a6337e6f DW	168	*/
	169	envsize = datasize - (CRC_SIZE + redundant);
	170	envptr = dataptr + CRC_SIZE + redundant;
	171
	172	/* Pad the environment with the padding byte */
	173	memset(envptr, padbyte, envsize);
	174
	175	/* Open the input file ... */
48995b5a	176	if (optind >= argc \|\| strcmp(argv[optind], "-") == 0) {
a6337e6f	177	int readbytes = 0;
48995b5a	178	int readlen = sizeof(envptr) 4096;
a6337e6f DW	179	txt_fd = STDIN_FILENO;
	180
	181	do {
	182	filebuf = realloc(filebuf, readlen);
3d0f9bd0 DW	183	if (!filebuf) {
	184	fprintf(stderr, "Can't realloc memory for the input file buffer\n");
	185	return EXIT_FAILURE;
	186	}
a6337e6f	187	readbytes = read(txt_fd, filebuf + filesize, readlen);
3d0f9bd0 DW	188	if (errno) {
	189	fprintf(stderr, "Error while reading stdin: %s\n",
	190	strerror(errno));
	191	return EXIT_FAILURE;
	192	}
a6337e6f DW	193	filesize += readbytes;
	194	} while (readbytes == readlen);
	195
	196	} else {
48995b5a	197	txt_filename = argv[optind];
a6337e6f DW	198	txt_fd = open(txt_filename, O_RDONLY);
	199	if (txt_fd == -1) {
	200	fprintf(stderr, "Can't open \"%s\": %s\n",
	201	txt_filename, strerror(errno));
	202	return EXIT_FAILURE;
	203	}
	204	/* ... and check it */
	205	ret = fstat(txt_fd, &txt_file_stat);
	206	if (ret == -1) {
8a1b8fc7 DW	207	fprintf(stderr, "Can't stat() on \"%s\": %s\n",
8a1b8fc7 DW	208	txt_filename, strerror(errno));
a6337e6f DW	209	return EXIT_FAILURE;
	210	}
	211
	212	filesize = txt_file_stat.st_size;
6ee39f80 DW	213
	214	filebuf = mmap(NULL, sizeof(envptr) filesize, PROT_READ,
	215	MAP_PRIVATE, txt_fd, 0);
	216	if (filebuf == MAP_FAILED) {
1ebff63f	217	fprintf(stderr, "mmap (%zu bytes) failed: %s\n",
6ee39f80 DW	218	sizeof(envptr) filesize,
	219	strerror(errno));
	220	fprintf(stderr, "Falling back to read()\n");
	221
	222	filebuf = malloc(sizeof(envptr) filesize);
	223	ret = read(txt_fd, filebuf, sizeof(envptr) filesize);
	224	if (ret != sizeof(envptr) filesize) {
1ebff63f	225	fprintf(stderr, "Can't read the whole input file (%zu bytes): %s\n",
6ee39f80 DW	226	sizeof(envptr) filesize,
	227	strerror(errno));
	228
	229	return EXIT_FAILURE;
	230	}
a6337e6f DW	231	}
	232	ret = close(txt_fd);
	233	}
8a1b8fc7 DW	234	/* The +1 is for the additionnal ending \0. See below. */
	235	if (filesize + 1 > envsize) {
	236	fprintf(stderr, "The input file is larger than the environment partition size\n");
a6337e6f DW	237	return EXIT_FAILURE;
	238	}
	239
	240	/* Replace newlines separating variables with \0 */
	241	for (fp = 0, ep = 0 ; fp < filesize ; fp++) {
	242	if (filebuf[fp] == '\n') {
dbee61db	243	if (ep == 0) {
a6337e6f	244	/*
dbee61db DW	245	* Newlines at the beginning of the file ?
dbee61db DW	246	* Ignore them.
a6337e6f DW	247	*/
	248	continue;
	249	} else if (filebuf[fp-1] == '\\') {
	250	/*
	251	* Embedded newline in a variable.
	252	*
dbee61db DW	253	* The backslash was added to the envptr; rewind
dbee61db DW	254	* and replace it with a newline
a6337e6f DW	255	*/
	256	ep--;
	257	envptr[ep++] = '\n';
	258	} else {
	259	/* End of a variable */
	260	envptr[ep++] = '\0';
	261	}
a6337e6f DW	262	} else {
	263	envptr[ep++] = filebuf[fp];
	264	}
	265	}
	266	/*
	267	* Make sure there is a final '\0'
	268	* And do it again on the next byte to mark the end of the environment.
	269	*/
	270	if (envptr[ep-1] != '\0') {
	271	envptr[ep++] = '\0';
	272	/*
	273	* The text file doesn't have an ending newline. We need to
	274	* check the env size again to make sure we have room for two \0
	275	*/
	276	if (ep >= envsize) {
8a1b8fc7	277	fprintf(stderr, "The environment file is too large for the target environment storage\n");
a6337e6f DW	278	return EXIT_FAILURE;
	279	}
	280	envptr[ep] = '\0';
	281	} else {
	282	envptr[ep] = '\0';
	283	}
	284
	285	/* Computes the CRC and put it at the beginning of the data */
	286	crc = crc32(0, envptr, envsize);
	287	targetendian_crc = bigendian ? cpu_to_be32(crc) : cpu_to_le32(crc);
	288
d8d26599 DW	289	memcpy(dataptr, &targetendian_crc, sizeof(targetendian_crc));
	290	if (redundant)
	291	dataptr[sizeof(targetendian_crc)] = 1;
a6337e6f	292
48995b5a DW	293	if (!bin_filename \|\| strcmp(bin_filename, "-") == 0) {
	294	bin_fd = STDOUT_FILENO;
	295	} else {
4f7136e7 MF	296	bin_fd = creat(bin_filename, S_IRUSR \| S_IWUSR \| S_IRGRP \|
4f7136e7 MF	297	S_IWGRP);
48995b5a DW	298	if (bin_fd == -1) {
	299	fprintf(stderr, "Can't open output file \"%s\": %s\n",
	300	bin_filename, strerror(errno));
	301	return EXIT_FAILURE;
	302	}
a6337e6f DW	303	}
	304
	305	if (write(bin_fd, dataptr, sizeof(dataptr) datasize) !=
	306	sizeof(dataptr) datasize) {
	307	fprintf(stderr, "write() failed: %s\n", strerror(errno));
	308	return EXIT_FAILURE;
	309	}
	310
	311	ret = close(bin_fd);
	312
	313	return ret;
	314	}