From 95b49691c50fb84e2692eedbd121fa109af94c28 Mon Sep 17 00:00:00 2001 From: Elliot Maisl Date: Wed, 3 Mar 2021 22:24:08 +0100 Subject: [PATCH] Documentation: Add instruction about entitlements in BuildInstructions The QEMU's `--accel hvf` command was recently enabled in the `run.sh` script, but it sadly doesn't work on macOS Big Sur: you need to first sign your code by adding an `entitlements.xml` file and running a simple command. --- Documentation/BuildInstructions.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/BuildInstructions.md b/Documentation/BuildInstructions.md index cd52af800965c2..522f984296ca97 100644 --- a/Documentation/BuildInstructions.md +++ b/Documentation/BuildInstructions.md @@ -113,6 +113,23 @@ Notes: - bash is needed because the default version installed on macOS doesn't support globstar - If you install some commercial EXT2 macOS fs handler instead of osxfuse and fuse-ext2, you will need to `brew install e2fsprogs` to obtain `mke2fs` anyway. - As of 2020-08-06, you might need to tell the build system about your newer host compiler. Once you've built the toolchain, navigate to `Build/`, `rm -rf *`, then run `cmake .. -G Ninja -DCMAKE_C_COMPILER=gcc-10 -DCMAKE_CXX_COMPILER=g++-10`, then continue with `ninja install` as usual. +- If you are on macOS Big Sur, you will need to manually enable QEMU's acceleration before running Serenity, by creating a new file called `entitlements.xml` in the `Build/` folder, with the content below, and then run the command: `codesign -s - --entitlements entitlements.xml --force /usr/local/bin/qemu-system-x86_64`; otherwise the run command will fail. + +
+Content for 'entitlements.xml'. + +```xml + + + + + com.apple.security.hypervisor + + + +``` +
#### OpenBSD prerequisites ```