[Libvir] Difference between API functions virConnectNumOfDefinedDomains and virConnectNumOfDomains

[Daniel P. Berrange]

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.

Dan.
-- 
|=- Red Hat, Engineering, Emerging Technologies, Boston.  +1 978 392 2496 -=|
|=-           Perl modules: http://search.cpan.org/~danberr/              -=|
|=-               Projects: http://freshmeat.net/~danielpb/               -=|
|=-  GnuPG: 7D3B9505   F3C9 553F A1DA 4AC2 5648 23C1 B3DF F742 7D3B 9505  -=|