libvirt学习笔记

node上面的一个软件层，它能虚拟化node，并在其上建立多个虚拟机 

libvirt通过所谓driver和各种不同的hypervisor打交道

传输协议，主要包括以下几种：

1. unix，使用Unix Domain Socket，仅能在本地使用，不加密，示例：
   
   1	qemu+unix:///system?socket=/opt/libvirt/run/libvirt/libvirt-sock

2. ssh，通过SSH隧道进行连接，相当于通过SSH隧道在目标宿主机上执行Unix Domain Socket，示例：
   
   1	qemu+ssh://root@tokyo.gmem.cc/system

3. tcp，通过TCP进行远程连接，通过DIGEST-MD5进行加密，使用SASL/Kerberos进行身份验证，示例：
   
   1	qemu+tcp://tokyo.gmem.cc/system

4. tls，类似于tcp，但是使用SSL对TCP进行加密，需要配置密钥和证书，使用SASL/Kerberos进行身份验证，示例：
   
   1	qemu+tls://tokyo.gmem.cc/system

显示帮助信息：

connect [URI] [--readonly]

（重）连接到一个hypervisor，URI指明如何连接到hypervisor，例如：
xen:///    连接到本地XEN hypervisor
qemu:///system    以root身份连接到本地管理QEMU/KVM domain的hypervisor
qemu:///session   以普通用户身份连接到本地，管理他自己的QEMU/KVM domain
lxc:///    连接到本地的LXC容器

save domain state-file [--bypass-cache] [--xml file] [{--running | --paused}] [--verbose]

保存一个运行中的Domain的内存（而不是磁盘）状态到一个状态文件中，以便后续恢复。一旦被保存，则Domain不再继续运行，分配给Domain的内存可以被其它程序使用。该命令类似于Hibernate功能

state-file    状态文件路径
--bypass-cache    不包含文件系统缓存，会加快保存速度
--verbose    显示保存进度
--running    --paused    在恢复后，将Domain变为运行或暂停状态

可以基于domjobinfo子命令监控进度，或者利用domjobabort子命令取消保存，对当前Terminal发送SIGINT（Ctrl + C）也会取消保存

restore state-file [--bypass-cache] [--xml file] [{--running | --paused}]

将Domain从virsh save状态中还原

domblkstat domain [block-device] [--human]

输出块设备的统计信息
block-device    块设备名称（<target dev='name'/>）或块源文件（<source file='name'/>）
--human    输出易读的格式

输出列说明：
rd_req    读操作次数
rd_bytes    读字节数
wr_req    写操作次数
wr_bytes    写字节数
errs    错误计数
flush_operations    刷出磁盘的操作次数
rd_total_times    读操作总计消耗ns数
wr_total_times    写操作总计消耗ns数
flush_total_times    刷出操作总计消耗ns数

举例： virsh domblkstat fedora-10 vda 

domblkerror domain

显示块设备错误

domblkinfo domain block-device

显示块设备的尺寸相关信息

domblkinfo domain block-device

以表格形式打印与Domian相关联的块设备的简要信息

blockcommit domain path [bandwidth] {[base] | [--shallow]} [top] [--delete] [--wait [--verbose] [--timeout seconds] [--async]]

减少backing镜像链条的长度，将top（最新的）中的变化提交到backing镜像中去。默认的：

1. 此命令flatten整个链条
2. 此命令立即返回，commit操作在后台进行，可以使用blockjob检查进度

path    磁盘的全限定路径，<target dev='name'/>的name或者<source file='name'/>的file
base top    如果指定之一或都指定，则限制commit操作链条的范围
--shallow    提交到top直接的backing镜像
--delete     操作完成后，删除被合并的文件
--wait    阻塞直到操作完成
--timeout    阻塞最多的秒数
--verbose    显示进度的详细信息
--async    尽快的返回，否则在完成commit后还要等待一些清理操作

blockpull domain path [bandwidth] [base] [--wait [--verbose] [--timeout seconds] [--async]]

从backing镜像链生成一个磁盘。默认的：

1. 此命令flatten整个链条
2. 此命令立即返回，commit操作在后台进行，可以使用blockjob检查进度

path    磁盘的全限定路径，<target dev='name'/>的name或者<source file='name'/>的file
base   backing链条中的这一成员保留，仅它与top之间的backing镜像被合并到top

blockcopy domain path dest [bandwidth] [--shallow] [--reuse-external] [--raw] [--wait [--verbose] [{--pivot | --finish}] [--timeout seconds] [--async]]

拷贝磁盘的backing镜像链到dest。默认的：

1. 此命令flatten整个链条
2. 此命令立即返回，commit操作在后台进行，可以使用blockjob检查进度

domain    操作针对的Domain
path     操作针对的磁盘，全限定路径，<target dev='name'/>的name或者<source file='name'/>的file
bandwidth    带宽占用限制，MiB/s
--shallow  共享backing链，即对于base ⇦ snap0 ⇦ snap1，dest与src共享base ⇦ snap0
–pivot    转移，即拷贝完成后，Domain改用dest，不再使用src
--reuse-external    指定该选项则dest必须存在，且内容与resulting backing file等同
--raw    指定dest的格式，如果指定--reuse-external，则使用dest文件的格式

该命令主要用途是虚拟机的在线磁盘映像拷贝（live disk image copying）或镜像（mirroring），在存储迁移时很有用。应用场景包括：

1. 在线磁盘存储迁移
2. 在线磁盘映像、及其backing链的备份
3. 高效的非共享（ non-shared ）存储迁移

一个blockcopy操作可以分为两个阶段：

1. 所有的源磁盘内容被拷贝到dest。在此阶段，任务可以被取消，dest的状态没有保证
2. source、dest的内容变得等同，它们将保持mirrored状态，直到调用blockjob  --abort以结束mirroring

domifstat domain interface-device

输出网络接口的统计信息

输出列说明：
 rx_bytes 收字节数
 rx_packets收IP封包数
 rx_errs 错误封包数
 rx_drop 丢弃封包数
 tx开头的表示发送的统计数据

举例： virsh domifstat fedora-10 tap0 

domif-setlink domain interface-device state [--config]

修改网络接口的状态
state    目标状态，up/down
--config    --persistent    仅仅修改Domain的持久化配置，不立即改变接口状态

domif-getlink domain interface-device [--config]

获得网络接口的状态

domiflist domain [--inactive]

以表格形式打印与Domian相关联的网络接口的简要信息

dommemstat domain [--period seconds] [[--config] [--live] | [--current]]

获得运行中的Domain的内存统计信息

blkdeviotune domain device [[--config] [--live] | [--current]] [[total-bytes-sec] | [read-bytes-sec] [write-bytes-sec]] [[total-iops-sec] | [read-iops-sec] [write-iops-sec]]

查询或者设置Domain的某个块设备的I/O参数：
domain   目标客户机
device    操作针对的磁盘，<target dev='name'/>的name或者<source file='name'/>的file
--total-bytes-sec    设置每秒总计吞吐量的限制，单位Byte
--read-bytes-sec    设置每秒读取吞吐量的限制，单位Byte
--write-bytes-sec   设置每秒写入吞吐量的限制，单位Byte
--total-iops-sec    设置每秒IO操作次数限制
--read-iops-sec    设置每秒读次数限制
--write-iops-sec   设置每秒写次数限制
--live    影响正在运行的客户机
--config    在下次重启后，影响非瞬时Domain
--current    影响当前客户机的状态

domiftune domain interface-device [[--config] [--live] | [--current]] [--inbound average,peak,burst] [--outbound average,peak,burst]

查询或者修改网络接口的带宽参数：
interface-device    目标网络接口
--inbound    --outbound   修改入站还是出站带宽参数，如果都不指定，则执行查询操作。average/peak以KiB/s解释，burst以单次burst消耗的KiB解释
        average  设置网络接口期望的平均速率
        peak 设置峰值速率限制
        burst 以峰值速率爆发式的传送数据，最多连续传送多是KiB
--live    影响当前正在运行的Domain

举例： virsh domiftune fedora-10 tap0 

schedinfo domain [[--config] [--live] | [--current]] [[--set] parameter=value]...

schedinfo [--weight number] [--cap number] domain

显示或者设置Domain进程在宿主机中调度参数，可用参数：
LXC (posix scheduler)：cpu_shares
QEMU/KVM (posix scheduler)：cpu_shares, vcpu_period, vcpu_quota, emulator_period, emulator_quota
Xen (credit scheduler)： weight, cap
ESX (allocation scheduler)：reservation, limit, shares

--live    影响正在运行的Domain
--config    在下次重启后，影响非瞬时Domain
--set    执行设置操作

cpu_shares    处理器占用权重，范围0-262144，负值被转换为正值因此-1即262144，超过最大值都相当于262144
vcpu_period     对调度进行干预的周期，单位us，范围1000-1000000或者0，100000表示100ms干预一次
emulator_period
vcpu_quota    在干预周期内，进程能得到的时间片数，单位us，25000表示在一个周期内得到25ms的时间片
emulator_quota

screenshot domain [imagefilepath] [--screen screenID]

对Domain当前Console进行截屏，并保存到文件

send-key domain [--codeset codeset] [--holdtime holdtime] keycode..

将keycode的序列转换为按键动作，并发送到Domainkey，可用参数：
code可以是数字或者是codeset中的符号名称
--holdtime  每个按键按下持续的毫秒数
--codeset 指定代码集，默认Linux

举例：

migrate [--live] [--offline] [--direct] [--p2p [--tunnelled]] [--persistent] [--undefinesource] [--suspend] [--copy-storage-all] [--copy-storage-inc] [--change-protection] [--unsafe] [--verbose] [--compressed] [--abort-on-error] domain desturi [migrateuri] [graphicsuri] [listen-address] [dname] [--timeout seconds] [--xml file]

将客户机迁移到另外一台宿主机上，可用参数：
--live  在线迁移，迁移期间，源宿主机上的客户机不被暂停
--p2p  使用点对点迁移
--direct  使用直接迁移
--tunnelled  使用隧道迁移
--offline  不在目标机器上启动客户机，也不再源机器上停止客户机。通常用于inactive客户机的迁移
--persistent  让Domain在目标机器上持久化
--undefinesource  取消Domain在源机器上的定义
--suspend  让客户机在目标机器上停留在suspend状态
--copy-storage-all  提示不使用共享存储，进行完整的磁盘拷贝
--copy-storage-inc  提示不使用共享存储，进行增量的磁盘拷贝（即源、目标的共享backing file不拷贝）
注意：上面两个参数要求目标镜像文件存在于目标机器的对应位置
--change-protection  确保在迁移完成前，不得对Domain执行不兼容的配置更改。如果Hypervisor支持，该参数会自动包含，手工指定此参数的话，如果Hypervisor不支持change protection，则迁移操作被libvirt拒绝
--verbose  显示迁移进度
--compressed  对于需要在迁移过程中反复传输的内存页，执行压缩
--abort-on-error  当发生软错误（Soft error，例如I/O错误）时取消迁移
--unsafe  允许不安全的迁移（可能导致数据损坏）
desturi  目标宿主机的连接URI。对于点对点迁移，该参数是源宿主机看到的目标主机的URI；对于普通迁移则是客户端看到的URI
domain  被迁移的客户机名称
dname   在迁移时，修改Domain的名称
--xml  在目标机器上，为Domain指定机器特定的Domain配置信息，例如存储卷的名称（对于同一底层存储两台机器的命名可能不同）
--timeout  如果在线迁移超过指定的秒数，则Domain被强制suspend，然后转入离线迁移，必须和--live联用
listen-address  设置目标主机上的Hypervisor监听迁移请求的地址和端口

注意：

1. Hypervisor可能不支持所有的迁移类型，例如QEMU不支持直接迁移
2. 如果迁移可能导致数据损坏，libvirt可能拒绝迁移请求。例如对于QEMU，除非设置磁盘的缓存模式（cache mode）为none或者存储位于一致性的集群文件系统（GFS或者GPFS），迁移会被拒绝。这时可以使用--unsafe强制迁移

migrate-compcache domain [--size bytes]

设置或者取得在线迁移过程中，重复的用来压缩被传输的内存页的缓存的大小，单位字节
--size 如果指定此参数，则为设置操作，否则为读取操作

migrate-setmaxdowntime domain downtime

设置domain在线迁移时，能够容忍的最大宕机时间，单位毫秒

migrate-setspeed domain bandwidth

设置domain迁移到其它宿主机上时，最大使用的带宽，单位MiB/s

migrate-getspeed domain

获取domain迁移时的最大带宽

attach-device domain FILE [[[--live] [--config] | [--current]] | [--persistent]]

为domain添加一个新的设备
FILE  设备的XML配置，以interface/disk之类的元素为根元素
--config   在永久Domian下次启动时生效
--live  影响运行中的Domain
--current  影响当前Domain状态
注意：--config --live可以联用，但是--current不能和它们联用

attach-disk domain source target [[[--live] [--config] | [--current]] | [--persistent]] [--driver driver] [--subdriver subdriver] [--cache cache] [--type type] [--mode
mode] [--config] [--sourcetype soucetype] [--serial serial] [--wwn wwn] [--rawio] [--address address] [--multifunction] [--print-xml]

添加一个磁盘，参数与磁盘的XML配置元素对应

attach-interface domain type source [[[--live] [--config] | [--current]] | [--persistent]] [--target target] [--mac mac] [--script script] [--model model] [--config]
[--inbound average,peak,burst] [--outbound average,peak,burst]

添加一个磁盘，参数与网络接口的XML配置元素对应

detach-device domain FILE [[[--live] [--config] | [--current]] | [--persistent]]

移除一个设备

detach-disk domain target [[[--live] [--config] | [--current]] | [--persistent]]

移除一个磁盘

detach-interface domain type [--mac mac] [[[--live] [--config] | [--current]] | [--persistent]]

移除一个网络接口

update-device domain file [--force] [[[--live] [--config] | [--current]] | [--persistent]]

更新设备的配置，可用参数：
--force  强制设备更新

change-media domain path [--eject] [--insert] [--update] [source] [--force] [[--live] [--config] | [--current]]

改变光驱或者软驱的媒体（盘），可用参数：
path  光驱/软驱的全限定路径或者名称，例如hdc
source   更换的新媒体镜像的路径
--eject  弹出媒介
--insert  插入媒介

举例：

net-autostart network [--disable]

启用/禁用虚拟网络的自动启动

net-create file

从XML配置创建一个临时的虚拟网络并立即启动

net-define file

从XML配置文件创建一个永久的虚拟网络

net-destroy network

根据名称或者UUID停止一个虚拟网络

net-dumpxml network [--inactive]

导出虚拟网络的XML配置

net-edit network

编辑一个虚拟网络的配置

net-info network

显示一个虚拟网络的详细信息

net-list [--inactive | --all] [--persistent] [<--transient>] [--autostart] [<--no-autostart>]

显示虚拟网络的列表

net-start network

启动一个虚拟网络

net-undefine network

取消虚拟网络的定义

net-update network command section xml [--parent-index index] [[--live] [--config] | [--current]]

更新虚拟网络的指定配置片断，可用参数：
section 片断名称：bridge, domain, ip, ip-dhcp-host, ip-dhcp-range, forward, forward-interface, forward-pf, portgroup, dns-host, dns-srv，这些名称对应了虚拟网络XML配置的相应子代元素
xml  配置片断，要么是XML片断文本，要么是包含XML片断的文件名称
--live  影响正在运行的虚拟网络
--config  在永久虚拟网络重启后生效

snapshot-create domain [xmlfile] {[--redefine [--current]] | [--no-metadata] [--halt] [--disk-only] [--reuse-external] [--quiesce] [--atomic] [--live]}

为domain创建一个快照，创建快照期间客户机通常处于暂停状态。新创建的快照将成为当前快照，可以通过子命令snapshot-current查看。子命令参数：
xmlfile    指定此快照的属性，一般仅仅包含name、description元素，如果指定--disk-only则可以包含disks元素
--halt    Domain在创建快照后，进入停止（inactive）状态
--disk-only    仅仅对磁盘进行快照，与--halt联用则所有没有flush到磁盘的数据丢失
--redefine    如果指定，则snapshot-dumpxml生成的所有元素均有效，可用于跨机器迁移快照层次
--no-metadata    丢弃源数据，快照不被标记为current，除非后续使用--redefine，无法恢复快照
--reuse-external    重用此文件指向的外部快照，目标文件必须存在
--live    创建快照时，客户机将处于运行状态，仅支virsh snapshot-create-as fedora-10 snap2 "snap2" --diskspec=vda,file=$DIR/snap2.vda.qcow2 --disk-only --atomic
持外部检查点

snapshot-create-as domain {[--print-xml] | [--no-metadata] [--halt] [--reuse-external]} [name] [description] [--disk-only [--quiesce]] [--atomic] [[--live] [--memspec memspec]] [--diskspec] diskspec]...

以指定的name和description创建快照
--print-xml    仅创建snapshot-create使用的xmlfile，不进行快照创建
--memspec=[file=]name[,snapshot=type]    控制内存快照的创建方式，type可取值none,internal,external
--diskspec=disk[,snapshot=type][,driver=type][,file=name]    控制--disk-only和外部检查点创建外部文件的方式。此参数可以出现多次（对应Domain配置中磁盘的个数）
--atomic  libvrit保证原子性操作，快照要么完整的创建成功，要么彻底失败

snapshot-current domain {[--name] | [--security-info] | [snapshotname]}

查看和设置当前快照：如果不指定snapshotname，则输出Domain当前快照的XML。否则把snapshotname设置为当前快照
--name    仅仅输出当前快照的名称，而非XML
--security-info    在XML中包含安全性敏感的信息

snapshot-edit domain [snapshotname] [--current] {[--rename] | [--clone]}

编辑snapshotname的XML信息
--current    编辑当前快照，如果同时指定snapshotname，则snapshotname被设置为当前快照
--rename    允许设置快照名称
--clone    改变快照名称后，会创建一份快照元数据的克隆

snapshot-info domain {snapshot | --current}

输出当前快照或者指定快照的基本信息

snapshot-list domain [--metadata] [--no-metadata] [{--parent | --roots | [{--tree | --name}]}] [{[--from] snapshot | --current} [--descendants]] [--leaves] [--no-leaves] p[--inactive] [--active] [--disk-only] [--internal] [--external]

列出Domain所有可用的快照，默认输出列：快照名称、创建时间、Domain的状态

--parent   输出parent列，显示父快照名称
--roots    仅列出没有parent快照的那些快照
--tree    以树状输出结果，显示快照父子关系
--name    仅仅显示快照名称，与--tree互斥
--from    仅仅显示指定快照的子快照，联用--current则显示当前快照的子快照
--descendants    包含所有后代快照
--leaves    仅仅输出没有子代的那些快照
--inactive    --active    根据快照中Domain的状态过滤
--internal   --external    根据内/外部快照过滤

snapshot-dumpxml domain snapshot [--security-info]

显示指定快照的XML

snapshot-parent domain {snapshot | --current}

显示父快照的名称

snapshot-revert domain {snapshot | --current} [{--running | --paused}] [--force]

恢复Domain到指定的快照状态，此最后一次快照以来对Domain的变更将消失
--running    --paused 通常恢复后Domain处于创建快照时的状态，这两个参数可以覆盖之
--force    强制恢复快照

snapshot-delete domain {snapshot | --current} [--metadata] [{--children | --children-only}]

删除Domian的快照
--children   删除指定的快照及其子代
--children-only    仅仅删除子代，指定的快照本身被保留
--metadata    仅仅删除libvirt管理的元数据，不理会快照文件

find-storage-pool-sources type [srcSpec]

返回一个XML，描述所有能够找到的type类型的存储池
srcSpec  包含额外限制条件的XML

find-storage-pool-sources-as type [host] [port] [initiator]

类似上面，host port initiator限制查询条件

pool-autostart pool-or-uuid [--disable]

配置存储池的自动启动

pool-build pool-or-uuid [--overwrite] [--no-overwrite]

构建一个存储池
--overwrite  --no-overwrite 仅仅用于文件系统池，指定覆盖时，如果文件系统已经存在于目标设备上，mkfs也会执行，既有文件系统将被破坏

pool-create file

从配置文件定义并启动一个存储池

pool-create-as name --print-xml type [source-host] [source-path] [source-dev] [source-name] [<target>] [--source-format format]

类似上面，但是通过命令行来指定所需参数：
--print-xml  打印生成的池的XML配置

pool-define file

定义，但不启动池

pool-define-as name --print-xml type [source-host] [source-path] [source-dev] [source-name] [<target>] [--source-format format]

类似上面，但是通过命令行来指定所需参数：
--print-xml 打印生成的池的XML配置

pool-destroy pool-or-uuid

停止一个存储池，池中的数据不会消失

pool-delete pool-or-uuid

销毁池使用的所有资源，但是池本身仍然存在，你可以在其中存储新的卷

pool-dumpxml [--inactive] pool-or-uuid

打印池的配置信息

pool-edit pool-or-uuid

编辑池的XML配置

pool-info pool-or-uuid

显示池的基本信息

pool-list [--inactive] [--all] [--persistent] [--transient] [--autostart] [--no-autostart] [[--details] [<type>]

列出libvirt所知道的全部存储池

pool-name uuid
pool-uuid pool

显示指定uuid对应的池名称，或者显示池名称对应的UUID 

pool-refresh pool-or-uuid

刷新池中卷的列表

pool-start pool-or-uuid

启动一个存储池

pool-undefine pool-or-uuid

解除一个存储池的定义

vol-create pool-or-uuid FILE [--prealloc-metadata]

在池中创建一个卷，对于基于目录/文件系统的池，卷的本质就是一个镜像文件。可用参数：
pool-or-uuid 池的名称或者UUID
FILE  卷的配置XML
--prealloc-metadata  预分配元数据，用于qcow2之类不支持完全分配的镜像格式，该参数可以提高性能

示例： vol-create default definitions/volumes/fedora-10.xml 

vol-create-from pool-or-uuid FILE [--inputpool pool-or-uuid] vol-name-or-key-or-path [--prealloc-metadata]

创建一个卷，使用另外一个卷vol-name-or-key-or-path作为输入

vol-create-as pool-or-uuid name capacity [--allocation size] [--format string] [--backing-vol vol-name-or-key-or-path] [--backing-vol-format string] [--prealloc-metadata]

创建一个卷，从命令行参数读取配置信息

vol-clone [--pool pool-or-uuid] vol-name-or-key-or-path name [--prealloc-metadata]

克隆一个既有的卷，没有vol-create-from强大但是比它简单。可用参数：
--pool  指定在其中创建新卷的池
vol-name-or-key-or-path  被克隆的卷
name  新的卷的名称

vol-delete [--pool pool-or-uuid] vol-name-or-key-or-path

删除一个卷，底层的镜像文件将被删除，示例：

vol-upload [--pool pool-or-uuid] [--offset bytes] [--length bytes] vol-name-or-key-or-path local-file

上传本地文件的内容到一个卷，可用参数：
--pool  目标存储池
vol-name-or-key-or-path  目标卷
local-file  被上传的本地文件
--offset  在存储卷的什么位置开始写入数据
--length  写入数据的长度

vol-download [--pool pool-or-uuid] [--offset bytes] [--length bytes] vol-name-or-key-or-path local-file

下载存储卷中的内容到本地文件

vol-wipe [--pool pool-or-uuid] [--algorithm algorithm] vol-name-or-key-or-path

擦除一个卷的内容，可用参数：
--algorithm  擦除算法：zero nnsa dod bsi gutmann schneier pfitzner7 pfitzner33 random

vol-dumpxml [--pool pool-or-uuid] vol-name-or-key-or-path

打印卷的XML配置，示例：

vol-info [--pool pool-or-uuid] vol-name-or-key-or-path

显示卷的基本信息

vol-list [--pool pool-or-uuid] [--details]

列出一个存储池中的卷，示例：

vol-pool [--uuid] vol-key-or-path

根据卷的名称或者路径，返回其所在存储池的信息
--uuid 返回UUID而不是池名称

vol-path [--pool pool-or-uuid] vol-name-or-key

返回指定卷的路径

vol-name vol-key-or-path
vol-key [--pool pool-or-uuid] vol-name-or-path

查询卷的名称或者key

vol-resize [--pool pool-or-uuid] vol-name-or-path pool-or-uuid capacity [--allocate] [--delta] [--shrink]

重新设定卷的容量，以字节为单位，可用参数：
--allocate  分配空间，否则新容量是稀疏的
capacity  新的容量，如果指定了--delta，则是增加的容量
--shrink  缩小卷大小，不指定此参数，降低容量会报错

指定需要被启动的虚拟机操作系统的类型：
hvm    操作系统设计用来在裸金属（bare metal）上运行，即未修改的操作系统，需要全虚拟化
xen     表示支持Xen3的Guest API的操作系统，别名linux
exe    基于容器的虚拟化
uml   用户模式的Linux

元素属性：
arch    指定被虚拟化的CPU的体系结构
machine    指定机器类型

指定虚拟机固件镜像的（宿主机的）绝对路径。用于Xen全虚拟化、QEMU/KVM的BIOS文件路径设置

元素属性：
readonly    固件是否只读，yes/no
type    rom/pflash，告知hypervisor把固件映射到客户机内存的什么位置，如果loader指定UEFI镜像，则该属性应为pflash
secure    指示固件实现了安全启动（secure boot）特性

此元素可以出现多次，其dev属性可以是fd/hd/cdrom/network，用来确定优先从哪种设备启动虚拟机，写在最前面的那种设备优先级高

如果同一类型的设备配置了多个，它们将依据总线顺序排列，第一个被标记为可启动的。该元素难以细粒度的控制启动顺序，可以使用Per-device的boot元素代替（后者与此元素互斥）

逗号分隔的，Domain进程及虚拟CPU默认能够Pin到的物理CPU序号。可以用-指定范围，^进行排除

Domain进程及虚拟CPU的Pin策略可以由cputune指定，如果cputune的emulatorpin属性被设置，则当前属性被忽略
对于指定了vcpupin的虚拟CPU，当前属性被忽略

启用比最大数量更少的虚拟CPU

指定Domain进程的CPU placement mode，static/auto

用来指定强制的interval，单位毫秒，可取值 [1000, 1000000]之间。在一个period内，Domain中的每个虚拟CPU消耗的带宽不得超过quota

仅QEMU 0.9.4+、LXC 0.9.10+支持

在Linux 64位系统里面，默认内存是以4K的页面（Page）来管理的，当系统有非常多的内存的时候，管理这些内存的消耗就比较大。HugePage使用2M大小的页面来减小管理开销。HugePage管理的内存并不能被Swap，这就避免了swap引发的性能问题。如果系统经常碰到因为swap引发的性能问题可以考虑启用HugePage

告知hypervisor，客户机的内存基于hugepage而不是宿主机Native页大小来分配。从1.2.5开始，可以为每个numa节点更加细致的设置huagepages：
size/unit    指定huge页的大小
nodeset    给于特定numa节点hugepage

如果hypervisor支持，设置此元素可以禁止属于Domain的内存页被swap out

对于QEMU/KVM，使用此设置前你需要设置memtune的hard_limit，并且设置maxMemory=Domain所需内存+QEMU进程本身所需内存。注意：启用locked且设置过多的内存可能导致宿主机内核内存溢出

此元素可以有多个，用来设置Domain针对宿主机每一个块设备的I/O权重。子元素：
path    宿主机块设备文件的路径
weight    针对此块设备，Domain的权重
read_bytes_sec    读吞吐量限制，bytes/s
write_bytes_sec    写吞吐量限制，bytes/s
read_iops_sec    读次数限制，bytes/s
write_iops_sec    写次数限制，bytes/s

用于简化客户机的配置，让它尽量和宿主机CPU匹配。可选值：

1. custom（94.73%性能）：这种模式下虚拟机 CPU 指令集数最少，故性能相对最差，但是它在热迁移时跨不同型号 CPU 的能力最强。此外，custom 模式下支持用户添加额外的指令集
2. host-model（95.84%性能）：libvirt 根据当前宿主机 CPU 指令集从配置文件 /usr/share/libvirt/cpu_map.xml 选择一种最相配的 CPU 型号。在这种 mode 下，虚拟机的指令集往往比宿主机少，性能相对 host-passthrough 要差一点，但是热迁移时，它允许目的节点 CPU 和源节点的存在一定的差异
3. host-passthrough(100%性能）：libvirt 令 KVM 把宿主机的 CPU 指令集全部透传给虚拟机。因此虚拟机能够最大限度的使用宿主机 CPU 指令集，故性能是最好的。但是在热迁移时，它要求目的节点的 CPU 和源节点的一致

关于热迁移，理论上来说：

1. host-passthrough: 要求源节点和目的节点的指令集完全一致
2. host-model: 允许源节点和目的节点的指令集存在轻微差异
3. custom: 允许源节点和目的节点指令集存在较大差异

从实际情况来看，公司不同时间采购的 CPU 型号可能不相同；不同业务对 CPU 型号的要求也有差异。虽然互联网多采用 intel E5 系列的 CPU，但是该系列的 CPU 也有多种型号，常见的有 Xeon，Haswell，IvyBridge，SandyBridge 等等。即使是 host-model，在这些不同型号的 CPU 之间热迁移虚拟机也可能失败。所以从热迁移的角度，在选择 host-mode 时：

1. 需要充分考虑既有宿主机类型，以后采购扩容时，也需要考虑相同问题
2. 除非不存在热迁移的场景，否则不应用选择 host-passthrough
3. host-model 下不同型号的 CPU 最好能以 aggregate hosts 划分，在迁移时可以使用 aggregate filter 来匹配相同型号的物理机
4. 如果 CPU 型号过多，且不便用 aggregate hosts 划分，建议使用 custom mode

指定客户机要求的CPU型号，可用型号的列表在/usr/share/libvirt/cpu_map.xml
如果hypervisor不能使用精确的CPU，libvirt会自动fallback到特性最接近的CPU

属性列表：
fallback，是否允许fallback，可选值allow,forbid，默认allow
vendor_id，设置客户机看到的vendor_id，必须12字符长，典型值AuthenticAMD、GenuineIntel

仅适用于QEMU/KVM，指定客户机的numa拓扑，举例：

 每个cell子元素对应一个numa 节点（cell）：
cpus指定节点对应的CPU范围
memory指定节点本地内存大小
memAccess控制内存被映射为shared还是private，此属性仅针对基于hugepage的内存

磁盘的来源（source）类型。有效值：file,block,dir,network,volume

其中volume表示磁盘的来源是存储池中的一个卷

客户机看到的磁盘类别。有效值：floppy,disk,cdrom,lun，默认disk

仅当type=block|network且protocol=iscsi时；或者type=volume且使用protocol=iscsi、mode=host的source pool时可设置为lun，lun的行为与disk相同，除了来自客户机的SCSI命令被接收并pass through到物理设备。lun仅被raw设备识别，不能被分区识别

如果hypervisor支持多个backend驱动，则name属性指定primary后端驱动的名称，而type则指定一个子类型。例如：

1. xen支持的name有tap、tap2、phy、file，支持type有aio
2. QEMU仅支持name为qemu，而支持raw、bochs、qcow2、qed等type

控制IO缓存策略，有效值包括

1. default 由hypervisor自动选择。qemu-kvm 1.2-默认writethrough。之后的版本，对于客户机驱动ide/scsi/virtio来说，默认值可能是 writethrough
2. none 相当于直接使用宿主机的物理磁盘缓存，性能不错
3. writethrough 数据直接写入磁盘（O_DSYNC）里，不使用缓存；在数据更新时，同时写入缓存Cache和后端存储。此模式的优点是操作简单；缺点是因为数据修改需要同时写入存储，数据写入速度较慢
4. writeback 在数据更新时只写入缓存Cache（不使用O_DSYNC、O_DIRECT）。只在数据被替换出缓存时，被修改的缓存数据才会被写到后端存储。此模式的优点是数据写入速度快，因为不需要写存储；缺点是一旦更新后的数据未被写入存储时出现系统掉电的情况，数据将无法找回
5. directsync，写入磁盘时，qemu-kvm将使用O_DSYNC + O_DIRECT。速度慢
6. unsafe 任何时候都不要在生产环境使用，cache flush不会传播到宿主机，因此任何意外的VM关机都会摧毁虚拟机文件系统

最后两种几乎不会使用

writethrough、none、directsync的安全性好，只要客户机操作系统是现代且行为正常的 —— 必要时会执行flush

writeback的安全性次之，它给提示后端写缓存的存在，依赖于客户机发送必须的flush命令来保证客户机磁盘的数据完整性 —— 这是现代文件系统应有的正常行为。但是，在报告（给客户端应用程序）IO操作完成，到数据提交到宿主机磁盘，存在一个时间窗口。如果宿主机宕机，可能导致数据丢失

unsafe安全性差，和writeback的差异在于，客户机的flush命令被忽略

性能上： writeback > none > writethrough

控制AIO的策略，QEMU支持：

1. threads：用户空间异步IO的实现，其实它不是真正的异步IO，是通过启动一定数量的 blocking IO线程来模拟异步IO
2. native：Kernel native AIO :，Kernel的原生态异步IO实现

native的性能更好

当读取backing文件时，是否将读取的内容复制到当前的镜像文件中，当backing文件位于慢速网络中时可以设置为on

仅用于QEMU/KVM

指定文件系统的来源，有效值包括：
mount    默认值，挂载到客户机的一个宿主机目录，支持LXC、OpenVZ、QEMU/KVM
template    OpenVZ模板
file    一个宿主机文件被作为镜像，挂载到客户机，仅LXC
block    一个宿主机块设备，挂载到客户机，仅LXC
ram    一个内存文件系统
bind    绑定宿主机中的一个目录到客户机的一个目录，仅LXC

指定hypervisor驱动的更多细节，属性列表：
type    如果hypervisor支持多种backend驱动，使用该属性指定primary后端驱动的名称
format    指定格式类型

对于LXC，支持type=loop&format=raw，或者type=nbd；QEMU支持type=path|handle，不支持format

如果设置为true，则宿主机能够检测到并信任来自客户机的关于接口MAC地址变更的报告，并接收filters

对此设置的支持，取决于客户机的网络设备型号，以及宿主机的连接类型。当前只有virtio型号和macvtap宿主机连接类型支持