# HG changeset patch
# User Ruslan Ermilov <ru@nginx.com>
# Date 1335265773 0
# Node ID 5e332fafd228a4b065c2ec3daff6cc90cf4cfd96
# Parent  d00a4f9b1c5d7a37a92621266eb59b15b0839f68
Documented "cache loader" and its parameters.

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
@@ -207,7 +207,10 @@ will be cached.
     [<literal>levels</literal>=<value>levels</value>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
-    [<literal>max_size</literal>=<value>size</value>]</syntax>
+    [<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>
 <default/>
 <context>http</context>
 
@@ -254,6 +257,19 @@ by the <literal>max_size</literal> param
 when this size is exceeded it removes the least recently used data.
 </para>
 
+<para>
+A minute after the start the special process “cache loader” is activated
+that loads information about previously cached data stored on file system
+into a cache zone.
+A load is 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
+<literal>loader_threshold</literal> parameter (by default, 200 milliseconds).
+A pause is made between iterations, configured by the
+<literal>loader_sleep</literal> parameter (by default, 50 milliseconds).
+</para>
+
 </directive>
 
 
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
@@ -248,7 +248,10 @@ will be cached.
     [<literal>levels</literal>=<value>levels</value>]
     <literal>keys_zone</literal>=<value>name</value>:<value>size</value>
     [<literal>inactive</literal>=<value>time</value>]
-    [<literal>max_size</literal>=<value>size</value>]</syntax>
+    [<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>
 <default/>
 <context>http</context>
 
@@ -295,6 +298,19 @@ by the <literal>max_size</literal> param
 when this size is exceeded it removes the least recently used data.
 </para>
 
+<para>
+A minute after the start the special process “cache loader” is activated
+that loads information about previously cached data stored on file system
+into a cache zone.
+A load is 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
+<literal>loader_threshold</literal> parameter (by default, 200 milliseconds).
+A pause is made between iterations, configured by the
+<literal>loader_sleep</literal> parameter (by default, 50 milliseconds).
+</para>
+
 </directive>
 
 
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
@@ -205,7 +205,10 @@ fastcgi_cache_key localhost:9000$request
     [<literal>levels</literal>=<value>уровни</value>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
-    [<literal>max_size</literal>=<value>размер</value>]</syntax>
+    [<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>
 <default/>
 <context>http</context>
 
@@ -252,6 +255,19 @@ fastcgi_cache_path /data/nginx/cache lev
 его размеров удаляет наименее востребованные данные.
 </para>
 
+<para>
+Через минуту после старта активируется специальный процесс “cache loader”,
+который загружает в зону кэша информацию о ранее закэшированных данных,
+хранящихся на файловой системе.
+Загрузка происходит итерациями.
+За одну итерацию загружается не более <literal>loader_files</literal>
+элементов (по умолчанию 100).
+Кроме того, время работы одной итерации ограничено параметром
+<literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
+</para>
+
 </directive>
 
 
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
@@ -246,7 +246,10 @@ proxy_cache_key $scheme$proxy_host$uri$i
     [<literal>levels</literal>=<value>уровни</value>]
     <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
     [<literal>inactive</literal>=<value>время</value>]
-    [<literal>max_size</literal>=<value>размер</value>]</syntax>
+    [<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>
 <default/>
 <context>http</context>
 
@@ -293,6 +296,19 @@ proxy_cache_path /data/nginx/cache level
 его размеров удаляет наименее востребованные данные.
 </para>
 
+<para>
+Через минуту после старта активируется специальный процесс “cache loader”,
+который загружает в зону кэша информацию о ранее закэшированных данных,
+хранящихся на файловой системе.
+Загрузка происходит итерациями.
+За одну итерацию загружается не более <literal>loader_files</literal>
+элементов (по умолчанию 100).
+Кроме того, время работы одной итерации ограничено параметром
+<literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
+Между итерациями делается пауза на время, заданное параметром
+<literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
+</para>
+
 </directive>