ladybird/Documentation/Troubleshooting.md
2021-07-10 23:24:45 +02:00

2.2 KiB

Troubleshooting

In case of an error, you might find an answer of how to deal it here.

Building SerenityOS

CMake fails to configure the build because it's outdated

Ensure your CMake version is >= 3.16 with cmake --version. If your system doesn't provide a suitable version of CMake, you can download a binary release from the CMake website.

QEMU is missing or is outdated

Ensure your QEMU version is >= 5 with qemu-system-i386 -version. Otherwise, install it. You can also build it using the Toolchain/BuildQemu.sh script.

GCC is missing or is outdated

Ensure your gcc version is >= 10 with gcc --version. Otherwise, install it. If your gcc binary is not called gcc you have to specify the names of your C and C++ compiler when you run cmake, e.g. cmake ../.. -GNinja -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11.

Running SerenityOS

The VM is really slow

On Linux, QEMU is significantly faster if it's able to use KVM. The run script will automatically enable KVM if /dev/kvm exists and is readable+writable by the current user. On Windows, ensure that you have WHPX acceleration enabled.

Boot fails with "Error: Kernel Image too big for memory slot. Halting!"

This means the kernel is too large again. Contact us on the discord server or open a GitHub Issue about it. You might want to revert latest changes in tree to see if that solves the problem temporarily.

Boot fails with "Your computer does not support long mode (64-bit mode). Halting!"

Either your machine (if you try to boot on bare metal) is very old, thus it's not supporting x86_64 extensions, or you try to use VirtualBox without using a x64 virtualization mode or you try to use qemu-system-i386 which doesn't support x86_64 extensions too.

Boot fails with "Your computer does not support PAE. Halting!"

  • 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.
  • If you're using QEMU, the CPU model configuration is not exposing PAE.