[libvirt] [PATCH 7/9] virsh: add virsh manual for setting throttle blkio cgroup

[Daniel P. Berrange]

On Mon, Dec 02, 2013 at 02:48:02PM +0800, Gao feng wrote:
> Add the manual for the new blkiotune options, --device-read-iops,
> --device-write-iops, --device-read-bps, --device-write-bps.
> 
> Singed-off-by: Guan Qiang <hzguanqiang at corp.netease.com>
> Singed-off-by: Gao feng <gaofeng at cn.fujitsu.com>
> ---
>  tools/virsh.pod | 36 ++++++++++++++++++++++++++++++++++--
>  1 file changed, 34 insertions(+), 2 deletions(-)
> 
> diff --git a/tools/virsh.pod b/tools/virsh.pod
> index dac9a08..8ecc27c 100644
> --- a/tools/virsh.pod
> +++ b/tools/virsh.pod
> @@ -1625,8 +1625,12 @@ The guaranteed minimum memory allocation for the guest.
>  Specifying -1 as a value for these limits is interpreted as unlimited.
>  
>  =item B<blkiotune> I<domain> [I<--weight> B<weight>]
> -[I<--device-weights> B<device-weights>] [[I<--config>]
> -[I<--live>] | [I<--current>]]
> +[I<--device-weights> B<device-weights>]
> +[I<--device-read-iops> B<device-read-iops>]
> +[I<--device-write-iops> B<device-write-iops>]
> +[I<--device-read-bps> B<device-read-bps>]
> +[I<--device-write-bps> B<device-write-bps>]
> +[[I<--config>] [I<--live>] | [I<--current>]]
>  
>  Display or set the blkio parameters. QEMU/KVM supports I<--weight>.
>  I<--weight> is in range [100, 1000]. After kernel 2.6.39, the value
> @@ -1639,6 +1643,34 @@ or the value 0 to remove that device from per-device listings.
>  Only the devices listed in the string are modified;
>  any existing per-device weights for other devices remain unchanged.
>  
> +B<device-read-iops> is a single string listing one or more device/read_iops
> +pairs, int the format of /path/to/device,read_iops,/path/to/device,read_iops.
> +Each read_iops is a number which type is unsigned int, value 0 to remove that
> +device from per-decice listing.
> +Only the devices listed in the string are modified;
> +any existing per-device read_iops for other devices remain unchange.
> +
> +B<device-write-iops> is a single string listing one or more device/write_iops
> +pairs, int the format of /path/to/device,write_iops,/path/to/device,write_iops.
> +Each write_iops is a number which type is unsigned int, value 0 to remove that
> +device from per-decice listing.
> +Only the devices listed in the string are modified;
> +any existing per-device write_iops for other devices remain unchange.
> +
> +B<device-read-bps> is a single string listing one or more device/read_bps
> +pairs, int the format of /path/to/device,read_bps,/path/to/device,read_bps.
> +Each read_bps is a number which type is unsigned long long, value 0 to remove
> +that device from per-decice listing.
> +Only the devices listed in the string are modified;
> +any existing per-device read_bps for other devices remain unchange.
> +
> +B<device-write-bps> is a single string listing one or more device/write_bps
> +pairs, int the format of /path/to/device,write_bps,/path/to/device,write_bps.
> +Each write_bps is a number which type is unsigned long long, value 0 to remove
> +that device from per-decice listing.
> +Only the devices listed in the string are modified;
> +any existing per-device write_bps for other devices remain unchange.
> +
>  If I<--live> is specified, affect a running guest.
>  If I<--config> is specified, affect the next boot of a persistent guest.
>  If I<--current> is specified, affect the current guest state.

The changes to virsh.c should be in this same patch.

Daniel
-- 
|: http://berrange.com      -o-    http://www.flickr.com/photos/dberrange/ :|
|: http://libvirt.org              -o-             http://virt-manager.org :|
|: http://autobuild.org       -o-         http://search.cpan.org/~danberr/ :|
|: http://entangle-photo.org       -o-       http://live.gnome.org/gtk-vnc :|