changeset 1810:bc6341aaa832

Added cache manager parameters to proxy_cache path and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 07 Oct 2016 20:35:11 +0300
parents 2245f2827e2f
children 50da04ed139b
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_scgi_module.xml xml/en/docs/http/ngx_http_uwsgi_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml
diffstat 8 files changed, 120 insertions(+), 16 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="37">
+        rev="38">
 
 <section id="summary">
 
@@ -342,6 +342,9 @@
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</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>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
     [<literal>loader_threshold</literal>=<value>time</value>]
@@ -407,13 +410,23 @@
 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.
+The data is removed in iterations configured by
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal>, and
+<literal>manager_sleep</literal> parameters (1.11.5).
+During one iteration no more than <literal>manager_files</literal> items
+are deleted ( by default, 100).
+The duration of one iteration is limited by the
+<literal>manager_threshold</literal> parameter (by default, 200 milliseconds).
+Between iterations, a pause configured by the <literal>manager_sleep</literal>
+parameter (by default, 50 milliseconds) is made.
 </para>
 
 <para>
 A minute after the start the special “cache loader” process is activated.
 It loads information about previously cached data stored on file system
 into a cache zone.
-The loading is done in iterations.
+The loading is also done in iterations.
 During one iteration no more than <literal>loader_files</literal> items
 are loaded (by default, 100).
 Besides, the duration of one iteration is limited by the
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="50">
+        rev="51">
 
 <section id="summary">
 
@@ -358,6 +358,9 @@
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</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>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
     [<literal>loader_threshold</literal>=<value>time</value>]
@@ -423,13 +426,23 @@
 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.
+The data is removed in iterations configured by
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal>, and
+<literal>manager_sleep</literal> parameters (1.11.5).
+During one iteration no more than <literal>manager_files</literal> items
+are deleted ( by default, 100).
+The duration of one iteration is limited by the
+<literal>manager_threshold</literal> parameter (by default, 200 milliseconds).
+Between iterations, a pause configured by the <literal>manager_sleep</literal>
+parameter (by default, 50 milliseconds) is made.
 </para>
 
 <para>
 A minute after the start the special “cache loader” process is activated.
 It loads information about previously cached data stored on file system
 into a cache zone.
-The loading is done in iterations.
+The loading is also done in iterations.
 During one iteration no more than <literal>loader_files</literal> items
 are loaded (by default, 100).
 Besides, the duration of one iteration is limited by the
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -333,6 +333,9 @@
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</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>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
     [<literal>loader_threshold</literal>=<value>time</value>]
@@ -398,13 +401,23 @@
 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.
+The data is removed in iterations configured by
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal>, and
+<literal>manager_sleep</literal> parameters (1.11.5).
+During one iteration no more than <literal>manager_files</literal> items
+are deleted ( by default, 100).
+The duration of one iteration is limited by the
+<literal>manager_threshold</literal> parameter (by default, 200 milliseconds).
+Between iterations, a pause configured by the <literal>manager_sleep</literal>
+parameter (by default, 50 milliseconds) is made.
 </para>
 
 <para>
 A minute after the start the special “cache loader” process is activated.
 It loads information about previously cached data stored on file system
 into a cache zone.
-The loading is done in iterations.
+The loading is also done in iterations.
 During one iteration no more than <literal>loader_files</literal> items
 are loaded (by default, 100).
 Besides, the duration of one iteration is limited by the
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="29">
+        rev="30">
 
 <section id="summary">
 
@@ -333,6 +333,9 @@
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
     [<literal>max_size</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>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
     [<literal>loader_threshold</literal>=<value>time</value>]
@@ -398,13 +401,23 @@
 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.
+The data is removed in iterations configured by
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal>, and
+<literal>manager_sleep</literal> parameters (1.11.5).
+During one iteration no more than <literal>manager_files</literal> items
+are deleted ( by default, 100).
+The duration of one iteration is limited by the
+<literal>manager_threshold</literal> parameter (by default, 200 milliseconds).
+Between iterations, a pause configured by the <literal>manager_sleep</literal>
+parameter (by default, 50 milliseconds) is made.
 </para>
 
 <para>
 A minute after the start the special “cache loader” process is activated.
 It loads information about previously cached data stored on file system
 into a cache zone.
-The loading is done in iterations.
+The loading is also done in iterations.
 During one iteration no more than <literal>loader_files</literal> items
 are loaded (by default, 100).
 Besides, the duration of one iteration is limited by the
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="37">
+        rev="38">
 
 <section id="summary">
 
@@ -341,6 +341,9 @@
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>manager_files</literal>=<value>число</value>]
+    [<literal>manager_sleep</literal>=<value>время</value>]
+    [<literal>manager_threshold</literal>=<value>время</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
     [<literal>loader_threshold</literal>=<value>время</value>]
@@ -404,13 +407,23 @@
 Специальный процесс “cache manager” следит за максимальным размером кэша,
 заданным параметром <literal>max_size</literal>, и при превышении
 его размеров удаляет наименее востребованные данные.
+Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal> и
+<literal>manager_sleep</literal>.
+За одну итерацию загружается не более <literal>manager_files</literal>
+элементов (по умолчанию 100).
+Время работы одной итерации ограничено параметром
+<literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
 <para>
 Через минуту после старта активируется специальный процесс “cache loader”,
 который загружает в зону кэша информацию о ранее закэшированных данных,
 хранящихся на файловой системе.
-Загрузка происходит итерациями.
+Загрузка также происходит итерациями.
 За одну итерацию загружается не более <literal>loader_files</literal>
 элементов (по умолчанию 100).
 Кроме того, время работы одной итерации ограничено параметром
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="50">
+        rev="51">
 
 <section id="summary">
 
@@ -358,6 +358,9 @@
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>manager_files</literal>=<value>число</value>]
+    [<literal>manager_sleep</literal>=<value>время</value>]
+    [<literal>manager_threshold</literal>=<value>время</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
     [<literal>loader_threshold</literal>=<value>время</value>]
@@ -421,13 +424,23 @@
 Специальный процесс “cache manager” следит за максимальным размером кэша,
 заданным параметром <literal>max_size</literal>, и при превышении
 его размеров удаляет наименее востребованные данные.
+Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal> и
+<literal>manager_sleep</literal>.
+За одну итерацию загружается не более <literal>manager_files</literal>
+элементов (по умолчанию 100).
+Время работы одной итерации ограничено параметром
+<literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
 <para>
 Через минуту после старта активируется специальный процесс “cache loader”,
 который загружает в зону кэша информацию о ранее закэшированных данных,
 хранящихся на файловой системе.
-Загрузка происходит итерациями.
+Загрузка также происходит итерациями.
 За одну итерацию загружается не более <literal>loader_files</literal>
 элементов (по умолчанию 100).
 Кроме того, время работы одной итерации ограничено параметром
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -332,6 +332,9 @@
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>manager_files</literal>=<value>число</value>]
+    [<literal>manager_sleep</literal>=<value>время</value>]
+    [<literal>manager_threshold</literal>=<value>время</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
     [<literal>loader_threshold</literal>=<value>время</value>]
@@ -395,13 +398,23 @@
 Специальный процесс “cache manager” следит за максимальным размером кэша,
 заданным параметром <literal>max_size</literal>, и при превышении
 его размеров удаляет наименее востребованные данные.
+Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal> и
+<literal>manager_sleep</literal>.
+За одну итерацию загружается не более <literal>manager_files</literal>
+элементов (по умолчанию 100).
+Время работы одной итерации ограничено параметром
+<literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
 <para>
 Через минуту после старта активируется специальный процесс “cache loader”,
 который загружает в зону кэша информацию о ранее закэшированных данных,
 хранящихся на файловой системе.
-Загрузка происходит итерациями.
+Загрузка также происходит итерациями.
 За одну итерацию загружается не более <literal>loader_files</literal>
 элементов (по умолчанию 100).
 Кроме того, время работы одной итерации ограничено параметром
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Fri Oct 07 20:31:57 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Fri Oct 07 20:35:11 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="29">
+        rev="30">
 
 <section id="summary">
 
@@ -331,6 +331,9 @@
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
     [<literal>max_size</literal>=<value>размер</value>]
+    [<literal>manager_files</literal>=<value>число</value>]
+    [<literal>manager_sleep</literal>=<value>время</value>]
+    [<literal>manager_threshold</literal>=<value>время</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
     [<literal>loader_threshold</literal>=<value>время</value>]
@@ -394,13 +397,23 @@
 Специальный процесс “cache manager” следит за максимальным размером кэша,
 заданным параметром <literal>max_size</literal>, и при превышении
 его размеров удаляет наименее востребованные данные.
+Удаление данных происходит итерациями, настраиваемыми параметрами (1.11.5)
+<literal>manager_files</literal>,
+<literal>manager_threshold</literal> и
+<literal>manager_sleep</literal>.
+За одну итерацию загружается не более <literal>manager_files</literal>
+элементов (по умолчанию 100).
+Время работы одной итерации ограничено параметром
+<literal>manager_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>manager_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
 <para>
 Через минуту после старта активируется специальный процесс “cache loader”,
 который загружает в зону кэша информацию о ранее закэшированных данных,
 хранящихся на файловой системе.
-Загрузка происходит итерациями.
+Загрузка также происходит итерациями.
 За одну итерацию загружается не более <literal>loader_files</literal>
 элементов (по умолчанию 100).
 Кроме того, время работы одной итерации ограничено параметром