2 * QEMU Executable loader
4 * Copyright (c) 2006 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 * Gunzip functionality in this file is derived from u-boot:
26 * (C) Copyright 2008 Semihalf
28 * (C) Copyright 2000-2005
31 * This program is free software; you can redistribute it and/or
32 * modify it under the terms of the GNU General Public License as
33 * published by the Free Software Foundation; either version 2 of
34 * the License, or (at your option) any later version.
36 * This program is distributed in the hope that it will be useful,
37 * but WITHOUT ANY WARRANTY; without even the implied warranty of
38 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
39 * GNU General Public License for more details.
41 * You should have received a copy of the GNU General Public License along
42 * with this program; if not, see <http://www.gnu.org/licenses/>.
46 #include "disas/disas.h"
47 #include "monitor/monitor.h"
48 #include "sysemu/sysemu.h"
49 #include "uboot_image.h"
50 #include "hw/loader.h"
51 #include "hw/nvram/fw_cfg.h"
52 #include "exec/memory.h"
53 #include "exec/address-spaces.h"
57 bool option_rom_has_mr = false;
58 bool rom_file_has_mr = true;
60 static int roms_loaded;
62 /* return the size or -1 if error */
63 int get_image_size(const char *filename)
66 fd = open(filename, O_RDONLY | O_BINARY);
69 size = lseek(fd, 0, SEEK_END);
74 /* return the size or -1 if error */
75 /* deprecated, because caller does not specify buffer size! */
76 int load_image(const char *filename, uint8_t *addr)
79 fd = open(filename, O_RDONLY | O_BINARY);
82 size = lseek(fd, 0, SEEK_END);
83 lseek(fd, 0, SEEK_SET);
84 if (read(fd, addr, size) != size) {
92 /* return the size or -1 if error */
93 ssize_t load_image_size(const char *filename, void *addr, size_t size)
98 fd = open(filename, O_RDONLY | O_BINARY);
103 actsize = read(fd, addr, size);
113 /* read()-like version */
114 ssize_t read_targphys(const char *name,
115 int fd, hwaddr dst_addr, size_t nbytes)
120 buf = g_malloc(nbytes);
121 did = read(fd, buf, nbytes);
123 rom_add_blob_fixed("read", buf, did, dst_addr);
128 /* return the size or -1 if error */
129 int load_image_targphys(const char *filename,
130 hwaddr addr, uint64_t max_sz)
134 size = get_image_size(filename);
139 rom_add_file_fixed(filename, addr, -1);
144 void pstrcpy_targphys(const char *name, hwaddr dest, int buf_size,
150 if (buf_size <= 0) return;
151 nulp = memchr(source, 0, buf_size);
153 rom_add_blob_fixed(name, source, (nulp - source) + 1, dest);
155 rom_add_blob_fixed(name, source, buf_size, dest);
156 ptr = rom_ptr(dest + buf_size - 1);
165 uint32_t a_info; /* Use macros N_MAGIC, etc for access */
166 uint32_t a_text; /* length of text, in bytes */
167 uint32_t a_data; /* length of data, in bytes */
168 uint32_t a_bss; /* length of uninitialized data area, in bytes */
169 uint32_t a_syms; /* length of symbol table data in file, in bytes */
170 uint32_t a_entry; /* start address */
171 uint32_t a_trsize; /* length of relocation info for text, in bytes */
172 uint32_t a_drsize; /* length of relocation info for data, in bytes */
175 static void bswap_ahdr(struct exec *e)
177 bswap32s(&e->a_info);
178 bswap32s(&e->a_text);
179 bswap32s(&e->a_data);
181 bswap32s(&e->a_syms);
182 bswap32s(&e->a_entry);
183 bswap32s(&e->a_trsize);
184 bswap32s(&e->a_drsize);
187 #define N_MAGIC(exec) ((exec).a_info & 0xffff)
192 #define _N_HDROFF(x) (1024 - sizeof (struct exec))
193 #define N_TXTOFF(x) \
194 (N_MAGIC(x) == ZMAGIC ? _N_HDROFF((x)) + sizeof (struct exec) : \
195 (N_MAGIC(x) == QMAGIC ? 0 : sizeof (struct exec)))
196 #define N_TXTADDR(x, target_page_size) (N_MAGIC(x) == QMAGIC ? target_page_size : 0)
197 #define _N_SEGMENT_ROUND(x, target_page_size) (((x) + target_page_size - 1) & ~(target_page_size - 1))
199 #define _N_TXTENDADDR(x, target_page_size) (N_TXTADDR(x, target_page_size)+(x).a_text)
201 #define N_DATADDR(x, target_page_size) \
202 (N_MAGIC(x)==OMAGIC? (_N_TXTENDADDR(x, target_page_size)) \
203 : (_N_SEGMENT_ROUND (_N_TXTENDADDR(x, target_page_size), target_page_size)))
206 int load_aout(const char *filename, hwaddr addr, int max_sz,
207 int bswap_needed, hwaddr target_page_size)
214 fd = open(filename, O_RDONLY | O_BINARY);
218 size = read(fd, &e, sizeof(e));
231 if (e.a_text + e.a_data > max_sz)
233 lseek(fd, N_TXTOFF(e), SEEK_SET);
234 size = read_targphys(filename, fd, addr, e.a_text + e.a_data);
239 if (N_DATADDR(e, target_page_size) + e.a_data > max_sz)
241 lseek(fd, N_TXTOFF(e), SEEK_SET);
242 size = read_targphys(filename, fd, addr, e.a_text);
245 ret = read_targphys(filename, fd, addr + N_DATADDR(e, target_page_size),
263 static void *load_at(int fd, int offset, int size)
266 if (lseek(fd, offset, SEEK_SET) < 0)
268 ptr = g_malloc(size);
269 if (read(fd, ptr, size) != size) {
280 #define ELF_CLASS ELFCLASS32
284 #define elf_word uint32_t
285 #define elf_sword int32_t
286 #define bswapSZs bswap32s
287 #include "hw/elf_ops.h"
298 #define elfhdr elf64_hdr
299 #define elf_phdr elf64_phdr
300 #define elf_note elf64_note
301 #define elf_shdr elf64_shdr
302 #define elf_sym elf64_sym
303 #define elf_word uint64_t
304 #define elf_sword int64_t
305 #define bswapSZs bswap64s
307 #include "hw/elf_ops.h"
309 const char *load_elf_strerror(int error)
314 case ELF_LOAD_FAILED:
315 return "Failed to load ELF";
316 case ELF_LOAD_NOT_ELF:
317 return "The image is not ELF";
318 case ELF_LOAD_WRONG_ARCH:
319 return "The image is from incompatible architecture";
320 case ELF_LOAD_WRONG_ENDIAN:
321 return "The image has incorrect endianness";
323 return "Unknown error";
327 /* return < 0 if error, otherwise the number of bytes loaded in memory */
328 int load_elf(const char *filename, uint64_t (*translate_fn)(void *, uint64_t),
329 void *translate_opaque, uint64_t *pentry, uint64_t *lowaddr,
330 uint64_t *highaddr, int big_endian, int elf_machine, int clear_lsb)
332 int fd, data_order, target_data_order, must_swab, ret = ELF_LOAD_FAILED;
333 uint8_t e_ident[EI_NIDENT];
335 fd = open(filename, O_RDONLY | O_BINARY);
340 if (read(fd, e_ident, sizeof(e_ident)) != sizeof(e_ident))
342 if (e_ident[0] != ELFMAG0 ||
343 e_ident[1] != ELFMAG1 ||
344 e_ident[2] != ELFMAG2 ||
345 e_ident[3] != ELFMAG3) {
346 ret = ELF_LOAD_NOT_ELF;
349 #ifdef HOST_WORDS_BIGENDIAN
350 data_order = ELFDATA2MSB;
352 data_order = ELFDATA2LSB;
354 must_swab = data_order != e_ident[EI_DATA];
356 target_data_order = ELFDATA2MSB;
358 target_data_order = ELFDATA2LSB;
361 if (target_data_order != e_ident[EI_DATA]) {
362 ret = ELF_LOAD_WRONG_ENDIAN;
366 lseek(fd, 0, SEEK_SET);
367 if (e_ident[EI_CLASS] == ELFCLASS64) {
368 ret = load_elf64(filename, fd, translate_fn, translate_opaque, must_swab,
369 pentry, lowaddr, highaddr, elf_machine, clear_lsb);
371 ret = load_elf32(filename, fd, translate_fn, translate_opaque, must_swab,
372 pentry, lowaddr, highaddr, elf_machine, clear_lsb);
380 static void bswap_uboot_header(uboot_image_header_t *hdr)
382 #ifndef HOST_WORDS_BIGENDIAN
383 bswap32s(&hdr->ih_magic);
384 bswap32s(&hdr->ih_hcrc);
385 bswap32s(&hdr->ih_time);
386 bswap32s(&hdr->ih_size);
387 bswap32s(&hdr->ih_load);
388 bswap32s(&hdr->ih_ep);
389 bswap32s(&hdr->ih_dcrc);
394 #define ZALLOC_ALIGNMENT 16
396 static void *zalloc(void *x, unsigned items, unsigned size)
401 size = (size + ZALLOC_ALIGNMENT - 1) & ~(ZALLOC_ALIGNMENT - 1);
408 static void zfree(void *x, void *addr)
415 #define EXTRA_FIELD 4
418 #define RESERVED 0xe0
422 /* This is the usual maximum in uboot, so if a uImage overflows this, it would
423 * overflow on real hardware too. */
424 #define UBOOT_MAX_GUNZIP_BYTES (64 << 20)
426 static ssize_t gunzip(void *dst, size_t dstlen, uint8_t *src,
436 if (src[2] != DEFLATED || (flags & RESERVED) != 0) {
437 puts ("Error: Bad gzipped data\n");
440 if ((flags & EXTRA_FIELD) != 0)
441 i = 12 + src[10] + (src[11] << 8);
442 if ((flags & ORIG_NAME) != 0)
443 while (src[i++] != 0)
445 if ((flags & COMMENT) != 0)
446 while (src[i++] != 0)
448 if ((flags & HEAD_CRC) != 0)
451 puts ("Error: gunzip out of data in header\n");
458 r = inflateInit2(&s, -MAX_WBITS);
460 printf ("Error: inflateInit2() returned %d\n", r);
464 s.avail_in = srclen - i;
466 s.avail_out = dstlen;
467 r = inflate(&s, Z_FINISH);
468 if (r != Z_OK && r != Z_STREAM_END) {
469 printf ("Error: inflate() returned %d\n", r);
472 dstbytes = s.next_out - (unsigned char *) dst;
478 /* Load a U-Boot image. */
479 static int load_uboot_image(const char *filename, hwaddr *ep, hwaddr *loadaddr,
480 int *is_linux, uint8_t image_type)
485 uboot_image_header_t h;
486 uboot_image_header_t *hdr = &h;
487 uint8_t *data = NULL;
489 int do_uncompress = 0;
491 fd = open(filename, O_RDONLY | O_BINARY);
495 size = read(fd, hdr, sizeof(uboot_image_header_t));
499 bswap_uboot_header(hdr);
501 if (hdr->ih_magic != IH_MAGIC)
504 if (hdr->ih_type != image_type) {
505 fprintf(stderr, "Wrong image type %d, expected %d\n", hdr->ih_type,
510 /* TODO: Implement other image types. */
511 switch (hdr->ih_type) {
513 address = hdr->ih_load;
515 *loadaddr = hdr->ih_load;
518 switch (hdr->ih_comp) {
526 "Unable to load u-boot images with compression type %d\n",
535 /* TODO: Check CPU type. */
537 if (hdr->ih_os == IH_OS_LINUX) {
545 case IH_TYPE_RAMDISK:
549 fprintf(stderr, "Unsupported u-boot image type %d\n", hdr->ih_type);
553 data = g_malloc(hdr->ih_size);
555 if (read(fd, data, hdr->ih_size) != hdr->ih_size) {
556 fprintf(stderr, "Error reading file\n");
561 uint8_t *compressed_data;
565 compressed_data = data;
566 max_bytes = UBOOT_MAX_GUNZIP_BYTES;
567 data = g_malloc(max_bytes);
569 bytes = gunzip(data, max_bytes, compressed_data, hdr->ih_size);
570 g_free(compressed_data);
572 fprintf(stderr, "Unable to decompress gzipped image!\n");
575 hdr->ih_size = bytes;
578 rom_add_blob_fixed(filename, data, hdr->ih_size, address);
589 int load_uimage(const char *filename, hwaddr *ep, hwaddr *loadaddr,
592 return load_uboot_image(filename, ep, loadaddr, is_linux, IH_TYPE_KERNEL);
595 /* Load a ramdisk. */
596 int load_ramdisk(const char *filename, hwaddr addr, uint64_t max_sz)
598 return load_uboot_image(filename, NULL, &addr, NULL, IH_TYPE_RAMDISK);
601 /* This simply prevents g_malloc in the function below from allocating
602 * a huge amount of memory, by placing a limit on the maximum
603 * uncompressed image size that load_image_gzipped will read.
605 #define LOAD_IMAGE_MAX_GUNZIP_BYTES (256 << 20)
607 /* Load a gzip-compressed kernel. */
608 int load_image_gzipped(const char *filename, hwaddr addr, uint64_t max_sz)
610 uint8_t *compressed_data = NULL;
611 uint8_t *data = NULL;
616 if (!g_file_get_contents(filename, (char **) &compressed_data, &len,
621 /* Is it a gzip-compressed file? */
623 compressed_data[0] != 0x1f ||
624 compressed_data[1] != 0x8b) {
628 if (max_sz > LOAD_IMAGE_MAX_GUNZIP_BYTES) {
629 max_sz = LOAD_IMAGE_MAX_GUNZIP_BYTES;
632 data = g_malloc(max_sz);
633 bytes = gunzip(data, max_sz, compressed_data, len);
635 fprintf(stderr, "%s: unable to decompress gzipped kernel file\n",
640 rom_add_blob_fixed(filename, data, bytes, addr);
644 g_free(compressed_data);
650 * Functions for reboot-persistent memory regions.
651 * - used for vga bios and option roms.
652 * - also linux kernel (-kernel / -initrd).
655 typedef struct Rom Rom;
661 /* datasize is the amount of memory allocated in "data". If datasize is less
662 * than romsize, it means that the area from datasize to romsize is filled
675 QTAILQ_ENTRY(Rom) next;
678 static FWCfgState *fw_cfg;
679 static QTAILQ_HEAD(, Rom) roms = QTAILQ_HEAD_INITIALIZER(roms);
681 static void rom_insert(Rom *rom)
686 hw_error ("ROM images must be loaded at startup\n");
689 /* list is ordered by load address */
690 QTAILQ_FOREACH(item, &roms, next) {
691 if (rom->addr >= item->addr)
693 QTAILQ_INSERT_BEFORE(item, rom, next);
696 QTAILQ_INSERT_TAIL(&roms, rom, next);
699 static void *rom_set_mr(Rom *rom, Object *owner, const char *name)
703 rom->mr = g_malloc(sizeof(*rom->mr));
704 memory_region_init_ram(rom->mr, owner, name, rom->datasize, &error_abort);
705 memory_region_set_readonly(rom->mr, true);
706 vmstate_register_ram_global(rom->mr);
708 data = memory_region_get_ram_ptr(rom->mr);
709 memcpy(data, rom->data, rom->datasize);
714 int rom_add_file(const char *file, const char *fw_dir,
715 hwaddr addr, int32_t bootindex,
722 rom = g_malloc0(sizeof(*rom));
723 rom->name = g_strdup(file);
724 rom->path = qemu_find_file(QEMU_FILE_TYPE_BIOS, rom->name);
725 if (rom->path == NULL) {
726 rom->path = g_strdup(file);
729 fd = open(rom->path, O_RDONLY | O_BINARY);
731 fprintf(stderr, "Could not open option rom '%s': %s\n",
732 rom->path, strerror(errno));
737 rom->fw_dir = g_strdup(fw_dir);
738 rom->fw_file = g_strdup(file);
741 rom->romsize = lseek(fd, 0, SEEK_END);
742 rom->datasize = rom->romsize;
743 rom->data = g_malloc0(rom->datasize);
744 lseek(fd, 0, SEEK_SET);
745 rc = read(fd, rom->data, rom->datasize);
746 if (rc != rom->datasize) {
747 fprintf(stderr, "rom: file %-20s: read error: rc=%d (expected %zd)\n",
748 rom->name, rc, rom->datasize);
753 if (rom->fw_file && fw_cfg) {
754 const char *basename;
755 char fw_file_name[FW_CFG_MAX_FILE_PATH];
758 basename = strrchr(rom->fw_file, '/');
762 basename = rom->fw_file;
764 snprintf(fw_file_name, sizeof(fw_file_name), "%s/%s", rom->fw_dir,
766 snprintf(devpath, sizeof(devpath), "/rom@%s", fw_file_name);
768 if ((!option_rom || option_rom_has_mr) && rom_file_has_mr) {
769 data = rom_set_mr(rom, OBJECT(fw_cfg), devpath);
774 fw_cfg_add_file(fw_cfg, fw_file_name, data, rom->romsize);
776 snprintf(devpath, sizeof(devpath), "/rom@" TARGET_FMT_plx, addr);
779 add_boot_device_path(bootindex, NULL, devpath);
792 void *rom_add_blob(const char *name, const void *blob, size_t len,
793 hwaddr addr, const char *fw_file_name,
794 FWCfgReadCallback fw_callback, void *callback_opaque)
799 rom = g_malloc0(sizeof(*rom));
800 rom->name = g_strdup(name);
804 rom->data = g_malloc0(rom->datasize);
805 memcpy(rom->data, blob, len);
807 if (fw_file_name && fw_cfg) {
810 snprintf(devpath, sizeof(devpath), "/rom@%s", fw_file_name);
812 if (rom_file_has_mr) {
813 data = rom_set_mr(rom, OBJECT(fw_cfg), devpath);
818 fw_cfg_add_file_callback(fw_cfg, fw_file_name,
819 fw_callback, callback_opaque,
825 /* This function is specific for elf program because we don't need to allocate
826 * all the rom. We just allocate the first part and the rest is just zeros. This
827 * is why romsize and datasize are different. Also, this function seize the
828 * memory ownership of "data", so we don't have to allocate and copy the buffer.
830 int rom_add_elf_program(const char *name, void *data, size_t datasize,
831 size_t romsize, hwaddr addr)
835 rom = g_malloc0(sizeof(*rom));
836 rom->name = g_strdup(name);
838 rom->datasize = datasize;
839 rom->romsize = romsize;
845 int rom_add_vga(const char *file)
847 return rom_add_file(file, "vgaroms", 0, -1, true);
850 int rom_add_option(const char *file, int32_t bootindex)
852 return rom_add_file(file, "genroms", 0, bootindex, true);
855 static void rom_reset(void *unused)
859 QTAILQ_FOREACH(rom, &roms, next) {
863 if (rom->data == NULL) {
867 void *host = memory_region_get_ram_ptr(rom->mr);
868 memcpy(host, rom->data, rom->datasize);
870 cpu_physical_memory_write_rom(&address_space_memory,
871 rom->addr, rom->data, rom->datasize);
874 /* rom needs to be written only once */
879 * The rom loader is really on the same level as firmware in the guest
880 * shadowing a ROM into RAM. Such a shadowing mechanism needs to ensure
881 * that the instruction cache for that new region is clear, so that the
882 * CPU definitely fetches its instructions from the just written data.
884 cpu_flush_icache_range(rom->addr, rom->datasize);
888 int rom_load_all(void)
891 MemoryRegionSection section;
894 QTAILQ_FOREACH(rom, &roms, next) {
898 if (addr > rom->addr) {
899 fprintf(stderr, "rom: requested regions overlap "
900 "(rom %s. free=0x" TARGET_FMT_plx
901 ", addr=0x" TARGET_FMT_plx ")\n",
902 rom->name, addr, rom->addr);
906 addr += rom->romsize;
907 section = memory_region_find(get_system_memory(), rom->addr, 1);
908 rom->isrom = int128_nz(section.size) && memory_region_is_rom(section.mr);
909 memory_region_unref(section.mr);
911 qemu_register_reset(rom_reset, NULL);
915 void rom_load_done(void)
920 void rom_set_fw(FWCfgState *f)
925 static Rom *find_rom(hwaddr addr)
929 QTAILQ_FOREACH(rom, &roms, next) {
936 if (rom->addr > addr) {
939 if (rom->addr + rom->romsize < addr) {
948 * Copies memory from registered ROMs to dest. Any memory that is contained in
949 * a ROM between addr and addr + size is copied. Note that this can involve
950 * multiple ROMs, which need not start at addr and need not end at addr + size.
952 int rom_copy(uint8_t *dest, hwaddr addr, size_t size)
954 hwaddr end = addr + size;
955 uint8_t *s, *d = dest;
959 QTAILQ_FOREACH(rom, &roms, next) {
966 if (rom->addr + rom->romsize < addr) {
969 if (rom->addr > end) {
973 d = dest + (rom->addr - addr);
977 if ((d + l) > (dest + size)) {
985 if (rom->romsize > rom->datasize) {
986 /* If datasize is less than romsize, it means that we didn't
987 * allocate all the ROM because the trailing data are only zeros.
991 l = rom->romsize - rom->datasize;
993 if ((d + l) > (dest + size)) {
994 /* Rom size doesn't fit in the destination area. Adjust to avoid
1006 return (d + l) - dest;
1009 void *rom_ptr(hwaddr addr)
1013 rom = find_rom(addr);
1014 if (!rom || !rom->data)
1016 return rom->data + (addr - rom->addr);
1019 void do_info_roms(Monitor *mon, const QDict *qdict)
1023 QTAILQ_FOREACH(rom, &roms, next) {
1025 monitor_printf(mon, "%s"
1026 " size=0x%06zx name=\"%s\"\n",
1027 memory_region_name(rom->mr),
1030 } else if (!rom->fw_file) {
1031 monitor_printf(mon, "addr=" TARGET_FMT_plx
1032 " size=0x%06zx mem=%s name=\"%s\"\n",
1033 rom->addr, rom->romsize,
1034 rom->isrom ? "rom" : "ram",
1037 monitor_printf(mon, "fw=%s/%s"
1038 " size=0x%06zx name=\"%s\"\n",