Skip to contentSkip to conversation

Fix xm man page statement about asynchonous operation

PATCH New Michal Novotny 1 participant 1 message Jun 1, 2010

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Fix xm man page statement about asynchonous operation

Hi,
the man page for xm command states that many commands acts asynchronously which is not true. According to my experience most commands does act synchronously with several exceptions, like create, shutdown, mem-set and vcpu-set commands so this fixes the paragraph available in this xm man page.

Thanks,
Michal

Signature · 2 lines
Michal Novotny<[email protected]>, RHCE
Virtualization Team (xen userspace), Red Hat
docs/man/xm.pod.1 +4 -6
diff -r 96917cf25bf3 docs/man/xm.pod.1
@@ -40,12 +40,10 @@ communications channels used to talk to 
 communications channels used to talk to the hypervisor.  Running as
 non root will return an error.
 
-Most B<xm> commands act asynchronously, so just because the B<xm>
-command 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 B<xm list> periodically.
+Most B<xm> commands act synchronously, except maybe create, shutdown,
+mem-set and vcpu-set. The fact that the B<xm> command returned doesn't
+necessarily mean that the action is complete and you must poll through
+xm list periodically to detect that the operation completed.
 
 =head1 DOMAIN SUBCOMMANDS
 

_______________________________________________
Xen-devel mailing list
[email protected]
http://lists.xensource.com/xen-devel