From 49a9ba43cf913ee7484236be0e406129304f5cf0 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 ad226fbe4b197e..c7bedf2d4a519b 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -593,6 +593,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