[Libvir] Difference between API functions virConnectNumOfDefinedDomains and virConnectNumOfDomains

Richard W.M. Jones rjones at redhat.com
Mon Apr 30 17:03:07 UTC 2007

Daniel P. Berrange wrote:
> On Mon, Apr 30, 2007 at 10:12:43AM +0100, Richard W.M. Jones wrote:
>> Jan Michael wrote:
>>> Hello libvirt fellows,
>>> I have some problems to distinguish between those function calls in libvirt
>>> API:
>>>> virConnectNumOfDefinedDomains
>>>> virConnectNumOfDomains
>>> The API description states on both function that they will return me the
>>> number of active domain.
>>> Am I right if I assume that the first function 
>>> virConnectNumOfDefinedDomains
>>> returns me all defined, but necessarily not running domains, and the second
>>> one only running and therefore active domains?
>> I looked at this and I think you're right - it's a documentation error. 
>>  I will ask Dan Berrange about this when he wakes up (he wrote that bit).
> Yes, that's docs error. virConnectNumOfDomains lists active guests while
> virConnectNumOfDefinedDomains lists inactive guests. NB, there are not
> 100% guarenteed to be distinct sets, since obviously between the time of
> calling one & calling the other a guest may have started / stopped, thus
> moving from one list to the other. Mildly annoying, but not much we can 
> do about it in practice since the underlying APIs can't always give us
> the complet list of active & inactive guests atomically.

Documentation fixed in CVS.


Emerging Technologies, Red Hat  http://et.redhat.com/~rjones/
64 Baker Street, London, W1U 7DF     Mobile: +44 7866 314 421

Registered Address: Red Hat UK Ltd, Amberley Place, 107-111 Peascod
Street, Windsor, Berkshire, SL4 1TE, United Kingdom.
Registered in England and Wales under Company Registration No. 3798903
Directors: Michael Cunningham (USA), Charlie Peters (USA) and David
Owens (Ireland)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 3237 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20070430/699edee9/attachment-0001.bin>

More information about the libvir-list mailing list