doc: add example for building with constrained resources #7423

pull jarret wants to merge 1 commits into bitcoin:master from jarret:docBuildFlags changing 1 files +7 −4

jarret commented at 1:48 AM on January 27, 2016: contributor

discussed in github issue #6658
in doc/build-unix.md:None in abc3c15ab9 outdated
```
  58 | -compilation will take much longer due to swap thrashing.
  59 | +memory available when compiling Bitcoin Core. However, if you are building on a
  60 | +system with less than 1 GB memory, the compiler can be instructed to conserve
  61 | +memory with additional CXXFLAGS:
  62 | +
  63 | +    ./configure CXXFLAGS="--param ggc-min-expand=1 --param ggc-min-heapsize=32768"
```
jonasschnelli commented at 8:10 AM on January 27, 2016:

nit: Looks like gcc specific. Maybe okay. But is there a clang equivalent or something that is supported by "all"/"most" compilers?

laanwj commented at 9:10 AM on January 27, 2016:

Nit: From what I understood of #6658, these settings may even be helpful with only 1 GB of memory, not just with less

Edit: and yes, this should mention the compiler

jarret commented at 3:23 AM on January 28, 2016:

@jonasschnelli:

I have updated the wording to indicate gcc-specificness. I will have to do more research and testing for a working low-memory clang recipe. With gcc and aggressive values for these params, I have been able to successfully build with on a Raspberry Pi 1 with 512 RAM and no swap partition. This is better than @laanwj's clang measurements posted on issue 6658, so until we can demonstrate a better tweak with clang, this appears to be a solid recommendation. @laanwj:

That is correct, thanks. I have also updated the commit with a change of the section title and a phrasing that feels better to me. I went with a wording to encourage people to try if they are below 1.5 GB. Please let me know if you think it is an improvement.
jonasschnelli commented at 8:11 AM on January 27, 2016: contributor

utACK
jonasschnelli added the label Docs and Output on Jan 27, 2016
laanwj added the label Build system on Jan 27, 2016
doc: add example for building with constrained resources
discussed in github issue #6658
f9298cc60e
jarret force-pushed on Jan 28, 2016
laanwj commented at 10:07 AM on January 28, 2016: member

utACK https://github.com/jarret/bitcoin/commit/f9298cc60e093533ce109aedd7d54d59e87865cd
laanwj merged this on Jan 29, 2016
laanwj closed this on Jan 29, 2016
laanwj referenced this in commit 69e2a4003b on Jan 29, 2016
codablock referenced this in commit 23f3296140 on Sep 16, 2017
codablock referenced this in commit 6acab4821c on Sep 19, 2017
codablock referenced this in commit a2965c2c63 on Dec 9, 2017
codablock referenced this in commit 860ba2ba8e on Dec 9, 2017
codablock referenced this in commit 6c5286aadd on Dec 11, 2017
MarcoFalke locked this on Sep 8, 2021

Contributors

Labels

Linked (view graph)

#6658 Building requires >1GB memory