# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1593774262 -3600
# Node ID a5bbfdf88bbda7f62525086ecaf1743aabafb66a
# Parent  82e6029db0c0bcb0436a8bedf5d1ff4f0119c0e4
Documented the "min_free" parameter of proxy_cache_path and friends.

diff --git a/xml/en/docs/http/ngx_http_fastcgi_module.xml b/xml/en/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="51">
+        rev="52">
 
 <section id="summary">
 
@@ -386,6 +386,7 @@ will be cached.
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
+    [<literal>min_free</literal>=<value>size</value>]
     [<literal>manager_files</literal>=<value>number</value>]
     [<literal>manager_sleep</literal>=<value>time</value>]
     [<literal>manager_threshold</literal>=<value>time</value>]
@@ -459,10 +460,14 @@ regardless of their freshness.
 By default, <literal>inactive</literal> is set to 10 minutes.
 </para>
 
-<para>
+<para id="fastcgi_cache_path_max_size">
 The special “cache manager” process monitors the maximum cache size set
-by the <literal>max_size</literal> parameter.
-When this size is exceeded, it removes the least recently used data.
+by the <literal>max_size</literal> parameter,
+and the minimum amount of free space set
+by the <literal>min_free</literal> (1.19.1) parameter
+on the file system with cache.
+When the size is exceeded or there is not enough free space,
+it removes the least recently used data.
 The data is removed in iterations configured by
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal>, and
diff --git a/xml/en/docs/http/ngx_http_proxy_module.xml b/xml/en/docs/http/ngx_http_proxy_module.xml
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="65">
+        rev="66">
 
 <section id="summary">
 
@@ -402,6 +402,7 @@ will be cached.
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
+    [<literal>min_free</literal>=<value>size</value>]
     [<literal>manager_files</literal>=<value>number</value>]
     [<literal>manager_sleep</literal>=<value>time</value>]
     [<literal>manager_threshold</literal>=<value>time</value>]
@@ -475,10 +476,14 @@ regardless of their freshness.
 By default, <literal>inactive</literal> is set to 10 minutes.
 </para>
 
-<para>
+<para id="proxy_cache_path_max_size">
 The special “cache manager” process monitors the maximum cache size set
-by the <literal>max_size</literal> parameter.
-When this size is exceeded, it removes the least recently used data.
+by the <literal>max_size</literal> parameter,
+and the minimum amount of free space set
+by the <literal>min_free</literal> (1.19.1) parameter
+on the file system with cache.
+When the size is exceeded or there is not enough free space,
+it removes the least recently used data.
 The data is removed in iterations configured by
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal>, and
diff --git a/xml/en/docs/http/ngx_http_scgi_module.xml b/xml/en/docs/http/ngx_http_scgi_module.xml
--- a/xml/en/docs/http/ngx_http_scgi_module.xml
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="39">
+        rev="40">
 
 <section id="summary">
 
@@ -377,6 +377,7 @@ will be cached.
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
+    [<literal>min_free</literal>=<value>size</value>]
     [<literal>manager_files</literal>=<value>number</value>]
     [<literal>manager_sleep</literal>=<value>time</value>]
     [<literal>manager_threshold</literal>=<value>time</value>]
@@ -450,10 +451,14 @@ regardless of their freshness.
 By default, <literal>inactive</literal> is set to 10 minutes.
 </para>
 
-<para>
+<para id="scgi_cache_path_max_size">
 The special “cache manager” process monitors the maximum cache size set
-by the <literal>max_size</literal> parameter.
-When this size is exceeded, it removes the least recently used data.
+by the <literal>max_size</literal> parameter,
+and the minimum amount of free space set
+by the <literal>min_free</literal> (1.19.1) parameter
+on the file system with cache.
+When the size is exceeded or there is not enough free space,
+it removes the least recently used data.
 The data is removed in iterations configured by
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal>, and
diff --git a/xml/en/docs/http/ngx_http_uwsgi_module.xml b/xml/en/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="43">
+        rev="44">
 
 <section id="summary">
 
@@ -377,6 +377,7 @@ will be cached.
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</literal>=<value>size</value>]
+    [<literal>min_free</literal>=<value>size</value>]
     [<literal>manager_files</literal>=<value>number</value>]
     [<literal>manager_sleep</literal>=<value>time</value>]
     [<literal>manager_threshold</literal>=<value>time</value>]
@@ -450,10 +451,14 @@ regardless of their freshness.
 By default, <literal>inactive</literal> is set to 10 minutes.
 </para>
 
-<para>
+<para id="uwsgi_cache_path_max_size">
 The special “cache manager” process monitors the maximum cache size set
-by the <literal>max_size</literal> parameter.
-When this size is exceeded, it removes the least recently used data.
+by the <literal>max_size</literal> parameter,
+and the minimum amount of free space set
+by the <literal>min_free</literal> (1.19.1) parameter
+on the file system with cache.
+When the size is exceeded or there is not enough free space,
+it removes the least recently used data.
 The data is removed in iterations configured by
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal>, and
diff --git a/xml/ru/docs/http/ngx_http_fastcgi_module.xml b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="51">
+        rev="52">
 
 <section id="summary">
 
@@ -387,6 +387,7 @@ range-запрос будет передан на FastCGI-сервер
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>min_free</literal>=<value>размер</value>]
     [<literal>manager_files</literal>=<value>число</value>]
     [<literal>manager_sleep</literal>=<value>время</value>]
     [<literal>manager_threshold</literal>=<value>время</value>]
@@ -459,10 +460,14 @@ fastcgi_cache_path /data/nginx/cache lev
 По умолчанию <literal>inactive</literal> равен 10 минутам.
 </para>
 
-<para>
+<para id="fastcgi_cache_path_max_size">
 Специальный процесс “cache manager” следит за максимальным размером кэша,
-заданным параметром <literal>max_size</literal>, и при превышении
-его размеров удаляет наименее востребованные данные.
+заданным параметром <literal>max_size</literal>,
+и также за минимальным объёмом свободного места на файловой системе с кэшем,
+заданным параметром <literal>min_free</literal> (1.19.1).
+При превышении максимального размера кэша
+или недостаточном объёме свободного места
+процесс удаляет наименее востребованные данные.
 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal> и
diff --git a/xml/ru/docs/http/ngx_http_proxy_module.xml b/xml/ru/docs/http/ngx_http_proxy_module.xml
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="65">
+        rev="66">
 
 <section id="summary">
 
@@ -404,6 +404,7 @@ range-запрос будет передан на проксируемый сервер
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>min_free</literal>=<value>размер</value>]
     [<literal>manager_files</literal>=<value>число</value>]
     [<literal>manager_sleep</literal>=<value>время</value>]
     [<literal>manager_threshold</literal>=<value>время</value>]
@@ -476,10 +477,14 @@ proxy_cache_path /data/nginx/cache level
 По умолчанию <literal>inactive</literal> равен 10 минутам.
 </para>
 
-<para>
+<para id="proxy_cache_path_max_size">
 Специальный процесс “cache manager” следит за максимальным размером кэша,
-заданным параметром <literal>max_size</literal>, и при превышении
-его размеров удаляет наименее востребованные данные.
+заданным параметром <literal>max_size</literal>,
+и также за минимальным объёмом свободного места на файловой системе с кэшем,
+заданным параметром <literal>min_free</literal> (1.19.1).
+При превышении максимального размера кэша
+или недостаточном объёме свободного места
+процесс удаляет наименее востребованные данные.
 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal> и
diff --git a/xml/ru/docs/http/ngx_http_scgi_module.xml b/xml/ru/docs/http/ngx_http_scgi_module.xml
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="39">
+        rev="40">
 
 <section id="summary">
 
@@ -378,6 +378,7 @@ range-запрос будет передан на SCGI-сервер
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>min_free</literal>=<value>размер</value>]
     [<literal>manager_files</literal>=<value>число</value>]
     [<literal>manager_sleep</literal>=<value>время</value>]
     [<literal>manager_threshold</literal>=<value>время</value>]
@@ -450,10 +451,14 @@ scgi_cache_path /data/nginx/cache levels
 По умолчанию <literal>inactive</literal> равен 10 минутам.
 </para>
 
-<para>
+<para id="scgi_cache_path_max_size">
 Специальный процесс “cache manager” следит за максимальным размером кэша,
-заданным параметром <literal>max_size</literal>, и при превышении
-его размеров удаляет наименее востребованные данные.
+заданным параметром <literal>max_size</literal>,
+и также за минимальным объёмом свободного места на файловой системе с кэшем,
+заданным параметром <literal>min_free</literal> (1.19.1).
+При превышении максимального размера кэша
+или недостаточном объёме свободного места
+процесс удаляет наименее востребованные данные.
 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal> и
diff --git a/xml/ru/docs/http/ngx_http_uwsgi_module.xml b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="43">
+        rev="44">
 
 <section id="summary">
 
@@ -377,6 +377,7 @@ range-запрос будет передан на uwsgi-сервер
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>min_free</literal>=<value>размер</value>]
     [<literal>manager_files</literal>=<value>число</value>]
     [<literal>manager_sleep</literal>=<value>время</value>]
     [<literal>manager_threshold</literal>=<value>время</value>]
@@ -449,10 +450,14 @@ uwsgi_cache_path /data/nginx/cache level
 По умолчанию <literal>inactive</literal> равен 10 минутам.
 </para>
 
-<para>
+<para id="uwsgi_cache_path_max_size">
 Специальный процесс “cache manager” следит за максимальным размером кэша,
-заданным параметром <literal>max_size</literal>, и при превышении
-его размеров удаляет наименее востребованные данные.
+заданным параметром <literal>max_size</literal>,
+и также за минимальным объёмом свободного места на файловой системе с кэшем,
+заданным параметром <literal>min_free</literal> (1.19.1).
+При превышении максимального размера кэша
+или недостаточном объёме свободного места
+процесс удаляет наименее востребованные данные.
 Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
 <literal>manager_files</literal>,
 <literal>manager_threshold</literal> и