changeset 1582:8973c7b37854

Updated commercial docs. details: http://hg.nginx.com/nginx.org-se/rev/23bf3610377f branches: se changeset: 1814:23bf3610377f user: Yaroslav Zhuravlev <yar@nginx.com> description: Added purge parameters to proxy_cache_path and friends. diffstat: xml/en/docs/http/ngx_http_fastcgi_module.xml | 60 +++++++++++++++++++++++++++- xml/en/docs/http/ngx_http_proxy_module.xml | 60 +++++++++++++++++++++++++++- xml/en/docs/http/ngx_http_scgi_module.xml | 60 +++++++++++++++++++++++++++- xml/en/docs/http/ngx_http_uwsgi_module.xml | 60 +++++++++++++++++++++++++++- xml/ru/docs/http/ngx_http_fastcgi_module.xml | 60 +++++++++++++++++++++++++++- xml/ru/docs/http/ngx_http_proxy_module.xml | 60 +++++++++++++++++++++++++++- xml/ru/docs/http/ngx_http_scgi_module.xml | 60 +++++++++++++++++++++++++++- xml/ru/docs/http/ngx_http_uwsgi_module.xml | 60 +++++++++++++++++++++++++++- 8 files changed, 472 insertions(+), 8 deletions(-) diffs (truncated from 672 to 500 lines):
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 30 Sep 2015 18:48:54 +0300
parents 201bf8fa69e5
children cb7fbecee8e6
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, 472 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -329,7 +329,11 @@ will be cached.
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -402,6 +406,56 @@ Between iterations, a pause configured b
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="fastcgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -427,6 +481,10 @@ the <http-status code="204" text="No Con
 If the <link id="fastcgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="fastcgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -327,7 +327,11 @@ will be cached.
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -400,6 +404,56 @@ Between iterations, a pause configured b
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="proxy_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -425,6 +479,10 @@ the <http-status code="204" text="No Con
 If the <link id="proxy_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="proxy_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_scgi_module.xml
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml
@@ -320,7 +320,11 @@ will be cached.
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -393,6 +397,56 @@ Between iterations, a pause configured b
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="scgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -418,6 +472,10 @@ the <http-status code="204" text="No Con
 If the <link id="scgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="scgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml
@@ -320,7 +320,11 @@ will be cached.
     [<literal>max_size</literal>=<value>size</value>]
     [<literal>loader_files</literal>=<value>number</value>]
     [<literal>loader_sleep</literal>=<value>time</value>]
-    [<literal>loader_threshold</literal>=<value>time</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>time</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>number</value>]
+    [<literal>purger_sleep</literal>=<value>time</value>]
+    [<literal>purger_threshold</literal>=<value>time</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -393,6 +397,56 @@ Between iterations, a pause configured b
 parameter (by default, 50 milliseconds) is made.
 </para>
 
+<para>
+Additionally,
+the following parameters are available as part of our
+<commercial_version>commercial subscription</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Instructs whether cache entries that match a
+<link id="uwsgi_cache_purge">wildcard key</link>
+will be removed from the disk by the cache purger (1.7.12).
+Setting the parameter to <literal>on</literal>
+(default is <literal>off</literal>)
+will activate the “cache purger” process that
+permanently iterates through all cache entries
+and deletes the entries that match the wildcard key.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the number of items that will be scanned during one iteration (1.7.12).
+By default, <literal>purger_files</literal> is set to 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets the duration of one iteration (1.7.12).
+By default, <literal>purger_threshold</literal> is set to 50 milliseconds.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>number</value>
+</tag-name>
+<tag-desc>
+Sets a pause between iterations (1.7.12).
+By default, <literal>purger_sleep</literal> is set to 50 milliseconds.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -418,6 +472,10 @@ the <http-status code="204" text="No Con
 If the <link id="uwsgi_cache_key">cache key</link> of a purge request ends
 with an asterisk (“<literal>*</literal>”), all cache entries matching the
 wildcard key will be removed from the cache.
+However, these entries will remain on the disk until they are deleted
+for either <link id="uwsgi_cache_path">inactivity</link>,
+or processed by the <link id="purger">cache purger</link> (1.7.12),
+or a client attempts to access them.
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -328,7 +328,11 @@ fastcgi_cache_key localhost:9000$request
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -399,6 +403,56 @@ fastcgi_cache_path /data/nginx/cache lev
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="fastcgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -425,6 +479,10 @@ fastcgi_cache_path /data/nginx/cache lev
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="fastcgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -326,7 +326,11 @@ proxy_cache_key $scheme$proxy_host$uri$i
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -397,6 +401,56 @@ proxy_cache_path /data/nginx/cache level
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="proxy_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -423,6 +477,10 @@ proxy_cache_path /data/nginx/cache level
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="proxy_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml
@@ -319,7 +319,11 @@ scgi_cache_key localhost:9000$request_ur
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -390,6 +394,56 @@ scgi_cache_path /data/nginx/cache levels
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="scgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -416,6 +470,10 @@ scgi_cache_path /data/nginx/cache levels
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="scgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
@@ -318,7 +318,11 @@ uwsgi_cache_key localhost:9000$request_u
     [<literal>max_size</literal>=<value>размер</value>]
     [<literal>loader_files</literal>=<value>число</value>]
     [<literal>loader_sleep</literal>=<value>время</value>]
-    [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
+    [<literal>loader_threshold</literal>=<value>время</value>]
+    [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>purger_files</literal>=<value>число</value>]
+    [<literal>purger_sleep</literal>=<value>время</value>]
+    [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
 <default/>
 <context>http</context>
 
@@ -389,6 +393,56 @@ uwsgi_cache_path /data/nginx/cache level
 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
 </para>
 
+<para>
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
+</para>
+
+<para>
+<list type="tag">
+
+<tag-name id="purger">
+<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
+</tag-name>
+<tag-desc>
+Указывает, будут ли записи в кэше, соответствующие
+<link id="uwsgi_cache_purge">маске</link>,
+удалены с диска при помощи процесса “cache purger” (1.7.12).
+Установка параметра в значение <value>on</value>
+(по умолчанию <value>off</value>)
+активирует процесс “cache purger”, который
+проходит по всем записям в кэше
+и удаляет записи, соответствующие этой маске.
+</tag-desc>
+
+<tag-name id="purger_files">
+<literal>purger_files</literal>=<value>число</value>
+</tag-name>
+<tag-desc>
+Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
+По умолчанию <literal>purger_files</literal> равен 10.
+</tag-desc>
+
+<tag-name id="purger_threshold">
+<literal>purger_threshold</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт продолжительность одной итерации (1.7.12).
+По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
+</tag-desc>
+
+<tag-name id="purger_sleep">
+<literal>purger_sleep</literal>=<value>время</value>
+</tag-name>
+<tag-desc>
+Задаёт паузу между итерациями (1.7.12).
+По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
+</tag-desc>
+
+</list>
+</para>
+
 </directive>
 
 
@@ -415,6 +469,10 @@ uwsgi_cache_path /data/nginx/cache level
 запроса на очистку заканчивается
 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
 этой маске, будут удалены из кэша.
+Тем не менее, эти записи будут оставаться на диске или до момента удаления
+из-за <link id="uwsgi_cache_path">отсутствия обращения к данным</link>,
+или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
+или до попытки клиента получить к ним доступ.
 </para>
 
 <para>