From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michal Novotny Subject: [PATCH] Fix xm man page statement about asynchonous operation Date: Tue, 01 Jun 2010 17:25:51 +0200 Message-ID: <4C05267F.9030008@redhat.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------000208040207030509020700" Return-path: List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xensource.com Errors-To: xen-devel-bounces@lists.xensource.com To: "'xen-devel@lists.xensource.com'" List-Id: xen-devel@lists.xenproject.org This is a multi-part message in MIME format. --------------000208040207030509020700 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit 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 Signed-off-by: Michal Novotny -- Michal Novotny, RHCE Virtualization Team (xen userspace), Red Hat --------------000208040207030509020700 Content-Type: text/x-patch; name="xen-docs-man-xm-fix-sync-statement.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="xen-docs-man-xm-fix-sync-statement.patch" diff -r 96917cf25bf3 docs/man/xm.pod.1 --- a/docs/man/xm.pod.1 Fri May 28 10:54:07 2010 +0100 +++ b/docs/man/xm.pod.1 Tue Jun 01 17:20:53 2010 +0200 @@ -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 commands act asynchronously, so just because the B -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 periodically. +Most B commands act synchronously, except maybe create, shutdown, +mem-set and vcpu-set. The fact that the B 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 --------------000208040207030509020700 Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Xen-devel mailing list Xen-devel@lists.xensource.com http://lists.xensource.com/xen-devel --------------000208040207030509020700--