# 眼见为实

> 纸上得来终觉浅，绝知此事须躬行

讲了这么多概念是时候实际看一看这些数据结构的样子了。这次我们借助程序员的老朋友gdb来帮助我们近距离观察qemu的地址空间。

## 修改.gdbinit

在qemu源码目录下有一个文件.gdbinit， 这是默认gdb启动时加载的脚本。添加如下内容：

```
file x86_64-softmmu/qemu-system-x86_64
set args -nographic
source gdb-script
b pc_memory_init
r
```

修改后，在源码目录下直接运行gdb就可以执行这些命令。其含义是：

* 加载指定可执行文件
* 设定可执行文件的参数
* 加载一个脚本[gdb-script](https://gist.github.com/RichardWeiYang/123ce27f686165dca9a27278384d1081)
* 设置断点在pc\_memory\_init
* 运行

在源码目录下敲入gdb开始我们的探索。

注：请自行编译qemu源码。

## 查看帮助

脚本中主要的函数有三个，分别带有简单的帮助，可以先看一下。

```
(gdb) help dump_address_spaces
Dump a AddressSpace: dump_address_spaces 0|1

Example:

dump_address_spaces 0
dump_address_spaces 1
(gdb) help dump_memory_region
Dump a MemoryRegion: dump_memory_region SYM|ADDRESS

Example:

dump_memory_region system_memory
dump_memory_region 0x5555565036a0
(gdb) help dump_flatview
Dump a FlatView: dump_flatview ADDRESS

Example:

dump_memory_region 0x555556675be0
```

这三个函数分别用来显示AddressSpace, MemoryRegion和FlatView。

## 显示AddressSpace

首先来看看当前qemu中AddressSpace的状况。

```
(gdb) dump_address_spaces 0
AddressSpace : memory(0x5555565036a0)
     Root MR : 0x55555661e300
    FlatView : 0x555556675be0
AddressSpace : I/O(0x555556503640)
     Root MR : 0x555556616800
    FlatView : 0x555556691f60
AddressSpace : cpu-memory-0(0x5555566756e0)
     Root MR : 0x55555661e300
    FlatView : 0x555556675be0
AddressSpace : cpu-smm-0(0x5555566758c0)
     Root MR : 0x555556590000
    FlatView : 0x555556675be0
```

这个命令可以带两个参数，0或1。

* 0: 显示地址空间的根MemoryRegion和FlatView
* 1: 显示地址空间的MemoryRegion树

## 显示MemoryRegion

接着我们可以查看MemoryRegion的情况。

```
(gdb) dump_memory_region 0x55555661e300
Dump MemoryRegion:system
```

这个函数可以接受两种参数，变量名或地址。

在这个例子中，我们传入的是上一步地址空间中得到的一个根MemoryRegion的地址。

## 显示FlatView

看过了MemoryRegion，我们还以看其对应的FlatView。

```
(gdb) dump_flatview 0x555556675be0
[000000000fee00000-000000000fef00000], offset_in_region 0000000000000000
```

这个就是刚才那个根MemoryRegion的一维展开了。

怎么样，这样是不是更清楚了？

最近发现在qemu monitor中已经有类似的功能了。直接输入info mtree，就可以获得内存树结构。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://richardweiyang-2.gitbook.io/understanding_qemu/00-as/07-witness.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.