Re: [PATCHv6 10/11] lib: Document that virConnectGetAllDomainStats may omit some stats fields

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 09/15/2014 09:42 AM, Peter Krempa wrote:
> Add a note to make the users aware that some stats groups or fields may
> be missing in certain cases.
> ---
>  src/libvirt.c | 5 +++++
>  1 file changed, 5 insertions(+)
> 

ACK.

> diff --git a/src/libvirt.c b/src/libvirt.c
> index 03f7e5b..b3ddf95 100644
> --- a/src/libvirt.c
> +++ b/src/libvirt.c
> @@ -21657,6 +21657,11 @@ virConnectGetDomainCapabilities(virConnectPtr conn,
>   * "block.<num>.allocation" - offset of the highest written sector
>   *                            as unsigned long long.
>   *
> + * Note that entire stats groups or individual stat fields may be missing from
> + * the output in case they are not supported by the given hypervisor, are not
> + * applicable for the current state of the guest domain or their retrieval
> + * was not successful.

Depending on which grammar expert you ask, some people prefer "a, b, or
c" while others prefer "a, b or c" when listing three or more things
(the use of a comma before the conjunction that lists the last element
of a list).  I'm in the former group, but not strongly enough to request
that others change their habits.  So up to you if you want to add a
comma before that last "or".

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

Attachment: signature.asc
Description: OpenPGP digital signature

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list

[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]