beenull/ladybird
1
0
Fork 0
mirror of https://github.com/LadybirdBrowser/ladybird.git synced 2024-11-22 07:30:19 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

Documentation: Add troubleshooting note regarding KVM GDB

Browse source
This commit is contained in:
Simon Haegler 2022-12-30 13:00:27 +01:00 committed by Andrew Kaster
parent bfbb4bcd9b
commit 5220afcf73
Notes: sideshowbarker 2024-07-17 01:28:15 +09:00 
Author: https://github.com/mistafunk 🔰
Commit: https://github.com/SerenityOS/serenity/commit/5220afcf73
Pull-request: https://github.com/SerenityOS/serenity/pull/16723
Reviewed-by: https://github.com/ADKaster ✅
Reviewed-by: https://github.com/martinfalisse
1 changed files with 5 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
Documentation/Troubleshooting.md
View file

@ -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`