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
29 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
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/>.
45 #include "qemu/osdep.h"
46 #include "qemu-common.h"
47 #include "qemu/datadir.h"
48 #include "qapi/error.h"
49 #include "qapi/qapi-commands-machine.h"
50 #include "qapi/type-helpers.h"
53 #include "disas/disas.h"
54 #include "migration/vmstate.h"
55 #include "monitor/monitor.h"
56 #include "sysemu/reset.h"
57 #include "sysemu/sysemu.h"
58 #include "uboot_image.h"
59 #include "hw/loader.h"
60 #include "hw/nvram/fw_cfg.h"
61 #include "exec/memory.h"
62 #include "hw/boards.h"
63 #include "qemu/cutils.h"
64 #include "sysemu/runstate.h"
68 static int roms_loaded
;
70 /* return the size or -1 if error */
71 int64_t get_image_size(const char *filename
)
75 fd
= open(filename
, O_RDONLY
| O_BINARY
);
78 size
= lseek(fd
, 0, SEEK_END
);
83 /* return the size or -1 if error */
84 ssize_t
load_image_size(const char *filename
, void *addr
, size_t size
)
87 ssize_t actsize
, l
= 0;
89 fd
= open(filename
, O_RDONLY
| O_BINARY
);
94 while ((actsize
= read(fd
, addr
+ l
, size
- l
)) > 0) {
100 return actsize
< 0 ? -1 : l
;
103 /* read()-like version */
104 ssize_t
read_targphys(const char *name
,
105 int fd
, hwaddr dst_addr
, size_t nbytes
)
110 buf
= g_malloc(nbytes
);
111 did
= read(fd
, buf
, nbytes
);
113 rom_add_blob_fixed("read", buf
, did
, dst_addr
);
118 int load_image_targphys(const char *filename
,
119 hwaddr addr
, uint64_t max_sz
)
121 return load_image_targphys_as(filename
, addr
, max_sz
, NULL
);
124 /* return the size or -1 if error */
125 int load_image_targphys_as(const char *filename
,
126 hwaddr addr
, uint64_t max_sz
, AddressSpace
*as
)
130 size
= get_image_size(filename
);
131 if (size
< 0 || size
> max_sz
) {
135 if (rom_add_file_fixed_as(filename
, addr
, -1, as
) < 0) {
142 int load_image_mr(const char *filename
, MemoryRegion
*mr
)
146 if (!memory_access_is_direct(mr
, false)) {
147 /* Can only load an image into RAM or ROM */
151 size
= get_image_size(filename
);
153 if (size
< 0 || size
> memory_region_size(mr
)) {
157 if (rom_add_file_mr(filename
, mr
, -1) < 0) {
164 void pstrcpy_targphys(const char *name
, hwaddr dest
, int buf_size
,
170 if (buf_size
<= 0) return;
171 nulp
= memchr(source
, 0, buf_size
);
173 rom_add_blob_fixed(name
, source
, (nulp
- source
) + 1, dest
);
175 rom_add_blob_fixed(name
, source
, buf_size
, dest
);
176 ptr
= rom_ptr(dest
+ buf_size
- 1, sizeof(*ptr
));
185 uint32_t a_info
; /* Use macros N_MAGIC, etc for access */
186 uint32_t a_text
; /* length of text, in bytes */
187 uint32_t a_data
; /* length of data, in bytes */
188 uint32_t a_bss
; /* length of uninitialized data area, in bytes */
189 uint32_t a_syms
; /* length of symbol table data in file, in bytes */
190 uint32_t a_entry
; /* start address */
191 uint32_t a_trsize
; /* length of relocation info for text, in bytes */
192 uint32_t a_drsize
; /* length of relocation info for data, in bytes */
195 static void bswap_ahdr(struct exec
*e
)
197 bswap32s(&e
->a_info
);
198 bswap32s(&e
->a_text
);
199 bswap32s(&e
->a_data
);
201 bswap32s(&e
->a_syms
);
202 bswap32s(&e
->a_entry
);
203 bswap32s(&e
->a_trsize
);
204 bswap32s(&e
->a_drsize
);
207 #define N_MAGIC(exec) ((exec).a_info & 0xffff)
212 #define _N_HDROFF(x) (1024 - sizeof (struct exec))
213 #define N_TXTOFF(x) \
214 (N_MAGIC(x) == ZMAGIC ? _N_HDROFF((x)) + sizeof (struct exec) : \
215 (N_MAGIC(x) == QMAGIC ? 0 : sizeof (struct exec)))
216 #define N_TXTADDR(x, target_page_size) (N_MAGIC(x) == QMAGIC ? target_page_size : 0)
217 #define _N_SEGMENT_ROUND(x, target_page_size) (((x) + target_page_size - 1) & ~(target_page_size - 1))
219 #define _N_TXTENDADDR(x, target_page_size) (N_TXTADDR(x, target_page_size)+(x).a_text)
221 #define N_DATADDR(x, target_page_size) \
222 (N_MAGIC(x)==OMAGIC? (_N_TXTENDADDR(x, target_page_size)) \
223 : (_N_SEGMENT_ROUND (_N_TXTENDADDR(x, target_page_size), target_page_size)))
226 int load_aout(const char *filename
, hwaddr addr
, int max_sz
,
227 int bswap_needed
, hwaddr target_page_size
)
234 fd
= open(filename
, O_RDONLY
| O_BINARY
);
238 size
= read(fd
, &e
, sizeof(e
));
251 if (e
.a_text
+ e
.a_data
> max_sz
)
253 lseek(fd
, N_TXTOFF(e
), SEEK_SET
);
254 size
= read_targphys(filename
, fd
, addr
, e
.a_text
+ e
.a_data
);
259 if (N_DATADDR(e
, target_page_size
) + e
.a_data
> max_sz
)
261 lseek(fd
, N_TXTOFF(e
), SEEK_SET
);
262 size
= read_targphys(filename
, fd
, addr
, e
.a_text
);
265 ret
= read_targphys(filename
, fd
, addr
+ N_DATADDR(e
, target_page_size
),
283 static void *load_at(int fd
, off_t offset
, size_t size
)
286 if (lseek(fd
, offset
, SEEK_SET
) < 0)
288 ptr
= g_malloc(size
);
289 if (read(fd
, ptr
, size
) != size
) {
300 #define ELF_CLASS ELFCLASS32
304 #define elf_word uint32_t
305 #define elf_sword int32_t
306 #define bswapSZs bswap32s
307 #include "hw/elf_ops.h"
319 #define elfhdr elf64_hdr
320 #define elf_phdr elf64_phdr
321 #define elf_note elf64_note
322 #define elf_shdr elf64_shdr
323 #define elf_sym elf64_sym
324 #define elf_rela elf64_rela
325 #define elf_word uint64_t
326 #define elf_sword int64_t
327 #define bswapSZs bswap64s
329 #include "hw/elf_ops.h"
331 const char *load_elf_strerror(ssize_t error
)
336 case ELF_LOAD_FAILED
:
337 return "Failed to load ELF";
338 case ELF_LOAD_NOT_ELF
:
339 return "The image is not ELF";
340 case ELF_LOAD_WRONG_ARCH
:
341 return "The image is from incompatible architecture";
342 case ELF_LOAD_WRONG_ENDIAN
:
343 return "The image has incorrect endianness";
344 case ELF_LOAD_TOO_BIG
:
345 return "The image segments are too big to load";
347 return "Unknown error";
351 void load_elf_hdr(const char *filename
, void *hdr
, bool *is64
, Error
**errp
)
354 uint8_t e_ident_local
[EI_NIDENT
];
356 size_t hdr_size
, off
;
364 fd
= open(filename
, O_RDONLY
| O_BINARY
);
366 error_setg_errno(errp
, errno
, "Failed to open file: %s", filename
);
369 if (read(fd
, hdr
, EI_NIDENT
) != EI_NIDENT
) {
370 error_setg_errno(errp
, errno
, "Failed to read file: %s", filename
);
373 if (e_ident
[0] != ELFMAG0
||
374 e_ident
[1] != ELFMAG1
||
375 e_ident
[2] != ELFMAG2
||
376 e_ident
[3] != ELFMAG3
) {
377 error_setg(errp
, "Bad ELF magic");
381 is64l
= e_ident
[EI_CLASS
] == ELFCLASS64
;
382 hdr_size
= is64l
? sizeof(Elf64_Ehdr
) : sizeof(Elf32_Ehdr
);
388 while (hdr
!= e_ident_local
&& off
< hdr_size
) {
389 size_t br
= read(fd
, hdr
+ off
, hdr_size
- off
);
392 error_setg(errp
, "File too short: %s", filename
);
395 error_setg_errno(errp
, errno
, "Failed to read file: %s",
406 /* return < 0 if error, otherwise the number of bytes loaded in memory */
407 ssize_t
load_elf(const char *filename
,
408 uint64_t (*elf_note_fn
)(void *, void *, bool),
409 uint64_t (*translate_fn
)(void *, uint64_t),
410 void *translate_opaque
, uint64_t *pentry
, uint64_t *lowaddr
,
411 uint64_t *highaddr
, uint32_t *pflags
, int big_endian
,
412 int elf_machine
, int clear_lsb
, int data_swab
)
414 return load_elf_as(filename
, elf_note_fn
, translate_fn
, translate_opaque
,
415 pentry
, lowaddr
, highaddr
, pflags
, big_endian
,
416 elf_machine
, clear_lsb
, data_swab
, NULL
);
419 /* return < 0 if error, otherwise the number of bytes loaded in memory */
420 ssize_t
load_elf_as(const char *filename
,
421 uint64_t (*elf_note_fn
)(void *, void *, bool),
422 uint64_t (*translate_fn
)(void *, uint64_t),
423 void *translate_opaque
, uint64_t *pentry
, uint64_t *lowaddr
,
424 uint64_t *highaddr
, uint32_t *pflags
, int big_endian
,
425 int elf_machine
, int clear_lsb
, int data_swab
,
428 return load_elf_ram(filename
, elf_note_fn
, translate_fn
, translate_opaque
,
429 pentry
, lowaddr
, highaddr
, pflags
, big_endian
,
430 elf_machine
, clear_lsb
, data_swab
, as
, true);
433 /* return < 0 if error, otherwise the number of bytes loaded in memory */
434 ssize_t
load_elf_ram(const char *filename
,
435 uint64_t (*elf_note_fn
)(void *, void *, bool),
436 uint64_t (*translate_fn
)(void *, uint64_t),
437 void *translate_opaque
, uint64_t *pentry
,
438 uint64_t *lowaddr
, uint64_t *highaddr
, uint32_t *pflags
,
439 int big_endian
, int elf_machine
, int clear_lsb
,
440 int data_swab
, AddressSpace
*as
, bool load_rom
)
442 return load_elf_ram_sym(filename
, elf_note_fn
,
443 translate_fn
, translate_opaque
,
444 pentry
, lowaddr
, highaddr
, pflags
, big_endian
,
445 elf_machine
, clear_lsb
, data_swab
, as
,
449 /* return < 0 if error, otherwise the number of bytes loaded in memory */
450 ssize_t
load_elf_ram_sym(const char *filename
,
451 uint64_t (*elf_note_fn
)(void *, void *, bool),
452 uint64_t (*translate_fn
)(void *, uint64_t),
453 void *translate_opaque
, uint64_t *pentry
,
454 uint64_t *lowaddr
, uint64_t *highaddr
,
455 uint32_t *pflags
, int big_endian
, int elf_machine
,
456 int clear_lsb
, int data_swab
,
457 AddressSpace
*as
, bool load_rom
, symbol_fn_t sym_cb
)
459 int fd
, data_order
, target_data_order
, must_swab
;
460 ssize_t ret
= ELF_LOAD_FAILED
;
461 uint8_t e_ident
[EI_NIDENT
];
463 fd
= open(filename
, O_RDONLY
| O_BINARY
);
468 if (read(fd
, e_ident
, sizeof(e_ident
)) != sizeof(e_ident
))
470 if (e_ident
[0] != ELFMAG0
||
471 e_ident
[1] != ELFMAG1
||
472 e_ident
[2] != ELFMAG2
||
473 e_ident
[3] != ELFMAG3
) {
474 ret
= ELF_LOAD_NOT_ELF
;
477 #ifdef HOST_WORDS_BIGENDIAN
478 data_order
= ELFDATA2MSB
;
480 data_order
= ELFDATA2LSB
;
482 must_swab
= data_order
!= e_ident
[EI_DATA
];
484 target_data_order
= ELFDATA2MSB
;
486 target_data_order
= ELFDATA2LSB
;
489 if (target_data_order
!= e_ident
[EI_DATA
]) {
490 ret
= ELF_LOAD_WRONG_ENDIAN
;
494 lseek(fd
, 0, SEEK_SET
);
495 if (e_ident
[EI_CLASS
] == ELFCLASS64
) {
496 ret
= load_elf64(filename
, fd
, elf_note_fn
,
497 translate_fn
, translate_opaque
, must_swab
,
498 pentry
, lowaddr
, highaddr
, pflags
, elf_machine
,
499 clear_lsb
, data_swab
, as
, load_rom
, sym_cb
);
501 ret
= load_elf32(filename
, fd
, elf_note_fn
,
502 translate_fn
, translate_opaque
, must_swab
,
503 pentry
, lowaddr
, highaddr
, pflags
, elf_machine
,
504 clear_lsb
, data_swab
, as
, load_rom
, sym_cb
);
512 static void bswap_uboot_header(uboot_image_header_t
*hdr
)
514 #ifndef HOST_WORDS_BIGENDIAN
515 bswap32s(&hdr
->ih_magic
);
516 bswap32s(&hdr
->ih_hcrc
);
517 bswap32s(&hdr
->ih_time
);
518 bswap32s(&hdr
->ih_size
);
519 bswap32s(&hdr
->ih_load
);
520 bswap32s(&hdr
->ih_ep
);
521 bswap32s(&hdr
->ih_dcrc
);
526 #define ZALLOC_ALIGNMENT 16
528 static void *zalloc(void *x
, unsigned items
, unsigned size
)
533 size
= (size
+ ZALLOC_ALIGNMENT
- 1) & ~(ZALLOC_ALIGNMENT
- 1);
540 static void zfree(void *x
, void *addr
)
547 #define EXTRA_FIELD 4
550 #define RESERVED 0xe0
554 ssize_t
gunzip(void *dst
, size_t dstlen
, uint8_t *src
, size_t srclen
)
566 if (src
[2] != DEFLATED
|| (flags
& RESERVED
) != 0) {
567 puts ("Error: Bad gzipped data\n");
570 if ((flags
& EXTRA_FIELD
) != 0) {
574 i
= 12 + src
[10] + (src
[11] << 8);
576 if ((flags
& ORIG_NAME
) != 0) {
577 while (i
< srclen
&& src
[i
++] != 0) {
581 if ((flags
& COMMENT
) != 0) {
582 while (i
< srclen
&& src
[i
++] != 0) {
586 if ((flags
& HEAD_CRC
) != 0) {
596 r
= inflateInit2(&s
, -MAX_WBITS
);
598 printf ("Error: inflateInit2() returned %d\n", r
);
602 s
.avail_in
= srclen
- i
;
604 s
.avail_out
= dstlen
;
605 r
= inflate(&s
, Z_FINISH
);
606 if (r
!= Z_OK
&& r
!= Z_STREAM_END
) {
607 printf ("Error: inflate() returned %d\n", r
);
610 dstbytes
= s
.next_out
- (unsigned char *) dst
;
616 puts("Error: gunzip out of data in header\n");
620 /* Load a U-Boot image. */
621 static int load_uboot_image(const char *filename
, hwaddr
*ep
, hwaddr
*loadaddr
,
622 int *is_linux
, uint8_t image_type
,
623 uint64_t (*translate_fn
)(void *, uint64_t),
624 void *translate_opaque
, AddressSpace
*as
)
629 uboot_image_header_t h
;
630 uboot_image_header_t
*hdr
= &h
;
631 uint8_t *data
= NULL
;
633 int do_uncompress
= 0;
635 fd
= open(filename
, O_RDONLY
| O_BINARY
);
639 size
= read(fd
, hdr
, sizeof(uboot_image_header_t
));
640 if (size
< sizeof(uboot_image_header_t
)) {
644 bswap_uboot_header(hdr
);
646 if (hdr
->ih_magic
!= IH_MAGIC
)
649 if (hdr
->ih_type
!= image_type
) {
650 if (!(image_type
== IH_TYPE_KERNEL
&&
651 hdr
->ih_type
== IH_TYPE_KERNEL_NOLOAD
)) {
652 fprintf(stderr
, "Wrong image type %d, expected %d\n", hdr
->ih_type
,
658 /* TODO: Implement other image types. */
659 switch (hdr
->ih_type
) {
660 case IH_TYPE_KERNEL_NOLOAD
:
661 if (!loadaddr
|| *loadaddr
== LOAD_UIMAGE_LOADADDR_INVALID
) {
662 fprintf(stderr
, "this image format (kernel_noload) cannot be "
663 "loaded on this machine type");
667 hdr
->ih_load
= *loadaddr
+ sizeof(*hdr
);
668 hdr
->ih_ep
+= hdr
->ih_load
;
671 address
= hdr
->ih_load
;
673 address
= translate_fn(translate_opaque
, address
);
676 *loadaddr
= hdr
->ih_load
;
679 switch (hdr
->ih_comp
) {
687 "Unable to load u-boot images with compression type %d\n",
696 /* TODO: Check CPU type. */
698 if (hdr
->ih_os
== IH_OS_LINUX
) {
706 case IH_TYPE_RAMDISK
:
710 fprintf(stderr
, "Unsupported u-boot image type %d\n", hdr
->ih_type
);
714 data
= g_malloc(hdr
->ih_size
);
716 if (read(fd
, data
, hdr
->ih_size
) != hdr
->ih_size
) {
717 fprintf(stderr
, "Error reading file\n");
722 uint8_t *compressed_data
;
726 compressed_data
= data
;
727 max_bytes
= UBOOT_MAX_GUNZIP_BYTES
;
728 data
= g_malloc(max_bytes
);
730 bytes
= gunzip(data
, max_bytes
, compressed_data
, hdr
->ih_size
);
731 g_free(compressed_data
);
733 fprintf(stderr
, "Unable to decompress gzipped image!\n");
736 hdr
->ih_size
= bytes
;
739 rom_add_blob_fixed_as(filename
, data
, hdr
->ih_size
, address
, as
);
749 int load_uimage(const char *filename
, hwaddr
*ep
, hwaddr
*loadaddr
,
751 uint64_t (*translate_fn
)(void *, uint64_t),
752 void *translate_opaque
)
754 return load_uboot_image(filename
, ep
, loadaddr
, is_linux
, IH_TYPE_KERNEL
,
755 translate_fn
, translate_opaque
, NULL
);
758 int load_uimage_as(const char *filename
, hwaddr
*ep
, hwaddr
*loadaddr
,
760 uint64_t (*translate_fn
)(void *, uint64_t),
761 void *translate_opaque
, AddressSpace
*as
)
763 return load_uboot_image(filename
, ep
, loadaddr
, is_linux
, IH_TYPE_KERNEL
,
764 translate_fn
, translate_opaque
, as
);
767 /* Load a ramdisk. */
768 int load_ramdisk(const char *filename
, hwaddr addr
, uint64_t max_sz
)
770 return load_ramdisk_as(filename
, addr
, max_sz
, NULL
);
773 int load_ramdisk_as(const char *filename
, hwaddr addr
, uint64_t max_sz
,
776 return load_uboot_image(filename
, NULL
, &addr
, NULL
, IH_TYPE_RAMDISK
,
780 /* Load a gzip-compressed kernel to a dynamically allocated buffer. */
781 int load_image_gzipped_buffer(const char *filename
, uint64_t max_sz
,
784 uint8_t *compressed_data
= NULL
;
785 uint8_t *data
= NULL
;
790 if (!g_file_get_contents(filename
, (char **) &compressed_data
, &len
,
795 /* Is it a gzip-compressed file? */
797 compressed_data
[0] != 0x1f ||
798 compressed_data
[1] != 0x8b) {
802 if (max_sz
> LOAD_IMAGE_MAX_GUNZIP_BYTES
) {
803 max_sz
= LOAD_IMAGE_MAX_GUNZIP_BYTES
;
806 data
= g_malloc(max_sz
);
807 bytes
= gunzip(data
, max_sz
, compressed_data
, len
);
809 fprintf(stderr
, "%s: unable to decompress gzipped kernel file\n",
814 /* trim to actual size and return to caller */
815 *buffer
= g_realloc(data
, bytes
);
817 /* ownership has been transferred to caller */
821 g_free(compressed_data
);
826 /* Load a gzip-compressed kernel. */
827 int load_image_gzipped(const char *filename
, hwaddr addr
, uint64_t max_sz
)
832 bytes
= load_image_gzipped_buffer(filename
, max_sz
, &data
);
834 rom_add_blob_fixed(filename
, data
, bytes
, addr
);
841 * Functions for reboot-persistent memory regions.
842 * - used for vga bios and option roms.
843 * - also linux kernel (-kernel / -initrd).
846 typedef struct Rom Rom
;
852 /* datasize is the amount of memory allocated in "data". If datasize is less
853 * than romsize, it means that the area from datasize to romsize is filled
865 GMappedFile
*mapped_file
;
870 QTAILQ_ENTRY(Rom
) next
;
873 static FWCfgState
*fw_cfg
;
874 static QTAILQ_HEAD(, Rom
) roms
= QTAILQ_HEAD_INITIALIZER(roms
);
877 * rom->data can be heap-allocated or memory-mapped (e.g. when added with
878 * rom_add_elf_program())
880 static void rom_free_data(Rom
*rom
)
882 if (rom
->mapped_file
) {
883 g_mapped_file_unref(rom
->mapped_file
);
884 rom
->mapped_file
= NULL
;
892 static void rom_free(Rom
*rom
)
898 g_free(rom
->fw_file
);
902 static inline bool rom_order_compare(Rom
*rom
, Rom
*item
)
904 return ((uintptr_t)(void *)rom
->as
> (uintptr_t)(void *)item
->as
) ||
905 (rom
->as
== item
->as
&& rom
->addr
>= item
->addr
);
908 static void rom_insert(Rom
*rom
)
913 hw_error ("ROM images must be loaded at startup\n");
916 /* The user didn't specify an address space, this is the default */
918 rom
->as
= &address_space_memory
;
921 rom
->committed
= false;
923 /* List is ordered by load address in the same address space */
924 QTAILQ_FOREACH(item
, &roms
, next
) {
925 if (rom_order_compare(rom
, item
)) {
928 QTAILQ_INSERT_BEFORE(item
, rom
, next
);
931 QTAILQ_INSERT_TAIL(&roms
, rom
, next
);
934 static void fw_cfg_resized(const char *id
, uint64_t length
, void *host
)
937 fw_cfg_modify_file(fw_cfg
, id
+ strlen("/rom@"), host
, length
);
941 static void *rom_set_mr(Rom
*rom
, Object
*owner
, const char *name
, bool ro
)
945 rom
->mr
= g_malloc(sizeof(*rom
->mr
));
946 memory_region_init_resizeable_ram(rom
->mr
, owner
, name
,
947 rom
->datasize
, rom
->romsize
,
950 memory_region_set_readonly(rom
->mr
, ro
);
951 vmstate_register_ram_global(rom
->mr
);
953 data
= memory_region_get_ram_ptr(rom
->mr
);
954 memcpy(data
, rom
->data
, rom
->datasize
);
959 int rom_add_file(const char *file
, const char *fw_dir
,
960 hwaddr addr
, int32_t bootindex
,
961 bool option_rom
, MemoryRegion
*mr
,
964 MachineClass
*mc
= MACHINE_GET_CLASS(qdev_get_machine());
970 fprintf(stderr
, "Specifying an Address Space and Memory Region is " \
971 "not valid when loading a rom\n");
972 /* We haven't allocated anything so we don't need any cleanup */
976 rom
= g_malloc0(sizeof(*rom
));
977 rom
->name
= g_strdup(file
);
978 rom
->path
= qemu_find_file(QEMU_FILE_TYPE_BIOS
, rom
->name
);
980 if (rom
->path
== NULL
) {
981 rom
->path
= g_strdup(file
);
984 fd
= open(rom
->path
, O_RDONLY
| O_BINARY
);
986 fprintf(stderr
, "Could not open option rom '%s': %s\n",
987 rom
->path
, strerror(errno
));
992 rom
->fw_dir
= g_strdup(fw_dir
);
993 rom
->fw_file
= g_strdup(file
);
996 rom
->romsize
= lseek(fd
, 0, SEEK_END
);
997 if (rom
->romsize
== -1) {
998 fprintf(stderr
, "rom: file %-20s: get size error: %s\n",
999 rom
->name
, strerror(errno
));
1003 rom
->datasize
= rom
->romsize
;
1004 rom
->data
= g_malloc0(rom
->datasize
);
1005 lseek(fd
, 0, SEEK_SET
);
1006 rc
= read(fd
, rom
->data
, rom
->datasize
);
1007 if (rc
!= rom
->datasize
) {
1008 fprintf(stderr
, "rom: file %-20s: read error: rc=%d (expected %zd)\n",
1009 rom
->name
, rc
, rom
->datasize
);
1014 if (rom
->fw_file
&& fw_cfg
) {
1015 const char *basename
;
1016 char fw_file_name
[FW_CFG_MAX_FILE_PATH
];
1019 basename
= strrchr(rom
->fw_file
, '/');
1023 basename
= rom
->fw_file
;
1025 snprintf(fw_file_name
, sizeof(fw_file_name
), "%s/%s", rom
->fw_dir
,
1027 snprintf(devpath
, sizeof(devpath
), "/rom@%s", fw_file_name
);
1029 if ((!option_rom
|| mc
->option_rom_has_mr
) && mc
->rom_file_has_mr
) {
1030 data
= rom_set_mr(rom
, OBJECT(fw_cfg
), devpath
, true);
1035 fw_cfg_add_file(fw_cfg
, fw_file_name
, data
, rom
->romsize
);
1039 snprintf(devpath
, sizeof(devpath
), "/rom@%s", file
);
1041 snprintf(devpath
, sizeof(devpath
), "/rom@" TARGET_FMT_plx
, addr
);
1045 add_boot_device_path(bootindex
, NULL
, devpath
);
1056 MemoryRegion
*rom_add_blob(const char *name
, const void *blob
, size_t len
,
1057 size_t max_len
, hwaddr addr
, const char *fw_file_name
,
1058 FWCfgCallback fw_callback
, void *callback_opaque
,
1059 AddressSpace
*as
, bool read_only
)
1061 MachineClass
*mc
= MACHINE_GET_CLASS(qdev_get_machine());
1063 MemoryRegion
*mr
= NULL
;
1065 rom
= g_malloc0(sizeof(*rom
));
1066 rom
->name
= g_strdup(name
);
1069 rom
->romsize
= max_len
? max_len
: len
;
1070 rom
->datasize
= len
;
1071 g_assert(rom
->romsize
>= rom
->datasize
);
1072 rom
->data
= g_malloc0(rom
->datasize
);
1073 memcpy(rom
->data
, blob
, len
);
1075 if (fw_file_name
&& fw_cfg
) {
1080 snprintf(devpath
, sizeof(devpath
), "/rom@%s", fw_file_name
);
1082 snprintf(devpath
, sizeof(devpath
), "/ram@%s", fw_file_name
);
1085 if (mc
->rom_file_has_mr
) {
1086 data
= rom_set_mr(rom
, OBJECT(fw_cfg
), devpath
, read_only
);
1092 fw_cfg_add_file_callback(fw_cfg
, fw_file_name
,
1093 fw_callback
, NULL
, callback_opaque
,
1094 data
, rom
->datasize
, read_only
);
1099 /* This function is specific for elf program because we don't need to allocate
1100 * all the rom. We just allocate the first part and the rest is just zeros. This
1101 * is why romsize and datasize are different. Also, this function takes its own
1102 * reference to "mapped_file", so we don't have to allocate and copy the buffer.
1104 int rom_add_elf_program(const char *name
, GMappedFile
*mapped_file
, void *data
,
1105 size_t datasize
, size_t romsize
, hwaddr addr
,
1110 rom
= g_malloc0(sizeof(*rom
));
1111 rom
->name
= g_strdup(name
);
1113 rom
->datasize
= datasize
;
1114 rom
->romsize
= romsize
;
1118 if (mapped_file
&& data
) {
1119 g_mapped_file_ref(mapped_file
);
1120 rom
->mapped_file
= mapped_file
;
1127 int rom_add_vga(const char *file
)
1129 return rom_add_file(file
, "vgaroms", 0, -1, true, NULL
, NULL
);
1132 int rom_add_option(const char *file
, int32_t bootindex
)
1134 return rom_add_file(file
, "genroms", 0, bootindex
, true, NULL
, NULL
);
1137 static void rom_reset(void *unused
)
1141 QTAILQ_FOREACH(rom
, &roms
, next
) {
1146 * We don't need to fill in the RAM with ROM data because we'll fill
1147 * the data in during the next incoming migration in all cases. Note
1148 * that some of those RAMs can actually be modified by the guest.
1150 if (runstate_check(RUN_STATE_INMIGRATE
)) {
1151 if (rom
->data
&& rom
->isrom
) {
1153 * Free it so that a rom_reset after migration doesn't
1154 * overwrite a potentially modified 'rom'.
1161 if (rom
->data
== NULL
) {
1165 void *host
= memory_region_get_ram_ptr(rom
->mr
);
1166 memcpy(host
, rom
->data
, rom
->datasize
);
1168 address_space_write_rom(rom
->as
, rom
->addr
, MEMTXATTRS_UNSPECIFIED
,
1169 rom
->data
, rom
->datasize
);
1172 /* rom needs to be written only once */
1176 * The rom loader is really on the same level as firmware in the guest
1177 * shadowing a ROM into RAM. Such a shadowing mechanism needs to ensure
1178 * that the instruction cache for that new region is clear, so that the
1179 * CPU definitely fetches its instructions from the just written data.
1181 cpu_flush_icache_range(rom
->addr
, rom
->datasize
);
1183 trace_loader_write_rom(rom
->name
, rom
->addr
, rom
->datasize
, rom
->isrom
);
1187 /* Return true if two consecutive ROMs in the ROM list overlap */
1188 static bool roms_overlap(Rom
*last_rom
, Rom
*this_rom
)
1193 return last_rom
->as
== this_rom
->as
&&
1194 last_rom
->addr
+ last_rom
->romsize
> this_rom
->addr
;
1197 static const char *rom_as_name(Rom
*rom
)
1199 const char *name
= rom
->as
? rom
->as
->name
: NULL
;
1200 return name
?: "anonymous";
1203 static void rom_print_overlap_error_header(void)
1205 error_report("Some ROM regions are overlapping");
1207 "These ROM regions might have been loaded by "
1208 "direct user request or by default.\n"
1209 "They could be BIOS/firmware images, a guest kernel, "
1210 "initrd or some other file loaded into guest memory.\n"
1211 "Check whether you intended to load all this guest code, and "
1212 "whether it has been built to load to the correct addresses.\n");
1215 static void rom_print_one_overlap_error(Rom
*last_rom
, Rom
*rom
)
1218 "\nThe following two regions overlap (in the %s address space):\n",
1221 " %s (addresses 0x" TARGET_FMT_plx
" - 0x" TARGET_FMT_plx
")\n",
1222 last_rom
->name
, last_rom
->addr
, last_rom
->addr
+ last_rom
->romsize
);
1224 " %s (addresses 0x" TARGET_FMT_plx
" - 0x" TARGET_FMT_plx
")\n",
1225 rom
->name
, rom
->addr
, rom
->addr
+ rom
->romsize
);
1228 int rom_check_and_register_reset(void)
1230 MemoryRegionSection section
;
1231 Rom
*rom
, *last_rom
= NULL
;
1232 bool found_overlap
= false;
1234 QTAILQ_FOREACH(rom
, &roms
, next
) {
1239 if (roms_overlap(last_rom
, rom
)) {
1240 if (!found_overlap
) {
1241 found_overlap
= true;
1242 rom_print_overlap_error_header();
1244 rom_print_one_overlap_error(last_rom
, rom
);
1245 /* Keep going through the list so we report all overlaps */
1249 section
= memory_region_find(rom
->mr
? rom
->mr
: get_system_memory(),
1251 rom
->isrom
= int128_nz(section
.size
) && memory_region_is_rom(section
.mr
);
1252 memory_region_unref(section
.mr
);
1254 if (found_overlap
) {
1258 qemu_register_reset(rom_reset
, NULL
);
1263 void rom_set_fw(FWCfgState
*f
)
1268 void rom_set_order_override(int order
)
1272 fw_cfg_set_order_override(fw_cfg
, order
);
1275 void rom_reset_order_override(void)
1279 fw_cfg_reset_order_override(fw_cfg
);
1282 void rom_transaction_begin(void)
1286 /* Ignore ROMs added without the transaction API */
1287 QTAILQ_FOREACH(rom
, &roms
, next
) {
1288 rom
->committed
= true;
1292 void rom_transaction_end(bool commit
)
1297 QTAILQ_FOREACH_SAFE(rom
, &roms
, next
, tmp
) {
1298 if (rom
->committed
) {
1302 rom
->committed
= true;
1304 QTAILQ_REMOVE(&roms
, rom
, next
);
1310 static Rom
*find_rom(hwaddr addr
, size_t size
)
1314 QTAILQ_FOREACH(rom
, &roms
, next
) {
1321 if (rom
->addr
> addr
) {
1324 if (rom
->addr
+ rom
->romsize
< addr
+ size
) {
1333 * Copies memory from registered ROMs to dest. Any memory that is contained in
1334 * a ROM between addr and addr + size is copied. Note that this can involve
1335 * multiple ROMs, which need not start at addr and need not end at addr + size.
1337 int rom_copy(uint8_t *dest
, hwaddr addr
, size_t size
)
1339 hwaddr end
= addr
+ size
;
1340 uint8_t *s
, *d
= dest
;
1344 QTAILQ_FOREACH(rom
, &roms
, next
) {
1351 if (rom
->addr
+ rom
->romsize
< addr
) {
1354 if (rom
->addr
> end
|| rom
->addr
< addr
) {
1358 d
= dest
+ (rom
->addr
- addr
);
1362 if ((d
+ l
) > (dest
+ size
)) {
1370 if (rom
->romsize
> rom
->datasize
) {
1371 /* If datasize is less than romsize, it means that we didn't
1372 * allocate all the ROM because the trailing data are only zeros.
1376 l
= rom
->romsize
- rom
->datasize
;
1378 if ((d
+ l
) > (dest
+ size
)) {
1379 /* Rom size doesn't fit in the destination area. Adjust to avoid
1391 return (d
+ l
) - dest
;
1394 void *rom_ptr(hwaddr addr
, size_t size
)
1398 rom
= find_rom(addr
, size
);
1399 if (!rom
|| !rom
->data
)
1401 return rom
->data
+ (addr
- rom
->addr
);
1404 typedef struct FindRomCBData
{
1405 size_t size
; /* Amount of data we want from ROM, in bytes */
1406 MemoryRegion
*mr
; /* MR at the unaliased guest addr */
1407 hwaddr xlat
; /* Offset of addr within mr */
1408 void *rom
; /* Output: rom data pointer, if found */
1411 static bool find_rom_cb(Int128 start
, Int128 len
, const MemoryRegion
*mr
,
1412 hwaddr offset_in_region
, void *opaque
)
1414 FindRomCBData
*cbdata
= opaque
;
1417 if (mr
!= cbdata
->mr
) {
1421 alias_addr
= int128_get64(start
) + cbdata
->xlat
- offset_in_region
;
1422 cbdata
->rom
= rom_ptr(alias_addr
, cbdata
->size
);
1426 /* Found a match, stop iterating */
1430 void *rom_ptr_for_as(AddressSpace
*as
, hwaddr addr
, size_t size
)
1433 * Find any ROM data for the given guest address range. If there
1434 * is a ROM blob then return a pointer to the host memory
1435 * corresponding to 'addr'; otherwise return NULL.
1437 * We look not only for ROM blobs that were loaded directly to
1438 * addr, but also for ROM blobs that were loaded to aliases of
1439 * that memory at other addresses within the AddressSpace.
1441 * Note that we do not check @as against the 'as' member in the
1442 * 'struct Rom' returned by rom_ptr(). The Rom::as is the
1443 * AddressSpace which the rom blob should be written to, whereas
1444 * our @as argument is the AddressSpace which we are (effectively)
1445 * reading from, and the same underlying RAM will often be visible
1446 * in multiple AddressSpaces. (A common example is a ROM blob
1447 * written to the 'system' address space but then read back via a
1448 * CPU's cpu->as pointer.) This does mean we might potentially
1449 * return a false-positive match if a ROM blob was loaded into an
1450 * AS which is entirely separate and distinct from the one we're
1451 * querying, but this issue exists also for rom_ptr() and hasn't
1452 * caused any problems in practice.
1457 FindRomCBData cbdata
= {};
1459 /* Easy case: there's data at the actual address */
1460 rom
= rom_ptr(addr
, size
);
1465 RCU_READ_LOCK_GUARD();
1467 fv
= address_space_to_flatview(as
);
1468 cbdata
.mr
= flatview_translate(fv
, addr
, &cbdata
.xlat
, &len_unused
,
1469 false, MEMTXATTRS_UNSPECIFIED
);
1471 /* Nothing at this address, so there can't be any aliasing */
1475 flatview_for_each_range(fv
, find_rom_cb
, &cbdata
);
1479 HumanReadableText
*qmp_x_query_roms(Error
**errp
)
1482 g_autoptr(GString
) buf
= g_string_new("");
1484 QTAILQ_FOREACH(rom
, &roms
, next
) {
1486 g_string_append_printf(buf
, "%s"
1487 " size=0x%06zx name=\"%s\"\n",
1488 memory_region_name(rom
->mr
),
1491 } else if (!rom
->fw_file
) {
1492 g_string_append_printf(buf
, "addr=" TARGET_FMT_plx
1493 " size=0x%06zx mem=%s name=\"%s\"\n",
1494 rom
->addr
, rom
->romsize
,
1495 rom
->isrom
? "rom" : "ram",
1498 g_string_append_printf(buf
, "fw=%s/%s"
1499 " size=0x%06zx name=\"%s\"\n",
1507 return human_readable_text_from_str(buf
);
1510 typedef enum HexRecord HexRecord
;
1514 EXT_SEG_ADDR_RECORD
,
1515 START_SEG_ADDR_RECORD
,
1516 EXT_LINEAR_ADDR_RECORD
,
1517 START_LINEAR_ADDR_RECORD
,
1520 /* Each record contains a 16-bit address which is combined with the upper 16
1521 * bits of the implicit "next address" to form a 32-bit address.
1523 #define NEXT_ADDR_MASK 0xffff0000
1525 #define DATA_FIELD_MAX_LEN 0xff
1526 #define LEN_EXCEPT_DATA 0x5
1527 /* 0x5 = sizeof(byte_count) + sizeof(address) + sizeof(record_type) +
1528 * sizeof(checksum) */
1532 uint8_t record_type
;
1533 uint8_t data
[DATA_FIELD_MAX_LEN
];
1537 /* return 0 or -1 if error */
1538 static bool parse_record(HexLine
*line
, uint8_t *our_checksum
, const uint8_t c
,
1539 uint32_t *index
, const bool in_process
)
1541 /* +-------+---------------+-------+---------------------+--------+
1542 * | byte | |record | | |
1543 * | count | address | type | data |checksum|
1544 * +-------+---------------+-------+---------------------+--------+
1546 * |1 byte | 2 bytes |1 byte | 0-255 bytes | 1 byte |
1549 uint32_t idx
= *index
;
1551 if (g_ascii_isspace(c
)) {
1554 if (!g_ascii_isxdigit(c
) || !in_process
) {
1557 value
= g_ascii_xdigit_value(c
);
1558 value
= (idx
& 0x1) ? (value
& 0xf) : (value
<< 4);
1560 line
->byte_count
|= value
;
1561 } else if (2 <= idx
&& idx
< 6) {
1562 line
->address
<<= 4;
1563 line
->address
+= g_ascii_xdigit_value(c
);
1564 } else if (6 <= idx
&& idx
< 8) {
1565 line
->record_type
|= value
;
1566 } else if (8 <= idx
&& idx
< 8 + 2 * line
->byte_count
) {
1567 line
->data
[(idx
- 8) >> 1] |= value
;
1568 } else if (8 + 2 * line
->byte_count
<= idx
&&
1569 idx
< 10 + 2 * line
->byte_count
) {
1570 line
->checksum
|= value
;
1574 *our_checksum
+= value
;
1580 const char *filename
;
1585 uint32_t next_address_to_write
;
1586 uint32_t current_address
;
1587 uint32_t current_rom_index
;
1588 uint32_t rom_start_address
;
1593 /* return size or -1 if error */
1594 static int handle_record_type(HexParser
*parser
)
1596 HexLine
*line
= &(parser
->line
);
1597 switch (line
->record_type
) {
1599 parser
->current_address
=
1600 (parser
->next_address_to_write
& NEXT_ADDR_MASK
) | line
->address
;
1601 /* verify this is a contiguous block of memory */
1602 if (parser
->current_address
!= parser
->next_address_to_write
) {
1603 if (parser
->current_rom_index
!= 0) {
1604 rom_add_blob_fixed_as(parser
->filename
, parser
->bin_buf
,
1605 parser
->current_rom_index
,
1606 parser
->rom_start_address
, parser
->as
);
1608 parser
->rom_start_address
= parser
->current_address
;
1609 parser
->current_rom_index
= 0;
1612 /* copy from line buffer to output bin_buf */
1613 memcpy(parser
->bin_buf
+ parser
->current_rom_index
, line
->data
,
1615 parser
->current_rom_index
+= line
->byte_count
;
1616 parser
->total_size
+= line
->byte_count
;
1617 /* save next address to write */
1618 parser
->next_address_to_write
=
1619 parser
->current_address
+ line
->byte_count
;
1623 if (parser
->current_rom_index
!= 0) {
1624 rom_add_blob_fixed_as(parser
->filename
, parser
->bin_buf
,
1625 parser
->current_rom_index
,
1626 parser
->rom_start_address
, parser
->as
);
1628 parser
->complete
= true;
1629 return parser
->total_size
;
1630 case EXT_SEG_ADDR_RECORD
:
1631 case EXT_LINEAR_ADDR_RECORD
:
1632 if (line
->byte_count
!= 2 && line
->address
!= 0) {
1636 if (parser
->current_rom_index
!= 0) {
1637 rom_add_blob_fixed_as(parser
->filename
, parser
->bin_buf
,
1638 parser
->current_rom_index
,
1639 parser
->rom_start_address
, parser
->as
);
1642 /* save next address to write,
1643 * in case of non-contiguous block of memory */
1644 parser
->next_address_to_write
= (line
->data
[0] << 12) |
1645 (line
->data
[1] << 4);
1646 if (line
->record_type
== EXT_LINEAR_ADDR_RECORD
) {
1647 parser
->next_address_to_write
<<= 12;
1650 parser
->rom_start_address
= parser
->next_address_to_write
;
1651 parser
->current_rom_index
= 0;
1654 case START_SEG_ADDR_RECORD
:
1655 if (line
->byte_count
!= 4 && line
->address
!= 0) {
1659 /* x86 16-bit CS:IP segmented addressing */
1660 *(parser
->start_addr
) = (((line
->data
[0] << 8) | line
->data
[1]) << 4) +
1661 ((line
->data
[2] << 8) | line
->data
[3]);
1664 case START_LINEAR_ADDR_RECORD
:
1665 if (line
->byte_count
!= 4 && line
->address
!= 0) {
1669 *(parser
->start_addr
) = ldl_be_p(line
->data
);
1676 return parser
->total_size
;
1679 /* return size or -1 if error */
1680 static int parse_hex_blob(const char *filename
, hwaddr
*addr
, uint8_t *hex_blob
,
1681 size_t hex_blob_size
, AddressSpace
*as
)
1683 bool in_process
= false; /* avoid re-enter and
1684 * check whether record begin with ':' */
1685 uint8_t *end
= hex_blob
+ hex_blob_size
;
1686 uint8_t our_checksum
= 0;
1687 uint32_t record_index
= 0;
1688 HexParser parser
= {
1689 .filename
= filename
,
1690 .bin_buf
= g_malloc(hex_blob_size
),
1696 rom_transaction_begin();
1698 for (; hex_blob
< end
&& !parser
.complete
; ++hex_blob
) {
1699 switch (*hex_blob
) {
1707 if ((LEN_EXCEPT_DATA
+ parser
.line
.byte_count
) * 2 !=
1709 our_checksum
!= 0) {
1710 parser
.total_size
= -1;
1714 if (handle_record_type(&parser
) == -1) {
1715 parser
.total_size
= -1;
1720 /* start of a new record. */
1722 memset(&parser
.line
, 0, sizeof(HexLine
));
1727 /* decoding lines */
1729 if (!parse_record(&parser
.line
, &our_checksum
, *hex_blob
,
1730 &record_index
, in_process
)) {
1731 parser
.total_size
= -1;
1739 g_free(parser
.bin_buf
);
1740 rom_transaction_end(parser
.total_size
!= -1);
1741 return parser
.total_size
;
1744 /* return size or -1 if error */
1745 int load_targphys_hex_as(const char *filename
, hwaddr
*entry
, AddressSpace
*as
)
1747 gsize hex_blob_size
;
1751 if (!g_file_get_contents(filename
, &hex_blob
, &hex_blob_size
, NULL
)) {
1755 total_size
= parse_hex_blob(filename
, entry
, (uint8_t *)hex_blob
,