QEMU源码全解析37 —— Machine（7）

本文内容参考：

《QEMU/KVM》源码解析与应用 —— 李强，机械工业出版社

特此致谢！

上回书讲完了qemu_create_machine函数中的第一步select_machine函数。本文讲解第2个步骤函数：MACHINE。为了便于理解，再次贴出qemu_create_machine函数代码，在softmmu/vl.c中，如下：

static void qemu_create_machine(QDict *qdict)
{
    MachineClass *machine_class = select_machine(qdict, &error_fatal);
    object_set_machine_compat_props(machine_class->compat_props);
 
    current_machine = MACHINE(object_new_with_class(OBJECT_CLASS(machine_class)));
    object_property_add_child(object_get_root(), "machine",
                              OBJECT(current_machine));
    object_property_add_child(container_get(OBJECT(current_machine),
                                            "/unattached"),
                              "sysbus", OBJECT(sysbus_get_default()));
 
    if (machine_class->minimum_page_bits) {
        if (!set_preferred_target_page_bits(machine_class->minimum_page_bits)) {
            /* This would be a board error: specifying a minimum smaller than
             * a target's compile-time fixed setting.
             */
            g_assert_not_reached();
        }
    }
 
    cpu_exec_init_all();
    page_size_init();
 
    if (machine_class->hw_version) {
        qemu_set_hw_version(machine_class->hw_version);
    }
 
    /*
     * Get the default machine options from the machine if it is not already
     * specified either by the configuration file or by the command line.
     */
    if (machine_class->default_machine_opts) {
        QDict *default_opts =
            keyval_parse(machine_class->default_machine_opts, NULL, NULL,
                         &error_abort);
        qemu_apply_legacy_machine_options(default_opts);
        object_set_properties_from_keyval(OBJECT(current_machine), default_opts,
                                          false, &error_abort);
        qobject_unref(default_opts);
    }
}

第2步代码片段如下：

current_machine = MACHINE(object_new_with_class(OBJECT_CLASS(machine_class)));

笔者开始对这个MACHINE并没有引起重视，以为在QEMU源码根目录下一搜索就能找到，结果搜索了半天，愣是找不到它是在哪里定义的。后来又查找系统目录，怀疑是在系统目录下的哪个头文件中而非QEMU源码中，结果也没有找到。又在网上搜索，也没有任何相关的结果。在参考的书和培训资料中也都是只列出了以上代码，并没有提到具体的定义……

几经周折，终于发现了一些端倪。笔者在google上搜索“X86_MACHINE”，其中一个结果链接给出（指向）了QEMU源码中include/hw/i386/x86.h的老版本源码。在此老版本源码中，是能够找到X86_MACHINE的定义的，如下所示：

由此就联想到既然X86_MACHINE的定义与X86MachineState结构在同一个文件（include/hw/i386/x86.h）中，那么MACHINE的定义就应该和MachineState在同一个文件中。于是在QEMU源码根目录下搜索“MachineState”，最终定位到include/hw/boards.h文件。

又由于X86_MACHINE宏定义所在的include/hw/i386/x86.h文件的内容由于版本更新已经和上边不同了，因此通过原本X86_MACHINE宏被定义的地方，看看新版本中对应的代码是怎样的。结果找到了这一段代码：

#define TYPE_X86_MACHINE   MACHINE_TYPE_NAME("x86")
OBJECT_DECLARE_TYPE(X86MachineState, X86MachineClass, X86_MACHINE)

这就很明显地能够看出，原本是代码“#define X86_MACHINE(obj) OBJECT_CHECK(X86MachineState, (obj), TYPE_X86_MACHINE)”的地方，在新版本中变成了“OBJECT_DECLARE_TYPE(X86MachineState, X86MachineClass, X86_MACHINE)”。那么与之对应，在include/hw/boards.h文件中，如果也能找到这个“OBJECT_DECLARE_TYPE”关键字，那么想必其所对应的代码就是MACHINE的定义之处。

按照这个思路，在include/hw/boards.h中搜索，果然不出所料，找到了以下代码：

OBJECT_DECLARE_TYPE(MachineState, MachineClass, MACHINE)

那么毋庸置疑，这段代码中一定就包含了MACHINE的定义（尤其都已经看到MACHINE关键字了）。历尽周折，使用推理的方法终于找到了被新版本代码隐藏得很深的MACHINE宏！

关于MACHINE所“藏匿”的这个OBJECT_DECLARE_TYPE宏，在下回中做详细解析。

QEMU源码全解析37 —— Machine（7）

猜你喜欢