Xen devel - Jan 2013 - [PATCH v1 02/02] HVM firmware passthrough libxl support

This patch updates the xl.cfg man page with descriptions of the two new
parameters for firmware passthrough.

Signed-off-by: Ross Philipson <ross.philipson@citrix.com>



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

On Fri, 2013-01-18 at 21:41 +0000, Ross Philipson wrote:
> This patch updates the xl.cfg man page with descriptions of the two new
> parameters for firmware passthrough.
> 
> Signed-off-by: Ross Philipson <ross.philipson@citrix.com>
> 
> diff -r 38cc3302bf25 docs/man/xl.cfg.pod.5
> --- a/docs/man/xl.cfg.pod.5     Fri Jan 18 15:24:32 2013 -0500
> +++ b/docs/man/xl.cfg.pod.5     Fri Jan 18 15:44:19 2013 -0500
> @@ -829,6 +829,24 @@ libxl: ''host,tm=0,sse3=0''
>  More info about the CPUID instruction can be found in the processor
manuals, and
>  in Wikipedia: L<http://en.wikipedia.org/wiki/CPUID>
>  
> +=item B<acpi_firmware="STRING">
> +
> +Specify a path to a file that contains extra ACPI firmware tables to pass
in to
> +a guest. The file can contain several tables in their binary AML form
> +concatenated together. Each table self describes its length so no
additional
> +information is needed. These tables will be added to the ACPI table set in
the
> +guest.
Are there any restriction on which sorts of tables can be passed here?
SSDT and the like I suppose are supported, what about an entire DSDT?
> +=item B<smbios_firmware="STRING">
> +
> +Specify a path to a file that contains extra SMBIOS firmware structures to
pass
> +in to a guest. The file can contain a set DMTF predefined structures which
will
                                           ^of?
> +override the internal defaults. Not all predefined structures can be
overriden,
                                                                       
overridden
> +only the following types: 0, 1, 2, 3, 11, 22, 39. The file can also
contain any
> +number of vendor defined SMBIOS structures (type 128 - 255). Since SMBIOS
> +structures do not present their overall size, each entry in the file must
be
> +preceeded by a 32b integer indicating the size of the next structure.
   preceded
> +
>  =back 
>  
>  =head3 Guest Virtual Time Controls

> -----Original Message-----
> From: Ian Campbell
> Sent: Monday, January 21, 2013 5:00 AM
> To: Ross Philipson
> Cc: xen-devel@lists.xensource.com
> Subject: Re: [Xen-devel] [PATCH v1 02/02] HVM firmware passthrough libxl
> support
> 
> On Fri, 2013-01-18 at 21:41 +0000, Ross Philipson wrote:
> > This patch updates the xl.cfg man page with descriptions of the two
> new
> > parameters for firmware passthrough.
> >
> > Signed-off-by: Ross Philipson <ross.philipson@citrix.com>
> >
> > diff -r 38cc3302bf25 docs/man/xl.cfg.pod.5
> > --- a/docs/man/xl.cfg.pod.5     Fri Jan 18 15:24:32 2013 -0500
> > +++ b/docs/man/xl.cfg.pod.5     Fri Jan 18 15:44:19 2013 -0500
> > @@ -829,6 +829,24 @@ libxl: ''host,tm=0,sse3=0''
> >  More info about the CPUID instruction can be found in the processor
> manuals, and
> >  in Wikipedia: L<http://en.wikipedia.org/wiki/CPUID>
> >
> > +=item B<acpi_firmware="STRING">
> > +
> > +Specify a path to a file that contains extra ACPI firmware tables to
> pass in to
> > +a guest. The file can contain several tables in their binary AML form
> > +concatenated together. Each table self describes its length so no
> additional
> > +information is needed. These tables will be added to the ACPI table
> set in the
> > +guest.
> 
> Are there any restriction on which sorts of tables can be passed here?
> SSDT and the like I suppose are supported, what about an entire DSDT?
> 
Yea there are. There is no way to override the entire DSDT at present. In
fact ACPI pass-through doesn''t allow overriding any tables, just adding
new ones. So it would not make sense to pass in a FADT or something like
that. I will update the docs to indicate that and fix the type-os.

Thanks
Ross