From nobody Wed May 14 19:26:36 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1520889132993715.0323512585944; Mon, 12 Mar 2018 14:12:12 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 7FDB636807; Mon, 12 Mar 2018 21:12:11 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4238A60BEB; Mon, 12 Mar 2018 21:12:11 +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 E6A8B4CA99; Mon, 12 Mar 2018 21:12:09 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id w2CLC8N2028700 for ; Mon, 12 Mar 2018 17:12:08 -0400 Received: by smtp.corp.redhat.com (Postfix) id C8A5417A70; Mon, 12 Mar 2018 21:12:08 +0000 (UTC) Received: from unknown54ee7586bd10.attlocal.net.com (ovpn-116-66.phx2.redhat.com [10.3.116.66]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8671B608EE for ; Mon, 12 Mar 2018 21:12:08 +0000 (UTC) From: John Ferlan To: libvir-list@redhat.com Date: Mon, 12 Mar 2018 17:11:48 -0400 Message-Id: <20180312211158.28343-2-jferlan@redhat.com> In-Reply-To: <20180312211158.28343-1-jferlan@redhat.com> References: <20180312211158.28343-1-jferlan@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH 01/11] virsh: Clean up formatting of the vol-create* commands 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: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.30]); Mon, 12 Mar 2018 21:12:12 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Clean up the formatting to make the output a bit more readable at least with respect to not having one paragraph of output. Each option will start on its own line. Signed-off-by: John Ferlan --- tools/virsh.pod | 30 +++++++++++++++++++++++------- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 82de2cc45..52f45d721 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -3948,10 +3948,13 @@ before the event. =3Ditem B I I [I<--prealloc-metadata>] =20 Create a volume from an XML . + I is the name or UUID of the storage pool to create the volu= me in. + I is the XML with the volume definition. An easy way to creat= e the XML is to use the B command to obtain the definition o= f a pre-existing volume. + [I<--prealloc-metadata>] preallocate metadata (for qcow2 images which don't support full allocation). This option creates a sparse image file with met= adata, resulting in higher performance compared to images with no preallocation a= nd @@ -3963,53 +3966,66 @@ B vi newvolume.xml (or make changes with your other text editor) virsh vol-create differentstoragepool newvolume.xml =20 -=3Ditem B I I [I<--inputpool> -I] I [I<--prealloc-metadata>] -[I<--reflink>] +=3Ditem B I I I +[I<--inputpool> I] [I<--prealloc-metadata>] [I<--reflink>] =20 Create a volume, using another volume as input. + I is the name or UUID of the storage pool to create the volu= me in. + I is the XML with the volume definition. + +I is the name or key or path of the source volume. + I<--inputpool> I is the name or uuid of the storage pool the source volume is in. -I is the name or key or path of the source volume. + [I<--prealloc-metadata>] preallocate metadata (for qcow2 images which don't support full allocation). This option creates a sparse image file with met= adata, resulting in higher performance compared to images with no preallocation a= nd only slightly higher initial disk space usage. + When I<--reflink> is specified, perform a COW lightweight copy, where the data blocks are copied only when modified. If this is not possible, the copy fails. =20 =3Ditem B I I I -[I<--allocation> I] [I<--format> I] [I<--backing-vol> -I] [I<--backing-vol-format> I] -[I<--prealloc-metadata>] [I<--print-xml>] +[I<--allocation> I] [I<--format> I] +[I<--backing-vol> I] +[I<--backing-vol-format> I] [I<--prealloc-metadata>] [I<--print-xm= l>] =20 Create a volume from a set of arguments unless I<--print-xml> is specified= , in which case just the XML of the volume object is printed out without any ac= tual object creation. + I is the name or UUID of the storage pool to create the volu= me in. + I is the name of the new volume. For a disk pool, this must match the partition name as determined from the pool's source device path and the ne= xt available partition. For example, a source device path of /dev/sdb and the= re are no partitions on the disk, then the name must be sdb1 with the next name being sdb2 and so on. + I is the size of the volume to be created, as a scaled integer (see B above), defaulting to bytes if there is no suffix. + I<--allocation> I is the initial size to be allocated in the volume, also as a scaled integer defaulting to bytes. + I<--format> I is used in file based storage pools to specify the v= olume file format to use; raw, bochs, qcow, qcow2, vmdk, qed. Use extended for d= isk storage pools in order to create an extended partition (other values are validity checked but not preserved when libvirtd is restarted or the pool is refreshed). + I<--backing-vol> I is the source backing volume to be used if taking a snapshot of an existing volume. + I<--backing-vol-format> I is the format of the snapshot backing vo= lume; raw, bochs, qcow, qcow2, qed, vmdk, host_device. These are, however, meant= for file based storage pools. + [I<--prealloc-metadata>] preallocate metadata (for qcow2 images which don't support full allocation). This option creates a sparse image file with met= adata, resulting in higher performance compared to images with no preallocation a= nd --=20 2.13.6 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list