* Negative caching, i.e. caching of build failures. Disabled by

  default.  This is mostly useful for Hydra.

1 files changed, 16 insertions, 0 deletions

diff --git a/nix.conf.example b/nix.conf.example
index e7f8adcab6..5b6d5b87fe 100644
--- a/nix.conf.example
+++ b/nix.conf.example
@@ -154,6 +154,22 @@
 #build-chroot-dirs = /dev /dev/pts /proc
 
 
+### Option `build-cache-failure'
+#
+# If this option is enabled, Nix will do negative caching; that is, it
+# will remember failed builds, and won't attempt to try to build them
+# again if you ask for it.  Negative caching is disabled by default
+# because Nix cannot distinguish between permanent build errors (e.g.,
+# a syntax error in a source file) and transient build errors (e.g., a
+# full disk), as they both cause the builder to return a non-zero exit
+# code.  You can clear the cache by doing `rm -f
+# /nix/var/nix/db/failed/*'.
+#
+# Example:
+#   build-cache-failure = true
+#build-cache-failure = false
+
+
 ### Option `system'
 #
 # This option specifies the canonical Nix system name of the current