From fff8eb27928cedc9af9325d492c1513505d6f0d1 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 b9e8e0146f5d56..224b8fbd795f02 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