virsh help domain命令内容解析

简介

这段时间学习热迁移，要不断的在qemu monitor和libvirt中调转使用命令，故整理virsh命令，这篇是第一篇，整理virsh help domain相关内容

virsh # help domain
Domain Management (help keyword 'domain'):
attach-device                  attach device from an XML file(通过XML配置给虚拟机添加设备)
attach-disk                    attach disk device(添加磁盘设备）
attach-interface               attach network interface（添加网络设备）
**autostart**  
autostart a domain（给虚拟机添加自动启动配置，当libvirtd服务被拉起的时候，自动启动）
blkdeviotune                   Set or query a block device I/O tuning parameters.（设置或查询磁盘I/ O参数）
blkiotune                      Get or set blkio parameters（获取或设置blkio参数）
blockcommit                    Start a block commit operation.（将磁盘文件的变化保存到备份文件中）
blockcopy                      Start a block copy operation.（拷贝磁盘备份镜像到目的地）
blockjob                       Manage active block operations（管理active状态的磁盘任务）
blockpull                      Populate a disk from its backing image.（从backing file中拷贝数据到磁盘）
blockresize                    Resize block device of domain.（给虚拟机的块设备扩容）
change-media                   Change media of CD or floppy drive（更新cdrom或floppy设备）
console                        connect to the guest console（通过控制连接虚拟机）
cpu-baseline                   compute baseline CPU（计算基准CPU）
cpu-compare                    compare host CPU with a CPU described by an XML file（将XML中配置的CPU与HostCPU进行对比）
cpu-stats                      show domain cpu statistics（显示CPU统计信息）
create                         create a domain from an XML file（根据XML配置创建并启动一个非持久化虚拟机）
define                         define (but don't start) a domain from an XML file（根据XML配置创建一个虚拟机）
desc                           show or set domain's description or title（显示或设置虚拟机的描述或者标题）
destroy                        destroy (stop) a domain（强制删除一个虚拟机）
detach-device                  detach device from an XML file（根据XML定义删除虚拟机的设备）
detach-disk                    detach disk device（删除磁盘设备）
detach-interface               detach network interface（删除网络设备）
domdisplay                     domain display connection URI（显示虚拟机的连接URI）
domfsfreeze                    Freeze domain's mounted filesystems.(冻结虚拟机的挂载文件系统)
domfsthaw                      Thaw domain's mounted filesystems.(解冻虚拟机的挂载文件系统)
domfsinfo                      Get information of domain's mounted filesystems.
domfstrim                      Invoke fstrim on domain's mounted filesystems.(在虚拟机挂载的文件系统上执行fstrim命令)
domhostname                    print the domain's hostname(打印虚拟机的hostname)
domid                          convert a domain name or UUID to domain id(把虚拟机的名字或UUID转化为虚拟机ID)
domif-setlink                  set link state of a virtual interface(虚拟机设备接口链路状态设置)
domiftune                      get/set parameters of a virtual interface(获取或者设置虚拟机设备接口得参数)
domjobabort                    abort active domain job(终止虚拟机的一个处于active的任务)
**domjobinfo**  
domain job information(获取虚拟机的任务信息，比如正在virsh save可以查询操作情况)
domname                        convert a domain id or UUID to domain name(通过虚拟机的ID或者UUID获取虚拟机的名字)
**dompmsuspend**  
suspend a domain gracefully using power management functions(使用电源管理功能将虚拟机挂起，需要qga支持)
**dompmwakeup**  
wakeup a domain from pmsuspended state(唤醒使用dompmsuspend挂起的虚拟机)
domuuid                        convert a domain name or id to domain UUID(通过虚拟机的name或ID获取虚拟机的UUID)
domxml-from-native             Convert native config to domain XML(将已存在的一组QEMU参数转成可以被libvirt使用Domain XML文件)
domxml-to-native               Convert domain XML to native config(将已存在的libvirt使用的Domain XML文件转化为QEMU参数)
dump                           dump the core of a domain to a file for analysis(dump出虚拟机的core文件，用于分析崩溃原因)
dumpxml                        domain information in XML(获取虚拟机的XML配置信息)
edit                           edit XML configuration for a domain(编辑虚拟机的XML配置文件)
event                          Domain Events(获取虚拟机事件)
**inject-nmi**  
Inject NMI to the guest(注入NMI中断到虚拟机内部，当硬件发生不可恢复的错误时使用)
iothreadinfo                   view domain IOThreads
iothreadpin                    control domain IOThread affinity
iothreadadd                    add an IOThread to the guest domain
iothreaddel                    delete an IOThread from the guest domain
send-key                       Send keycodes to the guest(往虚拟机发送键盘按键指令)
**send-process-signal**  
Send signals to processes(给进程发送信号,qemu不支持)
lxc-enter-namespace            LXC Guest Enter Namespace(进入LXC虚拟机的命名空间)

**managedsave**  
managed save of a domain state(管理保存虚拟机的内存状态到/var/lib/libvirt/qemu/save/*.save,将虚拟机保存并销毁,后续restore的时候恢复到save之前的状态)
**managedsave-remove**  
Remove managed save of a domain（删除虚拟机状态管理设置/var/lib/libvirt/qemu/save/*.save文件）

memtune                        Get or set memory parameters（获取或者设置内存参数）
metadata                       show or set domain's custom XML metadata
migrate                        migrate domain to another host（将虚拟机迁移到另一个节点）
migrate-setmaxdowntime         set maximum tolerable downtime（设置停机迁移时间）
migrate-compcache              get/set compression cache size（获取或者设置内存压缩的cache大小）
migrate-setspeed               Set the maximum migration bandwidth（设置迁移的最大带宽）
migrate-getspeed               Get the maximum migration bandwidth（获取迁移的最大带宽）
numatune                       Get or set numa parameters（获取或者设置numa参数）
qemu-attach                    QEMU Attach（QEMU Attach）
qemu-monitor-command           QEMU Monitor Command（给qemu monitor发送命令）
qemu-monitor-event             QEMU Monitor Events（监听qemu monitor事件）
qemu-agent-command             QEMU Guest Agent Command（给qemu agent发送命令）
**reboot**  
reboot a domain（优雅重启虚拟机，acpi|agent（启用的qga情况下调用qga进行关机）|initctl(upstart命令)|signal|paravirt（xen））,对应qemu只支持agent和acpi
reset                          reset a domain（强制重启虚拟机）

**restore**  
restore a domain from a saved state in a file（通过保存的内存文件恢复虚拟机）
**resume**  
resume a domain（唤醒处于pause状态的虚拟机，也就是suspend的虚机）
**save**  
save a domain state to a file（将虚拟机内存状态保存到一个文件）
**save-image-define**  
redefine the XML for a domain's saved state file（刷新虚拟机配置到save虚拟机的文件中）
**save-image-dumpxml**  
**saved state domain**  
information in XML(dump出save虚拟机文件中的虚拟机配置信息)
**save-image-edit**  
edit XML for a domain's saved state file(出save虚拟机文件中的虚拟机配置信息)

schedinfo                      show/set scheduler parameters(显示或设置scheduler参数)
screenshot                     take a screenshot of a current domain console and store it into a file(截取当前虚拟机的屏幕，并将其保存到一个文件中)
set-user-password              set the user password inside the domain
setmaxmem                      change maximum memory limit(改变最大内存限制，停机状态下才可以)
setmem                         change memory allocation(使用virtio-balloon动态增大或者减小内存大小)
setvcpus                       change number of virtual CPUs(设置vcpu个数)
shutdown                       gracefully shutdown a domain(优雅关闭虚拟机,acpi|agent（启用的qga情况下调用qga进行关机）|initctl(upstart命令)|signal|paravirt（xen）)，对应qemu只支持agent和acpi
start                          start a (previously defined) inactive domain(启动一个处于关闭状态的虚拟机)
**suspend**  
suspend a domain(暂停一个虚拟机)
ttyconsole                     tty console(tty console显示)
undefine                       undefine a domain(删除虚拟机的定义)
update-device                  update device from an XML file(根据XML配置更新虚拟机的设备)
vcpucount                      domain vcpu counts(获取虚拟机vcpu个数)
vcpuinfo                       detailed domain vcpu information(显示虚拟机vcpu的详细信息)
vcpupin                        control or query domain vcpu affinity(控制或者查询虚拟机的vcpu亲和性)
emulatorpin                    control or query domain emulator affinity(控制或者查询模拟器的亲和性)
vncdisplay                     vnc display(获取vnc端口号)

1虚拟机操作相关

create：create从XML文件创建域
定义：从XML文件定义（但不要启动）域
启动：启动（先前定义的）非活动域
destroy：销毁（停止）域
关闭：正常关闭域
undefine：取消定义域名

reboot：重新启动域
重置：重置域（重置目标域，就像通过电源按钮一样）

暂停：暂停域
恢复：恢复域

save：将域状态保存到文件
还原：从文件
屏幕截图中的已保存状态还原域：获取当前域控制台的屏幕截图并将其存储到文件中

自动启动：自动启动域（配置域在启动时自动启动）

managedsave：托管保存域状态（保存并销毁正在运行的域，以便以后可以从同一状态重新启动。当域的下次运行virsh'start'命令时，它将自动从这个保存状态。） managedsave-remove：删除域的托管保存

desc：显示或设置域的描述或标题
domhostname：打印域的主机名

domname：将域ID或UUID转换为域名（输出域名）
元数据：显示或设置域的自定义XML元数据

domuuid：将域名或ID转换为域UUID 
domid：将域名或UUID转换为域id numatune：获取或设置numa参数

emulatorpin：控制或查询域仿真器关联（Pin域仿真器线程到主机物理CPU）

2.XML相关

domxml-from-native：将本机配置转换为域XML 
domxml-native：将域XML转换为本机配置

dumpxml：XML 
编辑中的域信息：编辑域的XML配置

3.CPU相关

vcpucount：域VCPU计数
vcpuinfo：详细域VCPU信息
vcpupin：控制或查询域VCPU亲和力
setvcpus：虚拟CPU的数量改变
CPU的基线：计算基线CPU 
CPU-比较：由XML文件中描述的一个CPU比较主机CPU CPU- stats：显示域cpu统计信息

4.mem相关

setmaxmem：更改最大内存限制
setmem：更改内存分配
memtune：获取或设置内存参数

5.blk

blkdeviotune：设置或查询块设备I / O调整参数。

blkiotune：获取或设置blkio参数

blockcommit：启动一个块提交操作。（提交从快照到其支持图像的更改合并快照文件）

blockcopy：启动一个块复制操作。
blockjob：管理活动块操作
blockpull：从其后备映像填充磁盘。（将支持文件数据合并至overlay中）blockresize：调整域的块设备。

6.attch /分离

attach-device：从XML文件
附加设备attach-device：attach disk device 
attach-interface：attach network interface

detach-device：从XML文件中分离设备
detach-disk：detach disk device 
detach-interface：detach network interface

update-device：从XML文件更新设备

7.迁移相关

迁移：迁移域到另一台主机
迁移-setmaxdowntime：设置最大可容忍的停机时间
迁移，compcache：获取/设置压缩缓存大小
迁移，setspeed：设置最大迁移带宽
迁移-getspeed：获取最大迁移带宽

8.代理人

QEMU访客代理是一个运行在虚拟机内部的普通应用程序，其目的是实现一种宿主机和虚拟机进行交互的方式这种方式不依赖于网络，而是依赖于为Virtio序列。
QEMU提供了串口设备的模拟及数据交换的通道，最终呈现出来的是一个串口设备（虚拟机内部）和一个Unix套接字文件（宿主机上）。
通过QEMU来宾代理，宿主机可以控制虚拟机实现冻结/恢复/整理文件系统（冻结文件系统），列出IP地址等功能。

set-user-password：在域
domfsfreeze中设置用户密码：冻结域的挂载文件系统。
domfsthaw：解冻域的挂载文件系统。
domfsinfo：获取域挂载文件系统的信息。
domfstrim：在域的挂载文件系统上调用fstrim。

dompmsuspend：使用电源管理功能正常暂停域
dompmwakeup：从pmsuspended状态唤醒域

9.io线程

当前不知道是配置，还是什么原因，没有相关的信息

iothreadinfo：view domain IOThreads 

iothreadpin：control domain IOThread affinity 
iothreadadd：将IOThread添加到来宾域
iothreaddel：从来宾域中删除IOThread

10操纵拯救生成的文件

这里主要是处理保存生成的文件，包括以XML形式展现等

save-image-define：为域的已保存状态文件重新定义XML（替换与保存的状态文件关联的域XML）
save-image-dumpxml：以XML格式保存的状态域信息（提取在域中生效的域XML）使用save命令创建保存的状态文件文件的时间）
save-image-edit：编辑域的已保存状态文件的XML

11.Qemu特定命令

强烈建议不要使用以下命令。
它们可能导致libvirt混淆并在后续操作中做错事。
使用此命令后，请不要向libvirt开发人员报告问题; 报告将被忽略。

qemu-attach QEMU附加
qemu-monitor-command QEMU Monitor命令
qemu-monitor-event QEMU监视器事件
qemu-agent-command QEMU Guest Agent命令

12.网络相关

domif-setlink：设置虚拟接口的链路状态

virsh domif-setlink domain vnet0 down
virsh domif-setlink domain vnet0 up

domiftune：获取/设置虚拟接口的参数

13.other

domjobabort：abort active domain job 
domjobinfo：domain job information 
可以用来查询任务进展，比如正在进行virsh save操作的时候，可以使用此命令进行查询

dump：将域的核心转储到文件进行分析
domdisplay：域显示连接URI inject-nmi：向guest虚拟机注入NMI（不可屏蔽中断）（当响应时间很关键时使用，例如不可恢复的硬件错误）
vncdisplay：vnc display（输出VNC显示的IP地址和端口号）
ttyconsole：tty console（输出TTY控制台的设备）
schedinfo：show / set scheduler parameters 

lxc-enter-namespace：LXC Guest输入命名空间（virsh lxc-enter-namespace命令可用于输入容器的命名空间和安全上下文，然后执行任意命令。）

send-key：向客户发送密钥代码

在虚拟机内部，每执行一条上述的发送密钥都会回显一个密钥字符串
 send-process-signal：向进程发送信号

console：连接到访客控制台 事件：域事件