summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorTristan Menke <tr.menke@web.de>2021-06-21 02:53:18 +0200
committerGunnar Beutner <gunnar@beutner.name>2021-07-03 17:32:33 +0200
commit9f117a79f648abccabaff73b68dfee2298ca13e7 (patch)
tree393e4de69a34159785bd52de3450ba0c7fd56f76 /Documentation
parente4a55404f18ce785068aab710c7dbb33f10d226b (diff)
downloadserenity-9f117a79f648abccabaff73b68dfee2298ca13e7.zip
Documentation: Add workaround for blackscreen using WSL+QEMU6.x
This workaround disables the in-kernel interrupt controller. This impacts the VM performance and should probably be removed when the workaround is no longer needed. This workaround was posed by stelar7. See #7523
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/NotesOnWSL.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/NotesOnWSL.md b/Documentation/NotesOnWSL.md
index 8e8002d062..3f13b4d5a0 100644
--- a/Documentation/NotesOnWSL.md
+++ b/Documentation/NotesOnWSL.md
@@ -75,6 +75,8 @@ If Serenity freezes on boot with the log message: `Scheduler[0]: idle loop runni
Please ensure you have installed the most recent version of [QEMU for Windows](https://qemu.weilnetz.de/) and that you have followed the step above to enable the maximum feature set available:
`export SERENITY_QEMU_CPU="max,vmx=off"`.
+If the steps above do not fix the problem, check the boot log for `whpx: injection failed, MSI (0, 0) delivery: 0, dest_mode: 0, trigger mode: 0, vector: 0, lost (c0350005)`. If present, try disabling the KVM in-kernel interrupt handler by extending the above to `export SERENITY_EXTRA_QEMU_ARGS="-accel whpx,kernel-irqchip=off"`. This seems to be an issue for some users with QEMU 6.x.
+
##### Illegal instruction on boot
Using `SERENITY_QEMU_CPU="max"` can trigger a QEMU bug where the OSXSAVE CPUID flag is erroneously set, playing havoc with feature detection logic in libgcc and resulting in this error.