Re: [libvirt] Just to make sure I understand the API
On Sun, Jan 10, 2010 at 01:20:38PM +0100, Matthias Bolte wrote:
2010/1/9 Bryan Kearney <bkearney(a)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 :|