本文摘自:http://blog.sina.com.cn/s/blog_da4487c40102v31i.html
libvirt对象
libvirt的对象向外展现了虚拟化环境的所有资源。libvirt API编程操纵的第一个对象总是virConnectPtr,它提供了到一个Hypervisor的连接。任何一个libvirt应用程序,都是从调用 virConnectOpen函数开始的,该函数的参数包含一个Hypervisor的URI,函数执行成功表示已连接到指定的Hypervisor,并返回一个代表该连接的virConnectPtr对象,通过这个对象,应用程序就可以管理它上面的域以及其它虚拟化资源。libvirt主要通过5个对象展现它的所有功能,对象之间的结构如图所示:
除了virConnectPtr对象外,virDomainPtr对象代表Hypervisor上的一个域;virNetworkPtr对象代表Hypervisor上的一个网络;virStorageVolPtr对象代表一个存储卷,它是可以供域使用的块存储设备;virStoragePoolPtr对象代表Hypervisor上的一个存储池,它为存储卷提供一个逻辑存储区域。
上述对象都有以下几种命名方法:
1)name,用户友好型的标识名,但不能保证名称在节点之间保持唯一性。
2)ID, 运行时的标识名,一般为一数字,由Hypervisor为当前活动对象指定的名称,只在对象存活期内有效。
3)UUID,一个16字节的唯一标识名,遵循RFC4122规范,可以确保名称在跨节点范围内的唯一性,并且能被长时间保持。
函数命名规范
libvirt库中的函数名称存在一些命名规则,主要有以下几种:
1)查找对象:[...LookupBy...]
根据对象的名称标识查找对象,如:
virDomainLookupByID
virDomainLookupByName
virDomainLookupByUUID
virDomainLookupByUUIDString
2)枚举对象数量 [virConnectList..., virConnectNumOf...]
枚举当前连接可用对象的数量,如:
virConnectListDomains
virConnectNumOfDomains
virConnectListNetworks
virConnectListStoragePools
3)获取对象信息 [...GetInfo]
提供对象的基本信息,如:
virNodeGetInfo
virDomainGetInfo
virStoragePoolGetInfo
virStorageVolGetInfo
4)访问对象 [...Get..., ...Set...]
查询或修改指定对象的数据,如:
virConnectGetType
virDomainGetMaxMemory
virDomainSetMemory
virDomainGetVcpus
virStoragePoolSetAutostart
virNetworkGetBridgeName
5)建立对象 [...Create, ...CreateXML]
建立并启动对象,可以通过XML描述信息建立对象,也可以通过对象指针建立对象,如:
virDomainCreate
virDomainCreateXML
virNetworkCreate
virNetworkCreateXML
6)停用对象 [...Destroy]
通过关闭、停止操作使对象失效,如:
virDomainDestroy
virNetworkDestroy
virStoragePoolDestroy
注意:有些函数返回一个对象vir*Ptr (如virDomainLookup)
,返回对象内存空间的释放需要调用对应的vir*Free函数(如virDomainFree释放一个virDomainPtr对象)。