roots/wiki
1
0
Fork 0
mirror of https://github.com/PhyllomeOS/wiki.git synced 2024-12-22 05:35:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update gofurther/virtiofs

Browse Source
This commit is contained in:
lukas 2023-01-24 16:27:18 +00:00
parent 78bd3ae200
commit 78aa670ac2
1 changed files with 31 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
gofurther/virtiofs.md
View File

@ -2,17 +2,27 @@
title: Share a host directory with a guest using virtiofs title: Share a host directory with a guest using virtiofs
description: description:
published: true published: true
date: 2022-08-13T00:16:17.437Z date: 2023-01-24T16:27:16.582Z
tags: tags:
editor: markdown editor: markdown
dateCreated: 2022-08-13T00:16:17.437Z dateCreated: 2022-08-13T00:16:17.437Z
--- ---
# virtio-fs # Sharing a directory
*to-be done* > *As of January 2023, virtio-fs is only available for virtual machines managed by the system libvirt instance (`qemu:///system`)*
{.is-info}
* Memory backing needs to be added: > *As of January 2023, virtio-fs does not feature a read-only mode. Do not share a host directory with a untrusted guest*.
{.is-warning}
[Virtio-fs](https://virtio-fs.gitlab.io/), shorts for virtio shared filesystem, allows you to share a directory located on the host with a guest. It is designed to be fast and optimized for local usage, when the host and the guest are located on the same physical machine.
## The guest
### Edit XML configuration
* Memory backing needs to be added to the XML definition:
``` ```
<domain type="kvm"> <domain type="kvm">
@ -22,10 +32,10 @@ dateCreated: 2022-08-13T00:16:17.437Z
<access mode="shared/>" <access mode="shared/>"
</memoryBacking> </memoryBacking>
[...] [...]
</domain> </domain>
``` ```
* Then a a directory can be shared using the following definition: * A filesystem device has to be added.
``` ```
<domain type="kvm"> <domain type="kvm">
@ -34,11 +44,23 @@ dateCreated: 2022-08-13T00:16:17.437Z
[...] [...]
<filesystem type="mount" accessmode="passthrough"> <filesystem type="mount" accessmode="passthrough">
<driver type="virtiofs"/> <driver type="virtiofs"/>
<source dir="/mnt/"> # Host directory to be shared with the guest <source dir="/mnt/"> # The host directory to be shared with the guest
<target dir="/mnt"/> # Directory on the guest <target dir="share"/> # Contrary to what the name implies, this is the tag used inside the guest
</filesystem> </filesystem>
[...] [...]
</devices> </devices>
[...] [...]
</domain> </domain>
``` ```
### Mount the folder inside the guest
* Inside the guest VM, mount the folder using the following commmand to mount the `/mnt` host directory on the guest, using also the `/mnt` point:
`# mount -t virtiofs share /mnt/`
## Resources
* Official website: https://virtio-fs.gitlab.io/index.html#status
* In the context of a Windows guest: https://github.com/virtio-win/kvm-guest-drivers-windows/wiki/VirtIO-FS:-Shared-file-system