From nobody Sun May 5 20:26:16 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1576089965; cv=none; d=zohomail.com; s=zohoarc; b=nixzrs0/DvkIkRARjBvz8cgBq89cF/2odwBL5FZgNu2zBKZgNNC/6RWRjjgtfH4BwqVxxtFHy8v8kOHBPUjsFPEtmGEtl+AC04QCyhpPxYyf1sxL/cIGhD1bMuOTwfvapzHN6DTK1qr433mT18yjJubfVLmk9ygMSVwSQLQDH1s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1576089965; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=Qn52EM5L4SacEjio+7rMWdxwGHaP2KgodRA8rTIY1ao=; b=k7u7vW2St8hf++fxOtjns/e0OAXHFDfCHtfTdhYGN5WhmmXrec5kdM4m7kLmXjgpbivuDMFwLbMTTgh8oqOtz82tQOuNGfgGG0LulkLilySenGmsCcwQ+7LvGjZgPIULF5tshf2826Z5gPwTn/+6GeERiuelPKtz6WenIJxgbKw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1576089965035700.2940833308926; Wed, 11 Dec 2019 10:46:05 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-311-ut4cBcjFOZiYJI-OJ_zWag-1; Wed, 11 Dec 2019 13:45:39 -0500 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 47C52800D41; Wed, 11 Dec 2019 18:45:34 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 205EE5C219; Wed, 11 Dec 2019 18:45:34 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id CC1C318089C8; Wed, 11 Dec 2019 18:45:33 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id xBBIjWHb006040 for ; Wed, 11 Dec 2019 13:45:32 -0500 Received: by smtp.corp.redhat.com (Postfix) id 50D3460C05; Wed, 11 Dec 2019 18:45:32 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-112-62.ams2.redhat.com [10.36.112.62]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8130760BF1; Wed, 11 Dec 2019 18:45:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1576089962; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=Qn52EM5L4SacEjio+7rMWdxwGHaP2KgodRA8rTIY1ao=; b=dxlFcj2QFQniEEWzlrIkiprR1WzcHb5xkwVSKxSlsZ0DMxXa7f7jD4iRoKP8FxCQDgZIJ8 hlZhcGeWYv9LetHzVeZ2CtPrjXLK2v03vULDVXAawJvmyGrR0DHPhPcbadgnAi1HwJOAxG bMVrP+715/AKhodIjIwLp1ocM+Go3oY= From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Date: Wed, 11 Dec 2019 18:45:25 +0000 Message-Id: <20191211184525.1828215-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH] docs: stop using syntax highlighting for man page code blocks X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-MC-Unique: ut4cBcjFOZiYJI-OJ_zWag-1 X-Mimecast-Spam-Score: 0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Some versions of the rst2man convertor are buggy failing to cope with syntax highlighting in code blocks. This isn't something we really need for the man page code blocks, so we can just delete the highlighting directive. Signed-off-by: Daniel P. Berrang=C3=A9 --- docs/manpages/libvirtd.rst | 4 +- docs/manpages/virsh.rst | 576 ++++++++++++++--------------- docs/manpages/virt-admin.rst | 50 +-- docs/manpages/virt-login-shell.rst | 2 +- docs/manpages/virtlockd.rst | 4 +- docs/manpages/virtlogd.rst | 4 +- 6 files changed, 320 insertions(+), 320 deletions(-) diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index b7489a57fc..4125604f9a 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -199,7 +199,7 @@ EXAMPLES =20 To retrieve the version of libvirtd: =20 -.. code-block:: shell +.. code-block:: =20 # libvirtd --version libvirtd (libvirt) 0.8.2 @@ -207,7 +207,7 @@ To retrieve the version of libvirtd: =20 To start libvirtd, instructing it to daemonize and create a PID file: =20 -.. code-block:: shell +.. code-block:: =20 # libvirtd -d # ls -la RUNSTATEDIR/libvirtd.pid diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index e9d6deaee1..e063b76641 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -38,7 +38,7 @@ KVM, LXC, OpenVZ, VirtualBox and VMware ESX. The basic structure of most virsh usage is: =20 =20 -.. code-block:: shell +.. code-block:: =20 virsh [OPTION]... [ARG]... =20 @@ -214,7 +214,7 @@ help =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 help [command-or-group] =20 @@ -228,7 +228,7 @@ group as an option. For example: =20 **Example 1:** =20 -.. code-block:: shell +.. code-block:: =20 virsh # help host =20 @@ -250,7 +250,7 @@ option instead. For example: =20 **Example 2:** =20 -.. code-block:: shell +.. code-block:: =20 virsh # help list NAME @@ -272,7 +272,7 @@ quit, exit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 quit exit @@ -286,7 +286,7 @@ version =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 version [--daemon] =20 @@ -296,7 +296,7 @@ is included in the output. =20 **Example:** =20 -.. code-block:: shell +.. code-block:: =20 $ virsh version Compiled against library: libvirt 1.2.3 @@ -317,7 +317,7 @@ cd =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cd [directory] =20 @@ -334,7 +334,7 @@ pwd =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pwd =20 @@ -347,7 +347,7 @@ connect =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 connect [URI] [--readonly] =20 @@ -388,7 +388,7 @@ uri =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 uri =20 @@ -400,7 +400,7 @@ hostname =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 hostname =20 @@ -412,7 +412,7 @@ sysinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 sysinfo =20 @@ -424,7 +424,7 @@ nodeinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodeinfo =20 @@ -440,7 +440,7 @@ nodecpumap =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodecpumap [--pretty] =20 @@ -456,7 +456,7 @@ nodecpustats =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodecpustats [cpu] [--percent] =20 @@ -471,7 +471,7 @@ nodememstats =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodememstats [cell] =20 @@ -484,7 +484,7 @@ nodesuspend =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodesuspend [target] [duration] =20 @@ -503,7 +503,7 @@ node =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 node-memory-tune [shm-pages-to-scan] [shm-sleep-millisecs] [shm-merge-a= cross-nodes] =20 @@ -525,7 +525,7 @@ capabilities =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 capabilities =20 @@ -545,7 +545,7 @@ domcapabilities =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domcapabilities [virttype] [emulatorbin] [arch] [machine] =20 @@ -588,7 +588,7 @@ pool-capabilities =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-capabilities =20 @@ -605,7 +605,7 @@ inject =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 inject-nmi domain =20 @@ -617,7 +617,7 @@ list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 list [--inactive | --all] [--managed-save] [--title] @@ -637,7 +637,7 @@ specified it prints out information about running domai= ns. =20 An example format for the list is as follows: =20 -.. code-block:: shell +.. code-block:: =20 ``virsh`` list Id Name State @@ -775,7 +775,7 @@ printed in an extra column. This flag is usable only wi= th the default =20 **Example 2:** =20 -.. code-block:: shell +.. code-block:: =20 $ virsh list --title Id Name State Title @@ -790,7 +790,7 @@ freecell =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 freecell [{ [--cellno] cellno | --all }] =20 @@ -809,7 +809,7 @@ freepages =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 freepages [{ [--cellno] cellno [--pagesize] pagesize | --all }] =20 @@ -824,7 +824,7 @@ allocpages =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 allocpages [--pagesize] pagesize [--pagecount] pagecount [[--cellno] ce= llno] [--add] [--all] =20 @@ -843,7 +843,7 @@ cpu-baseline =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cpu-baseline FILE [--features] [--migratable] =20 @@ -864,7 +864,7 @@ cpu-compare =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cpu-compare FILE [--error] =20 @@ -890,7 +890,7 @@ cpu-models =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cpu-models arch =20 @@ -909,7 +909,7 @@ echo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 echo [--shell] [--xml] [err...] [arg...] =20 @@ -926,7 +926,7 @@ hypervisor-cpu-compare =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 hypervisor-cpu-compare FILE [virttype] [emulator] [arch] [machine] [--e= rror] =20 @@ -958,7 +958,7 @@ hypervisor-cpu-baseline =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 hypervisor-cpu-baseline FILE [virttype] [emulator] [arch] [machine] [--= features] [--migratable] =20 @@ -1005,7 +1005,7 @@ autostart =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 autostart [--disable] domain =20 @@ -1020,7 +1020,7 @@ blkdeviotune =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blkdeviotune domain device [[--config] [--live] | [--current]] [[total-bytes-sec] | [read-bytes-sec] [write-bytes-sec]] @@ -1102,7 +1102,7 @@ blkiotune =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blkiotune domain [--weight weight] [--device-weights device-weights] [--device-read-iops-sec device-read-iops-sec] @@ -1163,7 +1163,7 @@ blockcommit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blockcommit domain path [bandwidth] [--bytes] [base] [--shallow] [top] [--delete] [--keep-relative] @@ -1221,7 +1221,7 @@ blockcopy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blockcopy domain path { dest [format] [--blockdev] | --xml file } [--shallow] [--reuse-external] [bandwidth] @@ -1293,7 +1293,7 @@ blockjob =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blockjob domain path { [--abort] [--async] [--pivot] | [--info] [--raw] [--bytes] | [bandwidth] } @@ -1343,7 +1343,7 @@ blockpull =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blockpull domain path [bandwidth] [--bytes] [base] [--wait [--verbose] [--timeout seconds] [--async]] @@ -1384,7 +1384,7 @@ blockresize =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 blockresize domain path size =20 @@ -1405,7 +1405,7 @@ console =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 console domain [devname] [--safe] [--force] =20 @@ -1426,7 +1426,7 @@ cpu-stats =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cpu-stats domain [--total] [start] [count] =20 @@ -1442,7 +1442,7 @@ create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 create FILE [--console] [--paused] [--autodestroy] [--pass-fds N,M,...] [--validate] @@ -1473,7 +1473,7 @@ is only supported with container based virtualization. #. prepare a template from an existing domain (skip directly to 3a if writ= ing one from scratch) =20 - .. code-block:: shell + .. code-block:: =20 # virsh dumpxml > domain.xml =20 @@ -1482,7 +1482,7 @@ is only supported with container based virtualization. a. DO CHANGE! and ( can also be removed), or b. DON'T CHANGE! either or =20 - .. code-block:: shell + .. code-block:: =20 # $EDITOR domain.xml =20 @@ -1493,7 +1493,7 @@ is only supported with container based virtualization. b. an existing persistent domain will run with a modified one-time configuration =20 - .. code-block:: shell + .. code-block:: =20 # virsh create domain.xml =20 @@ -1503,7 +1503,7 @@ define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 define FILE [--validate] =20 @@ -1519,7 +1519,7 @@ desc =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 desc domain [[--live] [--config] | [--current]] [--title] [--edit] [--new-desc @@ -1551,7 +1551,7 @@ destroy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 destroy domain [--graceful] =20 @@ -1579,7 +1579,7 @@ domblkerror =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domblkerror domain =20 @@ -1595,7 +1595,7 @@ domblkinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domblkinfo domain [block-device --all] [--human] =20 @@ -1615,7 +1615,7 @@ domblklist =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domblklist domain [--inactive] [--details] =20 @@ -1635,7 +1635,7 @@ domblkstat =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domblkstat domain [block-device] [--human] =20 @@ -1672,7 +1672,7 @@ domblkthreshold =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domblkthreshold domain dev threshold =20 @@ -1687,7 +1687,7 @@ domcontrol =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domcontrol domain =20 @@ -1701,7 +1701,7 @@ domdisplay =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domdisplay domain [--include-password] [[--type] type] [--all] =20 @@ -1718,7 +1718,7 @@ domfsfreeze =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domfsfreeze domain [[--mountpoint] mountpoint...] =20 @@ -1740,7 +1740,7 @@ domfsinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domfsinfo domain =20 @@ -1757,7 +1757,7 @@ domfsthaw =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domfsthaw domain [[--mountpoint] mountpoint...] =20 @@ -1774,7 +1774,7 @@ domfstrim =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domfstrim domain [--minimum bytes] [--mountpoint mountPoint] =20 @@ -1795,7 +1795,7 @@ domhostname =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domhostname domain =20 @@ -1807,7 +1807,7 @@ domid =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domid domain-name-or-uuid =20 @@ -1819,7 +1819,7 @@ domif =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domif-getlink domain interface-device [--config] =20 @@ -1835,7 +1835,7 @@ domif =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domif-setlink domain interface-device state [--config] =20 @@ -1851,7 +1851,7 @@ domifaddr =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domifaddr domain [interface] [--full] [--source lease|agent|arp] @@ -1878,7 +1878,7 @@ backup-begin =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 backup-begin domain [backupxml] [checkpointxml] [--reuse-external] =20 @@ -1912,7 +1912,7 @@ backup-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 backup-dumpxml domain =20 @@ -1924,7 +1924,7 @@ domiflist =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domiflist domain [--inactive] =20 @@ -1941,7 +1941,7 @@ domifstat =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domifstat domain interface-device =20 @@ -1958,7 +1958,7 @@ domiftune =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domiftune domain interface-device [[--config] [--live] | [--current]] [*--inbound average,peak,burst,floor*] @@ -1992,7 +1992,7 @@ dominfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dominfo domain =20 @@ -2004,7 +2004,7 @@ domjobabort =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domjobabort domain =20 @@ -2016,7 +2016,7 @@ domjobinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domjobinfo domain [--completed [--keep-completed]] [--anystats] [--raws= tats] =20 @@ -2043,7 +2043,7 @@ dommemstat =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dommemstat domain [--period seconds] [[--config] [--live] | [--current]] =20 @@ -2096,7 +2096,7 @@ domname =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domname domain-id-or-uuid =20 @@ -2108,7 +2108,7 @@ dompmsuspend =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dompmsuspend domain target [--duration] =20 @@ -2139,7 +2139,7 @@ dompmwakeup =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dompmwakeup domain =20 @@ -2154,7 +2154,7 @@ domrename =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domrename domain new-name =20 @@ -2169,7 +2169,7 @@ domstate =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domstate domain [--reason] =20 @@ -2182,7 +2182,7 @@ domstats =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domstats [--raw] [--enforce] [--backing] [--nowait] [--state] [--cpu-total] [--balloon] [--vcpu] [--interface] @@ -2389,7 +2389,7 @@ domtime =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domtime domain { [--now] [--pretty] [--sync] [--time time] } =20 @@ -2414,7 +2414,7 @@ domuuid =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domuuid domain-name-or-id =20 @@ -2426,7 +2426,7 @@ domxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domxml-from-native format config =20 @@ -2444,7 +2444,7 @@ domxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 domxml-to-native format { [--xml] xml | --domain domain-name-or-id-or-u= uid } =20 @@ -2459,7 +2459,7 @@ dump =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dump domain corefilepath [--bypass-cache] { [--live] | [--crash] | [--reset] } @@ -2501,7 +2501,7 @@ dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 dumpxml domain [--inactive] [--security-info] [--update-cpu] [--migrata= ble] =20 @@ -2522,7 +2522,7 @@ edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 edit domain =20 @@ -2531,7 +2531,7 @@ next boot of the guest. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh dumpxml --inactive --security-info domain > domain.xml vi domain.xml (or make changes with your other text editor) @@ -2548,7 +2548,7 @@ emulatorpin =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 emulatorpin domain [cpulist] [[--live] [--config] | [--current]] =20 @@ -2570,7 +2570,7 @@ event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 event {[domain] { event | --all } [--loop] [--timeout seconds] [--times= tamp] | --list} =20 @@ -2597,7 +2597,7 @@ guest =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 guest-agent-timeout domain --timeout value =20 @@ -2616,7 +2616,7 @@ guestinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 guestinfo domain [--user] [--os] [--timezone] [--hostname] [--filesyste= m] =20 @@ -2692,7 +2692,7 @@ guestvcpus =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 guestvcpus domain [[--enable] | [--disable]] [cpulist] =20 @@ -2711,7 +2711,7 @@ iothreadadd =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iothreadadd domain iothread_id [[--config] [--live] | [--current]] =20 @@ -2731,7 +2731,7 @@ iothreaddel =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iothreaddel domain iothread_id [[--config] [--live] | [--current]] =20 @@ -2752,7 +2752,7 @@ iothreadinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iothreadinfo domain [[--live] [--config] | [--current]] =20 @@ -2772,7 +2772,7 @@ iothreadpin =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iothreadpin domain iothread cpulist [[--live] [--config] | [--current]] =20 @@ -2805,7 +2805,7 @@ iothreadset =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iothreadset domain iothread_id [[--poll-max-ns ns] [--poll-grow factor] [--poll-shrink divisor]] @@ -2836,7 +2836,7 @@ managedsave =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 managedsave domain [--bypass-cache] [{--running | --paused}] [--verbose] =20 @@ -2865,7 +2865,7 @@ managedsave-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 managedsave-define domain xml [{--running | --paused}] =20 @@ -2885,7 +2885,7 @@ managedsave-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 managedsave-dumpxml domain [--security-info] =20 @@ -2899,7 +2899,7 @@ managedsave-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 managedsave-edit domain [{--running | --paused}] =20 @@ -2913,7 +2913,7 @@ will allow overriding which state the ``restore`` sho= uld use. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh managedsave-dumpxml domain-name > state-file.xml vi state-file.xml (or make changes with your other text editor) @@ -2930,7 +2930,7 @@ managedsave-remove =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 managedsave-remove domain =20 @@ -2943,7 +2943,7 @@ maxvcpus =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 maxvcpus [type] =20 @@ -2957,7 +2957,7 @@ memtune =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 memtune domain [--hard-limit size] [--soft-limit size] [--swap-hard-lim= it size] [--min-guarantee size] [[--config] [--live] | [--current]] @@ -3015,7 +3015,7 @@ metadata =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 metadata domain [[--live] [--config] | [--current]] [--edit] [uri] [key] [set] [--remove] @@ -3054,7 +3054,7 @@ migrate =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate [--live] [--offline] [--direct] [--p2p [--tunnelled]] [--persistent] [--undefinesource] [--suspend] [--copy-storage-all] @@ -3228,7 +3228,7 @@ connected to and needs to connect through a proxy, *g= raphicsuri* may be used to specify the address the client should connect to. The URI is formed as follows: =20 -.. code-block:: shell +.. code-block:: =20 protocol://hostname[:port]/[?parameters] =20 @@ -3236,7 +3236,7 @@ where protocol is either "spice" or "vnc" and paramet= ers is a list of protocol specific parameters separated by '&'. Currently recognized parameters are "tlsPort" and "tlsSubject". For example, =20 -.. code-block:: shell +.. code-block:: =20 spice://target.host.com:1234/?tlsPort=3D4567 =20 @@ -3255,7 +3255,7 @@ migrate-compcache =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-compcache domain [--size bytes] =20 @@ -3275,7 +3275,7 @@ migrate-getmaxdowntime =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-getmaxdowntime domain =20 @@ -3290,7 +3290,7 @@ migrate-getspeed =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-getspeed domain [--postcopy] =20 @@ -3304,7 +3304,7 @@ migrate-postcopy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-postcopy domain =20 @@ -3317,7 +3317,7 @@ migrate-setmaxdowntime =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-setmaxdowntime domain downtime =20 @@ -3331,7 +3331,7 @@ migrate-setspeed =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 migrate-setspeed domain bandwidth [--postcopy] =20 @@ -3349,7 +3349,7 @@ numatune =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 numatune domain [--mode mode] [--nodeset nodeset] [[--config] [--live] | [--current]] @@ -3378,7 +3378,7 @@ perf =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 perf domain [--enable eventSpec] [--disable eventSpec] [[--config] [--live] | [--current]] @@ -3466,7 +3466,7 @@ reboot =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 reboot domain [--mode MODE-LIST] =20 @@ -3492,7 +3492,7 @@ reset =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 reset domain =20 @@ -3508,7 +3508,7 @@ restore =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 restore state-file [--bypass-cache] [--xml file] [{--running | --paused}] @@ -3540,7 +3540,7 @@ resume =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 resume domain =20 @@ -3554,7 +3554,7 @@ save =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 save domain state-file [--bypass-cache] [--xml file] [{--running | --paused}] [--verbose] @@ -3598,7 +3598,7 @@ save-image-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 save-image-define file xml [{--running | --paused}] =20 @@ -3620,7 +3620,7 @@ save-image-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 save-image-dumpxml file [--security-info] =20 @@ -3634,7 +3634,7 @@ save-image-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 save-image-edit file [{--running | --paused}] =20 @@ -3648,7 +3648,7 @@ will allow overriding which state the ``restore`` sho= uld use. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh save-image-dumpxml state-file > state-file.xml vi state-file.xml (or make changes with your other text editor) @@ -3665,7 +3665,7 @@ schedinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 schedinfo domain [[--config] [--live] | [--current]] [[--set] parameter= =3Dvalue]... schedinfo [--weight number] [--cap number] domain @@ -3706,7 +3706,7 @@ screenshot =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 screenshot domain [imagefilepath] [--screen screenID] =20 @@ -3723,7 +3723,7 @@ send-key =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 send-key domain [--codeset codeset] [--holdtime holdtime] keycode... =20 @@ -3820,7 +3820,7 @@ distinct keypresses, you must use multiple send-key i= nvocations. =20 **Examples:** =20 -.. code-block:: shell +.. code-block:: =20 # send three strokes 'k', 'e', 'y', using xt codeset. these # are all pressed simultaneously and may be received by the guest @@ -3840,7 +3840,7 @@ send-process-signal =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 send-process-signal domain-id pid signame =20 @@ -3851,7 +3851,7 @@ domain namespace. The *signame* argument may be either an integer signal constant number, or one of the symbolic names: =20 -.. code-block:: shell +.. code-block:: =20 "nop", "hup", "int", "quit", "ill", "trap", "abrt", "bus", "fpe", "kill", @@ -3871,7 +3871,7 @@ may be in uppercase or lowercase. =20 **Examples:** =20 -.. code-block:: shell +.. code-block:: =20 virsh send-process-signal myguest 1 15 virsh send-process-signal myguest 1 term @@ -3884,7 +3884,7 @@ set-lifecycle-action =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 set-lifecycle-action domain type action [[--config] [--live] | [--current]] @@ -3901,7 +3901,7 @@ set-user-password =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 set-user-password domain user password [--encrypted] =20 @@ -3919,7 +3919,7 @@ setmaxmem =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 setmaxmem domain size [[--config] [--live] | [--current]] =20 @@ -3950,7 +3950,7 @@ setmem =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 setmem domain size [[--config] [--live] | [--current]] =20 @@ -3985,7 +3985,7 @@ setvcpus =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 setvcpus domain count [--maximum] [[--config] [--live] | [--current]] [= --guest] [--hotpluggable] =20 @@ -4036,7 +4036,7 @@ setvcpu =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 setvcpu domain vcpulist [--enable] | [--disable] [[--live] [--config] | [--current]] @@ -4063,7 +4063,7 @@ shutdown =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 shutdown domain [--mode MODE-LIST] =20 @@ -4095,7 +4095,7 @@ start =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 start domain-name-or-uuid [--console] [--paused] [--autodestroy] [--bypass-cache] [--force-boot] @@ -4124,7 +4124,7 @@ suspend =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 suspend domain =20 @@ -4137,7 +4137,7 @@ ttyconsole =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 ttyconsole domain =20 @@ -4150,7 +4150,7 @@ undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 undefine domain [--managed-save] [--snapshots-metadata] [--checkpoints-metadata] [--nvram] [--keep-nvram] @@ -4216,7 +4216,7 @@ vcpucount =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vcpucount domain [{--maximum | --active} {--config | --live | --current}] [--guest] @@ -4247,7 +4247,7 @@ vcpuinfo =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vcpuinfo domain [--pretty] =20 @@ -4258,7 +4258,7 @@ With *--pretty*, cpu affinities are shown as ranges. =20 **Example:** =20 -.. code-block:: shell +.. code-block:: =20 $ virsh vcpuinfo fedora VCPU: 0 @@ -4311,7 +4311,7 @@ vcpupin =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vcpupin domain [vcpu] [cpulist] [[--live] [--config] | [--current]] =20 @@ -4339,7 +4339,7 @@ vncdisplay =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vncdisplay domain =20 @@ -4362,7 +4362,7 @@ attach-device =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 attach-device domain FILE [[[--live] [--config] | [--current]] | [--per= sistent]] =20 @@ -4398,7 +4398,7 @@ attach-disk =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 attach-disk domain source target [[[--live] [--config] | [--current]] | [--persistent]] [--targetbus bus] @@ -4464,7 +4464,7 @@ attach-interface =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 attach-interface domain type source [[[--live] [--config] | [--current]] | [--persistent]] @@ -4555,7 +4555,7 @@ detach-device =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 detach-device domain FILE [[[--live] [--config] | [--current]] | [--persistent]] @@ -4601,7 +4601,7 @@ detach-device-alias =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 detach-device-alias domain alias [[[--live] [--config] | [--current]]]] =20 @@ -4622,7 +4622,7 @@ detach-disk =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 detach-disk domain target [[[--live] [--config] | [--current]] | [--persistent]] [--print-xml] @@ -4655,7 +4655,7 @@ detach-interface =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 detach-interface domain type [--mac mac] [[[--live] [--config] | [--current]] | [--persistent]] @@ -4687,7 +4687,7 @@ update-device =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 update-device domain file [--force] [[[--live] [--config] | [--current]] | [--persistent]] @@ -4721,7 +4721,7 @@ change-media =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 change-media domain path [--eject] [--insert] [--update] [source] [--force] [[--live] [--config] | @@ -4791,7 +4791,7 @@ nodedev-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-create FILE =20 @@ -4807,7 +4807,7 @@ nodedev-destroy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-destroy device =20 @@ -4822,7 +4822,7 @@ nodedev-detach =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-detach nodedev [--driver backend_driver] =20 @@ -4842,7 +4842,7 @@ nodedev-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-dumpxml device =20 @@ -4859,7 +4859,7 @@ nodedev-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-list cap --tree =20 @@ -4878,7 +4878,7 @@ nodedev-reattach =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-reattach nodedev =20 @@ -4893,7 +4893,7 @@ nodedev-reset =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-reset nodedev =20 @@ -4908,7 +4908,7 @@ nodedev-event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nodedev-event {[nodedev] event [--loop] [--timeout seconds] [--timestam= p] | --list} =20 @@ -4944,7 +4944,7 @@ net-autostart =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-autostart network [--disable] =20 @@ -4957,7 +4957,7 @@ net-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-create file =20 @@ -4972,7 +4972,7 @@ net-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-define file =20 @@ -4985,7 +4985,7 @@ net-destroy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-destroy network =20 @@ -4998,7 +4998,7 @@ net-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-dumpxml network [--inactive] =20 @@ -5013,7 +5013,7 @@ net-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-edit network =20 @@ -5021,7 +5021,7 @@ Edit the XML configuration file for a network. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh net-dumpxml --inactive network > network.xml vi network.xml (or make changes with your other text editor) @@ -5038,7 +5038,7 @@ net-event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-event {[network] event [--loop] [--timeout seconds] [--timestamp] |= --list} =20 @@ -5063,7 +5063,7 @@ net-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-info network =20 @@ -5075,7 +5075,7 @@ net-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-list [--inactive | --all] { [--table] | --name | --uuid } @@ -5106,7 +5106,7 @@ net-name =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-name network-UUID =20 @@ -5118,7 +5118,7 @@ net-start =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-start network =20 @@ -5130,7 +5130,7 @@ net-undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-undefine network =20 @@ -5143,7 +5143,7 @@ net-uuid =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-uuid network-name =20 @@ -5155,7 +5155,7 @@ net-update =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-update network command section xml [--parent-index index] [[--live] [--config] | [--current]] @@ -5202,7 +5202,7 @@ net-dhcp-leases =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-dhcp-leases network [mac] =20 @@ -5227,7 +5227,7 @@ net-port-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-port-list { [--table] | --uuid } network =20 @@ -5244,7 +5244,7 @@ net-port-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-port-create network file =20 @@ -5257,7 +5257,7 @@ net-port-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-port-dumpxml network port =20 @@ -5269,7 +5269,7 @@ net-port-delete =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 net-port-delete network port =20 @@ -5298,7 +5298,7 @@ iface-bridge =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-bridge interface bridge [--no-stp] [delay] [--no-start] =20 @@ -5317,7 +5317,7 @@ iface-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-define file =20 @@ -5330,7 +5330,7 @@ iface-destroy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-destroy interface =20 @@ -5343,7 +5343,7 @@ iface-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-dumpxml interface [--inactive] =20 @@ -5357,7 +5357,7 @@ iface-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-edit interface =20 @@ -5365,7 +5365,7 @@ Edit the XML configuration file for a host interface. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh iface-dumpxml iface > iface.xml vi iface.xml (or make changes with your other text editor) @@ -5382,7 +5382,7 @@ iface-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-list [--inactive | --all] =20 @@ -5396,7 +5396,7 @@ iface-name =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-name interface =20 @@ -5411,7 +5411,7 @@ iface-mac =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-mac interface =20 @@ -5425,7 +5425,7 @@ iface-start =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-start interface =20 @@ -5437,7 +5437,7 @@ iface-unbridge =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-unbridge bridge [--no-start] =20 @@ -5455,7 +5455,7 @@ iface-undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-undefine interface =20 @@ -5467,7 +5467,7 @@ iface-begin =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-begin =20 @@ -5485,7 +5485,7 @@ iface-commit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-commit =20 @@ -5499,7 +5499,7 @@ iface-rollback =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 iface-rollback =20 @@ -5525,7 +5525,7 @@ find-storage-pool-sources =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 find-storage-pool-sources type [srcSpec] =20 @@ -5562,7 +5562,7 @@ find-pool-sources-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 find-storage-pool-sources-as type [host] [port] [initiator] =20 @@ -5586,7 +5586,7 @@ pool-autostart =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-autostart pool-or-uuid [--disable] =20 @@ -5598,7 +5598,7 @@ pool-build =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-build pool-or-uuid [--overwrite] [--no-overwrite] =20 @@ -5640,7 +5640,7 @@ pool-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-create file [--build] [[--overwrite] | [--no-overwrite]] =20 @@ -5658,7 +5658,7 @@ pool-create-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-create-as name type [--source-host hostname] [--source-path path] [--source-dev path] @@ -5744,7 +5744,7 @@ pool-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-define file =20 @@ -5757,7 +5757,7 @@ pool-define-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-define-as name type [--source-host hostname] [--source-path path] [--source-dev path] @@ -5782,7 +5782,7 @@ pool-destroy =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-destroy pool-or-uuid =20 @@ -5797,7 +5797,7 @@ pool-delete =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-delete pool-or-uuid =20 @@ -5811,7 +5811,7 @@ pool-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-dumpxml [--inactive] pool-or-uuid =20 @@ -5825,7 +5825,7 @@ pool-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-edit pool-or-uuid =20 @@ -5833,7 +5833,7 @@ Edit the XML configuration file for a storage pool. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh pool-dumpxml pool > pool.xml vi pool.xml (or make changes with your other text editor) @@ -5850,7 +5850,7 @@ pool-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-info [--bytes] pool-or-uuid =20 @@ -5863,7 +5863,7 @@ pool-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-list [--inactive] [--all] [--persistent] [--transient] @@ -5903,7 +5903,7 @@ pool-name =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-name uuid =20 @@ -5915,7 +5915,7 @@ pool-refresh =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-refresh pool-or-uuid =20 @@ -5927,7 +5927,7 @@ pool-start =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-start pool-or-uuid [--build] [[--overwrite] | [--no-overwrite]] =20 @@ -5955,7 +5955,7 @@ pool-undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-undefine pool-or-uuid =20 @@ -5967,7 +5967,7 @@ pool-uuid =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-uuid pool =20 @@ -5979,7 +5979,7 @@ pool-event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pool-event {[pool] event [--loop] [--timeout seconds] [--timestamp] | -= -list} =20 @@ -6007,7 +6007,7 @@ vol-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-create pool-or-uuid FILE [--prealloc-metadata] =20 @@ -6026,7 +6026,7 @@ only slightly higher initial disk space usage. =20 **Example:** =20 -.. code-block:: shell +.. code-block:: =20 virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml vi newvolume.xml (or make changes with your other text editor) @@ -6038,7 +6038,7 @@ vol-create-from =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-create-from pool-or-uuid FILE vol-name-or-key-or-path [--inputpool pool-or-uuid] [--prealloc-metadata] [--reflink] @@ -6069,7 +6069,7 @@ vol-create-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-create-as pool-or-uuid name capacity [--allocation size] [--format = string] [--backing-vol vol-name-or-key-or-path] @@ -6118,7 +6118,7 @@ vol-clone =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-clone vol-name-or-key-or-path name [--pool pool-or-uuid] [--prealloc-metadata] [--reflink] @@ -6151,7 +6151,7 @@ vol-delete =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-delete vol-name-or-key-or-path [--pool pool-or-uuid] [--delete-snap= shots] =20 @@ -6175,7 +6175,7 @@ vol-upload =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-upload vol-name-or-key-or-path local-file [--pool pool-or-uuid] [--offset bytes] @@ -6213,7 +6213,7 @@ vol-download =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-download vol-name-or-key-or-path local-file [--pool pool-or-uuid] [--offset bytes] [--length bytes] @@ -6244,7 +6244,7 @@ vol-wipe =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-wipe vol-name-or-key-or-path [--pool pool-or-uuid] [--algorithm alg= orithm] =20 @@ -6303,7 +6303,7 @@ vol-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-dumpxml vol-name-or-key-or-path [--pool pool-or-uuid] =20 @@ -6323,7 +6323,7 @@ vol-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-info vol-name-or-key-or-path [--pool pool-or-uuid] [--bytes] [--phy= sical] =20 @@ -6352,7 +6352,7 @@ vol-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-list [--pool pool-or-uuid] [--details] =20 @@ -6369,7 +6369,7 @@ vol-pool =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-pool vol-key-or-path [--uuid] =20 @@ -6387,7 +6387,7 @@ vol-path =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-path vol-name-or-key [--pool pool-or-uuid] =20 @@ -6406,7 +6406,7 @@ vol-name =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-name vol-key-or-path =20 @@ -6420,7 +6420,7 @@ vol-key =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-key vol-name-or-path [--pool pool-or-uuid] =20 @@ -6440,7 +6440,7 @@ vol-resize =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 vol-resize vol-name-or-path capacity [--pool pool-or-uuid] [--allocate]= [--delta] [--shrink] =20 @@ -6485,7 +6485,7 @@ secret-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-define file =20 @@ -6500,7 +6500,7 @@ secret-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-dumpxml secret =20 @@ -6512,7 +6512,7 @@ secret-event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-event {[secret] event [--loop] [--timeout seconds] [--timestamp]= | --list} =20 @@ -6537,7 +6537,7 @@ secret-set-value =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-set-value secret base64 =20 @@ -6550,7 +6550,7 @@ secret-get-value =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-get-value secret =20 @@ -6563,7 +6563,7 @@ secret-undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-undefine secret =20 @@ -6577,7 +6577,7 @@ secret-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 secret-list [--ephemeral] [--no-ephemeral] [--private] [--no-private] @@ -6604,7 +6604,7 @@ snapshot-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-create domain [xmlfile] {[--redefine [--current]] | [--no-metadata] [--halt] [--disk-only] [--reuse-external] @@ -6685,7 +6685,7 @@ snapshot-create-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-create-as domain {[--print-xml] [--no-metadata] [--halt] [--reuse-external]} [name] @@ -6723,7 +6723,7 @@ all three of *domain*, *name*, and *description* are = also present. For example, a diskspec of "vda,snapshot=3Dexternal,file=3D/path/to,,new" results in the following XML: =20 -.. code-block:: xml +.. code-block:: =20 @@ -6766,7 +6766,7 @@ snapshot-current =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-current domain {[--name] | [--security-info] | [snapshotname]} =20 @@ -6785,7 +6785,7 @@ snapshot-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-edit domain [snapshotname] [--current] {[--rename] | [--clone]} =20 @@ -6797,7 +6797,7 @@ snapshot. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh snapshot-dumpxml dom name > snapshot.xml vi snapshot.xml (or make changes with your other text editor) @@ -6822,7 +6822,7 @@ snapshot-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-info domain {snapshot | --current} =20 @@ -6835,7 +6835,7 @@ snapshot-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-list domain [--metadata] [--no-metadata] [{--parent | --roots | [{--tree | --name}]}] [--topological] @@ -6904,7 +6904,7 @@ snapshot-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-dumpxml domain snapshot [--security-info] =20 @@ -6918,7 +6918,7 @@ snapshot-parent =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-parent domain {snapshot | --current} =20 @@ -6931,7 +6931,7 @@ snapshot-revert =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-revert domain {snapshot | --current} [{--running | --paused}] = [--force] =20 @@ -6972,7 +6972,7 @@ snapshot-delete =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 snapshot-delete domain {snapshot | --current} [--metadata] [{--children | --children-only}] @@ -7006,7 +7006,7 @@ checkpoint-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-create domain [xmlfile] { --redefine | [--quiesce]} =20 @@ -7045,7 +7045,7 @@ checkpoint-create-as =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-create-as domain [--print-xml] [name] [description] [--quiesce] [--diskspec] diskspec]... @@ -7065,7 +7065,7 @@ all three of *domain*, *name*, and *description* are = also present. For example, a diskspec of "vda,checkpoint=3Dbitmap,bitmap=3Dmap1" results in the following XML: =20 -.. code-block:: xml +.. code-block:: =20 =20 @@ -7083,7 +7083,7 @@ checkpoint-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-edit domain checkpointname =20 @@ -7091,7 +7091,7 @@ Edit the XML configuration file for *checkpointname* = of a domain. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh checkpoint-dumpxml dom name > checkpoint.xml vi checkpoint.xml (or make changes with your other text editor) @@ -7109,7 +7109,7 @@ checkpoint-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-info domain checkpoint =20 @@ -7121,7 +7121,7 @@ checkpoint-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-list domain [{--parent | --roots | [{--tree | --name}]}] [--topological] @@ -7167,7 +7167,7 @@ checkpoint-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-dumpxml domain checkpoint [--security-info] [--no-domain] [-= -size] =20 @@ -7187,7 +7187,7 @@ checkpoint-parent =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-parent domain checkpoint =20 @@ -7199,7 +7199,7 @@ checkpoint =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 checkpoint-delete domain checkpoint [--metadata] [{--children | --children-only}] @@ -7236,7 +7236,7 @@ nwfilter-define =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-define xmlfile =20 @@ -7253,7 +7253,7 @@ nwfilter-undefine =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-undefine nwfilter-name =20 @@ -7266,7 +7266,7 @@ nwfilter-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-list =20 @@ -7278,7 +7278,7 @@ nwfilter-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-dumpxml nwfilter-name =20 @@ -7290,7 +7290,7 @@ nwfilter-edit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-edit nwfilter-name =20 @@ -7298,7 +7298,7 @@ Edit the XML of a network filter. =20 This is equivalent to: =20 -.. code-block:: shell +.. code-block:: =20 virsh nwfilter-dumpxml myfilter > myfilter.xml vi myfilter.xml (or make changes with your other text editor) @@ -7329,7 +7329,7 @@ nwfilter-binding-create =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-binding-create xmlfile =20 @@ -7348,7 +7348,7 @@ nwfilter-binding-delete =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-binding-delete port-name =20 @@ -7366,7 +7366,7 @@ nwfilter-binding-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-binding-list =20 @@ -7378,7 +7378,7 @@ nwfilter-binding-dumpxml =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 nwfilter-binding-dumpxml port-name =20 @@ -7402,7 +7402,7 @@ qemu-attach =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 qemu-attach pid =20 @@ -7411,7 +7411,7 @@ The QEMU process must have been created with a monito= r connection using the UNIX driver. Ideally the process will also have had the '-name' argument specified. =20 -.. code-block:: shell +.. code-block:: =20 $ qemu-kvm -cdrom ~/demo.iso \ -monitor unix:/tmp/demo,server,nowait \ @@ -7432,7 +7432,7 @@ qemu-monitor-command =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 qemu-monitor-command domain { [--hmp] | [--pretty] } command... =20 @@ -7451,7 +7451,7 @@ qemu-agent-command =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 qemu-agent-command domain [--timeout seconds | --async | --block] comma= nd... =20 @@ -7469,7 +7469,7 @@ qemu-monitor-event =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 qemu-monitor-event [domain] [--event event-name] [--loop] [--timeout seconds] [--pretty] [--regex] [--no-case] @@ -7500,7 +7500,7 @@ lxc-enter-namespace =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 lxc-enter-namespace domain [--noseclabel] -- /path/to/binary [arg1, [arg2, ...]] diff --git a/docs/manpages/virt-admin.rst b/docs/manpages/virt-admin.rst index bf42139f30..51c3d3917e 100644 --- a/docs/manpages/virt-admin.rst +++ b/docs/manpages/virt-admin.rst @@ -28,7 +28,7 @@ as for monitoring and managing all clients connected to t= he daemon. =20 The basic structure of most virt-admin usage is: =20 -.. code-block:: shell +.. code-block:: =20 virt-admin [OPTION]... [ARG]... =20 @@ -107,7 +107,7 @@ help =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 help [command-or-group] =20 @@ -124,7 +124,7 @@ quit, exit =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 quit exit @@ -136,7 +136,7 @@ version =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 version =20 @@ -146,7 +146,7 @@ the version of the daemon. =20 **Example:** =20 -.. code-block:: shell +.. code-block:: =20 $ virt-admin version Compiled against library: libvirt 1.2.21 @@ -160,7 +160,7 @@ cd =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 cd [directory] =20 @@ -175,7 +175,7 @@ pwd =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 pwd =20 @@ -187,7 +187,7 @@ connect =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 connect [URI] =20 @@ -206,7 +206,7 @@ uri =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 uri =20 @@ -230,7 +230,7 @@ server-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 server-list =20 @@ -243,7 +243,7 @@ daemon-log-filters =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 daemon-log-filters [--filters string] =20 @@ -264,7 +264,7 @@ space. Each filter must conform to the form described i= n detail by To define a filter which suppresses all e.g. 'virObjectUnref' DEBUG messages, use the following: =20 -.. code-block:: shell +.. code-block:: =20 $ virt-admin daemon-log-filters "4:util.object" =20 @@ -277,7 +277,7 @@ daemon-log-outouts =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 daemon-log-outputs [--outputs string] =20 @@ -298,13 +298,13 @@ space. Each output must conform to the form described= in detail by To replace the current setting for logging outputs with one that writes to a file while logging errors only, the following could be used: =20 -.. code-block:: shell +.. code-block:: =20 $ virt-admin daemon-log-outputs "4:file:" =20 To define multiple outputs at once they need to be delimited by spaces: =20 -.. code-block:: shell +.. code-block:: =20 $ virt-admin daemon-log-outputs "4:stderr 2:syslog:" =20 @@ -320,7 +320,7 @@ server-threadpool-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 server-threadpool-info server =20 @@ -355,7 +355,7 @@ that, unlike tasks carried out by normal workers, are w= ithin libvirt's full control and libvirt guarantees that such a task cannot hang, thus will alw= ays finish. An example of such a task this would be destroying a domain: =20 -.. code-block:: shell +.. code-block:: =20 $ virsh destroy . =20 @@ -365,7 +365,7 @@ server-threadpool-set =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 server-threadpool-set server [--min-workers count] [--max-workers count= ] [--priority-workers count] =20 @@ -394,7 +394,7 @@ server-clients-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 server-clients-info server =20 @@ -407,7 +407,7 @@ runtime values, more specifically, the current number o= f clients connected to =20 **Example:** =20 -.. code-block:: shell +.. code-block:: =20 # virt-admin server-clients-info libvirtd nclients_max : 120 @@ -421,7 +421,7 @@ server-clients-set =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 server-clients-set server [--max-clients count] [--max-unauth-clients c= ount] =20 @@ -457,7 +457,7 @@ client-list =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 client-list server =20 @@ -471,7 +471,7 @@ client-info =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 client-info server client =20 @@ -487,7 +487,7 @@ enabled within daemon). =20 **Examples:** =20 -.. code-block:: shell +.. code-block:: =20 # virt-admin client-info libvirtd 1 id : 1 @@ -513,7 +513,7 @@ client-disconnect =20 **Syntax:** =20 -.. code-block:: shell +.. code-block:: =20 client-disconnect server client =20 diff --git a/docs/manpages/virt-login-shell.rst b/docs/manpages/virt-login-= shell.rst index 4716493f87..3833a3e912 100644 --- a/docs/manpages/virt-login-shell.rst +++ b/docs/manpages/virt-login-shell.rst @@ -29,7 +29,7 @@ configured in ``/etc/libvirt/virt-login-shell.conf``. =20 The basic structure of most ``virt-login-shell`` usage is: =20 -.. code-block:: shell +.. code-block:: =20 virt-login-shell =20 diff --git a/docs/manpages/virtlockd.rst b/docs/manpages/virtlockd.rst index 4066934e42..1dc106d6fc 100644 --- a/docs/manpages/virtlockd.rst +++ b/docs/manpages/virtlockd.rst @@ -120,14 +120,14 @@ EXAMPLES =20 To retrieve the version of ``virtlockd``: =20 -.. code-block:: shell +.. code-block:: =20 # virtlockd --version virtlockd (libvirt) 1.1.1 =20 To start ``virtlockd``, instructing it to daemonize and create a PID file: =20 -.. code-block:: shell +.. code-block:: =20 # virtlockd -d # ls -la RUNSTATEDIR/virtlockd.pid diff --git a/docs/manpages/virtlogd.rst b/docs/manpages/virtlogd.rst index 7f4c5d7e7f..c84ab2e621 100644 --- a/docs/manpages/virtlogd.rst +++ b/docs/manpages/virtlogd.rst @@ -121,14 +121,14 @@ EXAMPLES =20 To retrieve the version of ``virtlogd``: =20 -.. code-block:: shell +.. code-block:: =20 # virtlogd --version virtlogd (libvirt) 1.1.1 =20 To start ``virtlogd``, instructing it to daemonize and create a PID file: =20 -.. code-block:: shell +.. code-block:: =20 # virtlogd -d # ls -la RUNSTATEDIR/virtlogd.pid --=20 2.23.0 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list