summaryrefslogtreecommitdiff
path: root/Documentation/BuildInstructions.md
diff options
context:
space:
mode:
authorkleines Filmröllchen <filmroellchen@serenityos.org>2022-12-28 14:00:29 +0100
committerLinus Groh <mail@linusgroh.de>2023-01-03 18:02:16 +0100
commitb36d09bab0d33c8d9c04efe6ece1173b24475d29 (patch)
tree68f10a015cf4f180f032898c2f9676fdbc30d440 /Documentation/BuildInstructions.md
parent2afe9f574e097e01b9d63ee786023ff058092de0 (diff)
downloadserenity-b36d09bab0d33c8d9c04efe6ece1173b24475d29.zip
Documentation: Document fix for missing /etc/mtab
/etc/mtab is identical to /proc/self/mounts, but it does not exist under many circumstances, e.g. chroot'ed or in WSL. The fact that many userspace programs rely on this file existing and the user needing to create symlinks manually has been a long-standing issue (there's pretty old forum posts on Debian and Arch Linux forums about it), but it's not fixed upstream. This short mention should save people some time.
Diffstat (limited to 'Documentation/BuildInstructions.md')
-rw-r--r--Documentation/BuildInstructions.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/BuildInstructions.md b/Documentation/BuildInstructions.md
index 5df37310d8..4e98d3c1fc 100644
--- a/Documentation/BuildInstructions.md
+++ b/Documentation/BuildInstructions.md
@@ -88,6 +88,8 @@ Meta/serenity.sh run
This will compile all of SerenityOS and install the built files into the `Build/x86_64/Root` directory inside your Git
repository. It will also build a disk image and start SerenityOS using QEMU.
+If, during build, an error like `fusermount: failed to open /etc/mtab: No such file or directory` appears, you have installed `fuse2fs` but your system does not provide the mtab symlink for various reasons. Simply create this symlink with `ln -sv /proc/self/mounts /etc/mtab`.
+
Note that the `anon` user is able to become `root` without a password by default, as a development convenience.
To prevent this, remove `anon` from the `wheel` group and he will no longer be able to run `/bin/su`.