On Tue, May 10, 2016 at 07:15:01PM -0400, Cole Robinson wrote:
On 05/10/2016 11:50 AM, Daniel P. Berrange wrote:
> On Tue, May 10, 2016 at 11:26:29AM -0400, Cole Robinson wrote:
>> On 05/10/2016 05:10 AM, Daniel P. Berrange wrote:
>>> On Mon, May 09, 2016 at 06:53:01PM -0400, Cole Robinson wrote:
>>>> On 05/09/2016 09:48 AM, Daniel P. Berrange wrote:
>>>
>>> IMHO it is a total failure if we require the application to extend its
>>> parser every time we add a new enum to the domain capabilities. We have
>>> the ability to design something that is data driven - we should not build
>>> something it is forced to be code driven with code changes for every
>>> libvirt addition.
>>
>> This is ignoring the point I made previously that the schema is not already
>> fully introspectable. Most of the current enums cannot be programmatically
>> consumed anyways, because there's no way to map an enum name to its domain
XML
>> property. So if that's our goal to be data driven, we should address that
>> issue first.
>
> Knowing the mapping of the capabilities enums to the domain schema is
> a pre-requisite for consuming the capabilities data, no matter which
> approach discussed in this thread is chosen. Assuming the app knows
> that mapping, then the enum conditionals can be programmatically
> handled with the approach I describe.
>
> Providing a way for the app to automatically determine the mapping
> from capabilities enums to the domain schema would be a nice
> addition, but it isn't a pre-requisite blocker for what's discussed
> here. It is something that can be deal with in parallel.
>
>> I can't really think of a good way to represent that without nesting
>> deeply or using specially formatted strings. Do you have a suggestion
>> for that?
>
> Probably the best thing is to use a very simplified xpath style notation.
> If we add a 'mapping' attribute to the <enum> that expresses the
attribute
> or element it is associated with, relative to the parent container element.
>
> eg, consider the tests/domaincapsschemadata/domaincaps-qemu_1.6.50-1.xml
> data file with the mapping info:
>
> <domainCapabilities>
> <path>/usr/bin/qemu-system-x86_64</path>
> <domain>kvm</domain>
> <machine>pc-1.2</machine>
> <arch>x86_64</arch>
> <os supported='yes'>
> <loader supported='yes'>
> <value>/usr/share/AAVMF/AAVMF_CODE.fd</value>
> <value>/usr/share/OVMF/OVMF_CODE.fd</value>
> <enum name='type' mapping="@type">
> <value>rom</value>
> <value>pflash</value>
> </enum>
> <enum name='readonly' mapping="@readonly">
> <value>yes</value>
> <value>no</value>
> </enum>
> </loader>
> </os>
> <devices>
> <disk supported='yes'>
> <enum name='diskDevice' mapping="@device">
> <value>disk</value>
> <value>cdrom</value>
> <value>floppy</value>
> <value>lun</value>
> </enum>
> <enum name='bus' mapping="target/@bus">
> <value>ide</value>
> <value>fdc</value>
> <value>scsi</value>
> <value>virtio</value>
> <value>usb</value>
> </enum>
> </disk>
> <hostdev supported='yes'>
> <enum name='mode' mapping="@mode">
> <value>subsystem</value>
> </enum>
> <enum name='startupPolicy'
mapping="source/@startupPolicy">
> <value>default</value>
> <value>mandatory</value>
> <value>requisite</value>
> <value>optional</value>
> </enum>
> <enum name='subsysType' mapping="@type">
> <value>usb</value>
> <value>pci</value>
> <value>scsi</value>
> </enum>
> <enum name='capsType' mapping="@type"/>
> <enum name='pciBackend' mapping="driver/@name">
> <value>default</value>
> <value>kvm</value>
> <value>vfio</value>
> </enum>
> </hostdev>
> </devices>
> <features>
> <gic supported='no'/>
> </features>
> </domainCapabilities>
>
>
> NB, with my proposed conditionals, the hostdev enums above would actually
> want to be different. eg it would want to look like this:
>
> <enum name='mode' mapping="@mode">
> <value>subsystem</value>
> </enum>
> <enum name='startupPolicy'
mapping="source/@startupPolicy">
> <value>default</value>
> <value>mandatory</value>
> <value>requisite</value>
> <value>optional</value>
> </enum>
> <enum name='type' mapping="@type">
> <condition>
> <enum name='mode' value='subsystem'/>
> </condition>
> <value>usb</value>
> <value>pci</value>
> <value>scsi</value>
> </enum>
> <enum name='driver' mapping="driver/@name">
> <condition>
> <enum name='mode' value='subsystem'/>
> <enum name='type' value='pci'/>
> </condition>
> <value>default</value>
> <value>kvm</value>
> <value>vfio</value>
> </enum>
>
Yeah that mapping= bit makes sense to me.
I don't have time to see pick this up now though, so I've stuffed it in a bug:
Thinking about this some more last night, I realize that once we have
the 'mapping' attribute, then the choice of values in the 'name'
attribute
becomes totally irrelevant.
IOW, we could use your suggestion for giving each enum a unique name,
eg 'spiceGL', 'vncGL', etc, etc. So apps which want to consume this
data have a choice between just matching on explicit enum names and
ignoring the <condition> rules, or they can match on the 'mapping'
attribute and use the <condition> rules.. So we get the best of both
ideas.
Regards,
Daniel
--
|:
http://berrange.com -o-
http://www.flickr.com/photos/dberrange/ :|
|:
http://libvirt.org -o-
http://virt-manager.org :|
|:
http://autobuild.org -o-
http://search.cpan.org/~danberr/ :|
|:
http://entangle-photo.org -o-
http://live.gnome.org/gtk-vnc :|