From 3d1d574b25451d275cee3dc4eaa545e47a5168b5 Mon Sep 17 00:00:00 2001 From: Liran Tal Date: Thu, 11 Jul 2024 14:15:26 +0300 Subject: [PATCH 1/2] doc: expand troubleshooting section 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. --- BUILDING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index c0fd9468b533ec..fc53639801f71f 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -594,6 +594,10 @@ 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. + ### Windows #### Tips From 5583527da21c9cb3ad7a6ef5bb90716d4462247d Mon Sep 17 00:00:00 2001 From: Liran Tal Date: Thu, 11 Jul 2024 16:24:11 +0300 Subject: [PATCH 2/2] doc: add note about parallel tasks increase MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Tobias Nießen --- BUILDING.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/BUILDING.md b/BUILDING.md index fc53639801f71f..8590f0c6f14d7e 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -596,7 +596,8 @@ 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. +more RAM or create swap space to accommodate toolchain requirements or reduce +the number of parallel build tasks (`-j`). ### Windows