From 75cd4d264282aed3f2ba9c2d498108596b44f4c3 Mon Sep 17 00:00:00 2001 From: Hamish McIntyre-Bhatty Date: Tue, 19 Jul 2022 11:39:09 +0100 Subject: [PATCH 1/2] Update build instructions --- src/build-instructions.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/src/build-instructions.md b/src/build-instructions.md index fa2dd4e..1d8f129 100644 --- a/src/build-instructions.md +++ b/src/build-instructions.md @@ -6,10 +6,12 @@ You must be running a 64-bit x86 Linux distribution. Darling cannot be used on a Clang is required to compile Darling; at least Clang 6 is required. You can force a specific version of Clang (if it is installed on your system) by editing `Toolchain.cmake`. +A minimum of 4 GB of RAM is also required for building. Using swap space may help reduce the memory usage, but is likely to slow the build down significantly. + Linux 5.0 or higher is required. -**Debian 10** +**Debian 10/11** ``` $ sudo apt install cmake clang-6.0 bison flex xz-utils libfuse-dev libudev-dev pkg-config \ @@ -36,9 +38,8 @@ Linux 5.0 or higher is required. gcc-multilib libcairo2-dev libgl1-mesa-dev libglu1-mesa-dev libtiff5-dev \ libfreetype6-dev git git-lfs libelf-dev libxml2-dev libegl1-mesa-dev libfontconfig1-dev libbsd-dev \ libxrandr-dev libxcursor-dev libgif-dev libavutil-dev libpulse-dev libavformat-dev libavcodec-dev \ - libswresample-dev libdbus-1-dev libxkbfile-dev libssl-dev + libswresample-dev libdbus-1-dev libxkbfile-dev libssl-dev python2 ``` -For Ubuntu 20.04, also install `python2`. **Arch Linux & Manjaro:** @@ -97,7 +98,7 @@ Darling makes extensive use of Git submodules, therefore you cannot use a plain $ git clone --recursive https://github.com/darlinghq/darling.git ``` -**Attention:** The source tree requires up to 4 GB of disk space! +**Attention:** The source tree requires up to 5 GB of disk space! # Updating sources @@ -114,7 +115,7 @@ $ git submodule update The build system of Darling is CMake. Makefiles are generated by CMake by default. -**Attention:** The build may require up to 10 GB of disk space! The Darling installation itself then takes up to 1 GB. +**Attention:** The build may require up to 16 GB of disk space! The Darling installation itself then takes up to 1 GB. ## Building and Installing @@ -207,7 +208,7 @@ To quote the [kernel documentation](https://www.kernel.org/doc/Documentation/fil > The lower filesystem can be any filesystem supported by Linux and does not need to be writable. The lower filesystem can even be another overlayfs. The upper filesystem will normally be writable and if it is it must support the creation of trusted.* extended attributes, and must provide valid d_type in readdir responses, so NFS is not suitable. -In addition to NFS not being supported, ZFS is also known not to work. +In addition to NFS not being supported, ZFS and eCryptfs encrypted storage are also known not to work. If you try to use an unsupported file system, this error will be printed: From 01b5fbee65351db2413afe12c2fa70da2059adc4 Mon Sep 17 00:00:00 2001 From: Marco Rolappe <215132+mrolappe@users.noreply.github.com> Date: Sun, 24 Jul 2022 19:01:33 +0200 Subject: [PATCH 2/2] docs: Add GNU Emacs 28.1 and CMake 3.23.2 to known working software --- src/known-working-software.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/known-working-software.md b/src/known-working-software.md index 63ff4eb..a3d47e8 100644 --- a/src/known-working-software.md +++ b/src/known-working-software.md @@ -4,4 +4,5 @@ The following software has been tested to work with Darling: - The Xcode commandline tools. - Python 3.10 (From https://www.python.org), including pip. - GNUPlot (http://www.gnuplot.info/), when outputting to PNG files. - +- Terminal GNU Emacs 28.1, installed via brew +- CMake 3.23.2, installed via brew