[PATCH] Correct man page of xl regarding cpu-pools

[PATCH] Correct man page of xl regarding cpu-pools

[Juergen Gross]

[-- Attachment #1: Type: text/plain, Size: 152 bytes --]

Signed-off-by: juergen.gross@ts.fujitsu.com


1 file changed, 16 insertions(+), 12 deletions(-)
docs/man/xl.pod.1 |   28 ++++++++++++++++------------



[-- Attachment #2: xen-staging.hg.patch --]
[-- Type: text/x-patch, Size: 2811 bytes --]

# HG changeset patch
# User Juergen Gross <juergen.gross@ts.fujitsu.com>
# Date 1320243784 -3600
# Node ID 57044b74a69d68fee06f6da5ca27b0e3def934f8
# Parent  068d3d55ce6e0862e83b443d4e1c83c84b26754d
Correct man page of xl regarding cpu-pools

Signed-off-by: juergen.gross@ts.fujitsu.com

diff -r 068d3d55ce6e -r 57044b74a69d docs/man/xl.pod.1
--- a/docs/man/xl.pod.1	Tue Nov 01 19:03:38 2011 +0000
+++ b/docs/man/xl.pod.1	Wed Nov 02 15:23:04 2011 +0100
@@ -615,14 +615,17 @@ assigned at most to one cpu-pool. Domain
 assigned at most to one cpu-pool. Domains are each restricted to a single
 cpu-pool. Scheduling does not cross cpu-pool boundaries, so each cpu-pool has
 an own scheduler.
-Physical cpus and domains can be moved from one pool to another only by an
+Physical cpus and domains can be moved from one cpu-pool to another only by an
 explicit command.
+Cpu-pools can be specified either by name or by id.
 
 =over 4
 
-=item B<cpupool-create> [I<OPTIONS>] I<ConfigFile>
+=item B<cpupool-create> [I<OPTIONS>] I<ConfigFile> [I<Variable=Value> ...]
 
 Create a cpu pool based an I<ConfigFile>.
+Variable settings from the I<ConfigFile> may be altered by specifying new
+or additional assignments on the command line.
 
 B<OPTIONS>
 
@@ -638,7 +641,7 @@ Dry run - prints the resulting configura
 
 =back
 
-=item B<cpupool-list> [I<-c|--cpus> I<cpu-pool>]
+=item B<cpupool-list> [I<-c|--cpus>] [I<cpu-pool>]
 
 List CPU pools on the host.
 If I<-c> is specified, B<xl> prints a list of CPUs used by I<cpu-pool>.
@@ -646,26 +649,27 @@ If I<-c> is specified, B<xl> prints a li
 =item B<cpupool-destroy> I<cpu-pool>
 
 Deactivates a cpu pool.
+This is possible only if no domain is active in the cpu-pool.
 
 =item B<cpupool-rename> I<cpu-pool> <newname>
 
-Renames a cpu pool to I<newname>.
+Renames a cpu-pool to I<newname>.
 
-=item B<cpupool-cpu-add> I<cpu-pool> I<cpu-nr|node-nr>
+=item B<cpupool-cpu-add> I<cpu-pool> I<cpu-nr|node:node-nr>
 
-Adds a cpu or a numa node to a cpu pool.
+Adds a cpu or all cpus of a numa node to a cpu-pool.
 
-=item B<cpupool-cpu-remove> I<cpu-nr|node-nr>
+=item B<cpupool-cpu-remove> I<cpu-nr|node:node-nr>
 
-Removes a cpu or a numa node from a cpu pool.
+Removes a cpu or all cpus of a numa node from a cpu-pool.
 
-=item B<cpupool-migrate> I<domain-id> I<cpu-pool>
+=item B<cpupool-migrate> I<domain> I<cpu-pool>
 
-Moves a domain into a cpu pool.
+Moves a domain specified by domain-id or domain-name into a cpu-pool.
 
 =item B<cpupool-numa-split>
 
-Splits up the machine into one cpu pool per numa node.
+Splits up the machine into one cpu-pool per numa node.
 
 =back
 
@@ -791,7 +795,7 @@ List pass-through pci devices for a doma
 
 =head1 SEE ALSO
 
-B<xldomain.cfg>(5), B<xentop>(1)
+B<xldomain.cfg>(5), B<xlcpupool.cfg>(5), B<xentop>(1)
 
 =head1 AUTHOR
 

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

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

Re: [PATCH] Correct man page of xl regarding cpu-pools

[Ian Jackson]

Juergen Gross writes ("[Xen-devel] [PATCH] Correct man page of xl regarding cpu-pools"):
> Signed-off-by: juergen.gross@ts.fujitsu.com

Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>

Thanks,
Ian.

Re: [PATCH] Correct man page of xl regarding cpu-pools

[Ian Campbell]

On Wed, 2011-11-02 at 10:23 -0400, Juergen Gross wrote:
> @@ -791,7 +795,7 @@ List pass-through pci devices for a doma
>  
>  =head1 SEE ALSO
>  
> -B<xldomain.cfg>(5), B<xentop>(1)
> +B<xldomain.cfg>(5), B<xlcpupool.cfg>(5), B<xentop>(1)

Does xlcpupoo.cfg(5) exist? I couldn't find it (I know xldomain.cfg
doesn't, I have a pending action item to change that link).

Ian.

Re: [PATCH] Correct man page of xl regarding cpu-pools

[Juergen Gross]

On 11/02/2011 08:18 PM, Ian Campbell wrote:
> On Wed, 2011-11-02 at 10:23 -0400, Juergen Gross wrote:
>> @@ -791,7 +795,7 @@ List pass-through pci devices for a doma
>>
>>   =head1 SEE ALSO
>>
>> -B<xldomain.cfg>(5), B<xentop>(1)
>> +B<xldomain.cfg>(5), B<xlcpupool.cfg>(5), B<xentop>(1)
> Does xlcpupoo.cfg(5) exist? I couldn't find it (I know xldomain.cfg
> doesn't, I have a pending action item to change that link).

As I'm no expert in pod format, I wanted to wait until xldomain.cfg(5)
shows up and create xlcpupool.cfg(5) accordingly. :-)

If you have other plans for xldomain.cfg(5), I'll adapt to them. :-)


Juergen

-- 
Juergen Gross                 Principal Developer Operating Systems
PDG ES&S SWE OS6                       Telephone: +49 (0) 89 3222 2967
Fujitsu Technology Solutions              e-mail: juergen.gross@ts.fujitsu.com
Domagkstr. 28                           Internet: ts.fujitsu.com
D-80807 Muenchen                 Company details: ts.fujitsu.com/imprint.html