From 216efc893fcf9410198061d7277478d79a6040f9 Mon Sep 17 00:00:00 2001 From: John Ferlan Date: Mon, 12 Mar 2018 16:08:11 -0400 Subject: [PATCH] virsh: Fix man page argument ordering for vol-info command The proper command order is 'virsh vol-info volume pool'. While making the modification clean up the description a bit too in order to help clarify under what circumstances the volume could be found if the pool name was not provided. Signed-off-by: John Ferlan --- tools/virsh.pod | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 6063c1b6bf..caaa62b840 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -4191,17 +4191,26 @@ is in. If the volume name is provided instead of the key or path, then providing the pool is necessary to find the volume to be uploaded into; otherwise, the first volume found by the key or path will be used. -=item B [I<--pool> I] I +=item B I [I<--pool> I] [I<--bytes>] [I<--physical>] Returns basic information about the given storage volume. + +I is the name or key or path of the volume +to return information for. + I<--pool> I is the name or UUID of the storage pool the volume -is in. I is the name or key or path of the volume -to return information for. If I<--bytes> is specified the sizes are not -converted to human friendly units. If I<--physical> is specified, then the host -physical size is returned and displayed instead of the allocation value. The -physical value for some file types, such as qcow2 may have a different (larger) -physical value than is shown for allocation. Additionally sparse files will +is in. If the volume name is provided instead of the key or path, then +providing the pool is necessary to find the volume to be uploaded into; +otherwise, the first volume found by the key or path will be used. + +If I<--bytes> is specified the sizes are not converted to human friendly +units. + +If I<--physical> is specified, then the host physical size is returned +and displayed instead of the allocation value. The physical value for +some file types, such as qcow2 may have a different (larger) physical +value than is shown for allocation. Additionally sparse files will have different physical and allocation values. =item B [I<--pool> I] [I<--details>] -- 2.47.2