qmp的简单使用

Posted 2021-01-08 ccxikka

QMP是一种基于JSON格式的传输协议，可使用QMP与一个QEMU虚拟机实例进行交互，例如查询虚拟机的相关状态等，以下就QMP的使用进行简单介绍。

可以通过libvirt向一个运行的虚拟机发送qmp命令，也可以使用qemu命令启动一个虚拟机，之后发送qmp命令。上述两种方式各有优点，第一种方式可用于相关工具的开发及使用，第二种方式由于可以看到qemu中的相关输出，因此可用于开发阶段的调试。

（一）简单使用

可通过如下命令开启虚拟机并使用qmp，其中/usr/local/bin/qemu-system-x86_64-libvmi 为虚拟机使用的qemu，/home/cmj/sourcecode/test.img为虚拟机镜像，使用端口号4444进行通信。因为qmp本质上是一种Unix socket的本地通信机制，通信内容基于json格式。

/usr/local/bin/qemu-system-x86_64-libvmi --enable-kvm -m 1024 /home/cmj/sourcecode/test.img -chardev socket,id=qmp,port=4444,host=localhost,server -mon chardev=qmp,mode=control,pretty=on

运行上述命令后输出如下：

使用 telnet localhost 4444连接qemu，如下：

输入使能qmp命令：

{"execute":"qmp_capabilities"}

查询kvm信息：

{"execute":"query-kvm"}

execute指定要执行的命令，return返回命令执行后的结果，若没有返回数据则为空。

（二）添加新的qmp命令

 可以通过修改qemu添加自定义的qmp命令用于交互，具体如下：

（1） 在qapi-schema.json的尾部指定一个新的qmp命令，编译的过程中会自动生成该命令的json格式的解析参数：

command为发送的命令格式，为get_testdata；data为传入的参数，此处传入两个参数，均为整型；返回值为testdata，testdata为自定义的数据类型，如上图第一行，该数据类型包含两个int型的变量。

（2）在qmp.c中添加该命令的具体实现：

testdata *qmp_get_testdata( int64_t index_value,int64_t count_value, Error **errp )
{

    printf("qmp test get data
");

    testdata *data;
    data = g_malloc0(sizeof(*data));
    
    data->index = index_value;
    data->count = count_value;
    printf("index:%d count:%d
",data->index,data->count);
    return data;
}

命令必须以qmp开头，testdata *表示返回该类型的指针，参数errp用于返回错误信息。不需要添加该函数的声明，因为qapi可自动化实现函数声明的任务。

（3）在文件qmp-commands.hx中添加以下内容：

在该文件中，注释内容放在SQMP和EQMP之间。name为命令名称；args_type为参数及类型，i表示int型。

（4）make 编译修改后的qemu

注意需要将虚拟机使用的qemu修改为刚刚修改的qemu，修改虚拟机的xml文件为修改后的qemu：

修改后使用virsh define text.xml 重新定义

（5）开启虚拟机进行新的qmp命令测试

a. 使用qemu命令开启虚拟机，使用Telnet连接,输入{"execute":"qmp_capabilities"} 使能命令后，输入新定义的qmp命令：arguments为定义的参数

执行完毕后，return中返回index及count，qemu端的输出如下：

b. 向运行的虚拟机发送qmp命令

virsh start test开启虚拟机之后，发送qmp命令如下：

virsh -c qemu:///system qemu-monitor-command test "{ "execute": "get_testdata", "arguments": { "index_value": 1, "count_value": 101} }"

其中test为虚拟机名称，arguments为参数。

执行结果如下：

以上则为qmp命令的简单使用。

参考：https://blog.csdn.net/wangwei222/article/details/80055615

https://www.cnblogs.com/YaoDD/p/5328088.html