diff options
| author | Christopher Baines <mail@cbaines.net> | 2024-03-25 20:06:24 +0000 |
|---|---|---|
| committer | Christopher Baines <mail@cbaines.net> | 2024-03-25 20:40:22 +0000 |
| commit | b538c1d7b95587d3f111a7bb610747e93c5f2468 (patch) | |
| tree | b5fc922ae6603b8e79084b7efc038b40f182e462 /doc | |
| parent | 9b399add9861bd608c6344313a090eadaec0fa55 (diff) | |
services: nar-herder: Add new configuration options.
* gnu/services/guix.scm (nar-herder-configuration-new-ttl,
nar-herder-cached-compression-configuration-unused-removal-duration,
nar-herder-cached-compression-configuration-ttl,
nar-herder-cached-compression-configuration-new-ttl): New procedure.
(nar-herder-shepherd-services): Handle the new options.
* doc/guix.texi (Guix Services): Document the new nar-herder options.
Change-Id: I161e490221a3ce394e32ada685dca27df60638bb
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index eda4084e7f..ddd98a5fd4 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -39670,6 +39670,14 @@ days, @code{1m} means 1 month, and so on. This allows the user's Guix to keep substitute information in cache for @var{ttl}. +@item @code{new-ttl} (default: @code{#f}) +If specified, this will override the @code{ttl} setting when used for +the @code{Cache-Control} headers, but this value will be used when +scheduling the removal of nars. + +Use this setting when the TTL is being reduced to avoid removing nars +while clients still have cached narinfos. + @item @code{negative-ttl} (default: @code{#f}) Similarly produce @code{Cache-Control} HTTP headers to advertise the time-to-live (TTL) of @emph{negative} lookups---missing store items, for @@ -39719,6 +39727,21 @@ in /var/cache/nar-herder/nar/TYPE. @item @code{directory-max-size} (default: @code{#f}) Maximum size in bytes of the directory. +@item @code{unused-removal-duration} (default: @code{#f}) +If a cached nar isn't used for @code{unused-removal-duration}, it will +be scheduled for removal. + +@var{unused-removal-duration} must denote a duration: @code{5d} means 5 +days, @code{1m} means 1 month, and so on. + +@item @code{ttl} (default: @code{#f}) +If specified this overrides the @code{ttl} used for narinfos when this +cached compression is available. + +@item @code{new-ttl} (default: @code{#f}) +As with the @code{new-ttl} option for @code{nar-herder-configuration}, +this value will override the @code{ttl} when used for narinfo requests. + @end table @end deftp |