From: Wolfgang Bangerth Date: Tue, 7 Jan 2020 15:07:48 +0000 (-0700) Subject: Document out of memory issues with 'make -jN'. X-Git-Tag: v9.2.0-rc1~730^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F9245%2Fhead;p=dealii.git Document out of memory issues with 'make -jN'. --- diff --git a/doc/readme.html b/doc/readme.html index 3e82ba3aa8..4367bc7aa3 100644 --- a/doc/readme.html +++ b/doc/readme.html @@ -179,7 +179,8 @@ make --jobs=4 install make test - One should usually use one job for each processor core on the machine. + One should usually use one job for each processor core on the + machine.

These steps compile, link, install the deal.II library, and run a few consistency checks. The whole process should take between a few minutes and an hour, depending on your machine. @@ -210,6 +211,17 @@

  • If you are changing part of the deal.II code itself, you can re-compile the library using only the last two commands above in the previously created build directory. It is also possible to change the configuration used in this directory by calling cmake a second time, possibly with different arguments. However, this sometimes leads to surprising results and you may not get exactly what you were hoping for. For more information, see here.
  • + +
  • + Compilers require a lot of memory. If your machine has many + cores but not so much memory, then using -jN + with a large N might lead to situations where + not enough memory is available for all compilers, and this + typically manifests as an "internal compiler error" or a + segmentation fault. If that happens, just + reduce N and type the make install + command again. +