qemu/scripts/dump-guest-memory.py

2 This python script adds a new gdb command, "dump-guest-memory". It
3 should be loaded with "source dump-guest-memory.py" at the (gdb)
13 the COPYING file in the top-level directory.
22     raise gdb.GdbError("Symbols must be loaded prior to sourcing dump-guest-memory.\n"
76         if arch == 'aarch64-le':
82         elif arch == 'aarch64-be':
103         elif arch == 'ppc64-le':
108         elif arch == 'ppc64-be':
116                                "aarch64-be, aarch64-le, X86_64, 386, s390, "
117                                "ppc64-be, ppc64-le")
142         """Adds a vmcoreinfo note to the ELF dump."""
152                              header.n_namesz - 1, header.n_descsz)
180         Dump contents
406     print("---------------- ---------------- ---------------- ------- "
407           "-----")
434             predecessor = guest_phys_blocks[-1]
435             predecessor_size = (predecessor["target_end"] -
442             # we want continuity in both guest-physical and
443             # host-virtual memory
460         print("%016x %016x %016x %-7s %5u" %
476 ARCH specifies the architecture for which the core will be generated.
478 This GDB command reimplements the dump-guest-memory QMP command in
481 command line option "-machine dump-guest-core=on" which is the default.
484 command are not supported -- no attempt is made to get the guest's
485 internal paging structures (ie. paging=false is hard-wired), and guest
488 Currently aarch64-be, aarch64-le, X86_64, 386, s390, ppc64-be,
489 ppc64-le guests are supported.
491 The CORE/NT_PRSTATUS and QEMU notes (that is, the VCPUs' statuses) are
504         super(DumpGuestMemory, self).__init__("dump-guest-memory",
511         """Prepares and writes ELF structures to core file."""
514         # not available in a qemu core.
525             block_size = block["target_end"] - block["target_start"]
531         """Writes guest core to file."""
536             left = block["target_end"] - block["target_start"]
545                 left -= chunk_size
552                 haddr = block["host_addr"] + (addr - block["target_start"])
561            or not gdb.parse_and_eval("(%s)->has_vmcoreinfo" % vmci):
564         fmt = gdb.parse_and_eval("(%s)->vmcoreinfo.guest_format" % vmci)
565         addr = gdb.parse_and_eval("(%s)->vmcoreinfo.paddr" % vmci)
566         size = gdb.parse_and_eval("(%s)->vmcoreinfo.size" % vmci)
583         # not dump the same multi-gig coredump to the same file.
588             raise gdb.GdbError("usage: dump-guest-memory FILE ARCH")