[libvirt] [PATCH] docs: document <address> elements in one place

[Michael Ellerman]

On Fri, 2011-12-09 at 16:35 -0700, Eric Blake wrote:
> Improve the documentation of what forms a valid <address> element,
> since these elements appear in numerous devices.

Thanks for doing that, minor rewrite on this one:

> +      <dt><code>type='spapr-vio'</code></dt>
> +      <dd>On PowerPC guests, devices are assigned on the SPAPR-VIO
> +        bus, which is a flat 64-bit address space, where each address
> +        should be aligned on a multiple of 0x1000.  Each address has
> +        the following additional attribute: <code>reg</code> (the hex
> +        value address of the starting
> +        register).

I would say something like:

On PowerPC pseries guests, devices can be assigned to the SPAPR VIO bus.
It has a flat 64-bit address space, by convention devices are generally
located at a multiple of 0x1000, but other addresses are legal and
accepted by libvirt. A device can be given an address by specifying the
<code>reg</code> attribute, this gives the 64-bit address of the device.
If no <code>reg</code> value is specified libvirt will attempt to assign
a value for you.


cheers
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20111212/57f703a7/attachment-0001.sig>