Xen devel - Sep 2012 - [PATCH] docs: document "ucode=" hypervisor command line option

Signed-off-by: Jan Beulich <jbeulich@suse.com>

--- a/docs/misc/xen-command-line.markdown
+++ b/docs/misc/xen-command-line.markdown
@@ -785,6 +785,19 @@ Specify the per-cpu trace buffer size in
 > `= unstable | skewed`
 
 ### ucode
+> `= <integer>`
+
+Specify the CPU microcode update blob module index. When positive, this
+specifies the n-th module (in the GrUB entry, zero based) to be used
+for updating CPU micrcode. When negative, counting starts at the end of
+the modules in the GrUB entry (so with the blob commonly being last,
+one could specify `ucode=-1`). Note that the value of zero is not valid
+here (entry zero, i.e. the first module, is always the Dom0 kernel
+image). Note further that use of this option has an unspecified effect
+when used with xen.efi (there the concept of modules doesn''t exist,
and
+the blob gets specified via the `ucode=<filename>` config file/section
+entry; see [EFI configuration file description](efi.html)).
+
 ### unrestricted\_guest
 > `= <boolean>`
 





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

On Mon, 2012-09-10 at 10:39 +0100, Jan Beulich wrote:
> Signed-off-by: Jan Beulich <jbeulich@suse.com>
Acked and applied. Thanks.

Can/will you take this for 4.2.0 too?
> 
> --- a/docs/misc/xen-command-line.markdown
> +++ b/docs/misc/xen-command-line.markdown
> @@ -785,6 +785,19 @@ Specify the per-cpu trace buffer size in
>  > `= unstable | skewed`
>  
>  ### ucode
> +> `= <integer>`
> +
> +Specify the CPU microcode update blob module index. When positive, this
> +specifies the n-th module (in the GrUB entry, zero based) to be used
> +for updating CPU micrcode. When negative, counting starts at the end of
> +the modules in the GrUB entry (so with the blob commonly being last,
> +one could specify `ucode=-1`). Note that the value of zero is not valid
> +here (entry zero, i.e. the first module, is always the Dom0 kernel
> +image). Note further that use of this option has an unspecified effect
> +when used with xen.efi (there the concept of modules doesn''t
exist, and
> +the blob gets specified via the `ucode=<filename>` config
file/section
> +entry; see [EFI configuration file description](efi.html)).
> +
>  ### unrestricted\_guest
>  > `= <boolean>`
>  
> 
> 
>

On Mon, Sep 10, 2012 at 10:39:47AM +0100, Jan Beulich
wrote:
> Signed-off-by: Jan Beulich <jbeulich@suse.com>
> 
> --- a/docs/misc/xen-command-line.markdown
> +++ b/docs/misc/xen-command-line.markdown
> @@ -785,6 +785,19 @@ Specify the per-cpu trace buffer size in
>  > `= unstable | skewed`
>  
>  ### ucode
> +> `= <integer>`
> +
> +Specify the CPU microcode update blob module index. When positive, this
> +specifies the n-th module (in the GrUB entry, zero based) to be used
> +for updating CPU micrcode. When negative, counting starts at the end of
                        ^
typo here, should be "microcode", obviously.

-- Pasi
> +the modules in the GrUB entry (so with the blob commonly being last,
> +one could specify `ucode=-1`). Note that the value of zero is not valid
> +here (entry zero, i.e. the first module, is always the Dom0 kernel
> +image). Note further that use of this option has an unspecified effect
> +when used with xen.efi (there the concept of modules doesn''t
exist, and
> +the blob gets specified via the `ucode=<filename>` config
file/section
> +entry; see [EFI configuration file description](efi.html)).
> +
>  ### unrestricted\_guest
>  > `= <boolean>`
>  
> 
> 
> 
> docs: document "ucode=" hypervisor command line option
> 
> Signed-off-by: Jan Beulich <jbeulich@suse.com>
> 
> --- a/docs/misc/xen-command-line.markdown
> +++ b/docs/misc/xen-command-line.markdown
> @@ -785,6 +785,19 @@ Specify the per-cpu trace buffer size in
>  > `= unstable | skewed`
>  
>  ### ucode
> +> `= <integer>`
> +
> +Specify the CPU microcode update blob module index. When positive, this
> +specifies the n-th module (in the GrUB entry, zero based) to be used
> +for updating CPU micrcode. When negative, counting starts at the end of
> +the modules in the GrUB entry (so with the blob commonly being last,
> +one could specify `ucode=-1`). Note that the value of zero is not valid
> +here (entry zero, i.e. the first module, is always the Dom0 kernel
> +image). Note further that use of this option has an unspecified effect
> +when used with xen.efi (there the concept of modules doesn''t
exist, and
> +the blob gets specified via the `ucode=<filename>` config
file/section
> +entry; see [EFI configuration file description](efi.html)).
> +
>  ### unrestricted\_guest
>  > `= <boolean>`
>  
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@lists.xen.org
> http://lists.xen.org/xen-devel

>>> On 10.09.12 at 12:15, Ian Campbell <Ian.Campbell@citrix.com>
wrote:
> On Mon, 2012-09-10 at 10:39 +0100, Jan Beulich wrote:
>> Signed-off-by: Jan Beulich <jbeulich@suse.com>
> 
> Acked and applied. Thanks.
> 
> Can/will you take this for 4.2.0 too?
Sure, once I''m allowed to put things there.

Jan