KVM API的使用

xuanxi

KVM API的使用

KVM的API是通过/dev/kvm设备进行访问的。/dev/kvm是一个字符型设备，如下图所示。

                              

作为Linux的一个标准字符型设备，可以使用常见的系统调用如open、close、ioctl等指令进行操作。因为KVM的字符型设备的实现函数中，没有包含write、read等操作。所有对KVM的操作都是通过ioctl发送相应的控制字实现的。　　
KVM所提供的用户控件API从功能上划分，可以分为三种类型，如下面所示。
API类型功能说明system指令针对虚拟化系统的全局性参数设置和用于虚拟机创建等控制操作VM指令
针对具体的VM虚拟机进行控制，如进行内存设置、创建VCPU等。注意：VM指令不是进程安全的

vcpu指令针对具体的vCPU进行参数设置（MRU寄存器读写、中断控制等）     用户空间的程序与KVM的交互来查询、管理KVM hypervisor或者guest，是通过使用ioctl函数与一个特殊的设备/dev/kvm的交互来实现的。 KVM API就是一些可以用于控制虚拟机各个方面的ioctl的集合。（The kvm API is a set of ioctls that are issued to control various aspects of a virtual machine.）
     用户可以通过KVM API 获得KVM的版本信息、创建虚拟机、创建VCPU、查询KVM的特性支持和性能容量，等等
内核代码中关于KVM API的参考文档在： $Linux-SRC/Documentation/virtual/kvm/api.txt
另外，可以参考代码： virt/kvm/kvm_main.c， arch/x86/kvm/x86.c
     下面是一个使用KVM API的示例小程序：
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/ioctl.h>
#include <fcntl.h>
#include <unistd.h>
#include <linux/kvm.h>

#define KVM_FILE &quot;/dev/kvm&quot;

int main()
{
        int dev;
        int ret;

        dev = open(KVM_FILE,O_RDWR|O_NDELAY);
        ret = ioctl(dev,KVM_GET_API_VERSION,0);
        printf(&quot;----KVM API version is--%d---\n&quot;,ret);
        ret = ioctl(dev,KVM_CHECK_EXTENSION,KVM_CAP_MAX_VCPUS);
        printf(&quot;----KVM supports MAX_VCPUS per guest(VM) is %d---\n&quot;,ret);
        ret = ioctl(dev,KVM_CHECK_EXTENSION,KVM_CAP_IOMMU);
        if(ret != 0)
                printf(&quot;----KVM supports IOMMU (i.e. Intel VT-d or AMD IOMMU).----\n&quot;);
        else
                printf(&quot;----KVM doesn't support IOMMU (i.e. Intel VT-d or AMD IOMMU).----\n&quot;);

        return 0;
}

运行上面的示例程序，如下所示：
[iyunv@jay-linux jay]# vim kvm-api-test.c
[iyunv@jay-linux jay]# gcc kvm-api-test.c  -o kvm-api-test
[iyunv@jay-linux jay]# ./kvm-api-test
----KVM API version is--12---
----KVM supports MAX_VCPUS per guest(VM) is 254---
----KVM supports IOMMU (i.e. Intel VT-d or AMD IOMMU).----

参考来源：1.    http://smilejay.com/2013/03/use-kvm-api/2.  《虚拟化技术原理与实现》
         版权声明：本文为博主原创文章，未经博主允许不得转载。