aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/conf-file.xml57
-rw-r--r--doc/manual/release-notes.xml5
2 files changed, 62 insertions, 0 deletions
diff --git a/doc/manual/conf-file.xml b/doc/manual/conf-file.xml
index c095a001c..ae167fb78 100644
--- a/doc/manual/conf-file.xml
+++ b/doc/manual/conf-file.xml
@@ -30,6 +30,9 @@ gc-keep-derivations = true # Idem
env-keep-derivations = false
</programlisting>
+<para>You can override settings using the <option>--option</option>
+flag, e.g. <literal>--option gc-keep-outputs false</literal>.</para>
+
<para>The following settings are currently available:
<variablelist>
@@ -243,6 +246,16 @@ env-keep-derivations = false
</varlistentry>
+ <varlistentry><term><literal>build-fallback</literal></term>
+
+ <listitem><para>If set to <literal>true</literal>, Nix will fall
+ back to building from source if a binary substitute fails. This
+ is equivalent to the <option>--fallback</option> flag. The
+ default is <literal>false</literal>.</para></listitem>
+
+ </varlistentry>
+
+
<varlistentry xml:id="conf-build-chroot-dirs"><term><literal>build-chroot-dirs</literal></term>
<listitem><para>When builds are performed in a chroot environment,
@@ -307,6 +320,50 @@ build-use-chroot = /dev /proc /bin</programlisting>
</varlistentry>
+ <varlistentry><term><literal>binary-caches</literal></term>
+
+ <listitem><para>A list of URLs of binary caches, separated by
+ whitespace. The default is
+ <literal>http://nixos.org/binary-cache</literal>.</para></listitem>
+
+ </varlistentry>
+
+
+ <varlistentry><term><literal>binary-caches-files</literal></term>
+
+ <listitem><para>A list of names of files that will be read to
+ obtain additional binary cache URLs. The default is
+ <literal>/nix/var/nix/profiles/per-user/root/channels/binary-caches/*</literal>,
+ which ensures that Nix will use the binary caches corresponding to
+ the channels installed by root. Do not set this option to read
+ files created by untrusted users!</para></listitem>
+
+ </varlistentry>
+
+
+ <varlistentry><term><literal>trusted-binary-caches</literal></term>
+
+ <listitem><para>A list of URLs of binary caches, separated by
+ whitespace. These are not used by default, but can be enabled by
+ users of the Nix daemon by specifying <literal>--option
+ binary-caches <replaceable>urls</replaceable></literal> on the
+ command line. Daemon users are only allowed to pass a subset of
+ the URLs listed in <literal>binary-caches</literal> and
+ <literal>trusted-binary-caches</literal>.</para></listitem>
+
+ </varlistentry>
+
+
+ <varlistentry><term><literal>binary-caches-parallel-connections</literal></term>
+
+ <listitem><para>The maximum number of parallel HTTP connections
+ used by the binary cache substituter to get NAR info files. This
+ number should be high to minimise latency. It defaults to
+ 150.</para></listitem>
+
+ </varlistentry>
+
+
<varlistentry><term><literal>system</literal></term>
<listitem><para>This option specifies the canonical Nix system
diff --git a/doc/manual/release-notes.xml b/doc/manual/release-notes.xml
index ed06b638a..7c78122f0 100644
--- a/doc/manual/release-notes.xml
+++ b/doc/manual/release-notes.xml
@@ -94,6 +94,11 @@
<citerefentry><refentrytitle>nix.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
</listitem>
+ <listitem>
+ <para>When using the Nix daemon, the <option>-s</option> flag in
+ <command>nix-env -qa</command> is now much faster.</para>
+ </listitem>
+
</itemizedlist>
</section>