doc:update acrn-shell.rst

update this doc related with dump host & guest memory.

Signed-off-by: Mingqiang Chi <mingqiang.chi@intel.com>
This commit is contained in:
Mingqiang Chi 2019-11-27 11:24:16 +08:00 committed by deb-intel
parent 413f098b11
commit acb5affd0b
3 changed files with 29 additions and 6 deletions

View File

@ -21,9 +21,12 @@ The ACRN hypervisor shell supports the following commands:
- List all vCPUs in all VMs
* - vcpu_dumpreg <vm_id> <vcpu_id>
- Dump registers for a specific vCPU
* - dumpmem <hva> <length>
- Dump host memory, starting at a given address, and for a given length
(in bytes)
* - dump_host_mem <hva> <length>
- Dump the host memory region as specified by the start of the region ``hva`` (in hexadecimal)
and its length ``length`` (in bytes, decimal number).
* - dump_guest_mem <vm_id> <gva> <length>
- Dump a User VM (guest) memory region based on the VM ID (``vm_id``, in decimal),
the start of the memory region ``gva`` (in hexadecimal) and its length ``length`` (in bytes, decimal number).
* - vm_console <vm_id>
- Switch to the VM's console. Use :kbd:`Ctrl+Spacebar` to return to the ACRN
shell console
@ -104,10 +107,10 @@ function ``acpi_idle_do_entry``.
system map information
dumpmem
=======
dump_host_mem
=============
``dumpmem mem_address`` provides the specified memory target data such as
``dump_host_mem hva length`` provides the specified memory target data such as
the physical CPU (pCPU) number, etc.
In this example, we know the pCPU active bitmap and physical CPU number
@ -129,6 +132,26 @@ pCPU number is 0x0000000000000004.
acrn map information
dump_guest_mem
==============
The ``dump_guest_mem`` command can dump guest memory according to the given
VM ID and guest virtual address (``gva``).
In this example, we know the starting address of kernel text segment
in guest console or through the ``system.map`` (Note that the path for
``system.map`` depends on how we build the kernel)
.. figure:: images/shell_image19.png
:align: center
guest virtual address
.. figure:: images/shell_image20.png
:align: center
guest memory information
vm_console
===========

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB