[libvirt PATCH 1/3] docs: document new socket attribute for virtiofs

Ján Tomko jtomko at redhat.com
Thu Apr 22 11:40:52 UTC 2021


Describe the attribute and add an example.

Signed-off-by: Ján Tomko <jtomko at redhat.com>
---
 docs/formatdomain.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst
index 1b9b221611..282176c4f4 100644
--- a/docs/formatdomain.rst
+++ b/docs/formatdomain.rst
@@ -3242,6 +3242,10 @@ A directory on the host that can be accessed directly from the guest.
          <source dir='/path'/>
          <target dir='mount_tag'/>
      </filesystem>
+     <filesystem type='mount'>
+         <driver type='virtiofs' queue='1024'/>
+         <source socket='/tmp/sock'/>
+     </filesystem>
      ...
    </devices>
    ...
@@ -3369,7 +3373,11 @@ A directory on the host that can be accessed directly from the guest.
 ``source``
    The resource on the host that is being accessed in the guest. The ``name``
    attribute must be used with ``type='template'``, and the ``dir`` attribute
-   must be used with ``type='mount'``. The ``usage`` attribute is used with
+   must be used with ``type='mount'``. For ``virtiofs``, the ``socket`` attribute
+   can be used to connect to a virtiofsd daemon launched outside of libvirt.
+   In that case, the ``target`` element does not apply and neither do most
+   virtiofs-related options, since they are controlled by virtiofsd, not libvirtd.
+   The ``usage`` attribute is used with
    ``type='ram'`` to set the memory limit in KiB, unless units are specified by
    the ``units`` attribute.
 ``target``
-- 
2.29.2




More information about the libvir-list mailing list