14.5.4. 编辑和显示域的描述和标题

以下命令用于显示或修改域的描述和标题，但不配置它：

# virsh desc [domain-name] [[--live] [--config] | [--current]] [--title] [--edit] [--new-desc New description or title message]

这些值是用户字段，允许存储任意文本数据以便易于识别域。理想情况下，标题应该很短，尽管 libvirt 不强制实施。

options --live 或 --config 选择此命令是否可以用于域的实时或永久定义。如果指定了 --live 和 --config，则会首先实施 --config 选项，其中在命令中输入的描述成为新的配置设置，该设置应用于实时配置和持久配置设置。current 选项将修改或获取当前状态配置，并且不具有持久性。如果未指定 --live 和 --config，则 --current 选项将使用 --current。edit 选项指定包含当前描述或标题内容的编辑器应打开，之后再保存的内容。使用 --title 选项将显示或修改域的标题字段，而不包括其描述。另外，如果命令中没有使用 --edit 和 --new-desc，则仅显示描述且无法修改。

例如，以下命令可将 guest 虚拟机的标题从 testvm 更改为 TestVM-4F，并将描述更改为 guest 虚拟机在第四四个阶段 ：

$ virsh desc testvm --current --title TestVM-4F --new-desc Guest VM on fourth floor