(转)libvirt API的基本概念
本文摘自：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对象)。
