[libvirt] [PATCH] 514532 Fix man page, most operation are synchronous

[Daniel P. Berrange]

On Wed, Nov 18, 2009 at 02:31:12PM +0100, Daniel Veillard wrote:
>  
> -Most B<virsh> commands act asynchronously, so just because the B<virsh>
> -program returned, doesn't mean the action is complete.  This is
> -important, as many operations on domains, like create and shutdown,
> -can take considerable time (30 seconds or more) to bring the machine
> -into a fully compliant state.  If you want to know when one of these
> -actions has finished you must poll through virsh list periodically.
> +Most B<virsh> commands act synchronously, except maybe shutdown
> +and domain creation. In those case the fact that the B<virsh>
> +program returned, may not mean the action is complete and you
> +must poll through virsh list periodically to detect that the
> +operation completed.

Shutdown is async, but domain creation is certainly supposed to
be synchronous.    Of course the guest may immediately crash
so appear inactive again just after create returns

Thinking about it, I believe virDomainShutdown/Reboot, and the SetMemory
and SetVcpus are the only two APIs that are allowed to be async, because 
they merely update the guest, but don't wait for it to react.

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 :|