[libvirt] Just to make sure I understand the API

[Daniel P. Berrange]

On Sun, Jan 10, 2010 at 01:20:38PM +0100, Matthias Bolte wrote:
> 2010/1/9 Bryan Kearney <bkearney at redhat.com>:
> > To make sure I understand the API. If I have a domain defined, but not
> > started.. it will show up in the list returned by:
> >
> > virConnectListDefinedDomains
> >
> > but not in the list
> >
> > virConnectListDomains
> >
> > Conversely, if it is started... it will only be in the list:
> >
> > virConnectListDomains
> >
> > not in the list
> >
> > virConnectListDefinedDomains
> >
> >
> > Is that correct?
> >
> > -- bk
> >
> 
> Yes, that's the correct behavior of these functions.
> virConnectListDefinedDomains list domains that are inactive but
> defined and virConnectListDomains lists domains that are active.
> 
> If you combine the output of both functions then you get the complete
> list of domains libvirt knows about for a given host.

Modulo the obvious race condition where a guest starts/stops in between
the time you call those two functions :-)

One of these days I'll have time to add an API I've long wanted - one
that lists all domains, and returns the virDomainPtr objects directly

  virConnectListAllDomains(virConnectPtr conn, virDomainPtr *domains, int *ndomains);

where libvirt allocates 'domains' to be the right size, not requiring
the caller todo so. Similarly this same API pattern for all other objects
virNetworkPtr, virStoragePoolPtr, etc, etc

Regards,
Daniel
-- 
|: Red Hat, Engineering, London   -o-   http://people.redhat.com/berrange/ :|
|: http://libvirt.org  -o-  http://virt-manager.org  -o-  http://ovirt.org :|
|: http://autobuild.org       -o-         http://search.cpan.org/~danberr/ :|
|: GnuPG: 7D3B9505  -o-  F3C9 553F A1DA 4AC2 5648 23C1 B3DF F742 7D3B 9505 :|