From: Peter Krempa Date: Wed, 15 Jul 2020 11:02:24 +0000 (+0200) Subject: virDomainSetBlockThreshold: Document values of '@dev' better X-Git-Tag: v6.6.0-rc1~49 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=794d7d97d8d98179b2e90baca9cf56b232f65e99;p=thirdparty%2Flibvirt.git virDomainSetBlockThreshold: Document values of '@dev' better Mention where to obtain the index and how it's treated. Signed-off-by: Peter Krempa Reviewed-by: Eric Blake --- 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..allocation" in the VIR_DOMAIN_STATS_BLOCK group. The current