qmp的简单使用

时间:2021-05-26 01:37:16

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

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

补充:之前以为通过libvirt的方式(即virsh命令)发送qmp命令看不到qemu端的输出,实际上其输出存放在/var/log/libvirt/qemu/文件夹下的日志文件中,其中log文件名与虚拟机名字关联。因此该种方式也可以用于开发阶段。

(一)简单使用

可通过如下命令开启虚拟机并使用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  /home/cmj/sourcecode/test.img -chardev socket,id=qmp,port=,host=localhost,server -mon chardev=qmp,mode=control,pretty=on

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

qmp的简单使用

使用 telnet localhost 4444连接qemu,如下:

qmp的简单使用

输入使能qmp命令:

{"execute":"qmp_capabilities"}

qmp的简单使用

查询kvm信息:

{"execute":"query-kvm"}

qmp的简单使用

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

(二)添加新的qmp命令

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

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

qmp的简单使用

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\n"); testdata *data;
data = g_malloc0(sizeof(*data)); data->index = index_value;
data->count = count_value;
printf("index:%d count:%d\n",data->index,data->count);
return data;
}

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

(3)在文件qmp-commands.hx中添加以下内容:

qmp的简单使用

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

(4)make 编译修改后的qemu

注意若修改的qemu与虚拟机之前使用的qemu不是同一个时,需要将虚拟机使用的qemu改为刚刚修改的qemu,修改虚拟机的xml文件为修改后的qemu:

qmp的简单使用

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

(5)开启虚拟机进行新的qmp命令测试

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

qmp的简单使用

执行完毕后,return中返回index及count,qemu端的输出如下:
qmp的简单使用

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的简单使用

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

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

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