[PATCH 01/10] virDomainSetBlockThreshold: Document values of '@dev' better
Eric Blake
eblake at redhat.com
Mon Jul 20 20:45:25 UTC 2020
On 7/15/20 8:10 AM, Peter Krempa wrote:
> Mention where to obtain the index and how it's treated.
>
> Signed-off-by: Peter Krempa <pkrempa at redhat.com>
> ---
> src/libvirt-domain.c | 6 ++++++
> 1 file changed, 6 insertions(+)
Reviewed-by: Eric Blake <eblake at redhat.com>
>
> diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
> index fe4dab7cdf..ba30d18f65 100644
> --- a/src/libvirt-domain.c
> +++ b/src/libvirt-domain.c
> @@ -12371,6 +12371,12 @@ int virDomainGetGuestInfo(virDomainPtr domain,
> * level is unset once the event fires. The event might not be delivered at all
> * if libvirtd was not running at the moment when the threshold was reached.
> *
> + * @dev can either be a disk target name (vda, sda) or disk target with index (
> + * vda[4]). Without the index the top image in the backing chain will have the
> + * threshold set. The index corresponds to the 'index' attribute reported in the
> + * live VM XML for 'backingStore' or 'source' elements of a disk. If index is
> + * given the threshold is set for the corresponding image.
> + *
> * Hypervisors report the last written sector of an image in the bulk stats API
> * (virConnectGetAllDomainStats/virDomainListGetStats) as
> * "block.<num>.allocation" in the VIR_DOMAIN_STATS_BLOCK group. The current
>
--
Eric Blake, Principal Software Engineer
Red Hat, Inc. +1-919-301-3226
Virtualization: qemu.org | libvirt.org
More information about the libvir-list
mailing list