这是 virsh 命令，可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
virsh - 管理用户界面
概要
维尔什 [OPTION]……[命令字符串]
维尔什 [OPTION] ... 指挥 [ARG] ...
商品描述
这个 维尔什 程序是管理 virsh 来宾域的主要界面。 该程序可以
用于创建、暂停和关闭域。 它也可以用来列出当前
域。 Libvirt 是一个 C 工具包，用于与最近的虚拟化功能进行交互
Linux（和其他操作系统）的版本。 它是 GNU Lesser 下的免费软件
通用公共许可证。 Linux 操作系统的虚拟化意味着能够
在单个硬件系统上同时运行多个操作系统实例，其中
基础资源由Linux实例驱动。 该图书馆旨在提供一个长期
术语稳定的 C API。 目前支持 Xen、QEMU、KVM、LXC、OpenVZ、VirtualBox 和
VMware ESX。
大多数virsh用法的基本结构是：
virsh [选项]... [ARG]...
其中 命令 是下面列出的命令之一； 域 是数字域 ID，或
域名，或域 UUID； 和 ARGS 是命令特定的选项。 有几个
在有关命令作用于所有域的情况下，此规则的例外情况，
整个机器，或直接在 xen 管理程序上。 这些例外对于
这些命令中的每一个。 注意：允许给域赋予数字名称，
但是，这样做将导致只能通过域 id 识别的域。 在
换句话说，如果提供了一个数值，它将被解释为域 ID，而不是作为
一个名字。
这个 维尔什 程序可以用来运行一个 指挥 通过给出命令及其
shell 命令行上的参数，或 命令字符串 这是一个单一的 shell 参数
由多个 指挥 操作及其参数与空格连接，以及
命令之间用分号分隔。 之内 命令字符串, virsh 理解
与 shell 相同的单、双和反斜杠转义，尽管您必须添加另一个
在创建单个 shell 参数时转义的 shell 层。 如果没有给出命令
命令行， 维尔什 然后将启动一个最小的解释器等待你的命令，
和 退出 命令将退出程序。
这个 维尔什 程序理解以下内容 配置.
-c, - 连接 的URI
连接到指定的 的URI, 好像由 联接 命令，而不是默认的
连接。
-d, -调试 LEVEL
在整数处启用调试消息 LEVEL 以上。 LEVEL 范围从 0 到 4
（默认）。 参见文档 VIRSH_DEBUG 下面的环境变量
每个的描述 LEVEL.
-e, - 逃脱 绳子
设置替代转义序列 领事 命令。 默认情况下，telnet 的 ^] 用来。
使用帽子符号时允许的字符有：字母字符、@、[、]、\、^、
_.
-h, - 帮帮我
忽略所有其他参数，并表现得好像 帮助 而是给出了命令。
-k, --保持活动间隔 间隔
设置一个 间隔 （以秒为单位）用于发送 keepalive 消息以检查是否
与服务器的连接仍然有效。 将时间间隔设置为 0 将禁用客户端
保活机制。
-K, --保持活动计数 COUNT个
设置可以发送保持连接消息的次数，而不会得到回复
服务器没有将连接标记为死。 对这个设置没有影响
情况下 间隔 设置为0。
-l, - 日志 文件
将日志详细信息输出到 文件.
-q, - 安静的
避免额外的信息性消息。
-r, - 只读
将初始连接设为只读，就像通过 - 只读 的选项 联接
命令。
-t, - 定时
输出每个命令的经过时间信息。
-v, --version[=短]
忽略所有其他参数，并打印 libvirt 库 virsh 的版本是
来自（哪里
-V, --版本=长
忽略所有其他参数，并打印 libvirt 库 virsh 的版本是
来自以及编译了哪些选项和驱动程序。
附注
桥梁 维尔什 操作依赖于 libvirt 库能够连接到一个已经
运行 libvirtd 服务。 这通常可以使用命令来完成 调用-rc.d 虚拟机
开始.
桥梁 维尔什 由于使用的通信通道，命令需要 root 权限才能运行
与管理程序交谈。 以非 root 身份运行将返回错误。
桥梁 维尔什 命令同步执行，除了shutdown、setvcpus 和setmem。 在
这些案件的事实是 维尔什 程序返回，可能并不意味着动作完成
并且您必须定期轮询以检测来宾是否完成了操作。
维尔什 力求向后兼容。 虽然 帮助 命令只列出
命令的首选用法，如果旧版本 维尔什 支持替代拼写
命令或选项（例如 --隧道 而不是 --隧道)，然后使用脚本
旧的拼写将继续有效。
几个 维尔什 命令采用可选的缩放整数； 如果没有提供比例，那么
命令中列出了默认值（由于历史原因，某些命令默认为
字节，而其他命令默认为 kibibytes）。 以下不区分大小写
后缀可用于选择特定比例：
b、字节字节1
KB 千字节 1,000
k, KiB 千比字节 1,024
MB 兆字节 1,000,000
M, MiB 兆字节 1,048,576
GB 千兆字节 1,000,000,000
G, GiB Gibibyte 1,073,741,824
TB 太字节 1,000,000,000,000
T, TiB 太字节 1,099,511,627,776
PB PB 1,000,000,000,000,000
P, PiB 1,125,899,906,842,624
EB 艾字节 1,000,000,000,000,000,000
E、EiB exbibyte 1,152,921,504,606,846,976
GENERIC 指令
以下命令是通用的，即不是特定于域的。
帮助 [命令或组]
这列出了每个 virsh 命令。 当不带选项使用时，所有命令都是
列出，每行一个，按相关类别分组，显示每个类别的关键字
组。
要仅显示特定组的命令，请将该组的关键字作为
选项。 例如：
virsh # 帮助主机
主机和管理程序（帮助关键字“主机”）：
能力 能力
cpu-models 显示架构的 CPU 模型
连接（重新）连接到管理程序
freecell NUMA 空闲内存
hostname 打印管理程序主机名
qemu-attach 附加到现有的 QEMU 进程
qemu-monitor-command QEMU 监控命令
qemu-agent-command QEMU 客户代理命令
sysinfo 打印管理程序 sysinfo
uri 打印管理程序规范 URI
要显示特定命令的详细信息，请将其名称作为选项
反而。 例如：
virsh # 帮助列表
您的姓名
list - 列出域
概要
列表 [--inactive] [--all]
商品描述
返回域列表。
配置
--inactive 列出非活动域
--all 列出非活动和活动域
退出, 出口
退出这个交互式终端
版本 [--守护进程]
将打印出有关此构建的主要版本信息。 如果 --守护进程 is
指定则 libvirt 守护程序的版本包含在输出中。
例如：
$ virsh 版本
针对库编译：libvirt 1.2.3
使用库：libvirt 1.2.3
使用 API：QEMU 1.2.3
运行管理程序：QEMU 2.0.50
$ virsh 版本 --daemon
针对库编译：libvirt 1.2.3
使用库：libvirt 1.2.3
使用 API：QEMU 1.2.3
运行管理程序：QEMU 2.0.50
针对守护进程运行：1.2.6
cd [目录]
将当前目录更改为 目录. 默认目录为 cd 命令
是主目录，或者，如果没有 主页 环境变量，根
目录。
此命令仅在交互模式下可用。
PWD 将打印当前目录。
联接 [的URI[- 只读]
（重新）-连接到管理程序。 当shell第一次启动时，这是自动的
运行 的URI 命令行上的“-c”选项请求的参数。 这 的URI
参数指定如何连接到管理程序。 文档页面位于
<http://libvirt.org/uri.html> 列出支持的值，但最常见的是：
xen:///
这用于连接到本地 Xen 管理程序
qemu:///系统
以 root 身份在本地连接到监督 QEMU 和 KVM 域的守护进程
qemu:///会话
作为普通用户在本地连接到他自己的一组 QEMU 和 KVM 域
lxc:///
连接到本地 linux 容器
要查找当前使用的 URI，请检查 URI 命令记录如下。
有关远程访问，请参阅文档页面http://libvirt.org/uri.html> 关于如何
制作 URI。 这 - 只读 选项允许只读连接
URI 打印管理程序规范 URI，在 shell 模式下很有用。
主机
打印管理程序主机名。
的sysinfo
打印管理程序 sysinfo 的 XML 表示（如果可用）。
节点信息
返回节点的基本信息，例如 CPU 的数量和类型，以及节点的大小
物理内存。 输出对应于 virNodeInfo 结构。 具体来说，
“CPU 插槽”字段表示每个 NUMA 单元的 CPU 插槽数。 信息
libvirt 显示取决于每个架构可能提供的内容。
节点cpumap [- 漂亮]
显示节点的CPU总数、在线CPU数和列表
在线 CPU。
通过 - 漂亮 在线 CPU 被打印为一个范围而不是一个列表。
nodecpstats [CPU[- 百分]
返回节点的 CPU 统计信息。 如果 CPU 指定，这将打印指定的 cpu
仅统计。 如果 - 百分 指定，这将打印每种类型的百分比
1 秒内的 CPU 统计信息。
节点内存统计 [细胞]
返回节点的内存统计信息。 如果 细胞 指定，这将打印指定
仅单元格统计。
节点挂起 [目标[为期]
将节点（主机）置于系统范围的睡眠状态并调度节点的
实时时钟中断在指定的持续时间后恢复节点
为期 出去了。 目标 指定主机将暂停到的状态，
它可以是“mem”（暂停到 RAM）、“disk”（暂停到磁盘）或“hybrid”（暂停到
RAM 和磁盘）。 为期 指定持续时间（以秒为单位）
主机必须被挂起，至少应该是 60 秒。
节点内存调整 [shm 页面扫描[shm-sleep-毫秒[shm-跨节点合并]
允许您显示或设置节点内存参数。 shm 页面扫描 可
用于设置共享内存服务转到之前要扫描的页数
睡觉; shm-sleep-毫秒 可用于设置共享的毫秒数
内存服务应该在下次扫描前休眠； shm-跨节点合并 指定是否
来自不同 numa 节点的页面可以合并。 当设置为 0 时，只有页面
物理上驻留在同一个NUMA节点的内存区域是可以合并的。 当设置为 1 时，
可以合并来自所有节点的页面。 默认为 1。
备注：目前“共享内存服务”仅表示 KSM（内核相同页面合并）。
能力
打印一个 XML 文档，描述我们当前使用的虚拟机管理程序的功能
连接到。 这包括关于主机能力的部分，在 CPU 和
功能，以及一组可以虚拟化的客户的描述。
更完整的描述见：
<http://libvirt.org/formatcaps.html> XML 还显示了 NUMA 拓扑信息
如果可供使用的话。
领域能力 [虚拟类型[模拟器bin[拱[ ]
打印一个 XML 文档，描述我们所使用的虚拟机管理程序的域功能
连接到使用来自现有域或取自的信息
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 维尔什 能力 输出。 如果您打算创建新域，这可能很有用
并且很好奇它是否可以通过创建一个域来使用 VFIO
具有特定模拟器和架构的管理程序。
每个虚拟机管理程序对需要哪些选项有不同的要求
哪些是可选的。 管理程序可以支持为以下任何一项提供默认值
选项。
这个 虚拟类型 选项指定使用的虚拟化类型。 要使用的值是
要么来自来自域的顶级元素
XML 或在每个中找到的“类型”属性元素来自 维尔什
能力 输出。 这 模拟器bin 选项指定模拟器的路径。 这
要使用的值是域 XML 中的元素或 维尔什
能力 输出。 这 拱 选项指定要用于的架构
领域。 要使用的值是域 XML 中的“arch”属性
元素和子元素或“名称”属性元素
来自 维尔什 能力 输出。 这 指定机器类型
模拟器。 要使用的值是域 XML 中的“机器”属性
元素和子元素或机器列表中的一个 维尔什
能力 特定架构和域类型的输出。
对于 qemu 管理程序，一个 虚拟类型 必须同时提供“qemu”或“kvm”
与 模拟器bin or 拱 为了生成默认输出
. 供应一个 value 将为特定机器生成输出。
注入-nmi 域
将 NMI 注入来宾。
名单 [--不活动 | - 全部[--管理保存[- 标题] { [- 桌子] | - 姓名 | --uuid }
[- 执着的[- 短暂的[--with-托管-保存[--没有管理保存[- 自动开启]
[--无自动启动[--带快照[--无快照[--状态运行[--状态暂停]
[--状态关闭[--状态-其他]
打印有关现有域的信息。 如果没有指定选项，它会打印出来
有关运行域的信息。
列表的示例格式如下：
维尔什 名单
ID 名称 状态
-------------------------------------------------- -
0 域-0 正在运行
2 Fedora 暂停
Name 是域的名称。 ID 域数字 ID。 state 是运行状态
（见下文）。
状态
State 字段列出了域的 8 个状态，以及当前域所在的状态。
运行
域当前正在 CPU 上运行
闲置
域处于空闲状态，未运行或不可运行。 这可能是因为
域正在等待 IO（传统的等待状态）或已进入睡眠状态，因为
它无事可做。
暂停
域已暂停，通常通过管理员运行发生
维尔什 暂停. 当处于暂停状态时，域仍将消耗分配的
资源，如内存，但不符合管理程序调度的条件。
关闭
域正在关闭，即来宾操作系统有
已收到通知，并应正常停止其操作。
关闭 折扣
域未运行。 通常这表示域已关闭
完全，或尚未开始。
坠毁
域崩了，总是暴力的结局。 通常这种状态可以
仅当域已配置为在崩溃时不重新启动时才会发生。
垂死
域正在消亡，但尚未完全关闭或崩溃。
暂停
域已被访客电源管理挂起，例如进入 s3
州。
通常只列出活动域。 要列出不活动的域，请指定 --不活动
or - 全部 列出活动和非活动域。
要进一步过滤域列表，您可以指定一个或多个过滤标志
通过支持 名单 命令。 这些标志按功能分组。 指定一个或
来自组的更多标志启用过滤器组。 注意一些标志的组合
可能没有结果。 支持的过滤标志和组：
坚持
旗 - 执着的 用于在返回的列表中包含持久域。 到
包括瞬态域指定 - 短暂的.
存在 of 管理 保存 图片
要列出具有托管保存图像的域，请指定标志 --with-托管-保存。 对于
没有托管保存图像的域指定 --没有管理保存.
域名 州
以下过滤器标志按状态选择域： --状态运行 HPMC胶囊
运行域， --状态暂停 对于暂停的域， --状态关闭 为转身
域外和 --状态-其他 对于所有其他状态作为后备。
自动启动 域名
要列出自动启动域，请使用该标志 - 自动开启. 用这个列出域
功能禁用使用 --无自动启动.
快照 存在
可以使用标志列出具有快照图像的域 --带快照,
没有快照的域 --无快照.
与旧服务器交谈时，此命令被迫使用一系列 API 调用
具有固有的种族，其中一个域可能不会被列出或可能出现超过
一次，如果它在收集列表时在调用之间更改状态。 较新
服务器没有这个问题。
If --管理保存 指定，然后域管理保存状态（仅
如果他们在 关闭 折扣 状态，所以你需要指定 --不活动 or - 全部
实际列出它们）将显示为 保存 在列表中。 这个标志是可用的
仅使用默认值 - 桌子 输出。 请注意，此标志不会过滤列表
域。
If - 姓名 指定，打印域名而不是表格格式
每行。 如果 --uuid 指定域的 UUID 被打印而不是名称。 旗帜
- 桌子 指定应使用旧表格式的输出。 这是
默认。 所有这些都是相互排斥的。
If - 标题 指定，然后短域描述（标题）打印在
额外的列。 此标志仅可与默认值一起使用 - 桌子 输出。
计费示例：
维尔什 列表 --title
Id 名称 状态 标题
-------------------------------------------------- ------------------------
0 域 0 运行邮件服务器 1
2 Fedora 暂停
接龙 [{[--cellno] 细胞 | - 全部 }]
打印机器上或 NUMA 单元内的可用内存量。 这
freecell 命令可以提供可用内存的三种不同显示中的一种
机器取决于指定的选项。 没有选项，它显示
机器上的总可用内存。 使用 --all 选项，它显示可用内存
在每个单元格和机器上的总可用内存。 最后，用数字
参数或使用 --cellno 加上一个单元格编号，它将显示
仅指定单元格。
免费页面 [{[--cellno] 细胞 [- 页面大小] 页面大小 | - 全部 }]
打印 NUMA 单元格内的可用页数。 细胞 指的是 NUMA
您感兴趣的单元格。 页面大小 是一个缩放整数（见 附注 以上）。
或者，如果 - 全部 使用，有关 NUMA 单元的每个可能组合的信息和
打印出页面大小。
分配 [- 页面大小] 页面大小 [--页数] 页数 [[--cellno] 细胞[- 添加]
[- 全部]
更改页面池的大小 页面大小 在主机上。 如果 - 添加 被指定，那么
页数 页被添加到池中。 然而，如果 - 添加 没有指定，那么
页数 被视为池的新绝对大小（这可用于释放一些
页并缩小池的大小）。 这 细胞 修饰符可用于缩小
修改为单个主机 NUMA 单元。 在光谱的另一端在于 - 全部
它对所有 NUMA 单元执行修改。
cpu-基线 文件 [- 特征[--可迁移]
计算基准 CPU 中给出的所有主机 CPU 都将支持该 CPU . 这
主机 CPU 列表是通过提取所有元素来自. 就这样
可以包含一组由新行甚至一组分隔的元素
完整的打印的元素 能力 命令。 如果 - 特征 is
指定那么生成的 XML 描述将显式包括所有功能
组成 CPU，如果没有此选项，则属于 CPU 型号的功能将不会
列在 XML 描述中。 如果 --可迁移 被指定，阻止的功能
迁移不会包含在生成的 CPU 中。
cpu-比较 文件 [- 错误]
从 XML 比较 CPU 定义与主机 CPU。 XML 可能含有
主机或来宾 CPU 定义。 主机 CPU 定义是元素和
其内容由印刷 能力 命令。 来宾 CPU 定义是
元素及其内容来自域 XML 定义。 有关访客 CPU 的更多信息
定义见：http://libvirt.org/formatdomain.html#elementsCPU>。 如果 - 错误 is
指定，当给定的 CPU 不兼容时，该命令将返回错误
主机 CPU 和提供有关不兼容的更多详细信息的消息将是
打印出来。
cpu 模型 拱
打印指定架构已知的 CPU 型号列表。
回音 [- 贝壳[--xml[ARG...]
回声每个 ARG, 以空格分隔。 如果 - 贝壳 被指定，那么输出将
在需要的地方使用单引号，以便它适合在 shell 上下文中重用。
If --xml 指定，则输出将被转义以在 XML 中使用。
域 指令
以下命令直接操作域，如前所述，大多数命令
将域作为第一个参数。 这 域 可以指定为短整数、名称
或完整的 UUID。
自动开启 [--禁用] 域
将域配置为在启动时自动启动。
选项 --禁用 禁用自动启动。
领事 域 [开发名称[- 安全的[- 力量]
连接来宾的虚拟串行控制台。 可选的 开发名称 参数
指备用控制台、串行或并行设备的设备别名
为客人配置。 如果省略，将打开主控制台。
如果国旗 - 安全的 指定，只有在驱动程序
支持安全控制台处理。 此标志指定服务器必须确保
对控制台设备的独占访问。 可选的 - 力量 可以指定标志，
请求断开任何现有会话，例如在中断的情况下
连接。
创建信息图 文件 [- 安慰[--暂停[--自动销毁[--pass-fds 否，中，...]
从 XML 创建域. 创建 XML 的简单方法是使用
转储xml 命令以获取预先存在的来宾的定义。 域将是
暂停，如果 --暂停 选项由驱动程序使用和支持； 否则它会
正在运行。 如果 - 安慰 请求，创建后附加到控制台。 如果
--自动销毁 被请求，那么在virsh时guest将被自动销毁
关闭与 libvirt 的连接，否则退出。
If --pass-fds 指定，参数是一个逗号分隔的打开文件列表
应该传递给来宾的描述符。 文件描述符将被重新
在来宾中编号，从 3 开始。这仅受基于容器的支持
虚拟化。
例如：
虚拟转储xml > 域.xml
vi domain.xml（或使用其他文本编辑器进行更改）
virsh 创建 domain.xml
定义 文件
从 XML 定义域. 域定义已注册但未注册
开始了。 如果域已经在运行，更改将在下次启动时生效。
说明 域 [[- 居住[--配置] | [- 当前的]][- 标题[- 编辑[--新描述 新建
描述或标题消息]
显示或修改域的描述和标题。 这些值是用户字段
允许存储任意文本数据，以便轻松识别域。 标题
应该很短，虽然它没有强制执行。 （也可以看看 元数据 适用于 XML
基于域元数据。）
旗 - 居住 or --配置 选择此命令适用于实时还是持久
域的定义。 如果两者 - 居住 和 --配置 被指定， --配置
选项优先于获取当前描述和实时配置
和配置在设置描述时更新。 - 当前的 是排他的和
如果没有指定这些，则暗示。
旗 - 编辑 指定具有当前描述或标题内容的编辑器
应该打开，然后将内容保存回来。
旗 - 标题 选择对标题字段而不是描述的操作。
如果两者都不是 - 编辑 和 --新描述 被指定显示注释或描述
而不是被修改。
摧毁 域 [- 优美]
立即终止域 域. 这不会给域操作系统任何机会
做出反应，这相当于在物理机器上拔掉电源线。
在大多数情况下，您会希望使用 关闭 命令代替。 然而，这确实
不删除来宾使用的任何存储卷，如果域是持久的，它
可以稍后重新启动。
If 域 是瞬态的，那么一旦来宾，任何快照的元数据都将丢失
停止运行，但快照内容仍然存在，并且具有相同的新域
name 和 UUID 可以恢复快照元数据 快照创建.
If - 优美 指定时，不要采取极端措施（例如 SIGKILL）
客人在合理的超时后不会停止； 而是返回错误。
动态数据表 域 [块设备[- 人类]
获取正在运行的域的设备块统计信息。 一种 块设备 对应一个独特的
目标名称（ ) 或源文件 ( ) 对于其中之一
连接到的磁盘设备 域 （另见 域名列表 用于列出这些名称）。 在
一个 lxc 或 qemu 域，省略 块设备 概括地产生设备块统计信息
对于整个域。
使用 VHDL 语言编写 - 人类 以获得更人类可读的输出。
这些字段的可用性取决于管理程序。 缺少不受支持的字段
从输出。 如果与较新版本的通信，可能会出现其他字段
libvirtd。
说明 of 领域 （字段按以下顺序出现）：
rd_req - 读取操作的计数
rd_bytes - 读取字节数
wr_req - 写操作计数
wr_bytes - 写入的字节数
errs - 错误计数
flush_operations - 刷新操作的计数
rd_total_times - 读取操作花费的总时间（ns）
wr_total_times - 写操作花费的总时间（ns）
flush_total_times - 刷新操作花费的总时间（ns）
<-- 管理程序提供的其他字段 -->
域名地址 域 [接口[- 满的[- 来源 租赁|代理]
获取正在运行的域的接口列表及其 IP 和 MAC 地址，或
仅针对一个接口的有限输出，如果 接口 被指定。 注意 接口
可以依赖于驱动程序，它可以是来宾操作系统中的名称或您将看到的名称
在域 XML 中。 此外，整个命令可能需要配置访客代理
对于某些驱动程序下的查询域，特别是 qemu。 如果 - 满的 被指定，
当接口有多个地址或别名时，总是显示接口名称，
否则只显示第一个地址的接口名称，“-”代表第一个地址
其他。 这 - 来源 参数指定用于地址的数据源，
当前的“租约”之一读取 DHCP 租约，或“代理”通过一个查询来宾操作系统
代理人。 如果未指定，'lease' 是默认值。
多米司他 域 接口设备
获取正在运行的域的网络接口统计信息。
domif 设置链接 域 接口设备 州 [--配置]
修改域虚拟接口的链路状态。 状态的可能值是
“上和下”。 如果 --配置 被指定，只有持久化配置
出于兼容性目的，域被修改， - 执着的 是别名 --配置.
接口设备 可以是接口的目标名称或 MAC 地址。
domif-getlink 域 接口设备 [--配置]
查询域虚拟接口的链路状态。 如果 --配置 被指定，查询
持久配置，出于兼容性目的， - 执着的 是别名
--配置.
接口设备 可以是接口的目标名称或 MAC 地址。
主旋律 域 接口设备 [[--配置[- 居住] | [- 当前的]][--入站
平均值、峰值、突发、最低值[--出站 平均、峰值、爆发]
设置或查询域的网络接口的带宽参数。 接口设备
可以是接口的目标名称（ ) 或 MAC 地址。
如果不 --入站 or --出站 指定，此命令将查询并显示
带宽设置。 否则，它将设置入站或出站带宽。
平均值、峰值、突发、最低值 与命令相同 附加接口. 值
, 高峰 和 地板 以千字节每秒表示，而 爆裂 is
在单个突发中以千字节表示 高峰 网络 XML 中描述的速度
文档在http://libvirt.org/formatnetwork.html#elementQoS>。
要清除入站或出站设置，请使用 --入站 or --出站 恭敬地
平均值为零。
If - 居住 指定，影响正在运行的客人。 如果 --配置 被指定，影响
下一次启动持久来宾。 如果 - 当前的 被指定，影响当前guest
状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果不
标志被指定，行为因虚拟机管理程序而异。
国家统计局 域 [- 时期 秒] [[--配置[- 居住] | [- 当前的]]
获取正在运行的域的内存统计信息。
根据管理程序的不同，可以返回各种统计信息
对于带有内存气球的 QEMU/KVM，设置可选的 - 时期 到更大的值
秒内小于 0 将允许气球驱动程序返回额外的统计信息
后续会显示 国家统计局 命令。 设置 - 时期 到 0 会
停止气球驱动收集，但不清除气球中的统计信息
司机。 至少需要在主机上运行 QEMU/KVM 1.5。
这个 - 居住, --配置和 - 当前的 标志仅在使用时有效 - 时期
选项以设置气球驱动程序的收集周期。 如果 - 居住 is
指定时，仅会影响正在运行的来宾收集周期。 如果 --配置 is
指定，影响持久来宾的下一次启动。 如果 - 当前的 被指定，
影响当前的客人状态。
以上皆是 - 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果没有标志
指定，行为因来宾状态而异。
错误 域
在块设备上显示错误。 这个命令通常在以下情况下派上用场 主状态 命令
表示域因 I/O 错误而暂停。 这 错误 命令列出所有
块设备处于错误状态以及在每个设备上看到的错误。
域名信息 域 块设备
获取域的块设备大小信息。 一种 块设备 对应一个独特的
目标名称（ ) 或源文件 ( ) 对于其中之一
连接到的磁盘设备 域 （另见 域名列表 用于列出这些名称）。
域名列表 域 [--不活动[- 细节]
打印一个表格，显示所有关联的块设备的简要信息
域。 如果 --不活动 指定，查询将在该设备上使用的块设备
下次启动，而不是当前正在运行的域中使用的那些。 如果 - 细节 is
指定，磁盘类型和设备值也将被打印。 其他上下文
需要一个块设备名称（例如 域名信息 or 快照创建 用于磁盘快照）
将接受此命令打印的目标或唯一源名称。
国内统计 [- 生的[- 执行[- 后盾[- 状态[--cpu-总计[- 气球[--vCPU]
[- 界面[- 堵塞] [[--列表活动[--列表-非活动状态[--列表持久]
[--列表瞬态[--list-运行[--list-暂停[--list-关闭[--list-其他]] |
[域 ...]
获取多个或所有域的统计信息。 没有任何参数此命令打印
所有域的所有可用统计信息。
可以通过列出域来限制要收集统计信息的域列表
作为空格分隔的列表，或通过指定过滤标志之一 - 列表-*。 （该
方法不能组合。）
默认情况下，某些返回的字段可能会转换为更人性化的值
由一组漂亮的打印机。 要抑制此行为，请使用 - 生的 旗。
可以通过特定标志选择各个统计组。 默认全部
返回支持的统计组。 支持的统计组标志是：
- 状态, --cpu-总计, - 气球, --vCPU, - 界面, - 堵塞.
选择 - 状态 组返回以下字段：“state.state”-
VM 的状态，从 virDomainState 枚举返回为数字，“state.reason” - 原因
用于进入给定状态，从对应的 virDomain*Reason 枚举作为 int 返回
给定状态。
--cpu-总计 返回：“cpu.time” - 此域花费的总 CPU 时间（以纳秒为单位），
"cpu.user" - 以纳秒为单位的用户 CPU 时间，"cpu.system" - 系统 CPU 时间
以纳秒为单位
- 气球 返回：“balloon.current” - 当前使用的 kiB 内存，
“balloon.maximum” - 允许的最大内存（以 kiB 为单位）
--vCPU 返回：“vcpu.current” - 当前在线虚拟 CPU 的数量，“vcpu.maximum”
- 在线虚拟 CPU 的最大数量，“vcpu. .state" - 虚拟 CPU 的状态
，作为来自 virVcpuState 枚举的数字，“vcpu. .time” - 花费的虚拟 CPU 时间
虚拟CPU
- 界面 返回：“net.count” - 此域上的网络接口数，
“网。 .name" - 接口名称， “网。 .rx.bytes" - 字节数
收到，“净。 .rx.pkts” - 收到的数据包数量，“net. .rx.errs”-
接收错误的数量，“net. .rx.drop" - 丢弃的接收数据包数量，
“网。 .tx.bytes" - 传输的字节数，"net. .tx.pkts" - 数量
传输的数据包，“net. .tx.errs" - 传输错误的数量，
“网。 .tx.drop" - 丢弃的传输数据包数
- 堵塞 返回有关与每个域关联的磁盘的信息。 使用
- 后盾 flag 扩展此信息以涵盖支持链中的所有资源，
而不是默认将信息限制到每个客人的活动层
盘。 列出的信息包括：“block.count” - 正在使用的块设备数量
列出，“阻止。 .name" - 块设备目标的名称（相同
多个条目的名称，如果 - 后盾 存在），“阻止。 .backingIndex” - 当
- 后盾 存在，与域 XML 中列出的索引
对于支持文件，“阻止。 .path" - 块设备的文件源, 如果是
本地文件或块设备，“block. .rd.reqs" - 读取请求的数量，
“堵塞。 .rd.bytes” - 读取字节数，“块。 .rd.times" - 总时间
(ns) 花费在读取上，“阻止。 .wr.reqs" - 写入请求的数量，
“堵塞。 .wr.bytes” - 写入的字节数，“块。 .wr.times" - 总时间
(ns) 花费在写入上，“阻止。 .fl.reqs" - 总刷新请求，
“堵塞。 .fl.times" - 缓存刷新所花费的总时间 (ns)，"block. .错误”
- 仅限 Xen：'oo_req' 值，“block. .allocation" - 最高写入的偏移量
以字节为单位的扇区，“块。 .capacity" - 源文件的逻辑大小，以字节为单位，
“堵塞。 .physical" - 源文件的物理大小（以字节为单位）
选择特定的统计组并不能保证守护进程支持
选定的统计数据组。 旗帜 - 执行 如果守护进程强制命令失败
不支持所选组。
主列表 域 [--不活动]
打印一个表格，显示所有关联的虚拟接口的简要信息
域。 如果 --不活动 指定，查询将用于的虚拟接口
下一次启动，而不是当前正在运行的域中使用的那些。 其他上下文
需要虚拟接口的 MAC 地址（例如 分离接口 or 多维-
设置链接) 将接受此命令打印的 MAC 地址。
块提交 域 径 [带宽[基地[- 浅[最佳[- 删除[--保持相对]
[- 等待 [--异步[--详细]][- 暂停 秒[- 积极的] [{- 枢 | --保持覆盖}]
通过在顶部提交更改来减少支持映像链的长度
将（快照或增量文件）链接到支持图像中。 默认情况下，此命令
试图拉平整个链条。 如果 基地 和 最佳 被指定为文件
在后备链中，则操作仅限于提交
链的一部分； - 浅 可以代替 基地 指定立即
要提交的最终图像的后备文件。 正在提交的文件
可能在操作开始后立即失效； 使用 - 删除
标志将尝试在成功完成后删除这些无效的文件
提交操作。 当。。。的时候 --保持相对 使用标志，后备文件路径
将保持相对。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 最佳 被省略或指定为活动图像，也可以指定
- 积极的 触发两阶段主动提交。 在第一阶段， 最佳 被复制到
基地 并且只能取消作业，top 仍然包含尚未在 base 中的数据。
在第二阶段， 最佳 和 基地 保持相同，直到调用 块作业 与
--中止 标志（保持顶部作为跟踪从该点开始的变化的活动图像
时间）或 - 枢 标志（使基础成为新的活动图像并使顶部无效）。
默认情况下，该命令尽快返回，整个磁盘的数据是
在后台提交； 可以检查操作的进度
块作业。 但是，如果 - 等待 指定，则此命令将阻塞，直到
操作完成（或为 - 积极的，进入第二阶段），或直到操作
被取消，因为可选 超时 以秒为单位或发送 SIGINT（通常
用“Ctrl-C”）。 使用 --详细 随着 - 等待 将产生周期性状态
更新。 如果触发作业取消， --异步 将控制权返回给用户
尽可能快，否则命令可能会继续阻塞一段时间
直到工作完成清理。 使用 - 枢 是组合的简写 - 积极的
- 等待 带有自动 块作业 - 枢; 并使用 --保持覆盖 是的简写
结合 - 积极的 - 等待 带有自动 块作业 --中止.
径 指定磁盘的完全限定路径； 它对应于一个独特的目标
姓名 （ ) 或源文件 ( ) 对于其中一个磁盘
连接到的设备 域 （另见 域名列表 用于列出这些名称）。 带宽
以 MiB/s 为单位指定复制带宽限制，尽管对于 qemu，它可能只是非零
对于在线域。 指定负值被解释为 unsigned long
长期价值或基本上无限。 管理程序可以选择是否拒绝
值或将其转换为允许的最大值。
块拷贝 域 径 { DEST [格式[--blockdev] | --xml 文件 } [- 浅]
[--重用外部[带宽[- 等待 [--异步[--详细]] [{- 枢 | - 结束}]
[- 暂停 秒[粒度[缓冲区大小]
将磁盘支持映像链复制到目标。 任何一个 DEST 作为目标文件
姓名，或 --xml 带有包含顶级的 XML 文件的名称元素
描述目的地，必须存在。 另外，如果 DEST 给出， 格式
应指定声明目的地的格式（如果 格式 省略，
然后 libvirt 将重用源的格式，或使用 --重用外部 会
被迫探测目标格式，这可能是一个潜在的安全漏洞）。
该命令支持 - 生的 作为布尔标志的同义词 --格式=原始。 使用时
DEST, 目标被视为常规文件，除非 --blockdev 用于发出信号
它是一个块设备。 默认情况下，此命令会展平整个链； 但如果
- 浅 指定，副本共享后备链。
If --重用外部 被指定，那么目的地必须存在并且有足够的
保存副本的空间。 如果 - 浅 与 --重用外部 然后
预先创建的图像必须具有与访客可见相同的访客可见内容
原始图像的后备文件的内容。 这可用于修改
目标上的后备文件名。
默认情况下，复制作业在后台运行，由两个阶段组成。
最初，作业必须从源复制所有数据，在此阶段，作业
只能取消以恢复到源磁盘，不能保证
目的地。 此阶段完成后，源和目标都保留
镜像直到调用 块作业 与 --中止 和 - 枢 标志转向
副本，或没有电话 - 枢 将目的地作为该目的地的忠实副本
时间点。 然而，如果 - 等待 指定，则此命令将阻塞，直到
镜像阶段开始，如果可选，则取消操作 超时 片刻之间
elapses 或 SIGINT 被发送（通常使用“Ctrl-C”）。 使用 --详细 随着 - 等待
将产生定期状态更新。 使用 - 枢 （如同 块作业 - 枢），或
- 结束 （如同 块作业 --中止） 暗示 - 等待，并将另外结束
干净地工作，而不是将事情留在镜像阶段。 如果作业取消是
由超时触发或由 - 结束, --异步 将尽快将控制权交还给用户
尽可能，否则命令可能会继续阻塞一段时间，直到
作业实际上已取消。
径 指定磁盘的完全限定路径。 带宽 指定复制
以 MiB/s 为单位的带宽限制。 指定负值被解释为无符号
long long 值可能本质上是无限的，但更有可能会溢出；
为此目的使用 0 更安全。 指定 粒度 允许微调
当检测到脏区域时将被复制的粒度； 较大的值
触发更少的 I/O 开销，但最终可能会复制更多的数据（默认值
通常是正确的）； 管理程序可能会将此限制为 XNUMX 的幂或属于
一定的范围。 指定 缓冲区大小 将控制可以同时处理多少数据
复制期间的飞行中； 较大的值使用更多的内存，但可能允许更快
完成（默认值通常是正确的）。
块拉 域 径 [带宽[基地[- 等待 [--详细[- 暂停 秒]
[--异步]][--保持相对]
从其后备映像链填充磁盘。 默认情况下，此命令会将
整个链条； 但如果 基地 指定，包含其中一个支持的名称
链中的文件，然后该文件成为新的后备文件，并且只有
链条的中间部分被拉动。 一旦所有从后台请求的数据
图像链已被拉出，磁盘不再依赖于支持的那部分
链。
默认情况下，该命令尽快返回，整个磁盘的数据是
在后台拉； 可以检查操作的进度 块作业.
但是，如果 - 等待 指定，则此命令将阻塞，直到操作
完成或取消操作，如果可选 超时 在几秒钟内过去或
发送 SIGINT（通常使用“Ctrl-C”）。 使用 --详细 随着 - 等待 将
产生定期状态更新。 如果触发作业取消， --异步 将
尽快将控制权交还给用户，否则命令可能会继续执行
再阻塞一会儿，直到工作完成清理。
使用 --保持相对 flag 将保持后备链名称相对。
径 指定磁盘的完全限定路径； 它对应于一个独特的目标
姓名 （ ) 或源文件 ( ) 对于其中一个磁盘
连接到的设备 域 （另见 域名列表 用于列出这些名称）。 带宽
指定以 MiB/s 为单位的复制带宽限制。 指定负值被解释
作为 unsigned long long 值或基本上是无限的。 管理程序可以选择
是否拒绝该值或将其转换为允许的最大值。
黑色调 域 设备 [[--配置[- 居住] | [- 当前的]] [[总字节秒] | [读-
字节秒[写字节秒]] [[总 iops 秒] | [读取 iops 秒[写 iops-sec]]
[[总字节秒最大] | [读取字节秒最大[写入字节秒最大]] [[总 iops-sec-max]
| [读取 iops-sec-max[写入 iops-sec-max]][大小-iops-sec]
设置或查询块设备的块磁盘 io 参数 域. 设备
指定唯一的目标名称 ( ) 或源文件 (
file='name'/>) 用于连接到的磁盘设备之一 域 （另见 域名列表 HPMC胶囊
列出这些名称）。
如果没有指定限制，它会查询当前的 I/O 限制设置。 否则，更改
这些标志的限制： --总字节数秒 指定总吞吐量限制在
每秒字节数。 --读取字节秒 以字节为单位指定读取吞吐量限制
第二。 --写字节秒 以每秒字节数指定写入吞吐量限制。
--总 iops-秒 指定每秒总 I/O 操作限制。 --读取 iops-秒
指定每秒读取 I/O 操作限制。 --write-iops-秒 指定写 I/O
每秒操作限制。 --总字节数秒最大 指定最大总吞吐量
每秒字节数限制。 --读取字节秒最大 指定最大读取吞吐量
每秒字节数限制。 --写入字节秒最大 指定最大写入吞吐量
每秒字节数限制。 --总 iops-秒-最大 指定最大总 I/O
每秒操作限制。 --读取 iops-秒-最大 指定最大读取 I/O
每秒操作限制。 --写入 iops-秒-最大 指定最大写 I/O
每秒操作限制。 --size-iops-秒 指定大小 I/O 操作限制
第二。
旧版本的 virsh 只接受这些带有下划线而不是破折号的选项，
如在 --总字节数秒.
Bytes 和 iops 值是独立的，但只设置一个值（如
--read-bytes-sec) 将该类别中的其他两个重置为无限制。 一个明确的 0
也清除任何限制。 给定总数的非零值不能与非零值混合
读取或写入的零值。
If - 居住 指定，影响正在运行的客人。 如果 --配置 被指定，影响
下一次启动持久来宾。 如果 - 当前的 被指定，影响当前guest
状态。 设置磁盘io参数时 - 居住 和 --配置 标志可能是
给定的，但是 - 当前的 是独家的。 仅用于查询其中之一 - 居住, --配置 or
- 当前的 可以指定。 如果未指定标志，则行为会有所不同，具体取决于
在管理程序上。
块作业 域 径 {[--中止[--异步[- 枢] | [- 信息[- 生的[--字节] |
[带宽]}
管理活动块操作。 共有三种互斥模式： - 信息,
带宽和 --中止. --异步 和 - 枢 暗示中止模式； - 生的 暗示信息
模式; 如果没有给出模式， - 信息 模式假设。
径 指定磁盘的完全限定路径； 它对应于一个独特的目标
姓名 （ ) 或源文件 ( ) 对于其中一个磁盘
连接到的设备 域 （另见 域名列表 用于列出这些名称）。
In --中止 模式，指定磁盘上的活动作业将被中止。 如果 --异步 is
也指定，此命令将立即返回，而不是等待
取消完成。 如果 - 枢 指定，这要求一个活动副本
或活动提交作业被转移到新图像。
In - 信息 模式，将打印指定磁盘上的活动作业信息。 经过
默认情况下，输出是一个人类可读的摘要行； 这种格式可能会改变
未来的版本。 添加 - 生的 以稳定的格式列出结构的每个字段。 如果
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 --字节 标志被设置，然后如果服务器不能提供命令错误
字节/秒分辨率； 省略标志时，原始输出以 MiB/s 和人工列出
可读输出自动选择服务器支持的最佳分辨率。
带宽 可用于为活动作业设置带宽限制。 指定一个
负值被解释为 unsigned long long 值或基本上是无限的。
管理程序可以选择是拒绝该值还是将其转换为最大值
允许值。
块调整大小 域 径 尺寸
在域运行时调整域的块设备的大小， 径 指定
块设备的绝对路径； 它对应于一个唯一的目标名称（
dev='name'/>）或源文件（ ) 对于磁盘设备之一
附于 域 （另见 域名列表 用于列出这些名称）。
尺寸 是一个缩放整数（见 附注 以上）默认为 KiB（1024 块
字节）如果没有后缀。 您必须使用后缀“B”来获取字节（注意
由于历史原因，这不同于 卷调整大小 默认为字节，没有
后缀）。
显示 域 [--包括密码] [[- 类型] 类型]
输出一个 URI，该 URI 可用于通过以下方式连接到域的图形显示
VNC、SPICE 或 RDP。 可以使用
类型 参数（例如“vnc”、“spice”、“rdp”）。 如果 --包括密码 被指定，
SPICE 通道密码将包含在 URI 中。
域名信息 域
显示正在运行的域中已安装文件系统的列表。 该列表包含
挂载点、来宾中挂载设备的名称、文件系统类型和唯一
域 XML 中使用的目标名称 ( ）。
请注意，此命令需要在域中配置并运行来宾代理
来宾操作系统。
domfs冻结 域 [[--挂载点] 挂载点...]
冻结正在运行的域中挂载的文件系统以准备一致
快照。
这个 --挂载点 选项接受一个参数 挂载点，这是一个挂载点路径
要冻结的文件系统。 此选项可多次出现。 如果这不是
指定，每个挂载的文件系统都被冻结。
请注意： 快照创建 命令有一个 --静默 选择冻结和解冻
文件系统自动保持快照一致。 domfs冻结 命令只是
当用户想要利用存储设备的本机快照功能时需要
libvirt 不支持。
解冻 域 [[--挂载点] 挂载点...]
在正在运行的域中解冻已安装的文件系统，这些文件系统已被冻结
domfsfreeze 命令。
这个 --挂载点 选项接受一个参数 挂载点，这是一个挂载点路径
要解冻的文件系统。 此选项可多次出现。 如果这不是
指定，每个挂载的文件系统都被解冻。
多姆夫斯特里姆 域 [- 最低限度 字节[--挂载点 挂载点]
在正在运行的域中的所有已安装文件系统上发出 fstrim 命令。 它丢弃
文件系统未使用的块。 如果 - 最低限度 字节 被指定，它
告诉客户内核连续自由范围的长度。 小于这个可以忽略
（这是一个提示，客人可能不尊重它）。 通过增加这个值，
fstrim 操作将更快地完成具有严重碎片空闲的文件系统
空间，尽管并非所有块都将被丢弃。 默认值为零，表示
“丢弃每个空闲块”。 此外，如果用户只想修剪一个挂载点，它
可以通过可选指定 --挂载点 参数。
域名主机名 域
如果虚拟机管理程序使其可用，则返回域的主机名。
域名信息 域
返回有关域的基本信息。
域 域名或ID
将域名或 id 转换为域 UUID
多米特 域名或uuid
将域名（或 UUID）转换为域 ID
多工作流产 域
中止当前运行的域作业。
工作信息 域 [- 完全的]
返回有关在域上运行的作业的信息。 - 完全的 告诉 virsh 返回
关于最近完成的工作的信息。 已完成作业的统计数据为
一旦读取或重新启动 libvirtd 时自动销毁。 注意时间
为完成迁移返回的信息可能完全无关，除非两者都
源主机和目标主机的时间同步（即 NTP 守护进程正在运行）
两个都）。
域名 域 ID 或 uuid
将域 ID（或 UUID）转换为域名
域名 域 新名字
重命名域。 此命令将当前域名更改为中指定的新名称
第二个论点。
备注: 域必须处于非活动状态且没有快照。
主状态 域 [- 原因]
返回有关域的状态。 - 原因 告诉 virsh 也打印原因
州。
控制 域
返回用于控制域的 VMM 接口的状态。 对于其他州
“ok”或“error”命令还会打印自控制以来经过的秒数
界面进入当前状态。
时间 域 {[- 现在[- 漂亮[- 同步[- 时间 次]}
获取或设置域的系统时间。 当不带任何参数运行时（但是 域),
打印出当前域的系统时间。 这 - 漂亮 修饰符可用于
以更易读的形式打印时间。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 - 时间 次 指定，域的时间不是获取而是设置。 这
- 现在 修饰符的作用就像它是一个别名 - 时间 $现在，这意味着它设置
当前运行在 virsh 主机上的时间。 在这两种情况下（设置和
得到），时间是相对于 UTC 中的 1970-01-01 纪元的秒数。 这 - 同步
稍微修改了设置行为：忽略了经过的时间，但设置的时间是
而是从域的 RTC 读取。 请注意，某些虚拟机管理程序可能需要访客
要配置的代理以获取或设置访客时间。
来自本机的 domxml 格式 配置
转换文件 配置 以由命名的本机来宾配置格式 格式 到
域 XML 格式。 对于 QEMU/KVM 管理程序， 格式 论点必须是 qemu argv。 对于
Xen 管理程序， 格式 争论可能是 xen-xm, xen-xl或 xen-sxpr. 对于 LXC
管理程序 格式 论点必须是 lxc-工具.
domxml 到本地 格式 XML
转换文件 XML 域 XML 格式到本机来宾配置格式
由...命名 格式. 对于 QEMU/KVM 管理程序， 格式 论点必须是 qemu argv。 对于
Xen 管理程序， 格式 争论可能是 xen-xm, xen-xl或 xen-sxpr. 对于 LXC
管理程序 格式 论点必须是 lxc-工具.
倾倒 域 核心文件路径 [--绕过缓存] { [- 居住] | [- 碰撞] | [- 重启] } [--详细]
[--仅内存[- 格式 绳子]
将域的核心转储到文件中进行分析。 如果 - 居住 指定域
继续运行直到核心转储完成，而不是预先暂停。 如果
- 碰撞 指定时，域会因崩溃状态而停止，而不仅仅是
处于暂停状态。 如果 - 重启 指定，成功后重置域
倾倒。 请注意，这三个开关是互斥的。 如果 --绕过缓存 is
指定，保存将避免文件系统缓存，尽管这可能会减慢
手术。 如果 --仅内存 指定，文件为elf文件，只会包含
域的内存和 cpu 公共寄存器值。 如果域使用，这是非常有用的
直接主机设备。 - 格式 绳子 用于指定'memory-only'的格式
转储，和 绳子 可以是其中之一：elf、kdump-zlib(kdump-compressed format with
zlib 压缩）、kdump-lzo（kdump 压缩格式和 lzo 压缩）、
kdump-snappy（kdump-compressed format with snappy-compressed）。
可以使用以下方法监控进度 工作信息 virsh 命令并取消了
多工作流产 命令（由另一个 virsh 实例发送）。 另一种选择是发送 SIGINT
（通常使用“Ctrl-C”）到 virsh 进程运行 倾倒 命令。 --详细 显示器
转储的进度。
注意：某些虚拟机管理程序可能要求用户手动确保对
参数指定的文件和路径 核心文件路径.
转储xml 域 [--不活动[- 安全信息[--更新CPU[--可迁移]
将域信息作为 XML 转储输出到标准输出，这种格式可以被
创建信息图 命令。 可以使用影响 XML 转储的其他选项。 --不活动
告诉 virsh 转储将在域下次启动时使用的域配置
与当前的域配置相反。 使用 - 安全信息 还将
在 XML 转储中包含安全敏感信息。 --更新CPU 更新域
CPU 要求根据主机 CPU。 和 --可迁移 可以请求一个 XML
适用于迁移，即与较旧的 libvirt 版本兼容，并且可能
用内部运行时选项修改。 此选项可能会自动启用其他
选项（--更新CPU, - 安全信息， ...） 有必要的。
编辑 域
编辑域的 XML 配置文件，这将影响下次启动
客人。
这等效于：
virsh dumpxml --inactive --security-info 域> domain.xml
vi domain.xml（或使用其他文本编辑器进行更改）
virsh 定义 domain.xml
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
活动 {[域] { 活动 | - 全部 } [- 环形[- 暂停 秒[--时间戳] | - 列表}
等待一类领域事件发生，并将事件的适当细节打印为
他们发生。 事件可以选择过滤 域。 运用 - 列表 作为
only 参数将提供可能的列表 活动 此客户已知的值，
尽管连接可能不允许注册所有这些事件。 也是
可以使用 - 全部 而不是 活动 注册所有可能的事件类型
一旦。
默认情况下，这条命令是一次性的，一旦有事件发生就返回成功； 你
可以发送 SIGINT（通常通过“Ctrl-C”）立即退出。 如果 - 暂停 is
指定后，命令放弃等待事件 秒 已经过去了。 和
- 环形，该命令打印所有事件，直到超时或中断键。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 --时间戳 使用时，将在事件之前打印人类可读的时间戳。
线程信息 域 [[- 居住[--配置] | [- 当前的]]
显示基本域 IOThreads 信息，包括 IOThread ID 和 CPU
每个 IOThread 的亲和力。
If - 居住 指定，从正在运行的来宾获取 IOThreads 数据。 如果客人是
未运行，返回错误。 如果 --配置 指定，获取IOThreads数据
从持久来宾的下一次引导开始。 如果 - 当前的 被指定或 - 居住 和
--配置 不指定，则根据当前guest获取IOThread数据
州。
iothreadpin 域 线程 共产党员 [[- 居住[--配置] | [- 当前的]]
将域 IOThread 的固定更改为托管物理 CPU。 为了检索一个
所有 IOThreads 的列表，使用 线程信息. 固定一个 线程 指定 共产党员
中列出的 IOThread ID 所需的 线程信息 输出。
共产党员 是物理 CPU 编号的列表。 它的语法是一个逗号分隔的列表和一个
也可以允许使用“-”和“^”（例如“0-4”、“0-3、^2”）的特殊标记。 这 '-'
表示范围，'^' 表示排他性。 如果你想重置iothreadpin
设置，即固定一个 线程 对于所有物理 CPU，只需将 'r' 指定为
共产党员.
If - 居住 指定，影响正在运行的客人。 如果来宾没有运行，则会出现错误
被退回。 如果 --配置 指定，影响持久来宾的下一次启动。
If - 当前的 被指定或 - 居住 和 --配置 未指定，影响当前
客人状态。 两个都 - 居住 和 --配置 可能会给出标志，如果 共产党员 存在，但是
- 当前的 是独家的。 如果未指定标志，则行为会有所不同，具体取决于
管理程序。
备注: 表达式是按顺序计算的，所以 "0-15,^8" 等同于
“9-14,0-7,15”但与“^8,0-15”不同。
线程添加 域 iothread_id [[--配置[- 居住] | [- 当前的]]
使用指定的域向域添加一个新的 IOThread iothread_id。 如果 iothread_id
已经存在，命令将失败。 这 iothread_id 必须大于零。
If - 居住 指定，影响正在运行的客人。 如果来宾没有运行错误
被退回。 如果 --配置 指定，影响持久来宾的下一次启动。
If - 当前的 被指定或 - 居住 和 --配置 未指定，影响当前
客人状态。
iothreaddel 域 iothread_id [[--配置[- 居住] | [- 当前的]]
使用指定的域从域中删除 IOThread iothread_id. 如果 IOThread 是
当前分配给磁盘资源，例如通过 附加磁盘 命令，然后
尝试删除 IOThread 将失败。 如果 iothread_id 不存在错误
会发生。
If - 居住 指定，影响正在运行的客人。 如果来宾没有运行错误
被退回。 如果 --配置 指定，影响持久来宾的下一次启动。
If - 当前的 被指定或 - 居住 和 --配置 未指定，影响当前
客人状态。
管理保存 域 [--绕过缓存] [{- 跑步 | --暂停}] [--详细]
保存并销毁（停止）正在运行的域，以便它可以从同一状态重新启动
晚些时候。 当 virsh 开始 下一次为域运行命令，它将
自动从此保存状态启动。 如果 --绕过缓存 被指定，
save 将避免文件系统缓存，尽管这可能会减慢操作速度。
可以使用以下方法监控进度 工作信息 virsh 命令并取消了
多工作流产 命令（由另一个 virsh 实例发送）。 另一种选择是发送 SIGINT
（通常使用“Ctrl-C”）到 virsh 进程运行 管理保存 命令。 --详细
显示保存进度。
通常，启动托管保存将根据
说明保存完成时域所在的位置； 通过 - 跑步 or
--暂停 标志将允许覆盖哪个状态 开始 应该使用。
这个 域名信息 命令可用于查询域当前是否有任何托管
保存图片。
管理保存删除 域
取出 管理保存 域的状态文件（如果存在）。 这确保了域
下次启动时将进行完全启动。
最大vcpu [类型]
提供此上来宾 VM 支持的最大虚拟 CPU 数
联系。 如果提供，则 类型 参数必须是有效的类型属性
XML 元素。
中央处理器统计 域 [- 全部的[开始[数]
提供域的cpu统计信息。 域应该正在运行。 默认
它显示所有 CPU 的统计信息，以及总数。 用 - 全部的 仅针对总统计数据， 开始
仅用于 CPU 的 per-cpu 统计信息 开始, 数 只 数 CPU 的统计数据。
元数据 域 [[- 居住[--配置] | [- 当前的]][- 编辑[URI[键[集[- 消除]
显示或修改域的自定义 XML 元数据。 元数据是用户定义的 XML
允许在域定义中存储任意 XML 数据。 多个分开
自定义元数据片段可以存储在域 XML 中。 这些碎片由
通过提供的私有 XML 命名空间 URI 争论。 （也可以看看 说明 与
域的文本元数据。）
旗 - 居住 or --配置 选择此命令适用于实时还是持久
域的定义。 如果两者 - 居住 和 --配置 被指定， --配置
选项优先于获取当前描述和实时配置
和配置在设置描述时更新。 - 当前的 是排他的和
如果没有指定这些，则暗示。
旗 - 消除 指定由指定的元数据元素 URI 论点应该
被删除而不是更新。
旗 - 编辑 指定具有元数据的编辑器 URI 论点
应该打开，然后将内容保存回来。 否则新内容
可以通过 集 论据。
通过设置元数据时 - 编辑 or 集 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 键 必须指定并使用参数
为自定义元素添加前缀以将它们绑定到私有命名空间。
如果两者都不是 - 编辑 和 集 指定了对应的 XML 元数据 URI
命名空间被显示而不是被修改。
迁移 [- 居住[- 离线[- 直接的[--p2p [--隧道]][- 执着的]
[--未定义源[- 暂停[--复制-存储-全部[--复制存储公司]
[--更改保护[--不安全[--详细[--压缩[-错误中止]
[--自动收敛] 域 德斯图里 [迁移[图形化[监听地址[名称]
[- 暂停 秒[--xml 文件[--迁移磁盘 磁盘列表]
将域迁移到另一台主机。 添加 - 居住 用于实时迁移； <--p2p> 为
对等 2 对等迁移； - 直接的 直接迁移； 或者 --隧道 用于隧道式
移民。 - 离线 迁移域定义而不启动域
目标，而不在源主机上停止它。 可以使用离线迁移
与不活动的域，它必须与 - 执着的 选项。 - 执着的
将域留在目标主机上， --未定义源 取消定义
源主机上的域，以及 - 暂停 使域在目标上暂停
主办。 --复制-存储-全部 表示使用具有完整磁盘的非共享存储进行迁移
复制， --复制存储公司 表示使用非共享存储进行增量迁移
复制（在源和目标之间共享相同的基本图像）。 在这两种情况下，磁盘
图像必须存在于目标主机上， --复制存储-... 选项只告诉
libvirt 将数据从源主机上的图像传输到在
目标主机上的相同位置。 默认情况下，只有非共享的非只读图像
转入。 用 --迁移磁盘 明确指定磁盘目标列表
通过逗号分隔的传输 磁盘列表 论据。 --更改保护 强制执行
迁移时不会对域进行不兼容的配置更改
进展中; 当管理程序支持时，这个标志被隐式启用，但可以
如果管理程序缺乏更改保护，则明确用于拒绝迁移
支持。 --详细 显示迁移进度。 --压缩 激活
压缩必须在直播期间重复传输的内存页
移民。 -错误中止 如果出现软错误（例如 I/O
错误）发生在迁移过程中。 --自动收敛 直播期间的力量收敛
移民。
备注：单个虚拟机管理程序通常不支持所有可能的迁移类型。
例如，QEMU 不支持直接迁移。
在某些情况下，libvirt 可能会拒绝迁移域，因为这样做可能会导致
数据损坏等潜在问题，因此考虑迁移
不安全。 对于 QEMU 域，如果该域使用磁盘而没有明确地使用磁盘，则可能会发生这种情况
将缓存模式设置为“无”。 迁移此类域是不安全的，除非磁盘映像
存储在一致的集群文件系统上，例如 GFS2 或 GPFS。 如果你确定
迁移是安全的，或者你只是不在乎，使用 --不安全 强制迁移。
名称 用于在迁移过程中将域重命名为新名称，通常也
可以省略。 同样地， --xml 文件 通常省略，但可用于提供
用于目标的替代 XML 文件以提供更大的一组更改
域 XML 的任何特定于主机的部分，例如命名说明
源和目标在访问底层存储方面的差异。
- 暂停 秒 当实时迁移超过那么多时，强制来宾暂停
秒，然后迁移将离线完成。 它只能与
- 居住.
可以通过中断 virsh（通常使用“Ctrl-C”）或通过
多工作流产 从另一个 virsh 实例发送的命令。
这个 德斯图里 和 迁移 参数可用于控制哪个目的地
迁移使用。 德斯图里 对托管迁移很重要，但不用于直接迁移
移民; 迁移 直接迁移需要，但通常可以
为托管迁移自动确定。
备注： 德斯图里 正常迁移和peer2peer迁移的参数不同
语义：
· 正常迁移： 德斯图里 是目标主机的地址，从
客户端机器。
· 点对点迁移： 德斯图里 是目标主机的地址，从
源机。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 迁移 未指定，libvirt 将自动确定管理程序
特定的 URI。 一些管理程序，包括 QEMU，有一个可选的“migration_host”
配置参数（当主机有多个网络接口时很有用）。 如果
这是未指定的，libvirt 通过查找目标主机的名称来确定名称
配置的主机名。
有几个场景指定 迁移 可能会帮助：
· 配置的主机名不正确，或DNS 损坏。 如果主机有主机名
它不会解析为匹配其公共 IP 地址之一，然后 libvirt 将
生成错误的 URI。 在这种情况下 迁移 应该明确
指定，使用 IP 地址或正确的主机名。
· 主机有多个网络接口。 如果一个主机有多个网络
接口，可能希望迁移数据流通过
出于安全或性能原因的特定接口。 在这种情况下
迁移 应明确指定，使用与
要使用的网络。
· 防火墙限制可用的端口。 当 libvirt 生成一个
迁移 URI，它将使用管理程序特定的规则选择一个端口号。 一些
管理程序只需要在防火墙中打开一个端口，而其他端口
需要整个范围的端口号。 在后一种情况下 迁移 可能是
指定选择默认范围之外的特定端口号，以便
遵守本地防火墙策略。
看到http://libvirt.org/migration.html#uris> 有关迁移 URI 的更多详细信息。
可选 图形化 覆盖用于自动的连接参数
在迁移结束时重新连接图形客户端。 如果省略，libvirt 将
根据目标主机IP地址计算参数。 如果客户不
可以直接访问网络虚拟化主机所连接并需要
通过代理连接， 图形化 可用于指定客户端的地址
应该连接到。 URI 的构成如下：
协议://主机名[:端口]/[?参数]
其中协议是“spice”或“vnc”，参数是协议列表
由'&'分隔的特定参数。 当前公认的参数是“tlsPort”
和“tlsSubject”。 例如，
香料://target.host.com:1234/?tlsPort=4567
可选 监听地址 设置目标管理程序的监听地址
端应绑定到传入迁移。 接受 IPv4 和 IPv6 地址
以及主机名（解析在目的地完成）。 一些管理程序没有
支持此功能，如果使用此参数将返回错误。
迁移-setmaxdowntime 域 停机
为正在实时迁移到另一个域的域设置最大可容忍停机时间
主持人。 这 停机 是允许访客停机的毫秒数
实时迁移结束。
迁移-compcache 域 [- 尺寸 字节]
设置和/或获取用于重复压缩的缓存大小（以字节为单位）
在实时迁移期间传输的内存页。 当没有调用时 尺寸， 命令
只打印压缩缓存的当前大小。 什么时候 尺寸 被指定，
要求管理程序将压缩缓存更改为 尺寸 字节，然后是当前
打印尺寸（由于四舍五入，结果可能与要求的尺寸不同）
管理程序）。 这 尺寸 选项应该在域被使用时使用
实时迁移是对迁移进度和压缩次数增加的反应
从 domjobinfo 获得的缓存未命中。
迁移设定速度 域 带宽
为要迁移到的域设置最大迁移带宽（以 MiB/s 为单位）
另一个主机。 带宽 被解释为 unsigned long long 值。 指定一个
负值导致提供给
管理程序。 管理程序可以选择是拒绝该值还是将其转换为
允许的最大值。
迁移获取速度 域
获取域的最大迁移带宽（以 MiB/s 为单位）。
魔音 域 [- 模式 模式[--节点集 节点集] [[--配置[- 居住] | [- 当前的]]
设置或获取域的 numa 参数，对应于的元素
域 XML。 如果没有标志，则显示当前设置。
模式 可以是“strict”、“interleave”和“preferred”之一或任何有效数字
virDomainNumatuneMemMode 枚举，以防守护程序支持它。 对于正在运行的域，
模式不能改变，只有当域是时才能改变节点集
以“严格”模式开始。
节点集 是主机用于运行域的 numa 节点列表。 它的语法
是一个逗号分隔的列表，“-”表示范围，“^”表示排除节点。
If - 居住 指定，设置正在运行的客人的调度程序信息。 如果 --配置 is
指定，影响持久来宾的下一次启动。 如果 - 当前的 被指定，
影响当前的客人状态。
重新启动 域 [- 模式 模式列表]
重新启动域。 这就像域具有 重新启动 命令从
安慰。 该命令在执行重新启动操作后立即返回，这可能
在域实际重新启动之前。
域重新启动时的确切行为由 重启 参数in
域的 XML 定义。
默认情况下，管理程序将尝试选择合适的关闭方法。 指定一个
替代方法， - 模式 参数可以指定一个逗号分隔的列表，其中
包括“acpi”、“agent”、“initctl”、“signal”和“paravirt”。 其中的顺序
驱动程序会尝试每种模式都是未定义的，并且与指定的顺序无关
虚拟的。 为了严格控制排序，一次使用一个模式并重复
命令。
重置 域
立即重置域，无需关闭任何来宾。 重置 模拟电源复位
机器上的按钮，所有来宾硬件都会看到 RST 线路集并重新初始化
内部国家。
备注：在不关闭任何来宾操作系统的情况下重置有数据丢失的风险。
恢复 状态文件 [--绕过缓存[--xml 文件] [{- 跑步 | --暂停}]
从一个域恢复 维尔什 保存 状态文件。 看 保存 获取更多信息。
If --绕过缓存 指定，还原将避免文件系统缓存，尽管
这可能会减慢操作速度。
--xml 文件 通常省略，但可用于提供替代的 XML 文件
在恢复的客户机上使用，仅在主机的特定部分进行更改
域 XML。 例如，它可用于说明文件命名差异
由于在保存来宾后拍摄的磁盘快照而导致的底层存储。
通常，恢复保存的图像将使用保存图像中记录的状态来
在运行或暂停之间做出决定； 通过 - 跑步 or --暂停 旗将
允许覆盖域应该在哪个状态启动。
备注: 为避免破坏域内的文件系统内容，您不应重复使用
保存的状态文件一秒钟 恢复 除非您还恢复了所有存储
卷恢复到与创建状态文件时相同的内容。
保存 域 状态文件 [--绕过缓存[--xml 文件] [{- 跑步 | --暂停}] [--详细]
将正在运行的域（RAM，但不是磁盘状态）保存到状态文件，以便它可以
后来恢复了。 一旦保存，域将不再在系统上运行，因此
为该域分配的内存将可供其他域使用。 维尔什
恢复 从此状态文件中恢复。 如果 --绕过缓存 指定，保存将
避免文件系统缓存，尽管这可能会减慢操作速度。
可以使用以下方法监控进度 工作信息 virsh 命令并取消了
多工作流产 命令（由另一个 virsh 实例发送）。 另一种选择是发送 SIGINT
（通常使用“Ctrl-C”）到 virsh 进程运行 保存 命令。 --详细 显示器
保存进度。
这大致相当于在正在运行的计算机上进行休眠，所有的
相同的限制。 打开的网络连接可能会在恢复时被切断，因为 TCP
超时可能已过期。
--xml 文件 通常省略，但可用于提供替代的 XML 文件
在恢复的客户机上使用，仅在主机的特定部分进行更改
域 XML。 例如，它可用于说明文件命名差异
计划在来宾之后通过底层存储的磁盘快照制作
保存。
通常，恢复保存的图像将根据运行或暂停决定
说明保存完成时域所在的位置； 通过 - 跑步 or
--暂停 标志将允许覆盖哪个状态 恢复 应该使用。
域保存状态文件假设磁盘映像在
创建和还原点。 对于更完整的系统还原点，磁盘所在位置
状态与内存状态一起保存，请参阅 快照 命令族。
保存图像定义 文件 XML [{- 跑步 | --暂停}]
更新将在以下情况下使用的域 XML 文件 后来用于 恢复
命令。 的 XML 参数必须是包含替代 XML 的文件名，其中
仅在域 XML 的特定于主机的部分发生变化。 例如，它可以是
用于解决因创建磁盘快照而导致的文件命名差异
来宾保存后的底层存储。
保存图像记录域是应该恢复到运行状态还是暂停状态
状态。 通常，该命令不会改变记录状态； 通过
- 跑步 or --暂停 标志将允许覆盖哪个状态 恢复 应该使用。
保存图像转储xml 文件 [- 安全信息]
提取保存状态文件时有效的域 XML 文件 是
用创建 保存 命令。 使用 - 安全信息 还将包括安全
敏感信息。
保存图像编辑 文件 [{- 跑步 | --暂停}]
编辑与保存的状态文件关联的 XML 配置 文件 通过创建 保存
命令。
保存图像记录域是应该恢复到运行状态还是暂停状态
状态。 通常，该命令不会改变记录状态； 通过
- 跑步 or --暂停 标志将允许覆盖哪个状态 恢复 应该使用。
这等效于：
virsh save-image-dumpxml 状态文件 > 状态文件.xml
vi state-file.xml（或使用其他文本编辑器进行更改）
virsh 保存图像定义状态文件状态文件 xml
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
调度信息 域 [[--配置[- 居住] | [- 当前的]] [[- 放] 参数=值] ...
调度信息 [- 重量 数[- 帽 数] 域
允许您显示（和设置）域调度程序参数。 可用参数
对于每个管理程序是：
LXC（posix 调度程序）：cpu_shares、vcpu_period、vcpu_quota
QEMU/KVM（posix 调度程序）：cpu_shares、vcpu_period、vcpu_quota、emulator_period、
模拟器配额
Xen（信用调度程序）：权重、上限
ESX（分配调度程序）：预留、限制、份额
If - 居住 指定，设置正在运行的客人的调度程序信息。 如果 --配置 is
指定，影响持久来宾的下一次启动。 如果 - 当前的 被指定，
影响当前的客人状态。
备注：cpu_shares 参数的有效值范围为 0-262144； 负值
被包裹为正数，较大的值被限制在最大值。 因此，-1
是 262144 的有用简写。在 Linux 内核上，值 0 和 1 是
自动转换为最小值 2。
备注：权重和上限参数仅针对 XEN_CREDIT 调度程序和
现在 弃用.
备注: vcpu_period/emulator_period 参数的有效值范围为
1000-1000000 或 0，并且 vcpu_quota/emulator_quota 参数具有有效值
范围为 1000-18446744073709551 或小于 0。任一参数的值 0 为
与不指定该参数相同。
截图 域 [图像文件路径[- 屏幕 屏幕ID]
获取当前域控制台的屏幕截图并将其存储到文件中。 可选，
如果管理程序支持一个域的更多显示， 屏幕ID 允许指定哪个
屏幕将被捕获。 它是屏幕的序号。 多的情况下
显卡，在设备之前枚举头，例如有两个显卡，
两者都有四个头，屏幕 ID 5 寻址第二张卡上的第二个头。
发送密钥 域 [--代码集 代码集[--保持时间 保持时间] 关键代码...
解析 关键代码 序列作为击键发送到 域。 每 关键代码 可以
是来自相应代码集的数值或符号名称。 如果 --保持时间
给定，每次击键都会保持那么多毫秒。 默认代码集
is Linux的，但使用 --代码集 选项允许选择其他代码集。
如果指定了多个键码，它们会同时发送给来宾，并且
它们可能以随机顺序接收。 如果您需要不同的按键，则必须使用
多次发送密钥调用。
Linux的
数值是由 Linux 通用输入事件子系统定义的数值。
符号名称与相应的 Linux 键常量宏名称匹配。
xt 数值是由原始 XT 键盘控制器定义的数值。 不
提供符号名称
属性1
数值是由 AT 键盘控制器定义的数值，设置为 1（又名 XT
兼容集）。 扩展密钥从 属性1 可能与扩展键码不同
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 xt 代码集。 未提供符号名称
属性2
数值为 AT 键盘控制器定义的数值，设置为 2。否
提供符号名称
属性3
数值是由 AT 键盘控制器定义的数值，设置 3（又名
PS/2 兼容套装）。 未提供符号名称
操作系统_x
数值是由 OS-X 键盘输入子系统定义的数值。 这
符号名称与相应的 OS-X 键常量宏名称匹配
xt_kbd
数值是由 Linux KBD 设备定义的数值。 这些是一个变种
在原始 XT 代码集上，但通常使用不同的编码来扩展
键码。 没有提供符号名称。
win32
数值是由 Win32 键盘输入子系统定义的数值。 这
符号名称与对应的 Win32 键常量宏名称匹配
USB 数值是由键盘的 USB HID 规范定义的值
输入。 未提供符号名称
射频 数值是由 RFB 扩展定义的，用于发送原始数据
键码。 这些是 XT 代码集的变体，但扩展键码具有
设置第二个字节的低位，而不是第一个字节的高位。 不
提供了符号名称。
例子
# 使用 xt 代码集发送三个笔画 'k', 'e', 'y'。 这些
# 都是同时按下的，客人可能会收到
# 随机顺序
virsh 发送密钥 dom --codeset xt 37 18 21
# 发送一笔 'right-ctrl+C'
virsh 发送密钥 dom KEY_RIGHTCTRL KEY_C
# 发送一个标签，保持 1 秒
virsh 发送密钥 --holdtime 1000 0xf
发送处理信号 域 ID PID 签名
发送信号 签名 到由识别的过程 PID 在虚拟域中运行
域 ID。 该 PID 是虚拟域命名空间中的进程 ID。
这个 签名 参数可以是整数信号常数，也可以是
符号名称：
"nop", "hup", "int", "quit", "ill",
“陷阱”，“abrt”，“总线”，“fpe”，“杀死”，
"usr1", "segv", "usr2", "pipe", "alrm",
"term", "stkflt", "chld", "cont", "stop",
"tstp", "ttin", "ttou", "urg", "xcpu",
“xfsz”、“vtalrm”、“教授”、“绞盘”、“民意调查”、
"pwr", "sys", "rt0", "rt1", "rt2", "rt3",
“rt4”、“rt5”、“rt6”、“rt7”、“rt8”、“rt9”、
“rt10”、“rt11”、“rt12”、“rt13”、“rt14”、“rt15”、
“rt16”、“rt17”、“rt18”、“rt19”、“rt20”、“rt21”、
“rt22”、“rt23”、“rt24”、“rt25”、“rt26”、“rt27”、
“rt28”、“rt29”、“rt30”、“rt31”、“rt32”
符号名称可以选择以“sig”或“sig_”为前缀，并且可以在
大写或小写。
例子
virsh 发送进程信号 myguest 1 15
virsh 发送进程信号 myguest 1 term
virsh 发送进程信号 myguest 1 sigterm
virsh 发送进程信号 myguest 1 SIG_HUP
设定记忆 域 尺寸 [[--配置[- 居住] | [- 当前的]]
更改来宾域的内存分配。 如果 - 居住 被指定，执行一个
正在运行的访客的内存气球。 如果 --配置 被指定，影响下次启动
执着的客人。 如果 - 当前的 指定，影响当前的客人状态。 两个都
- 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果没有标志
指定，行为因虚拟机管理程序而异。
尺寸 是一个缩放整数（见 附注 以上）; 它默认为 kibibytes（1024 块
字节），除非您提供后缀（和旧的选项名称 --千字节 可
作为已弃用的同义词）。 Libvirt 向上舍入到最接近的千比字节。 一些
管理程序需要比 KiB 更大的粒度，并且请求不是偶数
多个将被四舍五入。 例如，vSphere/ESX 将该参数向上舍入为
兆字节（1024 千字节）。
对于 Xen，如果域是，您只能调整正在运行的域的内存
半虚拟化或运行 PV 气球驱动程序。
对于 LXC，设置的值是 limit_in_bytes 的 cgroups 值或最大值
用户内存量（包括文件缓存）。 查看内存中的内存时
容器，这是 / proc /内存信息 “MemTotal”值。 当查看值时
主机，使用 维尔什 音调 命令。 为了查看当前使用的内存和
允许设置内存的最大值，使用 维尔什 域名信息 命令。
设置用户密码 域 用户 密码 [--加密]
设置密码 用户 来宾域中的帐户。
If --加密 指定时，假定密码已被加密
来宾操作系统所需的方法。
对于 QEMU/KVM，这需要配置并运行来宾代理。
设置最大内存 域 尺寸 [[--配置[- 居住] | [- 当前的]]
更改来宾域的最大内存分配限制。 如果 - 居住 is
指定，影响正在运行的来宾。 如果 --配置 被指定，影响下次启动
执着的客人。 如果 - 当前的 指定，影响当前的客人状态。 两个都
- 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果没有标志
指定，行为因虚拟机管理程序而异。
一些管理程序如 QEMU/KVM 不支持实时更改（尤其是增加）
最大内存限制。 即使是持久的配置更改也可能不会
使用某些虚拟机管理程序/配置（例如，在 QEMU 上启用 NUMA 的域上）执行。
对于复杂的配置更改使用命令 编辑 代替）。
尺寸 是一个缩放整数（见 附注 以上）; 它默认为 kibibytes（1024 块
字节），除非您提供后缀（和旧的选项名称 --千字节 可
作为已弃用的同义词）。 Libvirt 向上舍入到最接近的千比字节。 一些
管理程序需要比 KiB 更大的粒度，并且请求不是偶数
多个将被四舍五入。 例如，vSphere/ESX 将该参数向上舍入为
兆字节（1024 千字节）。
音调 域 [--硬限制 尺寸[--软限制 尺寸[--swap-硬限制 尺寸]
[--min-保证 尺寸] [[--配置[- 居住] | [- 当前的]]
允许您显示或设置域内存参数。 没有标志，当前
显示设置； 带有标志，如果支持，则调整适当的限制
管理程序。 LXC 和 QEMU/KVM 支持 --硬限制, --软限制和
--swap-硬限制. --min-保证 仅由 ESX 管理程序支持。 每一个
这些限制是按比例缩放的整数（请参阅 附注 以上），默认为 kibibytes
（1024 字节的块）如果不存在后缀。 Libvirt 向上舍入到最接近的
千字节。 一些管理程序需要比 KiB 更大的粒度，并要求
不是偶数倍数将被四舍五入。 例如，vSphere/ESX 四舍五入
参数最高为兆字节（1024 千字节）。
If - 居住 指定，影响正在运行的客人。 如果 --配置 被指定，影响
下一次启动持久来宾。 如果 - 当前的 被指定，影响当前guest
状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果不
标志被指定，行为因虚拟机管理程序而异。
对于 QEMU/KVM，参数是整体应用于 QEMU 进程的。 因此，当
计算它们，需要将访客 RAM、访客视频 RAM 和一些内存相加
QEMU 本身的开销。 最后一块很难确定所以需要猜测和
尝试。
对于 LXC，显示的 hard_limit 值是来自 XML 的当前内存设置或
结果来自 维尔什 设定记忆 命令。
--硬限制
来宾可以使用的最大内存。
--软限制
在内存争用期间强制执行的内存限制。
--swap-硬限制
来宾可以使用的最大内存加交换。 这必须不仅仅是困难 -
提供的限值。
--min-保证
保证为来宾分配的最小内存。
将 -1 指定为这些限制的值被解释为无限制。
蓝调 域 [- 重量 重量[--设备权重 设备权重]
[--设备读取iops-秒 设备读取 iops-sec[--设备写入iops-秒 设备写入 iops-
秒[--设备读取字节秒 设备读取字节秒[--设备写入字节秒 设备-
写字节秒] [[--配置[- 居住] | [- 当前的]]
显示或设置 blkio 参数。 QEMU/KVM 支持 - 重量. - 重量 在范围内
[100, 1000]。 在内核 2.6.39 之后，该值可能在 [10, 1000] 范围内。
设备权重 是一个单独的字符串，列出一个或多个设备/权重对，在
/path/to/device,weight,/path/to/device,weight 的格式。 每个重量都在范围内
[100, 1000], [10, 1000] 在内核 2.6.39 之后，或值 0 以从中删除该设备
每个设备的列表。 只修改字符串中列出的设备； 任何现有的
其他设备的每设备权重保持不变。
设备读取 iops-sec 是单个字符串，列出一个或多个 device/read_iops_sec
对，int格式为/path/to/device,read_iops_sec,/path/to/device,read_iops_sec。
每个 read_iops_sec 是一个类型为 unsigned int 的数字，值为 0 以删除该数字
来自 per-decice 列表的设备。 只修改字符串中列出的设备；
其他设备的任何现有每设备 read_iops_sec 保持不变。
设备写入 iops-sec 是列出一个或多个 device/write_iops_sec 的单个字符串
对，int 格式
/path/to/device,write_iops_sec,/path/to/device,write_iops_sec。 每个 write_iops_sec 是
类型为 unsigned int 的数字，值为 0 以从 per-decice 中删除该设备
清单。 只修改字符串中列出的设备； 任何现有的每台设备
其他设备的 write_iops_sec 保持不变。
设备读取字节秒 是单个字符串，列出一个或多个 device/read_bytes_sec
对，int 格式
/path/to/device,read_bytes_sec,/path/to/device,read_bytes_sec。 每个 read_bytes_sec 是
一个类型为 unsigned long long 的数字，值为 0 以从 per- 中删除该设备
决策列表。 只修改字符串中列出的设备； 任何现有的
其他设备的设备 read_bytes_sec 保持不变。
设备写入字节秒 是单个字符串，列出一个或多个 device/write_bytes_sec
对，int 格式
/path/to/device,write_bytes_sec,/path/to/device,write_bytes_sec。 每个 write_bytes_sec
是一个类型为 unsigned long long 的数字，值为 0 以从 per- 中删除该设备
决策列表。 只修改字符串中列出的设备； 任何现有的
其他设备的设备 write_bytes_sec 保持不变。
If - 居住 指定，影响正在运行的客人。 如果 --配置 被指定，影响
下一次启动持久来宾。 如果 - 当前的 被指定，影响当前guest
状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果不
标志被指定，行为因虚拟机管理程序而异。
设置vpu 域 数 [- 最大值] [[--配置[- 居住] | [- 当前的]][- 客人]
更改来宾域中活动的虚拟 CPU 的数量。 默认情况下，此命令
适用于活动的来宾域。 要更改非活动来宾域的设置，
使用 --配置 旗。
这个 数 值可能受主机、管理程序或来自
来宾域的原始描述。 对于 Xen，您只能调整虚拟
如果域是半虚拟化的，则运行域的 CPU。
如果 --配置 指定标志，对存储的 XML 配置进行更改
为来宾域，并且仅在来宾域下次启动时生效。
If - 居住 指定，来宾域必须处于活动状态，并且发生更改
立即地。 这俩 --配置 和 - 居住 标志可以一起指定，如果
由管理程序支持。 如果在来宾完成之前运行此命令
启动时，来宾可能无法处理更改。
If - 当前的 指定，影响当前的客人状态。
当没有给出标志时， - 居住 假定标志并且来宾域必须是
积极的。 在这种情况下，由管理程序决定是否 --配置 标志是
也假设，因此是否调整 XML 配置以使
改变持久。
If - 客人 指定，然后在来宾中修改 CPU 的计数而不是
管理程序。 此标志仅可用于实时域，并且可能需要来宾代理
在来宾中进行配置。
这个 - 最大值 flag 控制可以热插拔的最大虚拟 CPU 数量
下次启动域时。 因此，它只能与 --配置
标志，而不是 - 居住 或者 - 当前的 旗。
关闭 域 [- 模式 模式列表]
优雅地关闭域。 这与域操作系统协调以执行
正常关闭，因此不能保证它会成功，并且可能需要一段时间
可变的时间长度取决于域中必须关闭的服务。
域关闭时的确切行为由 开_关机 参数
在域的 XML 定义中。
If 域 是瞬态的，那么一旦来宾，任何快照的元数据都将丢失
停止运行，但快照内容仍然存在，并且具有相同的新域
name 和 UUID 可以恢复快照元数据 快照创建.
默认情况下，管理程序将尝试选择合适的关闭方法。 指定一个
替代方法， - 模式 参数可以指定一个逗号分隔的列表，其中
包括“acpi”、“agent”、“initctl”、“signal”和“paravirt”。 其中的顺序
驱动程序会尝试每种模式都是未定义的，并且与指定的顺序无关
虚拟的。 为了严格控制排序，一次使用一个模式并重复
命令。
开始 域名或uuid [- 安慰[--暂停[--自动销毁[--绕过缓存]
[--强制启动[--pass-fds 否，中，...]
启动一个（先前定义的）非活动域，或者从最后一个 管理保存 州，
或者，如果不存在 managedsave 状态，则通过全新启动。 如果出现以下情况，域将被暂停
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 --暂停 选项由驱动程序使用和支持； 否则它将运行。
If - 安慰 请求，创建后附加到控制台。 如果 --自动销毁 is
请求，那么当 virsh 关闭其时，guest 虚拟机将被自动销毁
与 libvirt 的连接，或以其他方式退出。 如果 --绕过缓存 被指定，并且
managedsave 状态存在，恢复将避免文件系统缓存，虽然这
可能会减慢操作速度。 如果 --强制启动 指定，然后任何托管保存状态
被丢弃并重新启动。
If --pass-fds 指定，参数是一个逗号分隔的打开文件列表
应该传递给来宾的描述符。 文件描述符将被重新
在来宾中编号，从 3 开始。这仅支持基于容器的
虚拟化。
暂停 域
暂停正在运行的域。 它保存在内存中，但不会再被安排。
简历 域
使域脱离挂起状态。 这将允许先前暂停的
域现在有资格由底层管理程序进行调度。
暂停 域 目标 [- 期间]
将正在运行的域暂停到这些状态之一（可能 目标 值）：
相当于 S3 ACPI 状态的 mem
相当于 S4 ACPI 状态的磁盘
混合 RAM 已保存到磁盘但未关闭电源
这个 - 期间 参数指定域被唤醒之前的秒数
暂停后（另见 唤醒）。 默认为 0 表示无限挂起
时间。 （此功能当前不受任何管理程序驱动程序支持，应该为 0
用过的。）。
请注意，此命令需要在域中配置并运行来宾代理
来宾操作系统。
请注意，至少对于 QEMU，域的进程将在目标
磁盘被使用，当 libvirt 被要求唤醒时将启动一个新进程
领域。 因此，任何运行时更改，例如设备热插拔或内存
设置会丢失，除非进行了此类更改 --配置 旗。
唤醒 域
从 pmsuspended 状态唤醒域（由 dompmsuspend 或从
客人自己）。 将唤醒注入处于 pmsuspended 状态的来宾，而不是
而不是等待先前请求的持续时间（如果有）过去。 这个操作
如果域正在运行，则不一定会失败。
控制台 域
输出用于域的 TTY 控制台的设备。 如果信息不
可用进程将提供退出代码 1。
取消定义 域 [--管理保存[--快照元数据[--nvram] [ {- 贮存 卷 |
--删除所有存储 [--删除快照]} --擦除存储]
取消定义域。 如果域正在运行，这会将其转换为临时域，
没有阻止它。 如果域处于非活动状态，则删除域配置。
这个 --管理保存 标志保证任何托管保存图像（请参阅 管理保存
命令）也被清理。 如果没有该标志，则尝试使用
托管保存图像将失败。
这个 --快照元数据 标志保证任何快照（请参阅 快照列表
命令）在取消定义非活动域时也会被清除。 没有国旗，
尝试使用快照元数据取消定义非活动域将失败。 如果
域处于活动状态，则忽略此标志。
这个 --nvram 标志确保不会留下任何 nvram (/domain/os/nvram/) 文件。 如果
域有一个 nvram 文件并且省略了标志，取消定义将失败。
这个 - 贮存 标志接受一个参数 卷，这是一个逗号分隔的列表
要删除的存储卷的卷目标名称或源路径
未定义的域。 卷可以是未定义的，因此只能在非活动域上删除。
仅在未定义域后才尝试删除卷； 如果不是所有的
请求的卷可以被删除，错误消息指出仍然存在的内容
在后面。 如果在域定义中未找到卷路径，则将其视为
卷已成功删除。 只有存储池中由 libvirt 管理的卷可以
以这种方式删除。 （看 域名列表 与关联的目标名称列表
领域）。 示例：--storage vda,/path/to/storage.img
这个 --删除所有存储 标志指定域的所有存储卷
应该删除。
这个 --删除快照 标志指定与存储关联的任何快照
卷也应该被删除。 需要 --删除所有存储 标志是
假如。 并非所有存储驱动程序都支持此选项，目前只有 rbd。
旗 --擦除存储 指定应该在之前擦除存储卷
和稳定性。
注意：对于非活动域，必须使用域名或 UUID 作为 域.
虚拟机 域 [{- 最大值 | - 积极的} {--配置 | - 居住 | - 当前的}] [- 客人]
打印有关给定的虚拟 CPU 计数的信息 域. 如果没有标志
指定，所有可能的计数都列在一个表中； 否则，输出是有限的
只是请求的数值。 由于历史原因，下表列出了
在可以通过隔离查询的行上标记“当前” - 积极的 旗，
而不是与 - 当前的 旗。
- 最大值 请求有关域可以通过添加的 vcpus 的最大上限的信息
设置vpu，而 - 积极的 显示当前使用情况； 这两个标志不能都是
指定的。 --配置 需要一个持久域并请求有关的信息
下次启动域时， - 居住 需要一个正在运行的域和列表
当前值，和 - 当前的 根据域的当前状态查询
（对应于 - 居住 如果正在运行，或 --配置 如果不活动）； 这三个标志是
互相排斥。
If - 客人 指定，然后从cpu的角度上报
客人。 此标志仅可用于实时域，并且可能需要来宾代理
在来宾中配置。
虚拟机信息 域 [- 漂亮]
返回有关域虚拟 CPU 的基本信息，例如 vCPU 的数量、
运行时间，对物理处理器的亲和力。
通过 - 漂亮, cpu 亲和力显示为范围。
虚拟CPU引脚 域 [虚拟机[共产党员] [[- 居住[--配置] | [- 当前的]]
查询或更改域 VCPU 到主机物理 CPU 的固定。 固定一个
虚拟机，请指定 共产党员; 否则，您可以查询一个 虚拟机 或省略 虚拟机 列出所有在
一旦。
共产党员 是物理 CPU 编号的列表。 它的语法是一个逗号分隔的列表和一个
也可以允许使用“-”和“^”（例如“0-4”、“0-3、^2”）的特殊标记。 这 '-'
表示范围，'^' 表示排他性。 用于固定 虚拟机 对所有身体
cpu 将 'r' 指定为 共产党员。 如果 - 居住 指定，影响正在运行的客人。 如果
--配置 指定，影响持久来宾的下一次启动。 如果 - 当前的 is
指定，影响当前的客人状态。 两个都 - 居住 和 --配置 标志可能是
给定如果 共产党员 存在，但是 - 当前的 是独家的。 如果没有指定标志，
行为因虚拟机管理程序而异。
备注: 表达式是按顺序计算的，所以 "0-15,^8" 等同于
“9-14,0-7,15”但与“^8,0-15”不同。
仿真器引脚 域 [共产党员] [[- 居住[--配置] | [- 当前的]]
查询或更改域模拟器线程到主机物理 CPU 的固定。
参见 虚拟CPU引脚 HPMC胶囊 共产党员.
If - 居住 指定，影响正在运行的客人。 如果 --配置 被指定，影响
下一次启动持久来宾。 如果 - 当前的 被指定，影响当前guest
状态。 两个都 - 居住 和 --配置 可能会给出标志，如果 共产党员 存在，但是
- 当前的 是独家的。 如果未指定标志，则行为会有所不同，具体取决于
管理程序。
显示器 域
输出 VNC 显示的 IP 地址和端口号。 如果信息不
可用进程将提供退出代码 1。
支持装置 指令
以下命令操作与域关联的设备。 这 域 可
指定为短整数、名称或完整的 UUID。 为了更好地理解价值观
允许作为命令阅读文档的选项
<http://libvirt.org/formatdomain.html> 关于设备部分的格式以获取
最准确的一组可接受的值。
附加设备 域 文件 [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
使用设备的 XML 文件中的设备定义将设备附加到域
定义元素如或者作为顶级元素。 见
文档在http://libvirt.org/formatdomain.html#elementsDevices> 了解
设备的 libvirt XML 格式。 如果 --配置 指定命令改变
设备附加的持久域配置下次生效
libvirt 启动域。 对于 cdrom 和软盘设备，此命令仅替换
现有设备中的媒体； 考虑使用 更新设备 对于这种用法。 为了
直通主机设备，另见 nodedev-分离, 如果 PCI 设备没有
使用托管模式。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
备注: 使用部分设备定义 XML 文件可能会导致意外结果，因为
某些字段可能是自动生成的，因此与预期之外的设备匹配。
附加磁盘 域 资源 目标 [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
[--目标总线 总线[- 司机 司机[--子驱动程序 子驱动程序[--io线程 线程[--缓存
缓存[- 类型 类型[- 模式 模式[--来源类型 源类型[--串行 串行[--wwn WWN]
[--拉维奥[- 地址 地址[- 多功能的[--打印-xml]
将新磁盘设备附加到域。 资源 是文件和设备的路径。
目标 控制将磁盘暴露给客户操作系统的总线或设备。 它
表示“逻辑”设备名称； 可选的 目标总线 属性指定
要模拟的磁盘设备类型； 可能的值是特定于驱动程序的，典型的
价值观 IDE, 科学上网, 维蒂奥, Xen的, USB, SATA或 sd, 如果省略，则总线类型为
从设备名称的样式推断（例如，名为“sda”的设备通常会
使用 SCSI 总线导出）。 司机 可 文件, 挖掘 or 物理 用于 Xen 管理程序
取决于访问的类型； 或者 哇 对于 QEMU 模拟器。 进一步详情
驱动程序可以通过使用 子驱动程序. 对于 Xen 子驱动程序 可 AIO, 而对于 QEMU
subdriver应该匹配磁盘源的格式，比如 原 or qcow2.
如果出现以下情况，将使用虚拟机管理程序默认值 子驱动程序 未指定。 然而，默认
可能不正确，尤其是。 对于 QEMU，出于安全原因，它被配置为不
检测磁盘格式。 类型 可以表明 周一, CDROM or 软盘 作为替代
磁盘默认值，尽管此用途仅替换现有虚拟机中的媒体
cdrom 或软盘设备； 考虑使用 更新设备 对于这种用法。 模式 能够
指定两种具体模式 只读 or 可分享的. 源类型 可以指明类型
源（块|文件） 缓存 可以是“默认”、“无”、“直写”之一，
“回写”、“直接同步”或“不安全”。 线程 是范围内的数字
该磁盘可能附加到的域 IOThreads（仅限 QEMU）。 串行 是连续剧
磁盘设备。 WWN 是磁盘设备的wwn。 拉维奥 表示磁盘需要rawio
能力。 地址 是磁盘设备的地址，形式为
pci:domain.bus.slot.function, scsi:controller.bus.unit, ide:controller.bus.unit 或
ccw:cssid.ssid.devno。 Virtio-ccw 设备必须将其 cssid 设置为 0xfe。
多功能 表示指定的 pci 地址是多功能 pci 设备地址。
If --打印-xml 指定，那么将附加的磁盘的 XML 是
改为打印。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。 同样地， --可共享 是的别名
- 模式 可分享的.
附加接口 域 类型 资源 [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
[- 目标 目标[- 苹果电脑 MAC[- 脚本 脚本[- 模型 模型[--入站
平均值、峰值、突发、最低值[--出站 平均、峰值、爆发[- 管理[--打印-xml]
将新的网络接口附加到域。
类型 可以是以下之一：
网络 通过 libvirt 虚拟网络指示连接，
桥 通过主机上的桥接设备指示连接，
直接 指示直接连接到主机的网络接口之一或
桥梁，
主机开发 使用主机上 PCI 设备的直通指示连接。
资源 表示连接的来源。 来源取决于类型
接口：
网络 虚拟网络的名称，
桥 桥接设备的名称，
直接 主机接口或网桥的名称，
主机开发 主机接口的 PCI 地址，格式为
域：总线：插槽。功能。
- 目标 用于指定用于将域连接到的 tap/macvtap 设备
来源。 以“vnet”开头的名称被视为自动生成的
每次连接接口时都会消隐/重新生成。
- 苹果电脑 指定网络接口的MAC地址； 如果 MAC 地址不是
给定，将自动生成一个新地址（并存储在持久性
如果在命令行上给出了“--config”，则配置）。
- 脚本 用于指定附加到要调用的自定义脚本的路径
一个网桥 - 这将被调用而不是默认脚本而不是除了它之外。
这仅对以下接口有效 桥 类型且仅适用于 Xen 域。
- 模型 指定要呈现给域的网络设备模型。
--入站 和 --出站 控制接口的带宽。 至少一个来自
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 , 地板 必须指定对。 另外两个 高峰 和 爆裂 是可选的
所以 "average,peak", "average,,burst", "average,,,floor", "average" 和 ",,,floor" 是
也合法。 值 , 地板 和 高峰 以千字节每秒表示，
而 爆裂 在单个突发中以千字节表示 高峰 速度如中所述
网络 XML 文档位于http://libvirt.org/formatnetwork.html#elementQoS>。
- 管理 仅可用于 主机开发 输入并告诉 libvirt 接口应该
被管理，这意味着通过 libvirt 与主机分离和重新连接。
If --打印-xml 指定，那么将附加的接口的 XML 是
改为打印。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
备注：可选的目标值是要创建为后端的设备的名称
节点上。 如果未提供，将创建名为“vnetN”或“vifN”的设备
自动。
分离设备 域 文件 [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
从域中分离设备，采用与命令相同类型的 XML 描述
附加设备. 对于直通主机设备，另请参见 nodedev-重新附加，如果
设备不使用托管模式。
备注: 所提供的设备 XML 描述应该与它的一样具体
域 XML 中的定义。 用于匹配设备的属性集是
驱动程序内部。 使用部分定义，或尝试分离设备
它不存在于域 XML 中，但与一个共享某些特定属性
即存在，可能会导致意想不到的结果。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
请注意，旧版本的 virsh 使用 --配置 作为别名 - 执着的.
分离磁盘 域 目标 [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
从域中分离磁盘设备。 这 目标 是从域中看到的设备。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
请注意，旧版本的 virsh 使用 --配置 作为别名 - 执着的.
分离接口 域 类型 [- 苹果电脑 MAC] [[[- 居住[--配置] | [- 当前的]] |
[- 执着的]]
从域中分离网络接口。 类型 可以是 网络 表示一个
物理网络设备或 桥 表示设备的网桥。 推荐
使用 MAC 如果有多个接口，则用于区分接口的选项
出现在域中。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 如果未指定标志，则使用其行为取决于
管理程序驱动程序。
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
请注意，旧版本的 virsh 使用 --配置 作为别名 - 执着的.
更新设备 域 文件 [- 力量] [[[- 居住[--配置] | [- 当前的]] | [- 执着的]]
更新与关联的设备的特性 域, 基于设备
XML 中的定义 文件。 该 - 力量 选项可用于强制设备更新，
例如，弹出 CD-ROM，即使它被锁定/安装在域中。 见
文档在http://libvirt.org/formatdomain.html#elementsDevices> 了解
设备的 libvirt XML 格式。
If - 居住 指定，影响正在运行的域。 如果 --配置 被指定，影响
下次启动持久域。 如果 - 当前的 被指定，影响当前
域状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 不指定任何标志与指定相同 - 当前的.
出于兼容性目的， - 执着的 表现得像 --配置 对于离线域，
和喜欢 - 居住 --配置 对于正在运行的域。
请注意，旧版本的 virsh 使用 --配置 作为别名 - 执着的.
备注: 使用部分设备定义 XML 文件可能会导致意外结果，因为
某些字段可能是自动生成的，因此与预期之外的设备匹配。
改变媒体 域 径 [- 喷射[- 插入[- 更新[资源[- 力量] [[- 居住]
[--配置] | [- 当前的]][--打印-xml[- 堵塞]
更换 CDROM 或软盘驱动器的媒体。 径 可以是完全限定的路径或
唯一目标名称 ( ) 的磁盘设备。 资源 指定路径
要插入或更新的媒体。 旗帜 - 堵塞 允许设置支持类型
如果块设备用作 CDROM 或软盘驱动器而不是文件的介质。
- 喷射 表示媒体将被弹出。 - 插入 表示媒体将
已插入。 资源 必须指定。 如果设备有源（例如
文件='媒体'>），和 资源 没有指定， - 更新 等于 - 喷射。 如果
设备没有来源，并且 资源 被指定， - 更新 等于 - 插入。 如果
设备有源，并且 资源 被指定， - 更新 表现得像组合
- 喷射 和 - 插入. 如果没有 - 喷射, - 插入和 - 更新 被指定，
- 更新 默认使用。 这 - 力量 选项可用于强制媒体更改。
If - 居住 指定，更改正在运行的来宾的实时配置。 如果 --配置 is
指定，更改持久配置，在下次启动时观察到效果。 - 当前的
可以是其中之一或两者 生活 和 配置, 取决于管理程序的实现。
以上皆是 - 居住 和 --配置 可以给出标志，但是 - 当前的 是独家的。 如果没有标志
指定，行为因虚拟机管理程序而异。 如果 --打印-xml is
指定，将用于更改媒体的 XML 被打印而不是更改
媒体。
节点开发 指令
以下命令操作旨在传递到的主机设备
来宾域通过域中的元素部分。 一个节点设备密钥
通常由总线名称后跟其地址指定，在它们之间使用下划线
所有组件，例如 pci_0000_00_02_1、usb_1_5_3 或 net_eth1_00_27_13_6a_fe_00。 这
节点开发列表 给出了 libvirt 已知的主机设备的完整列表，尽管这
包括无法分配给访客的设备（例如，尝试分离
控制主机硬盘控制器的 PCI 设备，来宾的磁盘映像位于其中
live 可能会导致主机系统锁定或重新启动）。
有关节点设备定义的更多信息，请参阅：http://libvirt.org/formatnode.html>.
主机及其来宾域不能同时使用直通设备，也不能同时使用直通设备。
由多个活跃的客人一次。 如果PCI 设备的描述包括
属性 管理='是'，并且管理程序驱动程序支持它，那么设备在
托管模式，并尝试在活动来宾中使用该直通设备将
自动表现得好像 nodedev-分离 （来宾启动，设备热插拔）和 节点开发-
重新连接 （访客停止，设备热拔出）在正确的点被调用。 如果 PCI 设备
未标记为托管，则必须手动将其分离，客人才能使用它，并且
手动重新连接以返回主机。 此外，如果手动分离设备，
那么主机不会在没有匹配重新连接的情况下重新获得对设备的控制，即使
客人以托管模式使用设备。
nodedev-创建 文件
在主机节点上创建一个设备，然后可以将其分配给虚拟机。
通常，libvirt 能够自动确定哪些主机节点可用
使用，但这允许注册 libvirt 没有的主机硬件
自动检测。 文件 包含顶级的 xml 描述
节点设备。
nodedev-销毁 设备
销毁（停止）主机上的设备。 设备 可以是设备名称或 wwn 对
“wwnn,wwpn”格式（目前仅适用于 vHBA）。 请注意，这会使 libvirt 退出
管理主机设备，甚至可能使该设备无法被其他人使用
物理主机，直到重新启动。
nodedev-分离 节点开发 [- 司机 后端驱动程序]
分离 节点开发 来自主机，以便客人可以通过
直通。 这与 nodedev-重新附加, 并自动完成
管理的设备。 出于兼容性目的，此命令也可以拼写
nodedev-分离.
不同的后端驱动程序希望设备绑定到不同的虚拟设备。
例如，QEMU 的“kvm”后端驱动程序（默认）期望设备被绑定
到 pci-stub，但它的“vfio”后端驱动程序希望设备绑定到 vfio-pci。
这个 - 司机 参数可用于指定所需的后端驱动程序。
节点开发转储XML 设备
转储一个给定节点设备的 XML 表示，包括这样的
信息如设备名称、哪条总线拥有设备、供应商和产品 ID，
以及 libvirt 可以使用的设备的任何功能（例如设备重置是否为
支持的）。 设备 可以是“wwnn,wwpn”格式的设备名称或 wwn 对（仅
适用于 HBA）。
节点开发列表 帽 - 树
列出节点上 libvirt 已知的所有可用设备。 帽 用来
要按功能类型过滤列表，类型必须用逗号分隔，例如
--cap pci,scsi, 有效的能力类型包括'system', 'pci', 'usb_device', 'usb',
'net', 'scsi_host', 'scsi_target', 'scsi', 'storage', 'fc_host', 'vports',
'scsi_generic'。 如果 - 树 被使用，输出被格式化为一棵树，代表
每个节点的父节点。 帽 和 - 树 相互排斥。
nodedev-重新附加 节点开发
声明 节点开发 不再被任何客人使用，并且主机可以恢复
设备的正常使用。 对于处于托管模式的 PCI 设备，这是自动完成的
和 USB 设备，但必须明确完成以匹配任何明确的 nodedev-分离.
节点开发重置 节点开发
触发设备重置 节点开发，在之间传输节点设备之前很有用
来宾直通或主机。 Libvirt 通常会在以下情况下隐式执行此操作
需要，但此命令允许在需要时进行显式重置。
VIRTUAL 网络 指令
以下命令操作网络。 Libvirt 能够定义虚拟
然后可以由域使用并链接到实际网络设备的网络。 更多
有关此功能的详细信息，请参阅文档：
<http://libvirt.org/formatnetwork.html> . 许多用于虚拟网络的命令都是
类似于用于域的那些，但命名虚拟网络的方法是
它的名称或 UUID。
网络自动启动 网络 [--禁用]
将虚拟网络配置为在引导时自动启动。 这 --禁用 选项
禁用自动启动。
网络创建 文件
从 XML 创建瞬态（临时）虚拟网络 文件 并实例化
（启动）网络。 请参阅文档http://libvirt.org/formatnetwork.html>
获取 libvirt 使用的 XML 网络格式的描述。
网络定义 文件
定义不活动的持久虚拟网络或修改现有的持久虚拟网络
从 XML 文件.
网络破坏 网络
销毁（停止）由其名称指定的给定临时或持久虚拟网络
或 UUID。 这立即生效。
网络转储xml 网络 [--不活动]
将虚拟网络信息作为 XML 转储输出到标准输出。 如果 --不活动 is
指定，那么物理功能不会扩展到它们相关的虚拟
功能。
网络编辑 网络
编辑网络的 XML 配置文件。
这等效于：
virsh net-dumpxml --inactive network > network.xml
vi network.xml（或使用其他文本编辑器进行更改）
virsh 网络定义 network.xml
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
网络事件 {[网络] 活动 [- 环形[- 暂停 秒[--时间戳] | - 列表}
等待一类网络事件发生，并打印适当的事件细节
当它们发生时。 事件可以选择过滤 网络。 运用 - 列表 as
唯一的参数将提供可能的列表 活动 此客户已知的值，
尽管连接可能不允许注册所有这些事件。
默认情况下，这条命令是一次性的，一旦有事件发生就返回成功； 你
可以发送 SIGINT（通常通过“Ctrl-C”）立即退出。 如果 - 暂停 is
指定后，命令放弃等待事件 秒 已经过去了。 和
- 环形，该命令打印所有事件，直到超时或中断键。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 --时间戳 使用时，将在事件之前打印人类可读的时间戳。
网络信息 网络
返回有关的基本信息 网络 目的。
网表 [--不活动 | - 全部] { [- 桌子] | - 姓名 | --uuid } [- 执着的]
[<--瞬态>] [- 自动开启] [<--无自动启动>]
返回活动网络列表，如果 - 全部 指定这也将包括
已定义但不活动的网络，如果 --不活动 指定只有不活动的人会
被列出。 您可能还想通过以下方式过滤返回的网络 - 执着的 列出
执着的人， - 短暂的 列出临时的， - 自动开启 列出
启用了自动启动的那些，以及 --无自动启动 列出自动启动的那些
禁用。
If - 姓名 指定，打印网络名称而不是表格格式
每行。 如果 --uuid 指定网络的 UUID 被打印而不是名称。 旗帜
- 桌子 指定应使用旧表格式的输出。 这是
默认。 所有这些都是相互排斥的。
注意：在与旧服务器通信时，此命令强制使用一系列 API
具有固有竞争的调用，其中可能未列出池或可能出现更多
如果在收集列表时在调用之间更改状态，则不止一次。 较新
服务器没有这个问题。
网名 网络 UUID
将网络 UUID 转换为网络名称。
网络启动 网络
启动（先前定义的）非活动网络。
网络未定义 网络
取消定义持久网络的配置。 如果网络处于活动状态，请使其
短暂的。
网络用户名 网络名称
将网络名称转换为网络 UUID。
网络更新 网络 命令 部分 XML [--父索引 指数] [[- 居住[--配置] |
[- 当前的]]
使用更改更新现有网络定义的给定部分
可选择立即生效，无需销毁和重新启动
网络。
命令 是“add-first”、“add-last”、“add”（add-last的同义词）、“delete”之一，
或“修改”。
部分 是“网桥”、“域”、“ip”、“ip-dhcp-host”、“ip-dhcp-range”之一，
“forward”、“forward-interface”、“forward-pf”、“portgroup”、“dns-host”、“dns-txt”或
“dns-srv”，每个部分都由 xml 元素层次结构的串联命名
导致元素被改变。 例如，“ip-dhcp-host”将改变一个
包含在 a 中的元素里面的元素的元素
网络。
XML 是正在更改的类型的完整 xml 元素的文本（例如
”
完整的 xml 元素。 消除歧义是通过查看第一个字符来完成的
提供的文本 - 如果第一个字符是“<”，则为 xml 文本，如果第一个字符
不是“<”，它是包含要使用的 xml 文本的文件的名称。
这个 --父索引 选项用于指定几个父元素中的哪一个
请求的元素在（从 0 开始）。 例如，一个 dhcp 元素可以在任何
多个之一网络中的元素； 如果未提供父索引，则
“最合适的” 元素将被选中（通常是唯一一个已经
有一个元素），但如果 --父索引 给出，那个特定的实例
将得到修改。
If - 居住 指定，影响正在运行的网络。 如果 --配置 被指定，影响
持久网络的下一次启动。 如果 - 当前的 被指定，影响
当前网络状态。 两个都 - 居住 和 --配置 可以给出标志，但是 - 当前的 is
独家的。 不指定任何标志与指定相同 - 当前的.
net-dhcp-租约 网络 [MAC]
获取连接到给定虚拟机的所有网络接口的 dhcp 租用列表
网络 或仅针对一个接口的有限输出，如果 MAC 已指定。
接口 指令
以下命令操作主机接口。 通常，这些主机接口然后可以
在域内按名称使用元素（例如系统创建的桥
接口），但不要求将主机接口绑定到任何特定的
来宾配置 XML。
许多用于主机接口的命令与用于域的命令类似，并且
命名接口的方法是通过其名称或 MAC 地址。 但是，使用 MAC
地址 Iface 参数仅在该地址唯一时才有效（如果接口和
网桥共享相同的 MAC 地址（通常是这种情况），然后使用该 MAC 地址
由于歧义而导致错误，您必须改用名称）。
接口桥 接口 桥 [--无stp[延迟[--没有开始]
创建一个名为的桥接设备 桥, 并附加现有的网络设备 接口
到新桥。 新网桥默认立即启动，启用 STP
延迟为0； 这些设置可以改变 --无stp, --没有开始和一个
整数秒数 延迟. 所有IP地址配置 接口 会
移动到新的桥接设备。
参见 iface-unbridge 用于撤消此操作。
界面定义 文件
定义不活动的持久物理主机接口或修改现有的持久物理主机接口
一个来自 XML 文件.
iface-销毁 接口
销毁（停止）给定的主机接口，例如通过运行“if-down”来禁用它
主动使用的接口。 这立即生效。
iface转储xml 接口 [--不活动]
将主机接口信息作为 XML 转储输出到 stdout。 如果 --不活动 is
指定，则输出反映了将要执行的接口的持久状态
下次启动时使用。
界面编辑 接口
编辑主机接口的 XML 配置文件。
这等效于：
virsh iface-dumpxml iface > iface.xml
vi iface.xml（或使用其他文本编辑器进行更改）
virsh iface-定义 iface.xml
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
界面列表 [--不活动 | - 全部]
返回活动主机接口的列表。 如果 - 全部 指定这也将
包括已定义但不活动的接口。 如果 --不活动 仅指定不活动的
将列出。
界面名称 接口
将主机接口 MAC 转换为接口名称，如果 MAC 地址在所有接口中是唯一的
主机的接口。
接口 指定接口MAC地址。
iface-mac 接口
将主机接口名称转换为 MAC 地址。
接口 指定接口名称。
界面启动 接口
启动（先前定义的）主机接口，例如通过运行“if-up”。
iface-unbridge 桥 [--没有开始]
拆除名为的桥接设备 桥, 将其底层接口释放回
正常使用，并将所有 IP 地址配置从桥接设备移动到
底层设备。 除非重新启动底层接口 --没有开始 is
展示; 这个标志是为了对称而存在，但通常不推荐。
参见 接口桥 用于创建桥梁。
iface-未定义 接口
取消定义非活动主机接口的配置。
界面开始
创建当前主机接口设置的快照，稍后可以提交
(iface 提交) 或恢复 (iface-回滚）。 如果快照已经存在，那么这个
命令将失败，直到前一个快照已提交或恢复。
如果对外部主机接口进行任何外部更改，则会导致未定义的行为
快照开始和最终提交之间的 libvirt API 或
回滚。
iface 提交
声明自上次以来的所有更改 界面开始 作为工作，并删除回滚
观点。 如果尚未启动接口快照，则此命令将
失败。
iface-回滚
将所有主机接口设置恢复到上次记录的状态 界面开始.
如果尚未启动接口快照，则此命令将失败。
重新启动主机也可用作隐式回滚点。
储存 POOL 指令
以下命令操作存储池。 Libvirt 有能力管理
各种存储解决方案，包括文件、原始分区和特定于域的格式，
用于提供作为虚拟机内设备可见的存储卷。 更多
有关此功能的详细信息，请参阅文档
<http://libvirt.org/formatstorage.html> . 池的许多命令类似于
用于域的那些。
查找存储池源 类型 [源规范]
返回描述所有可能可用的存储池源的 XML
创建或定义给定的存储池 类型。 如果 源规范 提供，它是一个
包含 XML 的文件以进一步限制对池的查询。
并非所有存储池都支持这种方式的发现。 此外，对于那些做
支持发现，只需要特定的 XML 元素才能返回有效的
数据，而其他元素甚至某些元素的属性被忽略，因为它们
没有必要根据搜索条件找到池。 以下列表
支持的 类型 选项和预期的最小 XML 元素用于执行
搜索。
对于“netfs”或“gluster”池，所需的最小预期 XML 是
具有描述 IP 地址或主机名的“name”属性的元素
找到游泳池。 “端口”属性将被忽略，任何其他提供的 XML 也将被忽略
元素 源规范.
对于“逻辑”池， 源规范 文件被忽略，虽然如果
前提是该文件必须至少存在。
对于“iscsi”池，所需的最小预期 XML 是元素与
“name”属性描述用于查找池的 IP 地址或主机名
（iSCSI 服务器地址）。 可选地，可以提供“端口”属性，尽管
它将默认为 3260。可选地，一个带有“名称”的 XML 元素
可以提供属性以进一步将 iSCSI 目标搜索限制为特定的
多 iqn iSCSI 存储池的启动器。
查找存储池源作为 类型 [主持人[端口[发起者]
而不是提供 源规范 XML 文件 查找存储池源 使用这个命令
选项以便让 virsh 使用可选的生成查询 XML 文件
论据。 该命令将返回相同的输出 XML 查找存储池源.
使用 VHDL 语言编写 主持人 描述用于网络存储的特定主机，例如 netfs，
gluster 和 iscsi 类型 池。
使用 VHDL 语言编写 端口 进一步限制用于连接的网络端口，如果
特定存储后端所需，例如 iSCSI。
使用 VHDL 语言编写 发起者 进一步限制iscsi 类型 池搜索到特定目标
发起人。
池自动启动 池或 uuid [--禁用]
配置是否 池 应该会在开机时自动启动。
池构建 池或 uuid [--覆盖[--无覆盖]
建立一个给定的池。
可选项 --覆盖 和 --无覆盖 只能用于 池构建 文件系统或
磁盘池。 对于文件系统池，如果它们都没有指定， 池构建 &
目录。 如果 --无覆盖 被指定，它探测以确定一个文件系统
目标设备上已经存在，如果存在则返回错误，或者使用 mkfs
如果没有，请格式化目标设备。 如果 --覆盖 被指定，mkfs 总是被执行
并且目标设备上的任何现有数据都将被无条件覆盖。 对于磁盘
池，如果它们都没有被指定或 --无覆盖 被指定， 池构建 将
使用 'parted --print' 来确定磁盘之前是否已经有标签
试图创造一个。 只有当磁盘还没有一个磁盘时，才会有一个标签
创建。 如果 --覆盖 已指定或已确定磁盘未
已经有一个，'parted mklabel' 将用于创建格式的标签
如果未为池指定，则由池源格式类型或“dos”指定。
池创建 文件 [- 建造] [[--覆盖] | [--无覆盖]]
从 XML 创建并启动池对象 文件.
[- 建造] [[--覆盖] | [--无覆盖]] 执行一个 池构建 在创建之后
以消除对构建池的后续命令的需要。 这 --覆盖
和 --无覆盖 标志遵循相同的规则 池构建. 如果只是 - 建造 is
提供，那么 池构建 不带标志调用。
池创建作为 姓名 类型 [--打印-xml[--源主机 主机[--源路径 径]
[--源开发 径[--源名称 姓名[- 目标 径[--源格式 格式]
[--auth 类型 认证类型 --auth-用户名 用户名 --秘密使用 用法] [[--适配器名称
姓名] | [--适配器-wwnn --适配器-wwpn[--适配器父 亲]][- 建造]
[[--覆盖] | [--无覆盖]]
创建并启动池对象 姓名 从原始参数。 如果 --打印-xml is
指定，然后在不创建池的情况下打印池对象的 XML。
否则，池具有指定的 类型。 使用时 池创建作为 对于一池
类型 “磁盘”，在磁盘上找到的现有分区 --源开发 径 将习惯
填充磁盘池。 因此，建议使用 池定义为 和 水池-
建立 与 --覆盖 以便正确初始化磁盘池。
[--源主机 主机] 为由存储支持的池提供源主机名
远程服务器（池类型 netfs、iscsi、rbd、sheepdog、gluster）。
[--源路径 径] 提供支持的池的源目录路径
目录（池类型目录）。
[--源开发 径] 为物理设备支持的池提供源路径
（池类型 fs、logical、disk、iscsi、zfs）。
[--源名称 姓名] 为由命名的存储支持的池提供源名称
元素（池类型逻辑、rbd、sheepdog、gluster）。
[- 目标 径]是存储池映射到主机文件的路径
系统。
[--源格式 格式] 提供有关池格式的信息（池类型
fs、netfs、磁盘、逻辑）。
[--auth 类型 认证类型 --auth-用户名 用户名 --秘密使用 用法] 提供
为存储池生成身份验证凭据所需的元素。 这
认证类型 是 iscsi 的第一章 类型 用于 rbd 的池或 ceph 类型 池。
[--适配器名称 姓名] 定义要用于 scsi_host 的 scsi_hostN 适配器名称
适配器类型池。
[--适配器-wwnn --适配器-wwpn [--适配器父 亲]] 将 wwnn 和 wwpn 定义为
用于 fc_host 适配器类型池。 父级可选地提供名称
要用于 vHBA 的 scsi_hostN 节点设备。
[- 建造] [[--覆盖] | [--无覆盖]] 执行一个 池构建 在创建之后
以消除对构建池的后续命令的需要。 这 --覆盖
和 --无覆盖 标志遵循相同的规则 池构建. 如果只是 - 建造 is
提供，那么 池构建 不带标志调用。
池定义 文件
定义一个不活动的持久存储池或修改现有的持久存储池
XML 文件.
池定义为 姓名 类型 [--打印-xml[--源主机 主机[--源路径 径]
[--源开发 径[--源名称 姓名[- 目标 径[--源格式 格式]
[--auth 类型 认证类型 --auth-用户名 用户名 --秘密使用 用法] [[--适配器名称
姓名] | [--适配器-wwnn --适配器-wwpn[--适配器父 亲]]
创建但不启动池对象 姓名 从原始参数。 如果 --打印-xml
指定，然后在不定义池的情况下打印池对象的 XML。
否则，池具有指定的 类型.
使用相同的参数 池创建作为，除了 - 建造, --覆盖和
--无覆盖 选项。
池破坏 池或 uuid
销毁（停止）给定的 池 目的。 Libvirt 将不再管理存储
由池对象描述，但池中包含的原始数据没有改变，
并且可以稍后恢复 池创建.
池删除 池或 uuid
销毁给定资源使用的资源 池 目的。 此操作不可恢复。
这个 池 执行此命令后对象仍将存在，准备创建新的
存储卷。
池转储xml [--不活动] 池或 uuid
返回有关的 XML 信息 池 目的。 --不活动 告诉 virsh 转储
池配置将在池的下一次启动时使用，而不是
当前池配置。
池编辑 池或 uuid
编辑存储池的 XML 配置文件。
这等效于：
virsh pool-dumpxml 池 > pool.xml
vi pool.xml（或使用其他文本编辑器进行更改）
virsh 池定义 pool.xml
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
池信息 池或 uuid
返回有关的基本信息 池 目的。
池列表 [--不活动[- 全部[- 执着的[- 短暂的[- 自动开启[--无自动启动]
[[- 细节] [ ]
列出 libvirt 已知的池对象。 默认情况下，只列出活动池；
--不活动 仅列出非活动池，以及 - 全部 列出所有池。
此外，还有几组过滤标志。 - 执着的 是列出
持久池， - 短暂的 是列出临时池。 - 自动开启 列出
自动启动池， --无自动启动 列出禁用自动启动的池。
您可能还想使用指定类型列出池 类型，池类型必须
用逗号分隔，例如 --type dir,disk。 有效的池类型包括“dir”、“fs”、
“netfs”、“logical”、“disk”、“iscsi”、“scsi”、“mpath”、“rbd”、“sheepdog”和“gluster”。
这个 - 细节 选项指示 virsh 额外显示池持久性和
可用的容量相关信息。
注意：在与旧服务器通信时，此命令强制使用一系列 API
具有固有竞争的调用，其中可能未列出池或可能出现更多
如果在收集列表时在调用之间更改状态，则不止一次。 较新
服务器没有这个问题。
池名 uid
转换 uid 到池名称。
池刷新 池或 uuid
刷新包含的卷列表 池.
池启动 池或 uuid [- 建造] [[--覆盖] | [--无覆盖]]
开始存储 池, 之前已定义但未激活。
[- 建造] [[--覆盖] | [--无覆盖]] 执行一个 池构建 前 池启动
确保池环境处于预期状态，而不需要运行
在启动之前构建命令。 这 --覆盖 和 --无覆盖 旗帜跟随
相同的规则 池构建. 如果只是 - 建造 提供，然后 池构建 被称为
没有标志。
备注：依赖远程资源的存储池，例如“iscsi”或 (v)HBA
支持的“scsi”池可能需要多次刷新才能拥有所有
检测到的卷（见 池刷新）。 这是因为对应的音量设备
在初始池启动期间，主机的文件系统中可能不存在
当前刷新尝试。 刷新重试次数取决于网络
连接以及主机导出相应设备所需的时间。
池未定义 池或 uuid
取消定义非活动配置 池.
池-uuid 池
返回命名的 UUID 池.
音量 指令
卷创建 池或 uuid 文件 [--prealloc-元数据]
从 XML 创建卷. 池或 uuid 是存储的名称或 UUID
要在其中创建卷的池。 文件 是 XML 与体积定义。 一个
创建 XML 的简单方法是使用 卷转储xml 命令获取
预先存在的卷的定义。 [--prealloc-元数据] 预分配元数据（对于
不支持完全分配的 qcow2 图像）。 此选项创建稀疏图像
带有元数据的文件，与没有元数据的图像相比具有更高的性能
预分配和仅略高的初始磁盘空间使用量。
例如：
virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml
vi newvolume.xml（或使用其他文本编辑器进行更改）
virsh vol-创建不同的存储池 newvolume.xml
卷创建自 池或 uuid 文件 [--输入池 池或 uuid] 卷名称或密钥或路径
[--prealloc-元数据[--reflink]
创建一个卷，使用另一个卷作为输入。 池或 uuid 是名称或 UUID
要在其中创建卷的存储池。 文件 是 XML 随着音量
定义。 --输入池 池或 uuid 是存储池的名称或 uuid
源卷在。 卷名称或密钥或路径 是源的名称或键或路径
体积。 [--prealloc-元数据] 预分配元数据（对于 qcow2 图像不
支持全额分配）。 此选项创建一个带有元数据的稀疏图像文件，
与没有预分配的图像相比，只有更高的性能
初始磁盘空间使用率略高。 什么时候 --reflink 指定，执行 COW
轻量级复制，仅在修改时复制数据块。 如果这不是
可能，复制失败。
卷创建为 池或 uuid 姓名 [- 分配 尺寸[- 格式 绳子]
[--支持卷 卷名称或密钥或路径[--backing-vol-格式 绳子]
[--prealloc-元数据]
从一组参数创建一个卷。 池或 uuid 是名称或 UUID
要在其中创建卷的存储池。 姓名 是新卷的名称。 对于磁盘
池，这必须与从池的源设备确定的分区名称匹配
路径和下一个可用分区。 例如/dev/sdb的源设备路径
并且磁盘上没有分区，那么名称必须是 sdb1 下一个名称
是 sdb2 等等。 是要创建的卷的大小，作为缩放
整数（见 附注 以上），如果没有后缀，则默认为字节。 - 分配
尺寸 是要在卷中分配的初始大小，也作为缩放整数
默认为字节。 - 格式 绳子 用于基于文件的存储池来指定
要使用的卷文件格式； 原始、bochs、qcow、qcow2、vmdk、qed。 使用扩展为
磁盘存储池以创建扩展分区（其他值为有效性
重新启动 libvirtd 或刷新池时已检查但不保留）。
--支持卷 卷名称或密钥或路径 是要使用的源支持卷，如果
拍摄现有卷的快照。 --backing-vol-格式 绳子 是格式
快照备份卷； 原始、bochs、qcow、qcow2、qed、vmdk、host_device。 这些
然而，适用于基于文件的存储池。 [--prealloc-元数据] 预分配
元数据（对于不支持完全分配的 qcow2 图像）。 此选项创建一个
带有元数据的稀疏图像文件，与图像相比具有更高的性能
没有预分配，只是初始磁盘空间使用率略高。
卷克隆 [- 水池 池或 uuid] 卷名称或密钥或路径 姓名 [--prealloc-元数据]
[--reflink]
克隆现有卷。 功能较弱但更易于键入的版本 卷创建-
，. - 水池 池或 uuid 是要创建的存储池的名称或 UUID
音量在。 卷名称或密钥或路径 是源卷的名称、键或路径。
姓名 是新卷的名称。 [--prealloc-元数据] 预分配元数据（对于
不支持完全分配的 qcow2 图像）。 此选项创建稀疏图像
带有元数据的文件，与没有元数据的图像相比具有更高的性能
预分配和仅略高的初始磁盘空间使用量。 什么时候 --reflink is
指定，执行 COW 轻量级复制，其中数据块仅在
修改的。 如果这是不可能的，则复制失败。
删除 [- 水池 池或 uuid] 卷名称或密钥或路径 [--删除快照]
删除给定的卷。 - 水池 池或 uuid 是存储池的名称或 UUID
音量在。 卷名称或密钥或路径 是卷的名称或键或路径
删除。
这个 --删除快照 标志指定与存储关联的任何快照
卷也应该被删除。 并非所有存储驱动程序都支持此选项，
目前只有rbd。
批量上传 [- 水池 池或 uuid[- 抵消 字节[- 长度 字节] 卷名称或密钥或路径
本地文件
上传内容 本地文件 到存储卷。 - 水池 池或 uuid 是
卷所在的存储池的名称或 UUID。 卷名称或密钥或路径 是
文件将上传到的卷的名称或密钥或路径。 - 抵消 是
存储卷中开始写入数据的位置。 该值必须为 0
或更大。 - 长度 是要上传的数据量的上限。 一个负
value 被解释为 unsigned long long 值，基本上包括所有内容
从偏移量到卷的末尾。 如果出现错误 本地文件 is
大于指定的长度。 请参阅 libvirt 的说明
virStorageVolUpload API 有关可能的目标卷和池更改的详细信息
作为尝试上传时池刷新的结果。
卷下载 [- 水池 池或 uuid[- 抵消 字节[- 长度 字节] 卷名称或密钥或-
径 本地文件
将存储卷的内容下载到 本地文件. - 水池 池或 uuid 是
卷所在的存储池的名称或 UUID。 卷名称或密钥或路径 是
要下载的卷的名称或密钥或路径。 - 抵消 是在
开始读取数据的存储卷。 该值必须为 0 或更大。
- 长度 是要下载的数据量的上限。 负值是
解释为一个 unsigned long long 值，基本上包括从
偏移到卷的末尾。
卷擦除 [- 水池 池或 uuid[- 算法 算法] 卷名称或密钥或路径
擦除卷，确保以后读取无法访问该卷上以前的数据。
- 水池 池或 uuid 是卷所在的存储池的名称或 UUID。 卷
名称或键或路径 是要擦除的卷的名称、键或路径。 有可能的
选择不同的擦除算法，而不是用零重写卷。 这
可以通过 - 算法 开关。
支持 算法
零 - 1-pass 全零
nnsa - 4 次 NNSA 政策信函 NAP-14.1-C (XVI-8)
清理可移动和不可移动硬盘：
随机 x2，0x00，验证。
dod - 4-pass DoD 5220.22-M 第 8-306 节程序
消毒可拆卸和不可拆卸刚性
磁盘：随机、0x00、0xff、验证。
bsi - 德国中心推荐的 9-pass 方法
信息技术安全
(http://www.bsi.bund.de）：0xff、0xfe、0xfd、0xfb、
0xf7、0xef、0xdf、0xbf、0x7f。
古特曼 - 中描述的规范的 35 遍序列
古特曼的论文。
schneier - Bruce Schneier 描述的 7-pass 方法
“应用密码学”（1996 年）：0x00、0xff、
随机 x5。
pfitzner7 - Roy Pfitzner 的 7-random-pass 方法：随机 x7.
pfitzner33 - Roy Pfitzner 的 33-random-pass 方法：随机 x33.
random - 1-pass 模式：随机。
备注: 算法的可用性可能会受到“scrub”版本的限制
二进制安装在主机上。
卷转储xml [- 水池 池或 uuid] 卷名称或密钥或路径
将卷信息作为 XML 转储输出到标准输出。 - 水池 池或 uuid 是
卷所在的存储池的名称或 UUID。 卷名称或密钥或路径 是名字
要输出 XML 的卷的键或路径。
卷信息 [- 水池 池或 uuid] 卷名称或密钥或路径
返回有关给定存储卷的基本信息。 - 水池 池或 uuid 是
卷所在的存储池的名称或 UUID。 卷名称或密钥或路径 是名字
要返回信息的卷的键或路径。
卷列表 [- 水池 池或 uuid[- 细节]
返回给定存储池中的卷列表。 - 水池 池或 uuid 是名字
或存储池的 UUID。 这 - 细节 选项指示 virsh 额外
显示可用的卷类型和容量相关信息。
卷池 [--uuid] 音量键或路径
返回给定卷的池名称或 UUID。 默认情况下，池名称为
回。 如果 --uuid 给出选项，则返回池 UUID。 音量键-
或路径 是要为其返回池信息的卷的键或路径。
卷路径 [- 水池 池或 uuid] 卷名或密钥
返回给定卷的路径。 - 水池 池或 uuid 是名称或 UUID
卷所在的存储池。 卷名或密钥 是卷的名称或键
返回路径。
卷名 音量键或路径
返回给定卷的名称。 音量键或路径 是卷的键或路径
返回名称。
音量键 [- 水池 池或 uuid] 卷名或路径
返回给定音量的音量键。 - 水池 池或 uuid 是名称或 UUID
卷所在的存储池。 卷名或路径 是卷的名称或路径
返回音量键。
卷调整大小 [- 水池 池或 uuid] 卷名或路径 池或 uuid [- 分配]
[- 三角洲[- 收缩]
调整给定卷的容量（以字节为单位）。 - 水池 池或 uuid 是名字还是
卷所在的存储池的 UUID。 卷名称或密钥或路径 是名字还是键
或要调整大小的卷的路径。 新容量可能很少，除非 - 分配
被指定。 一般， 是新尺寸，但如果 - 三角洲 存在，那么它
添加到现有大小。 尝试缩小卷将失败，除非
- 收缩 存在; 不能为负，除非 - 收缩 提供，但一个
负号不是必需的。 是一个缩放整数（见 附注 以上），其中
如果没有后缀，则默认为字节。 此命令仅对存储安全
活动来宾未使用的卷； 也可以看看 块调整大小 用于实时调整大小。
SECRET 指令
以下命令操作“秘密”（例如密码、密码和加密
键）。 Libvirt 可以独立于它们的使用和其他对象（例如
卷或域）可以指用于加密或其他用途的秘密。
使用 UUID 标识秘密。 看http://libvirt.org/formatsecret.html>对于
用于表示机密属性的 XML 格式的文档。
秘密定义 文件
使用中指定的属性创建一个秘密 文件, 没有关联的秘密
价值。 如果 文件 不指定 UUID，自动选择一个。 如果 文件 指定
现有秘密的 UUID，用定义的属性替换其属性 文件,
不影响秘密值。
秘密转储xml 秘密
的输出属性 秘密 （由其 UUID 指定）作为到标准输出的 XML 转储。
秘密集值 秘密 base64
设置关联的值 秘密 （由其 UUID 指定）到值
Base64 编码的值 base64.
秘密获取价值 秘密
输出与关联的值 秘密 （由其 UUID 指定）到标准输出，编码
使用 Base64。
秘密未定义 秘密
删除一个 秘密 （由其 UUID 指定），包括关联的值（如果有）。
秘密清单 [--短暂的[--没有短暂的[- 私人的[--无私人]
返回机密列表。 您可能还想通过以下方式过滤返回的机密
--短暂的 列出短暂的， --没有短暂的 列出非短暂的，
- 私人的 列出私人的，和 --无私人 列出非私人的。
快照 指令
以下命令操作域快照。 快照占用磁盘、内存和
某个时间点域的设备状态，并保存以备将来使用。 他们有很多
使用，从保存操作系统映像的“干净”副本到保存域的状态之前
潜在的破坏性操作。 快照用唯一的名称标识。 看
<http://libvirt.org/formatsnapshot.html> 用于 XML 格式的文档
表示快照的属性。
快照创建 域 [xml文件] {[--重新定义 [- 当前的]] | [--无元数据[- 停止]
[--仅磁盘[--重用外部[--静默[- 原子[- 居住]}
为域创建快照 域 具有中指定的属性 xml文件.
通常，域快照的唯一可设置属性是和
元素，以及如果 --仅磁盘 给出; 剩下的
字段被忽略，并由 libvirt 自动填充。 如果 xml文件 完全是
省略，则 libvirt 将为所有字段选择一个值。 新快照将
成为当前，如所列 快照电流.
If - 停止 指定后，域将处于非活动状态
快照已创建。
If --仅磁盘 指定，快照将只包括磁盘状态而不是
具有 vm 状态的常用系统检查点。 磁盘快照比完整系统更快
检查点，但恢复到磁盘快照可能需要 fsck 或日志重播，
因为它就像突然拉动电源线时的磁盘状态；
和混合 - 停止 和 --仅磁盘 丢失任何未刷新到磁盘的数据
时间。
If --重新定义 被指定，那么所有由生成的 XML 元素 快照转储xml 旨在
有效的; 这可用于将快照层次结构从一台机器迁移到另一台机器，以
为暂时域消失且稍后出现的情况重新创建层次结构
使用相同的名称和 UUID 重新创建，或对快照进行轻微更改
元数据（例如嵌入在快照中的域 XML 的特定于主机的方面）。
当提供此标志时， xml文件 参数是强制性的，并且域的
当前快照不会被改变，除非 - 当前的 还给出了标志。
If --无元数据 指定，然后创建快照数据，但任何元数据
立即丢弃（也就是说，libvirt 不会将快照视为当前快照，并且
无法恢复到快照，除非 --重新定义 后来用来教 libvirt 关于
元数据）。
If --重用外部 指定，并且快照 XML 请求外部快照
具有现有文件的目标，则目标必须存在并且是预
使用正确的格式和元数据创建。 然后重新使用该文件； 否则，一个
拒绝快照以避免丢失现有文件的内容。
If --静默 指定，libvirt 将尝试使用访客代理来冻结和解冻
域的挂载文件系统。 但是，如果域没有来宾代理，则快照
创建将失败。 目前，这需要 --仅磁盘 也要通过。
If - 原子 指定，libvirt 将保证快照成功，或者
没有变化就失败了； 并非所有管理程序都支持这一点。 如果这个标志不是
指定，那么某些管理程序可能会在部分执行操作后失败，并且
转储xml 必须用于查看是否发生了任何部分更改。
If - 居住 指定时，libvirt 会在来宾运行时拍摄快照。 这
增加外部检查点的内存映像的大小。 这是目前
仅支持外部检查点。
快照元数据的存在将阻止尝试 取消定义 一个持久域。
但是，对于瞬态域，当域
退出运行（无论是通过命令如 摧毁 或通过内部访客操作）。
快照创建为 域 {[--打印-xml] | [--无元数据[- 停止[--重用外部]}
[姓名[描述[--仅磁盘 [--静默]][- 原子] [[- 居住[--memspec 内存规格]]
[--磁盘规格] 磁盘规格] ...
为域创建快照 域 与给定的和; 如果要么
省略值，libvirt 将选择一个值。 如果 --打印-xml 指定，然后 XML
适用于 快照创建 是输出，而不是实际创建快照。
否则，如果 - 停止 指定后，域将处于非活动状态
创建快照，如果 --仅磁盘 指定，快照将不会
包括虚拟机状态。
这个 --memspec 选项可用于控制检查点是内部的还是
外部的。 这 --memspec 标志是强制性的，后跟一个 内存规格 的形式
[文件=]名称[，快照=类型], 类型可以是 没有, 内部或 外部. 包括
一个字面逗号 文件=名称, 用第二个逗号将其转义。 --memspec 不能使用
连同 --仅磁盘.
这个 --磁盘规格 选项可用于控制如何 --仅磁盘 和外部检查站
创建外部文件。 这个选项可以多次出现，根据数量
的域 xml 中的元素。 每个是在形式
磁盘[,快照=类型][,驱动程序=类型][,文件=名称]。 一个 磁盘规格 必须为磁盘提供
由块设备支持，因为 libvirt 不会为这些设备自动生成文件名。 到
包括一个文字逗号 磁盘 或 文件=名称, 用第二个逗号将其转义。 一个
文字 --磁盘规格 必须在每个之前 磁盘规格 除非所有三个 域, 姓名和
描述 也在场。 例如，磁盘规格为
"vda,snapshot=external,file=/path/to,,new" 生成以下 XML：
If --重用外部 被指定，并且域 XML 或 磁盘规格 选项要求
具有现有文件目标的外部快照，则目标必须
存在并使用正确的格式和元数据预先创建。 然后重新使用该文件；
否则，拒绝快照以避免丢失现有文件的内容。
If --静默 指定，libvirt 将尝试使用访客代理来冻结和解冻
域的挂载文件系统。 但是，如果域没有来宾代理，则快照
创建将失败。 目前，这需要 --仅磁盘 也要通过。
If --无元数据 指定，然后创建快照数据，但任何元数据
立即丢弃（也就是说，libvirt 不会将快照视为当前快照，并且
无法恢复到快照，除非 快照创建 后来用来教libvirt
再次关于元数据）。 此标志不兼容 --打印-xml.
If - 原子 指定，libvirt 将保证快照成功，或者
没有变化就失败了； 并非所有管理程序都支持这一点。 如果这个标志不是
指定，那么某些管理程序可能会在部分执行操作后失败，并且
转储xml 必须用于查看是否发生了任何部分更改。
If - 居住 指定时，libvirt 会在来宾运行时拍摄快照。 这
增加外部检查点的内存映像的大小。 这是目前
仅支持外部检查点。
快照电流 域 {[- 姓名] | [- 安全信息] | [快照名称]}
没有 快照名称，这将输出域当前的快照 XML
快照（如果有）。 如果 - 姓名 指定，只是当前的快照名称而不是
完整的 xml。 否则，使用 - 安全信息 还将包括安全敏感
XML 中的信息。
通过 快照名称，这是使现有命名快照成为
当前快照，而不恢复域。
快照编辑 域 [快照名称[- 当前的] {[- 改名] | [- 克隆]}
编辑 XML 配置文件 快照名称 域的。 如果两者 快照名称
和 - 当前的 指定，也强制编辑的快照成为当前
快照。 如果 快照名称 被省略，那么 - 当前的 必须提供，以编辑
当前快照。
这等效于：
virsh 快照转储xml dom名称> snapshot.xml
vi snapshot.xml（或使用其他文本编辑器进行更改）
virsh 快照创建 dom snapshot.xml --redefine [--current]
除了它会做一些错误检查。
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
If - 改名 指定，则编辑可以更改快照名称。 如果 - 克隆 is
指定，然后更改快照名称将创建快照的克隆
元数据。 如果两者均未指定，则编辑不得更改快照名称。
请注意，更改快照名称必须小心，因为某些内容
快照，例如单个 qcow2 文件中的内部快照，只能访问
从原来的名字。
快照信息 域 {快照 | - 当前的}
输出一个命名的基本信息, 或当前快照
- 当前的.
快照列表 域 [--元数据[--无元数据] [{--父母 | --根 [{- 树 |
- 姓名}]}] [{[- 从] 快照 | - 当前的} [- 子孙]][- 树叶[--无叶]
[--不活动[- 积极的[--仅磁盘[- 内部的[- 外部的]
列出给定域的所有可用快照，默认显示列
快照名称、创建时间和域状态。
If --父母 指定，在输出表中添加一列，给出名称
每个快照的父级。 如果 --根 已指定，列表将被过滤为仅
没有父级的快照。 如果 - 树 指定，输出将在树中
格式，仅列出快照名称。 这三个选项是相互排斥的。 如果
- 姓名 指定仅打印快照名称。 这个选项是相互的
与 - 树.
If - 从 提供，过滤列表到快照是给定的孩子
快照; 或者如果 - 当前的 提供，从当前快照开始。 当用于
隔离或与 --父母，该列表仅限于直系子女，除非
- 子孙 也存在。 当与 - 树，使用 - 子孙 is
默示。 此选项不兼容 --根. 注意起始点
- 从 or - 当前的 不包括在列表中，除非 - 树 选项也是
当下。
If - 树叶 指定，列表将被过滤到只有没有的快照
孩子们。 同样，如果 --无叶 已指定，列表将被过滤为仅
与孩子的合影。 （请注意，省略这两个选项不会进行过滤，而
提供这两个选项将产生相同的列表或错误，具体取决于
服务器是否识别标志）。 过滤选项不兼容
- 树.
If --元数据 指定，列表将被过滤到只涉及的快照
libvirt 元数据，因此会阻止 取消定义 持久域，或丢失
on 摧毁 的瞬态域。 同样，如果 --无元数据 已指定，列表
将被过滤到只存在不需要 libvirt 元数据的快照。
If --不活动 指定，列表将被过滤到拍摄的快照
当域被关闭时。 如果 - 积极的 指定，列表将被过滤到
域运行时拍摄的快照，以及快照包含的位置
恢复到运行状态的内存状态。 如果 --仅磁盘 被指定，
列表将被过滤到域运行时拍摄的快照，但
其中快照仅包括磁盘状态。
If - 内部的 指定，列表将被过滤到使用内部的快照
存储现有磁盘映像。 如果 - 外部的 指定，列表将是
过滤到使用外部文件进行磁盘映像或内存状态的快照。
快照转储xml 域 快照 [- 安全信息]
输出名为的域快照的快照 XML 快照。 运用
- 安全信息 还将包括安全敏感信息。 利用 snapshot-
当前 轻松访问当前快照的 XML。
快照父 域 {快照 | - 当前的}
输出给定的父快照的名称（如果有） 快照，或为
当前快照与 - 当前的.
快照还原 域 {快照 | - 当前的} [{- 跑步 | --暂停}] [- 力量]
将给定域恢复到指定的快照 快照, 或到当前
快照 - 当前的. 请注意，这是一种破坏性的行为； 任何变化
自上次拍摄快照以来的域将丢失。 还要注意的是，状态
快照恢复完成后域的状态将是域在
拍摄原始快照的时间。
通常，恢复到快照会使域保持其当时的状态
快照已创建，除了没有 vm 状态的磁盘快照离开
域处于非活动状态。 通过 - 跑步 or --暂停 旗将
执行其他状态更改（例如启动非活动域，或暂停
运行域）。 由于瞬态域不能处于非活动状态，因此需要使用
恢复到临时域的磁盘快照时，这些标志之一。
在两种情况下，快照恢复会带来额外风险，这需要
用于 - 力量 继续。 一种是缺少完整域的快照的情况
用于恢复配置的信息（例如在 libvirt 之前创建的快照
0.9.5); 因为 libvirt 无法证明当前的配置匹配
在快照时使用，提供 - 力量 向 libvirt 保证快照
与当前配置兼容（如果不兼容，域可能会
无法运行）。 另一种是从运行域恢复到活动域的情况
必须创建新的管理程序而不是重用现有的管理程序的状态
管理程序，因为它意味着缺点，例如破坏任何现有的 VNC 或 Spice
连接； 这种情况发生在使用可证明的活动快照
不兼容的配置，以及与结合的非活动快照
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 - 开始 or - 暂停 旗。
快照删除 域 {快照 | - 当前的} [--元数据] [{- 孩子们 |
--仅限儿童}]
删除名为的域的快照 快照, 或当前快照
- 当前的. 如果此快照有子快照，则此快照的更改将是
融入了孩子们。 如果 - 孩子们 通过，然后删除此快照和任何
此快照的子项。 如果 --仅限儿童 被传递，然后删除所有的孩子
此快照，但保留此快照不变。 这两个标志是相互的
排斥。
If --元数据 指定，则只删除由维护的快照元数据
libvirt，同时保留快照内容完整以供外部工具访问；
否则，删除快照也会同时删除该时间点的数据内容。
过滤器 指令
以下命令操作网络过滤器。 网络过滤器允许过滤
来自和去往虚拟机的网络流量。 个人网络流量
过滤器是用 XML 编写的，可能包含对其他网络过滤器的引用，描述
流量过滤规则，或两者都包含。 网络过滤器被虚拟引用
机器从他们的接口描述中。 网络过滤器可以通过以下方式引用
多个虚拟机的接口。
nwfilter-定义 xml文件
让 libvirt 知道一个新的网络过滤器。 如果同名的网络过滤器
已经存在，它将被新的 XML 替换。 任何正在运行的虚拟机
引用此网络过滤器将调整其网络流量规则。 如果对于
网络流量过滤规则不能由任何原因实例化的任何原因
运行虚拟机，那么新的 XML 将被拒绝。
nwfilter-取消定义 过滤器名称
删除网络过滤器。 如果任何正在运行的虚拟机被删除，删除将失败
当前使用此网络过滤器。
过滤器列表
列出所有可用的网络过滤器。
nwfilter转储xml 过滤器名称
输出网络过滤器 XML。
nwfilter-编辑 过滤器名称
编辑网络过滤器的 XML。
这等效于：
virsh nwfilter-dumpxml myfilter > myfilter.xml
vi myfilter.xml（或使用其他文本编辑器进行更改）
virsh nwfilter-定义 myfilter.xml
除了它会做一些错误检查。 新的网络过滤器可能会被拒绝
出于与上述相同的原因 nwfilter-定义.
使用的编辑器可以由 $VISUAL 或 $EDITOR 环境变量提供，并且
默认为“vi”。
特定于管理程序的 指令
注意：使用以下命令是 非常 灰心。 它们会导致 libvirt
变得困惑并在后续操作中做错事。 一旦你使用了这些
命令，请不要向 libvirt 开发人员报告问题； 报告将是
忽略。 如果你发现这些命令是完成某事的唯一方法，那么
最好要求将该功能添加为常规中的一等公民
libvirt 库。
qemu 附加 PID
将外部启动的 QEMU 进程附加到 libvirt QEMU 驱动程序。 QEMU
进程必须是使用 UNIX 驱动程序通过监视器连接创建的。
理想情况下，该过程还将指定“-name”参数。
$ qemu-kvm-cdrom 〜/演示.iso \
-monitor unix:/tmp/demo,server,nowait \
-名称 foo \
-uuid cece4f9f-dff0-575d-0e8e-01fe380f12ea &
$ QEMUPID=$！
$ virsh qemu-attach $QEMUPID
并不是所有的 libvirt 功能都可以在附加到一个
外部启动的 QEMU 进程。 来宾 ABI 更改时可能存在问题
迁移和设备热插拔或热拔出可能不起作用。 附着的环境
应该主要被认为是只读的。
qemu 监视器命令 域 {[--hmp] | [- 漂亮]} 命令...
发送任意监控命令 命令 域 域 通过 qemu 监视器。
命令的结果将打印在标准输出上。 如果 --hmp 通过，命令
被认为是人工监控命令，libvirt 会自动转换它
如果需要，进入 QMP。 在这种情况下，结果也将从 QMP 转换回来。 如果
- 漂亮 给出，并且监视器使用 QMP，那么输出将被漂亮地打印。
如果提供了多个参数 命令，它们与一个空格连接
在将单个命令传递给监视器之前。
qemu-agent-命令 域 [- 暂停 秒 | --异步 | - 堵塞] 命令...
发送任意访客代理命令 命令 域 域 通过 qemu 代理。
- 暂停, --异步 和 - 堵塞 选项是排他的。 - 暂停 需要超时
秒 秒 它必须是积极的。 什么时候 --aysnc 给出，命令等待
成功或失败超时。 什么时候 - 堵塞 给出，命令等待
永远阻塞超时。
qemu 监视器事件 [域[- 事件 事件名称[- 环形[- 暂停 秒[- 漂亮]
[--正则表达式[-- 不区分大小写[--时间戳]
等待任意 QEMU 监控事件发生，并打印出事件的详细信息
当它们发生时。 事件可以选择过滤 域 or 事件名称。 该
'query-events' QMP 命令可以通过 qemu 监视器命令 了解什么事件
支持。 如果 --正则表达式 用来， 事件名称 是一个基本的正则表达式
一个文字字符串。 如果 -- 不区分大小写 用来， 事件名称 将不区分大小写匹配。
默认情况下，这条命令是一次性的，一旦有事件发生就返回成功； 你
可以发送 SIGINT（通常通过“Ctrl-C”）立即退出。 如果 - 暂停 is
指定后，命令放弃等待事件 秒 已经过去了。 和
- 环形，该命令打印所有事件，直到超时或中断键。 如果 - 漂亮
指定后，任何 JSON 事件详细信息都被漂亮地打印出来以提高可读性。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 --时间戳 使用时，将在事件之前打印人类可读的时间戳，
QEMU 提供的时序信息将被省略。
lxc-输入-命名空间 域 -- /path/to/binary [arg1, [arg2, ...]]
输入命名空间 域 并执行命令“/path/to/binary”传递
请求的参数。 二进制路径是相对于容器根文件系统的，而不是相对于
主机根文件系统。 二进制文件将继承环境变量/控制台
virsh 可见。 此命令仅在连接到 LXC 管理程序驱动程序时有效。
仅当“/path/to/binary”的退出状态为 0 时，此命令才会成功。
环境
可以设置以下环境变量来改变“virsh”的行为
VIRSH_DEBUG=<0 到 4>
打开 virsh 命令的详细调试。 有效级别为
· VIRSH_DEBUG=0
调试 - 记录所有级别的消息
· VIRSH_DEBUG=1
INFO - 以 INFO、NOTICE、WARNING 和 ERROR 级别记录消息
· VIRSH_DEBUG=2
NOTICE - 在 NOTICE、WARNING 和 ERROR 级别记录消息
· VIRSH_DEBUG=3
WARNING - 在 WARNING 和 ERROR 级别记录消息
· VIRSH_DEBUG=4
ERROR - 仅记录 ERROR 级别的消息。
VIRSH_LOG_FILE="日志文件"
记录 virsh 调试消息的文件。
VIRSH_DEFAULT_CONNECT_URI
默认情况下要连接的管理程序。 将其设置为 URI，格式与
被接受 联接 选项。 不推荐使用此环境变量以支持
全球 LIBVIRT_DEFAULT_URI 用于相同目的的变量。
LIBVIRT_DEFAULT_URI
默认情况下要连接的管理程序。 将其设置为 URI，格式与
被接受 联接 选项。 这会覆盖任何客户端中设置的默认 URI
配置文件并防止 libvirt 探测驱动程序。
VISUAL
使用的编辑器 编辑 和相关选项。
EDITOR
使用的编辑器 编辑 和相关选项，如果未设置“VISUAL”。
VIRSH_HISTSIZE
命令历史记录中要记住的命令数。 默认值为 500。
LIBVIRT_DEBUG=级别
打开所有 libvirt API 调用的详细调试。 有效级别为
· LIBVIRT_DEBUG=1
DEBUG 或以上级别的消息
· LIBVIRT_DEBUG=2
INFO或以上级别的消息
· LIBVIRT_DEBUG=3
警告级别或更高级别的消息
· LIBVIRT_DEBUG=4
ERROR 或更高级别的消息
有关调试选项的更多信息，请咨询
"http://libvirt.org/logging.html"
使用 onworks.net 服务在线使用 virsh
