From 826edc4341863cadbe26bd629b590f984af00609 Mon Sep 17 00:00:00 2001 From: Liran Tal Date: Wed, 31 Jul 2024 12:42:02 +0300 Subject: [PATCH] doc: expand troubleshooting section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update the troubleshooting section with regards to memory requirements and potential errors. This error specifically happened to me on an Ubuntu host with 2GB of RAM which wasn't enough and g++ error'ed during Node.js compilation step. PR-URL: https://github.com/nodejs/node/pull/53808 Reviewed-By: Richard Lau Reviewed-By: Benjamin Gruenbaum Reviewed-By: Tobias Nießen Reviewed-By: Ulises Gascón Reviewed-By: Luigi Pinca Reviewed-By: Trivikram Kamat --- BUILDING.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index 9b40bda8e05f22..2b006e88f2e6f1 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -600,6 +600,11 @@ rebuild may take a lot more time than previous builds. Additionally, ran `./configure` with non-default options (such as `--debug`), you will need to run it again before invoking `make -j4`. +If you received the error `nodejs g++ fatal error compilation terminated cc1plus` +during compilation, this is likely a memory issue and you should either provide +more RAM or create swap space to accommodate toolchain requirements or reduce +the number of parallel build tasks (`-j`). + ### Windows #### Tips