libvirt_python

一、Connections

连接函数接口
libvirt.open(name);　　　　　　　　　　　　　　　　　　　//可读写方式连接上QEMU        参数说明： name:连接名称
libvirt.openAuth(uri, auth, flags);　　　　　　　　　 //认证方式连接上QEMU　　　　　　参数说明： uri：连接到Hypervisor的入口地址
libvirt.openReadOnly(name)　　　　　　　　　　　　　　　//可读方式连接上QEMU　　　　　　　　　　

# Example-1.py
from __future__ import print_function
import sys
import libvirt
conn = libvirt.open('qemu:///system')　　　　　　　　　　　　　　　　　　　　　　　　　　　　//可读写方式连接上hypervisor(QEMU)
if conn == None:
　　print('Failed to open connection to qemu:///system', file=sys.stderr)
exit(1)
conn.close()
exit(0)
# Example-2.py
from __future__ import print_function
import sys
import libvirt
conn = libvirt.openReadOnly('qemu:///system')　　　　　　　　　　　　　　　　　　　　　　//只读方式连接上hypervisor(QEMU)　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　
if conn == None:
　　print('Failed to open connection to qemu:///system', file=sys.stderr)
exit(1)
conn.close()
exit(0)

# Example-3.py
from __future__ import print_function
import sys
import libvirt
SASL_USER = "my-super-user"
SASL_PASS = "my-super-pass"
def request_cred(credentials, user_data):
　　for credential in credentials:
　　　　if credential[0] == libvirt.VIR_CRED_AUTHNAME:
　　　　　　credential[4] = SASL_USER
　　　　elif credential[0] == libvirt.VIR_CRED_PASSPHRASE:
　　　　　　credential[4] = SASL_PASS
　　return 0
auth = [[libvirt.VIR_CRED_AUTHNAME, libvirt.VIR_CRED_PASSPHRASE], request_cred, None]
conn = libvirt.openAuth('qemu+tcp://localhost/system', auth, 0)
if conn == None:
　　print('Failed to open connection to qemu+tcp://localhost/system', file=sys.stderr)
exit(1)
conn.close()

二、Host information

getHostname　　　　　　　　　　　　　　　　　　　　//获取主机名
getMaxVcpus　　　　　　　　　　　　　　　　　　　　//获取支持最大虚拟cpu个数
getInfo　　　　　//获取主机内存，CPU 相关信息    **以列表形式存储（list[7]）存储8个值 list[0]：cpu平台（x86_64/i382）;list[1]:主机内存大小；list[2]：CPU个数；list[3]：CPU频率；list[4]：NUMA节点个数；list[5]：CPU sockets 个数；list[6]：CPU核数；list[7]：CPU超线程核数

Member	Description
list[0]	CPU平台
list[1]	主机内存大小
list[2]	CPU个数
list[3]	CPU频率
list[4]	NUMA节点个数
list[5]	CPU Sockets 个数
list[6]	CPU核数
list[7]	CPU超线程核数

   　　　　　　　　　　　　　　　　　　　　　　







getCellsFreeMemory　　　　　　　　　　　　//每个节点（如 NUMA 节点）空闲内存大小
getType　　　　　　　　　　　　　　　　　　//获取虚拟化平台类型
getVersion　　　　　　　　　　　　　　　　//获取版本号                            **版本号计算方法：Versions numbers are integers: 1000000*major + 1000*minor + release.
getLibVersion　　　　　　　　　　　　　　//获取libvirt 版本号　　　　　　　　
getURI　　　　　　　　　　　　　　　　　　　//获取 libvirt 连接URI  地址　　　　　　　　　　　　　
isEncrypted　　　　　　　　　　　　　　//检测连接方式是否加密
isSecure　　　　　　　　　　　　　　　　//检测连接是否安全
isAlive　　　　　　　　　　　　　　　　　//检测是否是连接状态
compareCPU　　　　　　　　　　　　　　//设定CPU模式与主机CPU进行对比
getFreeMemory　　　　　　　　　　　　//返回空间节点内存大小（设定CPU与主机CPU对比之后）　　　　　　
getFreePages　　　　　　　　　　　　//获取指定空闲页表大小
getMemoryParameters　　　　　　　　//获取内存参数类型
getMemoryStats　　　　　　　　　　　　//获取节点内存统计信息
getSecurityModel　　　　　　　　　　//获取当前使用的安全模型
getSysinfo　　　　　　　　　　　　　
getCPUMap　　　　　　　　　　　　　　//获取主机节点CPU的CPU映射
getCPUStats　　　　　　　　　　　　　//获取CPU统计信息
getCPUModelNames　　　　　　　　　　//获取与CPU体系结构匹配的名称列表

# Example-9.py
from __future__ import print_function
import sys
import libvirt
conn = libvirt.open('qemu:///system')
if conn == None:
　　print('Failed to open connection to qemu:///system', file=sys.stderr)
　　exit(1)

host = conn.getHostname()
print('Hostname:'+host)

vcpus = conn.getMaxVcpus(None)
print('Maximum support virtual CPUs: '+str(vcpus))

nodeinfo = conn.getInfo()
print('Model: '+str(nodeinfo[0]))
print('Memory size: '+str(nodeinfo[1])+'MB')
print('Number of CPUs: '+str(nodeinfo[2]))
print('MHz of CPUs: '+str(nodeinfo[3]))
print('Number of NUMA nodes: '+str(nodeinfo[4]))
print('Number of CPU sockets: '+str(nodeinfo[5]))
print('Number of CPU cores per socket: '+str(nodeinfo[6]))
print('Number of CPU threads per core: '+str(nodeinfo[7]))

nodeinfo = conn.getInfo()
numnodes = nodeinfo[4]
memlist = conn.getCellsFreeMemory(0, numnodes)
cell = 0
for cellfreemem in memlist:
　　print('Node '+str(cell)+': '+str(cellfreemem)+' bytes free memory')
　　cell += 1

print('Virtualization type: '+conn.getType())

print('Version: '+str(conn.getVersion()))

print('Libvirt Version: '+str(conn.getLibVersion()));

print('Canonical URI: '+conn.getURI())

print('Connection is encrypted: '+str(conn.isEncrypted()))

print('Connection is secure: '+str(conn.isSecure()))

print("Connection is alive = " + str(conn.isAlive()))

xml = '<cpu mode="custom" match="exact">' + 
'<model fallback="forbid">kvm64</model>' + 
'</cpu>'
retc = conn.compareCPU(xml)
if retc == libvirt.VIR_CPU_COMPARE_ERROR:
　　print("CPUs are not the same or ther was error.")
elif retc == libvirt.VIR_CPU_COMPARE_INCOMPATIBLE:
　　print("CPUs are incompatible.")
elif retc == libvirt.VIR_CPU_COMPARE_IDENTICAL:
　　print("CPUs are identical.")
elif retc == libvirt.VIR_CPU_COMPARE_SUPERSET:
　　print("The host CPU is better than the one specified.")
else:
　　print("An Unknown return code was emitted.")

print("Free memory on the node (host) is " + str(conn.getFreeMemory()) + " bytes.")

pages = [2048]
start = 0
cellcount = 4
buf = conn.getFreePages(pages, start, cellcount)
i = 0
for page in buf:
　　print("Page Size: " + str(pages[i]) + " Available pages: " + str(page))
　　++i

buf = conn.getMemoryParameters()
for parm in buf:
　　print(parm)

buf = conn.getMemoryStats(libvirt.VIR_NODE_MEMORY_STATS_ALL_CELLS)
for parm in buf:
　　print(parm)

model = conn.getSecurityModel()
print(model[0] + " " + model[1])

xmlInfo = conn.getSysinfo()
print(xmlInfo)

map = conn.getCPUMap()
print("CPUs: " + str(map[0]))
print("Available: " + str(map[1]))

stats = conn.getCPUStats(0)
print("kernel: " + str(stats['kernel']))
print("idle: " + str(stats['idle']))
print("user: " + str(stats['user']))
print("iowait: " + str(stats['iowait']))

models = conn.getCPUModelNames('x86_64')
for model in models:
　　print(model)

conn.close()
exit(0)

三、Guest Domains