15.5.4. ドメインの説明またはタイトルの編集および表示

virsh desc [domain-name] [[--live] [--config] | [--current]] [--title] [--edit] [--new-desc New description or title message] コマンドは、ドメインの説明およびタイトルを表示するか、変更するために使用されますが、ドメインの設定をするものではありません。これらの値は、ドメインの識別を容易にする任意のテキストデータを保存するためのユーザーフィールドです。libvirt は強制しませんが、タイトルは短くすることが望まれます。
--live または --config のオプションは、このコマンドがドメインの稼働中の定義または永続的な定義で機能するかどうかを選択します。--live--config の両方が指定されると、--config オプションが最初に実行され、その場合、コマンドに入力されたものが新規設定となり、現行設定および永続的設定の両方にこれが適用されます。--current オプションは、現行設定を変更するか取得しますが、永続化はされません。 --live--config、または --current のいずれも指定されていない場合は、--current オプションが使用されます。--edit オプションは、現在の説明またはタイトルのコンテンツのあるエディターが開かれた後に、コンテンツが保存されることを指定します。--title オプションを使用すると、ドメインのタイトルフィールドのみを表示または修正し、説明は含まれません。さらに、--edit または --new-desc のいずれも指定されない場合は、説明が表示されますが、これを変更することはできません。
たとえば、コマンド $ virsh desc testvm --current --title TestVM-4F --new-desc Guest VM on fourth floor は、ゲスト仮想マシンのタイトルを testvm から TestVM-4F に変更し、説明も Guest VM on fourth floor に変更します。