514532 Fix man page, most operation are synchronous

* tools/virsh.pod: the man page was stating that most operations
  are asynchronous while in fact most of them are synchronous except
  domain shutdown, setvcpus and setmem.
This commit is contained in:
Daniel Veillard 2009-11-18 11:53:41 +01:00
parent 776b675861
commit 7d43c80bc4

View File

@ -40,12 +40,11 @@ Most B<virsh> commands require root privileges to run due to the
communications channels used to talk to the hypervisor. Running as communications channels used to talk to the hypervisor. Running as
non root will return an error. non root will return an error.
Most B<virsh> commands act asynchronously, so just because the B<virsh> Most B<virsh> commands act synchronously, except maybe shutdown,
program returned, doesn't mean the action is complete. This is setvcpus and setmem. In those case the fact that the B<virsh>
important, as many operations on domains, like create and shutdown, program returned, may not mean the action is complete and you
can take considerable time (30 seconds or more) to bring the machine must poll periodically to detect that the guest completed the
into a fully compliant state. If you want to know when one of these operation.
actions has finished you must poll through virsh list periodically.
=head1 GENERIC COMMANDS =head1 GENERIC COMMANDS