From: Peter Krempa Date: Wed, 15 Jul 2020 11:06:44 +0000 (+0200) Subject: virDomainSetBlockThreshold: Clarify values of @dev the event is fired for X-Git-Tag: v6.6.0-rc1~45 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=877d705ccf9e515a7506a2d326227251c4e272c7;p=thirdparty%2Flibvirt.git virDomainSetBlockThreshold: Clarify values of @dev the event is fired for Top level image may get two events, one with the disk target (vda) and one with disk target with index (vda[3]) if the top level image has an index. Signed-off-by: Peter Krempa Reviewed-by: Eric Blake --- diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c index ba30d18f65..31c1ab4cc1 100644 --- a/src/libvirt-domain.c +++ b/src/libvirt-domain.c @@ -12370,6 +12370,10 @@ int virDomainGetGuestInfo(virDomainPtr domain, * described by @dev is written beyond the set threshold level. The threshold * 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. + * Note that if the threshold level is reached for a top level image, the event + * is emitted for @dev corresponding to the disk target, and may also be reported + * with @dev corresponding to the disk target with an index corresponding to the + * 'index' attribute of 'source' in the live VM XML if the attribute is present. * * @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