[PATCH] Clarify use of xm mem-set and xm vcpu-set in xm.1 manpage

[PATCH] Clarify use of xm mem-set and xm vcpu-set in xm.1 manpage

[Richard W.M. Jones]

[-- Attachment #1.1.1: Type: text/plain, Size: 456 bytes --]

'xm mem-set' and 'xm vcpu-set' require cooperation of the domain.  This 
patch just clarifies the xm.1 manpage to make it clear that the commands 
won't work on a purely fullvirt domain.

Rich.

-- 
Emerging Technologies, Red Hat - http://et.redhat.com/~rjones/
Registered Address: Red Hat UK Ltd, Amberley Place, 107-111 Peascod
Street, Windsor, Berkshire, SL4 1TE, United Kingdom.  Registered in
England and Wales under Company Registration No. 03798903

[-- Attachment #1.1.2: xen-unstable-clarify-mem-set-vcpu-set.patch --]
[-- Type: text/x-patch, Size: 1286 bytes --]

diff -r f17b34df974f docs/man/xm.pod.1
--- a/docs/man/xm.pod.1	Wed Jan 16 15:55:57 2008 +0000
+++ b/docs/man/xm.pod.1	Thu Jan 17 17:21:23 2008 +0000
@@ -254,9 +254,12 @@ domain, as it may balloon down its memor
 
 =item B<mem-set> I<domain-id> I<mem>
 
-Set the domain's used memory using the balloon driver.  Because this
-operation requires cooperation from the domain operating system, there
-is no guarantee that it will succeed.
+Set the domain's used memory using the balloon driver.
+
+Because this operation requires cooperation from the domain operating
+system, there is no guarantee that it will succeed.  This command will
+definitely not work unless the domain has the required paravirt
+driver.
 
 B<Warning:> There is no good way to know in advance how small of a
 mem-set will make a domain unstable and cause it to crash.  Be very
@@ -391,6 +394,10 @@ Attempting to set the VCPUs to a number 
 Attempting to set the VCPUs to a number larger than the initially
 configured VCPU count is an error.  Trying to set VCPUs to < 1 will be
 quietly ignored.
+
+Because this operation requires cooperation from the domain operating
+system, there is no guarantee that it will succeed.  This command will
+not work with a full virt domain.
 
 =item B<vcpu-list> [I<domain-id>]
 

[-- Attachment #1.2: S/MIME Cryptographic Signature --]
[-- Type: application/x-pkcs7-signature, Size: 3237 bytes --]

[-- Attachment #2: Type: text/plain, Size: 138 bytes --]

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel