(KVM连载) 6.1.7 libvirt API 使用示例(C API)

6.1.7 libvirt API 使用示例

经过前面几个小节对libvirt的配置、编译、API、建立连接等内容的介绍,相信大家对libvirt已经有了大致的了解。对API进行学习的最好方法就是使用代码来调用API实现几个小功能,所以本节主要通过两个示例来分别演示如何调用libvirt的C语言和Python语言绑定的API。

1. libvirt C API的使用

在使用libvirt API之前,必须要在远程或本地的节点上启动libvirtd守护进程。在使用libvirt的客户端,先安装libvirt-devel软件包或使用6.1.2节中介绍的方法来自行编译和安装libvirt。本次示例中安装的是RHEL 6.3自带的libvirt-devel软件包,如下:

[root@rhel6u3-ga ~]# rpm -q libvirt-devel

libvirt-devel-0.9.10-21.el6.x86_64

如下一个简单的C程序(文件名为dominfo.c)就是通过调用libvirt的API来查询一些关于某个域的信息。该示例程序比较简单易懂,它仅仅对使用libvirt API的一个演示程序,这里不做过多的介绍。不过,这里有三点需要注意:1. 需要在示例代码的开头引入<libvirt/libvirt.h>这个头文件; 2. 由于只是做查询信息的功能,所以可以使用virConnectOpenReadOnly来建立只读连接; 3. 这里使用了空值(NULL)作为URI,是让libvirt自动根据6.1.6小节中介绍的默认规则去建立到Hypervisor的连接。这里由于本地是启动libvirtd守护进程,启动了两个QEMU/KVM客户机,所以它默认会建立到QEMU/KVM的连接。

/**

* Get domain information via libvirt C API.

* Tested with libvirt-devel-0.9.10 on a RHEL 6.3 host system.

*/

 

#include <stdio.h>

#include <libvirt/libvirt.h>

 

int getDomainInfo(int id) {

virConnectPtr conn = NULL; /* the hypervisor connection */

virDomainPtr dom = NULL;   /* the domain being checked */

virDomainInfo info;        /* the information being fetched */

 

/* NULL means connect to local QEMU/KVM hypervisor */

conn = virConnectOpenReadOnly(NULL);

if (conn == NULL) {

fprintf(stderr, “Failed to connect to hypervisor\n”);

return 1;

}

 

/* Find the domain by its ID */

dom = virDomainLookupByID(conn, id);

if (dom == NULL) {

fprintf(stderr, “Failed to find Domain %d\n”, id);

virConnectClose(conn);

return 1;

}

 

/* Get virDomainInfo structure of the domain */

if (virDomainGetInfo(dom, &info) < 0) {

fprintf(stderr, “Failed to get information for Domain %d\n”, id);

virDomainFree(dom);

virConnectClose(conn);

return 1;

}

 

/* Print some info of the domain */

printf(“Domain ID: %d\n”, id);

printf(”    vCPUs: %d\n”, info.nrVirtCpu);

printf(”   maxMem: %d KB\n”, info.maxMem);

printf(”   memory: %d KB\n”, info.memory);

 

if (dom != NULL)

virDomainFree(dom);

if (conn != NULL)

virConnectClose(conn);

 

return 0;

}

 

int main(int argc, char **argv)

{

int dom_id = 3;

printf(“—–Get domain info by ID via libvirt C API —–\n”);

getDomainInfo(dom_id);

return 0;

}

在获得dominfo.c这个示例程序之后,用virsh命令查看当前节点中的情况,再编译和运行这个示例程序去查询一些域的信息,可以将二者得到的一些信息进行对比,可以发现二者得到的信息是匹配的,命令行操作如下:

[root@rhel6u3-ga kvm_demo]# virsh list

Id    Name                           State

—————————————————-

3     kvm-guest                      running

6     kvm-guest-2                    running

 

[root@rhel6u3-ga kvm_demo]# virsh dommemstat 3

actual 1048576

rss 680228

 

[root@rhel6u3-ga kvm_demo]# virsh vcpucount 3

maximum      live           4

current      live           4

 

[root@rhel6u3-ga kvm_demo]# gcc dominfo.c -o dominfo -lvirt

 

[root@rhel6u3-ga kvm_demo]# ./dominfo

—–Get domain info by ID via libvirt C API —–

Domain ID: 3

vCPUs: 4

maxMem: 1048576 KB

memory: 1048576 KB

这里需要注意的是,在使用GCC编译dominfo.c这个示例程序时,加上了“-lvirt”这个参数来指定程序链接时的依赖的库文件,如果不指定libvirt相关的共享库,则会发生链接时错误。在本次示例的RHEL 6.3系统中,需要依赖的libvirt共享库文件是/usr/lib64/libvirt.so,如下:

[root@rhel6u3-ga ~]# ls /usr/lib64/libvirt.so

/usr/lib64/libvirt.so

master

Stay hungry, stay foolish.

One Comment

  1. 阁下的libvirt介绍的很详细,小白颇为受益,非常感谢。

发表评论

电子邮件地址不会被公开。 必填项已用*标注