changeset 302:df728215db07

Documented "proxy_cache_lock", "proxy_cache_lock_timeout", "fastcgi_cache_lock", and "fastcgi_cache_lock_timeout".
author Ruslan Ermilov <ru@nginx.com>
date Thu, 29 Dec 2011 15:36:38 +0000
parents ced6daa61e83
children 1c239146beb4
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml
diffstat 4 files changed, 136 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Thu Dec 29 09:10:56 2011 +0000
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Thu Dec 29 15:36:38 2011 +0000
@@ -130,6 +130,40 @@
 </directive>
 
 
+<directive name="fastcgi_cache_lock">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+When enabled, only one request at a time will be allowed to populate
+a new cache element identified according to the <link id="fastcgi_cache_key"/>
+directive by passing a request to a FastCGI server.
+Other requests of the same cache element will either wait
+for a response to appear in the cache, or the cache lock for
+this element to be released, up to the time set by the
+<link id="fastcgi_cache_lock_timeout"/> directive.
+</para>
+
+</directive>
+
+
+<directive name="fastcgi_cache_lock_timeout">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Sets a timeout for <link id="fastcgi_cache_lock"/>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_min_uses">
 <syntax><value>number</value></syntax>
 <default>1</default>
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Thu Dec 29 09:10:56 2011 +0000
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Thu Dec 29 15:36:38 2011 +0000
@@ -158,6 +158,40 @@
 </directive>
 
 
+<directive name="proxy_cache_lock">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+When enabled, only one request at a time will be allowed to populate
+a new cache element identified according to the <link id="proxy_cache_key"/>
+directive by passing a request to a proxied server.
+Other requests of the same cache element will either wait
+for a response to appear in the cache, or the cache lock for
+this element to be released, up to the time set by the
+<link id="proxy_cache_lock_timeout"/> directive.
+</para>
+
+</directive>
+
+
+<directive name="proxy_cache_lock_timeout">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Sets a timeout for <link id="proxy_cache_lock"/>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_min_uses">
 <syntax><value>number</value></syntax>
 <default>1</default>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Thu Dec 29 09:10:56 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Thu Dec 29 15:36:38 2011 +0000
@@ -129,6 +129,40 @@
 </directive>
 
 
+<directive name="fastcgi_cache_lock">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если включено, одновременно только одному запросу будет позволено
+заполнить новый элемент кэша, идентифицируемый согласно директиве
+<link id="fastcgi_cache_key"/>, передав запрос на FastCGI-сервер.
+Остальные запросы этого же элемента будут либо ожидать
+появления ответа в кэше, либо освобождения блокировки
+этого элемента, в течение времени, заданного директивой
+<link id="fastcgi_cache_lock_timeout"/>.
+</para>
+
+</directive>
+
+
+<directive name="fastcgi_cache_lock_timeout">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Задаёт таймаут для <link id="fastcgi_cache_lock"/>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_min_uses">
 <syntax><value>число</value></syntax>
 <default>1</default>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Thu Dec 29 09:10:56 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Thu Dec 29 15:36:38 2011 +0000
@@ -157,6 +157,40 @@
 </directive>
 
 
+<directive name="proxy_cache_lock">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Если включено, одновременно только одному запросу будет позволено
+заполнить новый элемент кэша, идентифицируемый согласно директиве
+<link id="proxy_cache_key"/>, передав запрос на проксируемый сервер.
+Остальные запросы этого же элемента будут либо ожидать
+появления ответа в кэше, либо освобождения блокировки
+этого элемента, в течение времени, заданного директивой
+<link id="proxy_cache_lock_timeout"/>.
+</para>
+
+</directive>
+
+
+<directive name="proxy_cache_lock_timeout">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Задаёт таймаут для <link id="proxy_cache_lock"/>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_min_uses">
 <syntax><value>число</value></syntax>
 <default>1</default>