diff options
Diffstat (limited to 'doc/manual/src/advanced-topics')
| -rw-r--r-- | doc/manual/src/advanced-topics/cores-vs-jobs.md | 10 | ||||
| -rw-r--r-- | doc/manual/src/advanced-topics/distributed-builds.md | 2 |
2 files changed, 6 insertions, 6 deletions
diff --git a/doc/manual/src/advanced-topics/cores-vs-jobs.md b/doc/manual/src/advanced-topics/cores-vs-jobs.md index 846b6356e..91e95d5b4 100644 --- a/doc/manual/src/advanced-topics/cores-vs-jobs.md +++ b/doc/manual/src/advanced-topics/cores-vs-jobs.md @@ -16,18 +16,18 @@ configuration trade-offs. -j`. The [???](#conf-cores) setting determines the value of -NIX\_BUILD\_CORES. NIX\_BUILD\_CORES is equal to [???](#conf-cores), -unless [???](#conf-cores) equals `0`, in which case NIX\_BUILD\_CORES +`NIX_BUILD_CORES`. `NIX_BUILD_CORES` is equal to [???](#conf-cores), +unless [???](#conf-cores) equals `0`, in which case `NIX_BUILD_CORES` will be the total number of cores in the system. The maximum number of consumed cores is a simple multiplication, -[???](#conf-max-jobs) \* NIX\_BUILD\_CORES. +[???](#conf-max-jobs) \* `NIX_BUILD_CORES`. The balance on how to set these two independent variables depends upon each builder's workload and hardware. Here are a few example scenarios on a machine with 24 cores: -| [???](#conf-max-jobs) | [???](#conf-cores) | NIX\_BUILD\_CORES | Maximum Processes | Result | +| [???](#conf-max-jobs) | [???](#conf-cores) | `NIX_BUILD_CORES` | Maximum Processes | Result | | --------------------- | ------------------ | ----------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | 24 | 24 | 24 | One derivation will be built at a time, each one can use 24 cores. Undersold if a job can’t use 24 cores. | | 4 | 6 | 6 | 24 | Four derivations will be built at once, each given access to six cores. | @@ -38,5 +38,5 @@ on a machine with 24 cores: Balancing 24 Build Cores It is up to the derivations' build script to respect host's requested -cores-per-build by following the value of the NIX\_BUILD\_CORES +cores-per-build by following the value of the `NIX_BUILD_CORES` environment variable. diff --git a/doc/manual/src/advanced-topics/distributed-builds.md b/doc/manual/src/advanced-topics/distributed-builds.md index 197708ee5..4f24febb0 100644 --- a/doc/manual/src/advanced-topics/distributed-builds.md +++ b/doc/manual/src/advanced-topics/distributed-builds.md @@ -27,7 +27,7 @@ If you get the error bash: nix-store: command not found error: cannot connect to 'mac' -then you need to ensure that the PATH of non-interactive login shells +then you need to ensure that the `PATH` of non-interactive login shells contains Nix. > **Warning** |