[libvirt] [PATCHv2 2/8] doc: schema: Add basic documentation for the virtual RNG device support

Eric Blake eblake at redhat.com
Mon Feb 25 21:01:02 UTC 2013


On 02/25/2013 02:08 AM, Peter Krempa wrote:
> On 02/22/13 19:20, Eric Blake wrote:
>> On 02/21/2013 07:47 AM, Peter Krempa wrote:
>>> This patch documents XML elements used for (basic) support of virtual
>>> RNG devices.
>>>
>>>
>>> For the slightly more advanced EGD backend:
>>>    <devices>
>>>      <rng model='virtio'>
>>>        <backend model='egd' type='udp'>
>>>          <!-- this is a definition of a character device -->
>>>          <source mode='bind' service='1234'/>
>>>          <source mode='connect' host='1.2.3.4' service='1234'/>
>>>          <!-- or other valid character device configuration -->
>>

>> Do we really want two <source> in a single <backend> in the example, or
>> would it be easier to show multiple <rng> devices, one for each type of
>> backend?
> 
> That actually is valid for the character device backends. The UDP
> backend has to use two separate sources for bi-directional
> communication. The definition of that source type is declared as a type
> in our RNG schema an I merely reused that.

Oh, I didn't realize that.  Do we want to ENFORCE that there are two
<source> elements present then?  Or can we always provide a sane default
when the user provides only 0 or 1 source?  Depending on that answer, it
might be worth additional documentation on why two <source> elements are
present, as well as mentioning that order is significant in how they are
listed.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 621 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20130225/148c57a4/attachment-0001.sig>


More information about the libvir-list mailing list