xref: /openbmc/qemu/hw/core/loader.c (revision 0b1183e3)
1 /*
2  * QEMU Executable loader
3  *
4  * Copyright (c) 2006 Fabrice Bellard
5  *
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:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
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
22  * THE SOFTWARE.
23  *
24  * Gunzip functionality in this file is derived from u-boot:
25  *
26  * (C) Copyright 2008 Semihalf
27  *
28  * (C) Copyright 2000-2005
29  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
30  *
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.
35  *
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.
40  *
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/>.
43  */
44 
45 #include "qemu/osdep.h"
46 #include "qapi/error.h"
47 #include "hw/hw.h"
48 #include "disas/disas.h"
49 #include "monitor/monitor.h"
50 #include "sysemu/sysemu.h"
51 #include "uboot_image.h"
52 #include "hw/loader.h"
53 #include "hw/nvram/fw_cfg.h"
54 #include "exec/memory.h"
55 #include "exec/address-spaces.h"
56 #include "hw/boards.h"
57 #include "qemu/cutils.h"
58 
59 #include <zlib.h>
60 
61 static int roms_loaded;
62 
63 /* return the size or -1 if error */
64 int get_image_size(const char *filename)
65 {
66     int fd, size;
67     fd = open(filename, O_RDONLY | O_BINARY);
68     if (fd < 0)
69         return -1;
70     size = lseek(fd, 0, SEEK_END);
71     close(fd);
72     return size;
73 }
74 
75 /* return the size or -1 if error */
76 /* deprecated, because caller does not specify buffer size! */
77 int load_image(const char *filename, uint8_t *addr)
78 {
79     int fd, size;
80     fd = open(filename, O_RDONLY | O_BINARY);
81     if (fd < 0)
82         return -1;
83     size = lseek(fd, 0, SEEK_END);
84     if (size == -1) {
85         fprintf(stderr, "file %-20s: get size error: %s\n",
86                 filename, strerror(errno));
87         close(fd);
88         return -1;
89     }
90 
91     lseek(fd, 0, SEEK_SET);
92     if (read(fd, addr, size) != size) {
93         close(fd);
94         return -1;
95     }
96     close(fd);
97     return size;
98 }
99 
100 /* return the size or -1 if error */
101 ssize_t load_image_size(const char *filename, void *addr, size_t size)
102 {
103     int fd;
104     ssize_t actsize;
105 
106     fd = open(filename, O_RDONLY | O_BINARY);
107     if (fd < 0) {
108         return -1;
109     }
110 
111     actsize = read(fd, addr, size);
112     if (actsize < 0) {
113         close(fd);
114         return -1;
115     }
116     close(fd);
117 
118     return actsize;
119 }
120 
121 /* read()-like version */
122 ssize_t read_targphys(const char *name,
123                       int fd, hwaddr dst_addr, size_t nbytes)
124 {
125     uint8_t *buf;
126     ssize_t did;
127 
128     buf = g_malloc(nbytes);
129     did = read(fd, buf, nbytes);
130     if (did > 0)
131         rom_add_blob_fixed("read", buf, did, dst_addr);
132     g_free(buf);
133     return did;
134 }
135 
136 int load_image_targphys(const char *filename,
137                         hwaddr addr, uint64_t max_sz)
138 {
139     return load_image_targphys_as(filename, addr, max_sz, NULL);
140 }
141 
142 /* return the size or -1 if error */
143 int load_image_targphys_as(const char *filename,
144                            hwaddr addr, uint64_t max_sz, AddressSpace *as)
145 {
146     int size;
147 
148     size = get_image_size(filename);
149     if (size > max_sz) {
150         return -1;
151     }
152     if (size > 0) {
153         if (rom_add_file_fixed_as(filename, addr, -1, as) < 0) {
154             return -1;
155         }
156     }
157     return size;
158 }
159 
160 int load_image_mr(const char *filename, MemoryRegion *mr)
161 {
162     int size;
163 
164     if (!memory_access_is_direct(mr, false)) {
165         /* Can only load an image into RAM or ROM */
166         return -1;
167     }
168 
169     size = get_image_size(filename);
170 
171     if (size > memory_region_size(mr)) {
172         return -1;
173     }
174     if (size > 0) {
175         if (rom_add_file_mr(filename, mr, -1) < 0) {
176             return -1;
177         }
178     }
179     return size;
180 }
181 
182 void pstrcpy_targphys(const char *name, hwaddr dest, int buf_size,
183                       const char *source)
184 {
185     const char *nulp;
186     char *ptr;
187 
188     if (buf_size <= 0) return;
189     nulp = memchr(source, 0, buf_size);
190     if (nulp) {
191         rom_add_blob_fixed(name, source, (nulp - source) + 1, dest);
192     } else {
193         rom_add_blob_fixed(name, source, buf_size, dest);
194         ptr = rom_ptr(dest + buf_size - 1);
195         *ptr = 0;
196     }
197 }
198 
199 /* A.OUT loader */
200 
201 struct exec
202 {
203   uint32_t a_info;   /* Use macros N_MAGIC, etc for access */
204   uint32_t a_text;   /* length of text, in bytes */
205   uint32_t a_data;   /* length of data, in bytes */
206   uint32_t a_bss;    /* length of uninitialized data area, in bytes */
207   uint32_t a_syms;   /* length of symbol table data in file, in bytes */
208   uint32_t a_entry;  /* start address */
209   uint32_t a_trsize; /* length of relocation info for text, in bytes */
210   uint32_t a_drsize; /* length of relocation info for data, in bytes */
211 };
212 
213 static void bswap_ahdr(struct exec *e)
214 {
215     bswap32s(&e->a_info);
216     bswap32s(&e->a_text);
217     bswap32s(&e->a_data);
218     bswap32s(&e->a_bss);
219     bswap32s(&e->a_syms);
220     bswap32s(&e->a_entry);
221     bswap32s(&e->a_trsize);
222     bswap32s(&e->a_drsize);
223 }
224 
225 #define N_MAGIC(exec) ((exec).a_info & 0xffff)
226 #define OMAGIC 0407
227 #define NMAGIC 0410
228 #define ZMAGIC 0413
229 #define QMAGIC 0314
230 #define _N_HDROFF(x) (1024 - sizeof (struct exec))
231 #define N_TXTOFF(x)							\
232     (N_MAGIC(x) == ZMAGIC ? _N_HDROFF((x)) + sizeof (struct exec) :	\
233      (N_MAGIC(x) == QMAGIC ? 0 : sizeof (struct exec)))
234 #define N_TXTADDR(x, target_page_size) (N_MAGIC(x) == QMAGIC ? target_page_size : 0)
235 #define _N_SEGMENT_ROUND(x, target_page_size) (((x) + target_page_size - 1) & ~(target_page_size - 1))
236 
237 #define _N_TXTENDADDR(x, target_page_size) (N_TXTADDR(x, target_page_size)+(x).a_text)
238 
239 #define N_DATADDR(x, target_page_size) \
240     (N_MAGIC(x)==OMAGIC? (_N_TXTENDADDR(x, target_page_size)) \
241      : (_N_SEGMENT_ROUND (_N_TXTENDADDR(x, target_page_size), target_page_size)))
242 
243 
244 int load_aout(const char *filename, hwaddr addr, int max_sz,
245               int bswap_needed, hwaddr target_page_size)
246 {
247     int fd;
248     ssize_t size, ret;
249     struct exec e;
250     uint32_t magic;
251 
252     fd = open(filename, O_RDONLY | O_BINARY);
253     if (fd < 0)
254         return -1;
255 
256     size = read(fd, &e, sizeof(e));
257     if (size < 0)
258         goto fail;
259 
260     if (bswap_needed) {
261         bswap_ahdr(&e);
262     }
263 
264     magic = N_MAGIC(e);
265     switch (magic) {
266     case ZMAGIC:
267     case QMAGIC:
268     case OMAGIC:
269         if (e.a_text + e.a_data > max_sz)
270             goto fail;
271 	lseek(fd, N_TXTOFF(e), SEEK_SET);
272 	size = read_targphys(filename, fd, addr, e.a_text + e.a_data);
273 	if (size < 0)
274 	    goto fail;
275 	break;
276     case NMAGIC:
277         if (N_DATADDR(e, target_page_size) + e.a_data > max_sz)
278             goto fail;
279 	lseek(fd, N_TXTOFF(e), SEEK_SET);
280 	size = read_targphys(filename, fd, addr, e.a_text);
281 	if (size < 0)
282 	    goto fail;
283         ret = read_targphys(filename, fd, addr + N_DATADDR(e, target_page_size),
284                             e.a_data);
285 	if (ret < 0)
286 	    goto fail;
287 	size += ret;
288 	break;
289     default:
290 	goto fail;
291     }
292     close(fd);
293     return size;
294  fail:
295     close(fd);
296     return -1;
297 }
298 
299 /* ELF loader */
300 
301 static void *load_at(int fd, off_t offset, size_t size)
302 {
303     void *ptr;
304     if (lseek(fd, offset, SEEK_SET) < 0)
305         return NULL;
306     ptr = g_malloc(size);
307     if (read(fd, ptr, size) != size) {
308         g_free(ptr);
309         return NULL;
310     }
311     return ptr;
312 }
313 
314 #ifdef ELF_CLASS
315 #undef ELF_CLASS
316 #endif
317 
318 #define ELF_CLASS   ELFCLASS32
319 #include "elf.h"
320 
321 #define SZ		32
322 #define elf_word        uint32_t
323 #define elf_sword        int32_t
324 #define bswapSZs	bswap32s
325 #include "hw/elf_ops.h"
326 
327 #undef elfhdr
328 #undef elf_phdr
329 #undef elf_shdr
330 #undef elf_sym
331 #undef elf_rela
332 #undef elf_note
333 #undef elf_word
334 #undef elf_sword
335 #undef bswapSZs
336 #undef SZ
337 #define elfhdr		elf64_hdr
338 #define elf_phdr	elf64_phdr
339 #define elf_note	elf64_note
340 #define elf_shdr	elf64_shdr
341 #define elf_sym		elf64_sym
342 #define elf_rela        elf64_rela
343 #define elf_word        uint64_t
344 #define elf_sword        int64_t
345 #define bswapSZs	bswap64s
346 #define SZ		64
347 #include "hw/elf_ops.h"
348 
349 const char *load_elf_strerror(int error)
350 {
351     switch (error) {
352     case 0:
353         return "No error";
354     case ELF_LOAD_FAILED:
355         return "Failed to load ELF";
356     case ELF_LOAD_NOT_ELF:
357         return "The image is not ELF";
358     case ELF_LOAD_WRONG_ARCH:
359         return "The image is from incompatible architecture";
360     case ELF_LOAD_WRONG_ENDIAN:
361         return "The image has incorrect endianness";
362     default:
363         return "Unknown error";
364     }
365 }
366 
367 void load_elf_hdr(const char *filename, void *hdr, bool *is64, Error **errp)
368 {
369     int fd;
370     uint8_t e_ident_local[EI_NIDENT];
371     uint8_t *e_ident;
372     size_t hdr_size, off;
373     bool is64l;
374 
375     if (!hdr) {
376         hdr = e_ident_local;
377     }
378     e_ident = hdr;
379 
380     fd = open(filename, O_RDONLY | O_BINARY);
381     if (fd < 0) {
382         error_setg_errno(errp, errno, "Failed to open file: %s", filename);
383         return;
384     }
385     if (read(fd, hdr, EI_NIDENT) != EI_NIDENT) {
386         error_setg_errno(errp, errno, "Failed to read file: %s", filename);
387         goto fail;
388     }
389     if (e_ident[0] != ELFMAG0 ||
390         e_ident[1] != ELFMAG1 ||
391         e_ident[2] != ELFMAG2 ||
392         e_ident[3] != ELFMAG3) {
393         error_setg(errp, "Bad ELF magic");
394         goto fail;
395     }
396 
397     is64l = e_ident[EI_CLASS] == ELFCLASS64;
398     hdr_size = is64l ? sizeof(Elf64_Ehdr) : sizeof(Elf32_Ehdr);
399     if (is64) {
400         *is64 = is64l;
401     }
402 
403     off = EI_NIDENT;
404     while (hdr != e_ident_local && off < hdr_size) {
405         size_t br = read(fd, hdr + off, hdr_size - off);
406         switch (br) {
407         case 0:
408             error_setg(errp, "File too short: %s", filename);
409             goto fail;
410         case -1:
411             error_setg_errno(errp, errno, "Failed to read file: %s",
412                              filename);
413             goto fail;
414         }
415         off += br;
416     }
417 
418 fail:
419     close(fd);
420 }
421 
422 /* return < 0 if error, otherwise the number of bytes loaded in memory */
423 int load_elf(const char *filename, uint64_t (*translate_fn)(void *, uint64_t),
424              void *translate_opaque, uint64_t *pentry, uint64_t *lowaddr,
425              uint64_t *highaddr, int big_endian, int elf_machine,
426              int clear_lsb, int data_swab)
427 {
428     return load_elf_as(filename, translate_fn, translate_opaque, pentry,
429                        lowaddr, highaddr, big_endian, elf_machine, clear_lsb,
430                        data_swab, NULL);
431 }
432 
433 /* return < 0 if error, otherwise the number of bytes loaded in memory */
434 int load_elf_as(const char *filename,
435                 uint64_t (*translate_fn)(void *, uint64_t),
436                 void *translate_opaque, uint64_t *pentry, uint64_t *lowaddr,
437                 uint64_t *highaddr, int big_endian, int elf_machine,
438                 int clear_lsb, int data_swab, AddressSpace *as)
439 {
440     return load_elf_ram(filename, translate_fn, translate_opaque,
441                         pentry, lowaddr, highaddr, big_endian, elf_machine,
442                         clear_lsb, data_swab, as, true);
443 }
444 
445 /* return < 0 if error, otherwise the number of bytes loaded in memory */
446 int load_elf_ram(const char *filename,
447                  uint64_t (*translate_fn)(void *, uint64_t),
448                  void *translate_opaque, uint64_t *pentry, uint64_t *lowaddr,
449                  uint64_t *highaddr, int big_endian, int elf_machine,
450                  int clear_lsb, int data_swab, AddressSpace *as,
451                  bool load_rom)
452 {
453     int fd, data_order, target_data_order, must_swab, ret = ELF_LOAD_FAILED;
454     uint8_t e_ident[EI_NIDENT];
455 
456     fd = open(filename, O_RDONLY | O_BINARY);
457     if (fd < 0) {
458         perror(filename);
459         return -1;
460     }
461     if (read(fd, e_ident, sizeof(e_ident)) != sizeof(e_ident))
462         goto fail;
463     if (e_ident[0] != ELFMAG0 ||
464         e_ident[1] != ELFMAG1 ||
465         e_ident[2] != ELFMAG2 ||
466         e_ident[3] != ELFMAG3) {
467         ret = ELF_LOAD_NOT_ELF;
468         goto fail;
469     }
470 #ifdef HOST_WORDS_BIGENDIAN
471     data_order = ELFDATA2MSB;
472 #else
473     data_order = ELFDATA2LSB;
474 #endif
475     must_swab = data_order != e_ident[EI_DATA];
476     if (big_endian) {
477         target_data_order = ELFDATA2MSB;
478     } else {
479         target_data_order = ELFDATA2LSB;
480     }
481 
482     if (target_data_order != e_ident[EI_DATA]) {
483         fprintf(stderr, "%s: wrong endianness\n", filename);
484         ret = ELF_LOAD_WRONG_ENDIAN;
485         goto fail;
486     }
487 
488     lseek(fd, 0, SEEK_SET);
489     if (e_ident[EI_CLASS] == ELFCLASS64) {
490         ret = load_elf64(filename, fd, translate_fn, translate_opaque, must_swab,
491                          pentry, lowaddr, highaddr, elf_machine, clear_lsb,
492                          data_swab, as, load_rom);
493     } else {
494         ret = load_elf32(filename, fd, translate_fn, translate_opaque, must_swab,
495                          pentry, lowaddr, highaddr, elf_machine, clear_lsb,
496                          data_swab, as, load_rom);
497     }
498 
499  fail:
500     close(fd);
501     return ret;
502 }
503 
504 static void bswap_uboot_header(uboot_image_header_t *hdr)
505 {
506 #ifndef HOST_WORDS_BIGENDIAN
507     bswap32s(&hdr->ih_magic);
508     bswap32s(&hdr->ih_hcrc);
509     bswap32s(&hdr->ih_time);
510     bswap32s(&hdr->ih_size);
511     bswap32s(&hdr->ih_load);
512     bswap32s(&hdr->ih_ep);
513     bswap32s(&hdr->ih_dcrc);
514 #endif
515 }
516 
517 
518 #define ZALLOC_ALIGNMENT	16
519 
520 static void *zalloc(void *x, unsigned items, unsigned size)
521 {
522     void *p;
523 
524     size *= items;
525     size = (size + ZALLOC_ALIGNMENT - 1) & ~(ZALLOC_ALIGNMENT - 1);
526 
527     p = g_malloc(size);
528 
529     return (p);
530 }
531 
532 static void zfree(void *x, void *addr)
533 {
534     g_free(addr);
535 }
536 
537 
538 #define HEAD_CRC	2
539 #define EXTRA_FIELD	4
540 #define ORIG_NAME	8
541 #define COMMENT		0x10
542 #define RESERVED	0xe0
543 
544 #define DEFLATED	8
545 
546 ssize_t gunzip(void *dst, size_t dstlen, uint8_t *src, size_t srclen)
547 {
548     z_stream s;
549     ssize_t dstbytes;
550     int r, i, flags;
551 
552     /* skip header */
553     i = 10;
554     flags = src[3];
555     if (src[2] != DEFLATED || (flags & RESERVED) != 0) {
556         puts ("Error: Bad gzipped data\n");
557         return -1;
558     }
559     if ((flags & EXTRA_FIELD) != 0)
560         i = 12 + src[10] + (src[11] << 8);
561     if ((flags & ORIG_NAME) != 0)
562         while (src[i++] != 0)
563             ;
564     if ((flags & COMMENT) != 0)
565         while (src[i++] != 0)
566             ;
567     if ((flags & HEAD_CRC) != 0)
568         i += 2;
569     if (i >= srclen) {
570         puts ("Error: gunzip out of data in header\n");
571         return -1;
572     }
573 
574     s.zalloc = zalloc;
575     s.zfree = zfree;
576 
577     r = inflateInit2(&s, -MAX_WBITS);
578     if (r != Z_OK) {
579         printf ("Error: inflateInit2() returned %d\n", r);
580         return (-1);
581     }
582     s.next_in = src + i;
583     s.avail_in = srclen - i;
584     s.next_out = dst;
585     s.avail_out = dstlen;
586     r = inflate(&s, Z_FINISH);
587     if (r != Z_OK && r != Z_STREAM_END) {
588         printf ("Error: inflate() returned %d\n", r);
589         return -1;
590     }
591     dstbytes = s.next_out - (unsigned char *) dst;
592     inflateEnd(&s);
593 
594     return dstbytes;
595 }
596 
597 /* Load a U-Boot image.  */
598 static int load_uboot_image(const char *filename, hwaddr *ep, hwaddr *loadaddr,
599                             int *is_linux, uint8_t image_type,
600                             uint64_t (*translate_fn)(void *, uint64_t),
601                             void *translate_opaque, AddressSpace *as)
602 {
603     int fd;
604     int size;
605     hwaddr address;
606     uboot_image_header_t h;
607     uboot_image_header_t *hdr = &h;
608     uint8_t *data = NULL;
609     int ret = -1;
610     int do_uncompress = 0;
611 
612     fd = open(filename, O_RDONLY | O_BINARY);
613     if (fd < 0)
614         return -1;
615 
616     size = read(fd, hdr, sizeof(uboot_image_header_t));
617     if (size < sizeof(uboot_image_header_t)) {
618         goto out;
619     }
620 
621     bswap_uboot_header(hdr);
622 
623     if (hdr->ih_magic != IH_MAGIC)
624         goto out;
625 
626     if (hdr->ih_type != image_type) {
627         fprintf(stderr, "Wrong image type %d, expected %d\n", hdr->ih_type,
628                 image_type);
629         goto out;
630     }
631 
632     /* TODO: Implement other image types.  */
633     switch (hdr->ih_type) {
634     case IH_TYPE_KERNEL:
635         address = hdr->ih_load;
636         if (translate_fn) {
637             address = translate_fn(translate_opaque, address);
638         }
639         if (loadaddr) {
640             *loadaddr = hdr->ih_load;
641         }
642 
643         switch (hdr->ih_comp) {
644         case IH_COMP_NONE:
645             break;
646         case IH_COMP_GZIP:
647             do_uncompress = 1;
648             break;
649         default:
650             fprintf(stderr,
651                     "Unable to load u-boot images with compression type %d\n",
652                     hdr->ih_comp);
653             goto out;
654         }
655 
656         if (ep) {
657             *ep = hdr->ih_ep;
658         }
659 
660         /* TODO: Check CPU type.  */
661         if (is_linux) {
662             if (hdr->ih_os == IH_OS_LINUX) {
663                 *is_linux = 1;
664             } else {
665                 *is_linux = 0;
666             }
667         }
668 
669         break;
670     case IH_TYPE_RAMDISK:
671         address = *loadaddr;
672         break;
673     default:
674         fprintf(stderr, "Unsupported u-boot image type %d\n", hdr->ih_type);
675         goto out;
676     }
677 
678     data = g_malloc(hdr->ih_size);
679 
680     if (read(fd, data, hdr->ih_size) != hdr->ih_size) {
681         fprintf(stderr, "Error reading file\n");
682         goto out;
683     }
684 
685     if (do_uncompress) {
686         uint8_t *compressed_data;
687         size_t max_bytes;
688         ssize_t bytes;
689 
690         compressed_data = data;
691         max_bytes = UBOOT_MAX_GUNZIP_BYTES;
692         data = g_malloc(max_bytes);
693 
694         bytes = gunzip(data, max_bytes, compressed_data, hdr->ih_size);
695         g_free(compressed_data);
696         if (bytes < 0) {
697             fprintf(stderr, "Unable to decompress gzipped image!\n");
698             goto out;
699         }
700         hdr->ih_size = bytes;
701     }
702 
703     rom_add_blob_fixed_as(filename, data, hdr->ih_size, address, as);
704 
705     ret = hdr->ih_size;
706 
707 out:
708     g_free(data);
709     close(fd);
710     return ret;
711 }
712 
713 int load_uimage(const char *filename, hwaddr *ep, hwaddr *loadaddr,
714                 int *is_linux,
715                 uint64_t (*translate_fn)(void *, uint64_t),
716                 void *translate_opaque)
717 {
718     return load_uboot_image(filename, ep, loadaddr, is_linux, IH_TYPE_KERNEL,
719                             translate_fn, translate_opaque, NULL);
720 }
721 
722 int load_uimage_as(const char *filename, hwaddr *ep, hwaddr *loadaddr,
723                    int *is_linux,
724                    uint64_t (*translate_fn)(void *, uint64_t),
725                    void *translate_opaque, AddressSpace *as)
726 {
727     return load_uboot_image(filename, ep, loadaddr, is_linux, IH_TYPE_KERNEL,
728                             translate_fn, translate_opaque, as);
729 }
730 
731 /* Load a ramdisk.  */
732 int load_ramdisk(const char *filename, hwaddr addr, uint64_t max_sz)
733 {
734     return load_uboot_image(filename, NULL, &addr, NULL, IH_TYPE_RAMDISK,
735                             NULL, NULL, NULL);
736 }
737 
738 /* Load a gzip-compressed kernel to a dynamically allocated buffer. */
739 int load_image_gzipped_buffer(const char *filename, uint64_t max_sz,
740                               uint8_t **buffer)
741 {
742     uint8_t *compressed_data = NULL;
743     uint8_t *data = NULL;
744     gsize len;
745     ssize_t bytes;
746     int ret = -1;
747 
748     if (!g_file_get_contents(filename, (char **) &compressed_data, &len,
749                              NULL)) {
750         goto out;
751     }
752 
753     /* Is it a gzip-compressed file? */
754     if (len < 2 ||
755         compressed_data[0] != 0x1f ||
756         compressed_data[1] != 0x8b) {
757         goto out;
758     }
759 
760     if (max_sz > LOAD_IMAGE_MAX_GUNZIP_BYTES) {
761         max_sz = LOAD_IMAGE_MAX_GUNZIP_BYTES;
762     }
763 
764     data = g_malloc(max_sz);
765     bytes = gunzip(data, max_sz, compressed_data, len);
766     if (bytes < 0) {
767         fprintf(stderr, "%s: unable to decompress gzipped kernel file\n",
768                 filename);
769         goto out;
770     }
771 
772     /* trim to actual size and return to caller */
773     *buffer = g_realloc(data, bytes);
774     ret = bytes;
775     /* ownership has been transferred to caller */
776     data = NULL;
777 
778  out:
779     g_free(compressed_data);
780     g_free(data);
781     return ret;
782 }
783 
784 /* Load a gzip-compressed kernel. */
785 int load_image_gzipped(const char *filename, hwaddr addr, uint64_t max_sz)
786 {
787     int bytes;
788     uint8_t *data;
789 
790     bytes = load_image_gzipped_buffer(filename, max_sz, &data);
791     if (bytes != -1) {
792         rom_add_blob_fixed(filename, data, bytes, addr);
793         g_free(data);
794     }
795     return bytes;
796 }
797 
798 /*
799  * Functions for reboot-persistent memory regions.
800  *  - used for vga bios and option roms.
801  *  - also linux kernel (-kernel / -initrd).
802  */
803 
804 typedef struct Rom Rom;
805 
806 struct Rom {
807     char *name;
808     char *path;
809 
810     /* datasize is the amount of memory allocated in "data". If datasize is less
811      * than romsize, it means that the area from datasize to romsize is filled
812      * with zeros.
813      */
814     size_t romsize;
815     size_t datasize;
816 
817     uint8_t *data;
818     MemoryRegion *mr;
819     AddressSpace *as;
820     int isrom;
821     char *fw_dir;
822     char *fw_file;
823 
824     hwaddr addr;
825     QTAILQ_ENTRY(Rom) next;
826 };
827 
828 static FWCfgState *fw_cfg;
829 static QTAILQ_HEAD(, Rom) roms = QTAILQ_HEAD_INITIALIZER(roms);
830 
831 static inline bool rom_order_compare(Rom *rom, Rom *item)
832 {
833     return ((uintptr_t)(void *)rom->as > (uintptr_t)(void *)item->as) ||
834            (rom->as == item->as && rom->addr >= item->addr);
835 }
836 
837 static void rom_insert(Rom *rom)
838 {
839     Rom *item;
840 
841     if (roms_loaded) {
842         hw_error ("ROM images must be loaded at startup\n");
843     }
844 
845     /* The user didn't specify an address space, this is the default */
846     if (!rom->as) {
847         rom->as = &address_space_memory;
848     }
849 
850     /* List is ordered by load address in the same address space */
851     QTAILQ_FOREACH(item, &roms, next) {
852         if (rom_order_compare(rom, item)) {
853             continue;
854         }
855         QTAILQ_INSERT_BEFORE(item, rom, next);
856         return;
857     }
858     QTAILQ_INSERT_TAIL(&roms, rom, next);
859 }
860 
861 static void fw_cfg_resized(const char *id, uint64_t length, void *host)
862 {
863     if (fw_cfg) {
864         fw_cfg_modify_file(fw_cfg, id + strlen("/rom@"), host, length);
865     }
866 }
867 
868 static void *rom_set_mr(Rom *rom, Object *owner, const char *name, bool ro)
869 {
870     void *data;
871 
872     rom->mr = g_malloc(sizeof(*rom->mr));
873     memory_region_init_resizeable_ram(rom->mr, owner, name,
874                                       rom->datasize, rom->romsize,
875                                       fw_cfg_resized,
876                                       &error_fatal);
877     memory_region_set_readonly(rom->mr, ro);
878     vmstate_register_ram_global(rom->mr);
879 
880     data = memory_region_get_ram_ptr(rom->mr);
881     memcpy(data, rom->data, rom->datasize);
882 
883     return data;
884 }
885 
886 int rom_add_file(const char *file, const char *fw_dir,
887                  hwaddr addr, int32_t bootindex,
888                  bool option_rom, MemoryRegion *mr,
889                  AddressSpace *as)
890 {
891     MachineClass *mc = MACHINE_GET_CLASS(qdev_get_machine());
892     Rom *rom;
893     int rc, fd = -1;
894     char devpath[100];
895 
896     if (as && mr) {
897         fprintf(stderr, "Specifying an Address Space and Memory Region is " \
898                 "not valid when loading a rom\n");
899         /* We haven't allocated anything so we don't need any cleanup */
900         return -1;
901     }
902 
903     rom = g_malloc0(sizeof(*rom));
904     rom->name = g_strdup(file);
905     rom->path = qemu_find_file(QEMU_FILE_TYPE_BIOS, rom->name);
906     rom->as = as;
907     if (rom->path == NULL) {
908         rom->path = g_strdup(file);
909     }
910 
911     fd = open(rom->path, O_RDONLY | O_BINARY);
912     if (fd == -1) {
913         fprintf(stderr, "Could not open option rom '%s': %s\n",
914                 rom->path, strerror(errno));
915         goto err;
916     }
917 
918     if (fw_dir) {
919         rom->fw_dir  = g_strdup(fw_dir);
920         rom->fw_file = g_strdup(file);
921     }
922     rom->addr     = addr;
923     rom->romsize  = lseek(fd, 0, SEEK_END);
924     if (rom->romsize == -1) {
925         fprintf(stderr, "rom: file %-20s: get size error: %s\n",
926                 rom->name, strerror(errno));
927         goto err;
928     }
929 
930     rom->datasize = rom->romsize;
931     rom->data     = g_malloc0(rom->datasize);
932     lseek(fd, 0, SEEK_SET);
933     rc = read(fd, rom->data, rom->datasize);
934     if (rc != rom->datasize) {
935         fprintf(stderr, "rom: file %-20s: read error: rc=%d (expected %zd)\n",
936                 rom->name, rc, rom->datasize);
937         goto err;
938     }
939     close(fd);
940     rom_insert(rom);
941     if (rom->fw_file && fw_cfg) {
942         const char *basename;
943         char fw_file_name[FW_CFG_MAX_FILE_PATH];
944         void *data;
945 
946         basename = strrchr(rom->fw_file, '/');
947         if (basename) {
948             basename++;
949         } else {
950             basename = rom->fw_file;
951         }
952         snprintf(fw_file_name, sizeof(fw_file_name), "%s/%s", rom->fw_dir,
953                  basename);
954         snprintf(devpath, sizeof(devpath), "/rom@%s", fw_file_name);
955 
956         if ((!option_rom || mc->option_rom_has_mr) && mc->rom_file_has_mr) {
957             data = rom_set_mr(rom, OBJECT(fw_cfg), devpath, true);
958         } else {
959             data = rom->data;
960         }
961 
962         fw_cfg_add_file(fw_cfg, fw_file_name, data, rom->romsize);
963     } else {
964         if (mr) {
965             rom->mr = mr;
966             snprintf(devpath, sizeof(devpath), "/rom@%s", file);
967         } else {
968             snprintf(devpath, sizeof(devpath), "/rom@" TARGET_FMT_plx, addr);
969         }
970     }
971 
972     add_boot_device_path(bootindex, NULL, devpath);
973     return 0;
974 
975 err:
976     if (fd != -1)
977         close(fd);
978 
979     g_free(rom->data);
980     g_free(rom->path);
981     g_free(rom->name);
982     if (fw_dir) {
983         g_free(rom->fw_dir);
984         g_free(rom->fw_file);
985     }
986     g_free(rom);
987 
988     return -1;
989 }
990 
991 MemoryRegion *rom_add_blob(const char *name, const void *blob, size_t len,
992                    size_t max_len, hwaddr addr, const char *fw_file_name,
993                    FWCfgReadCallback fw_callback, void *callback_opaque,
994                    AddressSpace *as, bool read_only)
995 {
996     MachineClass *mc = MACHINE_GET_CLASS(qdev_get_machine());
997     Rom *rom;
998     MemoryRegion *mr = NULL;
999 
1000     rom           = g_malloc0(sizeof(*rom));
1001     rom->name     = g_strdup(name);
1002     rom->as       = as;
1003     rom->addr     = addr;
1004     rom->romsize  = max_len ? max_len : len;
1005     rom->datasize = len;
1006     rom->data     = g_malloc0(rom->datasize);
1007     memcpy(rom->data, blob, len);
1008     rom_insert(rom);
1009     if (fw_file_name && fw_cfg) {
1010         char devpath[100];
1011         void *data;
1012 
1013         if (read_only) {
1014             snprintf(devpath, sizeof(devpath), "/rom@%s", fw_file_name);
1015         } else {
1016             snprintf(devpath, sizeof(devpath), "/ram@%s", fw_file_name);
1017         }
1018 
1019         if (mc->rom_file_has_mr) {
1020             data = rom_set_mr(rom, OBJECT(fw_cfg), devpath, read_only);
1021             mr = rom->mr;
1022         } else {
1023             data = rom->data;
1024         }
1025 
1026         fw_cfg_add_file_callback(fw_cfg, fw_file_name,
1027                                  fw_callback, callback_opaque,
1028                                  data, rom->datasize, read_only);
1029     }
1030     return mr;
1031 }
1032 
1033 /* This function is specific for elf program because we don't need to allocate
1034  * all the rom. We just allocate the first part and the rest is just zeros. This
1035  * is why romsize and datasize are different. Also, this function seize the
1036  * memory ownership of "data", so we don't have to allocate and copy the buffer.
1037  */
1038 int rom_add_elf_program(const char *name, void *data, size_t datasize,
1039                         size_t romsize, hwaddr addr, AddressSpace *as)
1040 {
1041     Rom *rom;
1042 
1043     rom           = g_malloc0(sizeof(*rom));
1044     rom->name     = g_strdup(name);
1045     rom->addr     = addr;
1046     rom->datasize = datasize;
1047     rom->romsize  = romsize;
1048     rom->data     = data;
1049     rom->as       = as;
1050     rom_insert(rom);
1051     return 0;
1052 }
1053 
1054 int rom_add_vga(const char *file)
1055 {
1056     return rom_add_file(file, "vgaroms", 0, -1, true, NULL, NULL);
1057 }
1058 
1059 int rom_add_option(const char *file, int32_t bootindex)
1060 {
1061     return rom_add_file(file, "genroms", 0, bootindex, true, NULL, NULL);
1062 }
1063 
1064 static void rom_reset(void *unused)
1065 {
1066     Rom *rom;
1067 
1068     QTAILQ_FOREACH(rom, &roms, next) {
1069         if (rom->fw_file) {
1070             continue;
1071         }
1072         if (rom->data == NULL) {
1073             continue;
1074         }
1075         if (rom->mr) {
1076             void *host = memory_region_get_ram_ptr(rom->mr);
1077             memcpy(host, rom->data, rom->datasize);
1078         } else {
1079             cpu_physical_memory_write_rom(rom->as, rom->addr, rom->data,
1080                                           rom->datasize);
1081         }
1082         if (rom->isrom) {
1083             /* rom needs to be written only once */
1084             g_free(rom->data);
1085             rom->data = NULL;
1086         }
1087         /*
1088          * The rom loader is really on the same level as firmware in the guest
1089          * shadowing a ROM into RAM. Such a shadowing mechanism needs to ensure
1090          * that the instruction cache for that new region is clear, so that the
1091          * CPU definitely fetches its instructions from the just written data.
1092          */
1093         cpu_flush_icache_range(rom->addr, rom->datasize);
1094     }
1095 }
1096 
1097 int rom_check_and_register_reset(void)
1098 {
1099     hwaddr addr = 0;
1100     MemoryRegionSection section;
1101     Rom *rom;
1102     AddressSpace *as = NULL;
1103 
1104     QTAILQ_FOREACH(rom, &roms, next) {
1105         if (rom->fw_file) {
1106             continue;
1107         }
1108         if ((addr > rom->addr) && (as == rom->as)) {
1109             fprintf(stderr, "rom: requested regions overlap "
1110                     "(rom %s. free=0x" TARGET_FMT_plx
1111                     ", addr=0x" TARGET_FMT_plx ")\n",
1112                     rom->name, addr, rom->addr);
1113             return -1;
1114         }
1115         addr  = rom->addr;
1116         addr += rom->romsize;
1117         section = memory_region_find(rom->mr ? rom->mr : get_system_memory(),
1118                                      rom->addr, 1);
1119         rom->isrom = int128_nz(section.size) && memory_region_is_rom(section.mr);
1120         memory_region_unref(section.mr);
1121         as = rom->as;
1122     }
1123     qemu_register_reset(rom_reset, NULL);
1124     roms_loaded = 1;
1125     return 0;
1126 }
1127 
1128 void rom_set_fw(FWCfgState *f)
1129 {
1130     fw_cfg = f;
1131 }
1132 
1133 void rom_set_order_override(int order)
1134 {
1135     if (!fw_cfg)
1136         return;
1137     fw_cfg_set_order_override(fw_cfg, order);
1138 }
1139 
1140 void rom_reset_order_override(void)
1141 {
1142     if (!fw_cfg)
1143         return;
1144     fw_cfg_reset_order_override(fw_cfg);
1145 }
1146 
1147 static Rom *find_rom(hwaddr addr)
1148 {
1149     Rom *rom;
1150 
1151     QTAILQ_FOREACH(rom, &roms, next) {
1152         if (rom->fw_file) {
1153             continue;
1154         }
1155         if (rom->mr) {
1156             continue;
1157         }
1158         if (rom->addr > addr) {
1159             continue;
1160         }
1161         if (rom->addr + rom->romsize < addr) {
1162             continue;
1163         }
1164         return rom;
1165     }
1166     return NULL;
1167 }
1168 
1169 /*
1170  * Copies memory from registered ROMs to dest. Any memory that is contained in
1171  * a ROM between addr and addr + size is copied. Note that this can involve
1172  * multiple ROMs, which need not start at addr and need not end at addr + size.
1173  */
1174 int rom_copy(uint8_t *dest, hwaddr addr, size_t size)
1175 {
1176     hwaddr end = addr + size;
1177     uint8_t *s, *d = dest;
1178     size_t l = 0;
1179     Rom *rom;
1180 
1181     QTAILQ_FOREACH(rom, &roms, next) {
1182         if (rom->fw_file) {
1183             continue;
1184         }
1185         if (rom->mr) {
1186             continue;
1187         }
1188         if (rom->addr + rom->romsize < addr) {
1189             continue;
1190         }
1191         if (rom->addr > end) {
1192             break;
1193         }
1194 
1195         d = dest + (rom->addr - addr);
1196         s = rom->data;
1197         l = rom->datasize;
1198 
1199         if ((d + l) > (dest + size)) {
1200             l = dest - d;
1201         }
1202 
1203         if (l > 0) {
1204             memcpy(d, s, l);
1205         }
1206 
1207         if (rom->romsize > rom->datasize) {
1208             /* If datasize is less than romsize, it means that we didn't
1209              * allocate all the ROM because the trailing data are only zeros.
1210              */
1211 
1212             d += l;
1213             l = rom->romsize - rom->datasize;
1214 
1215             if ((d + l) > (dest + size)) {
1216                 /* Rom size doesn't fit in the destination area. Adjust to avoid
1217                  * overflow.
1218                  */
1219                 l = dest - d;
1220             }
1221 
1222             if (l > 0) {
1223                 memset(d, 0x0, l);
1224             }
1225         }
1226     }
1227 
1228     return (d + l) - dest;
1229 }
1230 
1231 void *rom_ptr(hwaddr addr)
1232 {
1233     Rom *rom;
1234 
1235     rom = find_rom(addr);
1236     if (!rom || !rom->data)
1237         return NULL;
1238     return rom->data + (addr - rom->addr);
1239 }
1240 
1241 void hmp_info_roms(Monitor *mon, const QDict *qdict)
1242 {
1243     Rom *rom;
1244 
1245     QTAILQ_FOREACH(rom, &roms, next) {
1246         if (rom->mr) {
1247             monitor_printf(mon, "%s"
1248                            " size=0x%06zx name=\"%s\"\n",
1249                            memory_region_name(rom->mr),
1250                            rom->romsize,
1251                            rom->name);
1252         } else if (!rom->fw_file) {
1253             monitor_printf(mon, "addr=" TARGET_FMT_plx
1254                            " size=0x%06zx mem=%s name=\"%s\"\n",
1255                            rom->addr, rom->romsize,
1256                            rom->isrom ? "rom" : "ram",
1257                            rom->name);
1258         } else {
1259             monitor_printf(mon, "fw=%s/%s"
1260                            " size=0x%06zx name=\"%s\"\n",
1261                            rom->fw_dir,
1262                            rom->fw_file,
1263                            rom->romsize,
1264                            rom->name);
1265         }
1266     }
1267 }
1268