Ver Fonte

Documentation: Add troubleshooting note regarding KVM GDB

Simon Haegler há 2 anos atrás
pai
commit
5220afcf73
1 ficheiros alterados com 5 adições e 0 exclusões
  1. 5 0
      Documentation/Troubleshooting.md

+ 5 - 0
Documentation/Troubleshooting.md

@@ -58,3 +58,8 @@ extensions, or you try to use VirtualBox without using a x64 virtualization mode
 - If booting on bare metal, your CPU is too old to boot Serenity.
 - If booting on bare metal, your CPU is too old to boot Serenity.
 - If you're using VirtualBox, you need to enable PAE/NX. Check the instructions [here.](VirtualBox.md)
 - If you're using VirtualBox, you need to enable PAE/NX. Check the instructions [here.](VirtualBox.md)
 - If you're using QEMU, the [CPU model configuration](https://qemu-project.gitlab.io/qemu/system/qemu-cpu-models.html) is not exposing PAE.
 - If you're using QEMU, the [CPU model configuration](https://qemu-project.gitlab.io/qemu/system/qemu-cpu-models.html) is not exposing PAE.
+
+### Boot fails with "KVM doesn't support guest debugging"
+- Update your host kernel to at least version `5.10`. This is the oldest kernel which properly supports the required KVM capability `KVM_CAP_SET_GUEST_DEBUG` (see corresponding [kernel commit](https://github.com/torvalds/linux/commit/b9b2782cd5)).
+- Make sure that your distro has the qemu debug feature actually enabled (the corresponding check is [here](https://gitlab.com/qemu-project/qemu/-/blob/222059a0fccf4af3be776fe35a5ea2d6a68f9a0b/accel/kvm/kvm-all.c#L2540)). 
+- Or, disable KVM debugging by setting this env var when running serenity: `SERENITY_DISABLE_GDB_SOCKET=1`