summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorIdan Horowitz <idan.horowitz@gmail.com>2021-04-18 16:06:35 +0300
committerAndreas Kling <kling@serenityos.org>2021-04-18 22:06:42 +0200
commitaaf3d26dae90318e4d530ccc164574914223feeb (patch)
tree6c6151687dbd6a54b4dff12d584ff48ff450334c /Documentation
parent7dc95721ee0087846d818fdc46b380ed888c1d0e (diff)
downloadserenity-aaf3d26dae90318e4d530ccc164574914223feeb.zip
Kernel: Add kernel command line flag to disable VirtIO support
This command line flag can be used to disable VirtIO support on certain configurations (native windows) where interfacing with virtio devices can cause qemu to freeze.
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/NotesOnWSL.md3
1 files changed, 3 insertions, 0 deletions
diff --git a/Documentation/NotesOnWSL.md b/Documentation/NotesOnWSL.md
index bcba478df4..3703633590 100644
--- a/Documentation/NotesOnWSL.md
+++ b/Documentation/NotesOnWSL.md
@@ -40,6 +40,9 @@ By default this will be located at `/mnt/c/Program Files/qemu/qemu-system-i386.e
- Locate the _Windows_ path to the SerenityOS disk image, as native QEMU will be accessing it via the Windows filesystem. If your build tree is located in the WSL2 partition, this will be accessible under the `\\wsl$` network file share (see [notes below](#note-on-filesystems)).
+- Set the `SERENITY_KERNEL_CMDLINE` environment variable to disable VirtIO support (Because it is currently broken on native windows QEMU):
+`export SERENITY_KERNEL_CMDLINE="disable_virtio"`
+
- Set the `SERENITY_DISK_IMAGE` environment variable to the full path of the SerenityOS disk image file from above. For example: \
`export SERENITY_DISK_IMAGE='\\wsl$\Ubuntu-20.04\home\username\serenity\Build\i686\_disk_image'`