diff options
| author | Niklas Hambüchen <mail@nh2.me> | 2019-03-31 03:47:43 +0200 |
|---|---|---|
| committer | Niklas Hambüchen <mail@nh2.me> | 2019-03-31 03:57:45 +0200 |
| commit | caa76c369a6d77eb3ccaa14bd8144581c8cd50a7 (patch) | |
| tree | f050f3cfc47481f6b653bdfb83662adfbc262935 /doc/manual/command-ref/opt-common.xml | |
| parent | f32fbf952d8eb15963da65a162da169de72f36fa (diff) | |
docs: Mention `--max-jobs 0` to build remotely only
Diffstat (limited to 'doc/manual/command-ref/opt-common.xml')
| -rw-r--r-- | doc/manual/command-ref/opt-common.xml | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/doc/manual/command-ref/opt-common.xml b/doc/manual/command-ref/opt-common.xml index 4c572e129..b8a2f260e 100644 --- a/doc/manual/command-ref/opt-common.xml +++ b/doc/manual/command-ref/opt-common.xml @@ -107,14 +107,22 @@ <varlistentry xml:id="opt-max-jobs"><term><option>--max-jobs</option> / <option>-j</option> <replaceable>number</replaceable></term> - <listitem><para>Sets the maximum number of build jobs that Nix will + <listitem> + + <para>Sets the maximum number of build jobs that Nix will perform in parallel to the specified number. Specify <literal>auto</literal> to use the number of CPUs in the system. The default is specified by the <link linkend='conf-max-jobs'><literal>max-jobs</literal></link> configuration setting, which itself defaults to <literal>1</literal>. A higher value is useful on SMP systems or to - exploit I/O latency.</para></listitem> + exploit I/O latency.</para> + + <para> Setting it to <literal>0</literal> disallows building on the local + machine, which is useful when you want builds to happen only on remote + builders.</para> + + </listitem> </varlistentry> |