diff --git a/doc/manual/command-ref/conf-file.xml b/doc/manual/command-ref/conf-file.xml
index 6638bf61e..1033d385e 100644
--- a/doc/manual/command-ref/conf-file.xml
+++ b/doc/manual/command-ref/conf-file.xml
@@ -788,6 +788,30 @@ password my-password
+ negative-disk-cache-ttl
+
+
+
+ The TTL in seconds for negative lookups. If a store path is queried from a substituer but
+ was not found, there will be a negative lookup cached in the local disk cache database for the specified
+ duration.
+
+
+
+
+
+ positive-disk-cache-ttl
+
+
+
+ The TTL in seconds for positive lookups. If a store path is queried from a substituer, the result of
+ the query will be cached in the local disk cache database including some of the NAR metadata. Setting a TTL
+ for positive lookups can be useful in case of builds that aren't reproducible, in which case having a more
+ frequent cache invalidation would prevent hash mismatch issues.
+
+
+
+
diff --git a/src/libstore/globals.hh b/src/libstore/globals.hh
index 36c8b7357..00147f615 100644
--- a/src/libstore/globals.hh
+++ b/src/libstore/globals.hh
@@ -310,15 +310,17 @@ public:
"Disabled substituters that may be enabled via the substituters option by untrusted users.",
{"trusted-binary-caches"}};
- Setting ttlNegativeDiskCache{this, 3600, "negative-disk-cache-ttl",
- "The TTL in seconds for negative lookups in the disk cache."};
-
- Setting ttlPositiveDiskCache{this, 30 * 24 * 3600, "positive-disk-cache-ttl",
- "The TTL in seconds for positive lookups in the disk cache."};
-
Setting trustedUsers{this, {"root"}, "trusted-users",
"Which users or groups are trusted to ask the daemon to do unsafe things."};
+ Setting ttlNegativeDiskCache{this, 3600, "negative-disk-cache-ttl",
+ "The TTL in seconds for negative lookups in the disk cache i.e binary cache lookups that "
+ "return an invalid path result"};
+
+ Setting ttlPositiveDiskCache{this, 30 * 24 * 3600, "positive-disk-cache-ttl",
+ "The TTL in seconds for positive lookups in the disk cache i.e binary cache lookups that "
+ "return a valid path result."};
+
/* ?Who we trust to use the daemon in safe ways */
Setting allowedUsers{this, {"*"}, "allowed-users",
"Which users or groups are allowed to connect to the daemon."};