diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index a055b38ec4bbe13f861221d4baa3693e2891a9e9..ab66bbaa6af6e36a967bbf153043f77b2a32a25b 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -903,6 +903,113 @@ +
+ A directory on the host that can be accessed directly from the guest. + since 0.3.3, since 0.8.5 for QEMU/KVM +
+ ++ ... + <devices> + <filesystem type='template'> + <source name='my-vm-template'/> + <target dir='/'/> + </filesystem> + <filesystem type='mount' > + <source dir='/export/to/guest'/> + <target dir='/import/from/host'/> + <readonly/> + </filesystem> + ... + </devices> + ...+ +
filesystem
type
specifies the type of the
+ source
. The possible values are:
+
+ type='mount'
mode
if one is not specified.
+ type='template'
type='file'
type='block'
mode
+ which specifies the security mode for accessing the source
+ (since 0.8.5). Currently this only works
+ with type='mount'
for the QEMU/KVM driver. The possible
+ values are:
+
+ mode='passthrough'
source
is accessed with the permissions of the
+ user inside the guest. This is the default mode
if
+ one is not specified.
+ More info
+ mode='mapped'
source
is accessed with the permissions of the
+ hypervisor (QEMU process).
+ More info
+ mode='squash'
source
name
attribute must be used with
+ type='template'
, and the dir
attribute must
+ be used with type='mount'
+ target
source
can be accessed in the guest. For
+ most drivers this is an automatic mount point, but for QEMU/KVM
+ this is merely an arbitrary string tag that is exported to the
+ guest as a hint for where to mount.
+ readonly
readonly
attribute is available but currently
+ unused.
+