[libvirt] [PATCH] docs: Document <filesystem> device

[Eric Blake]

On 04/29/2011 11:29 AM, Cole Robinson wrote:
> Tried to dredge through old changelogs and commits to come up with it, so
> may not be completely accurate.

Maybe true, but still better than nothing.  Thanks for tackling this.

> 
> Signed-off-by: Cole Robinson <crobinso at redhat.com>
> ---
>  docs/formatdomain.html.in |  107 +++++++++++++++++++++++++++++++++++++++++++++
>  1 files changed, 107 insertions(+), 0 deletions(-)
> 
> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
> index a055b38..eafb983 100644
> --- a/docs/formatdomain.html.in
> +++ b/docs/formatdomain.html.in
> @@ -903,6 +903,113 @@
>        </dd>
>      </dl>
>  
> +    <h4><a name="elementsFilesystems">Filesystems</a></h4>
> +
> +    <p>
> +      A directory on the host that can be accessed directly from the guest.
> +      <span class="since">since 0.3.3 for containers, since 0.8.5 for QEMU/KVM</span>

Should this read 'LXC containers'?

> +        <a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a>
> +        </dd>
> +        <dt><code>mode='mapped'</code></dt>
> +        <dd>
> +        The <code>source</code> is accessed with the permissions of the
> +        hypervisor (QEMU process).
> +        <a href="http://lists.gnu.org/archive/html/qemu-devel/2010-05/msg02673.html">More info</a>
> +        </dd>
> +        <dt><code>mode='squash'</code></dt>
> +        <dd>
> +        Similar to 'passthrough', the exception is that failure of
> +        privileged operations like 'chown' are ignored. This makes a
> +        passthrough-like mode usable for people who run the hypervisor
> +        as non-root.
> +        <a href="http://www.mail-archive.com/qemu-devel@nongnu.org/msg41096.html">More info</a>

For consistency, we should use
http://lists.gnu.org/archive/html/qemu-devel/2010-09/msg00121.html
for the third URL, so that all three are pointing to the same archive site.

ACK with nits addressed.

-- 
Eric Blake   eblake at redhat.com    +1-801-349-2682
Libvirt virtualization library http://libvirt.org

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