changeset 1379:91f5c089f4ca

Documented fastcgi_cache_lock_age and look-alikes.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 19 Dec 2014 12:26:10 +0300
parents 6bfd39dc48c5
children 5018270f6703
files xml/en/docs/http/ngx_http_fastcgi_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_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml
diffstat 6 files changed, 150 insertions(+), 6 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
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="24">
+        rev="25">
 
 <section id="summary">
 
@@ -241,6 +241,24 @@ this element to be released, up to the t
 </directive>
 
 
+<directive name="fastcgi_cache_lock_age">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+If the last request passed to the FastCGI server
+for populating a new cache element
+has not completed for the specified <value>time</value>,
+one more request may be passed to the FastCGI server.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_lock_timeout">
 <syntax><value>time</value></syntax>
 <default>5s</default>
@@ -251,6 +269,12 @@ this element to be released, up to the t
 
 <para>
 Sets a timeout for <link id="fastcgi_cache_lock"/>.
+When the <value>time</value> expires,
+the request will be passed to the FastCGI server,
+however, the response will not be cached.
+<note>
+Before 1.7.8, the response could be cached.
+</note>
 </para>
 
 </directive>
--- 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="12">
+        rev="13">
 
 <section id="summary">
 
@@ -233,6 +233,24 @@ this element to be released, up to the t
 </directive>
 
 
+<directive name="scgi_cache_lock_age">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+If the last request passed to the SCGI server
+for populating a new cache element
+has not completed for the specified <value>time</value>,
+one more request may be passed to the SCGI server.
+</para>
+
+</directive>
+
+
 <directive name="scgi_cache_lock_timeout">
 <syntax><value>time</value></syntax>
 <default>5s</default>
@@ -243,6 +261,12 @@ this element to be released, up to the t
 
 <para>
 Sets a timeout for <link id="scgi_cache_lock"/>.
+When the <value>time</value> expires,
+the request will be passed to the SCGI server,
+however, the response will not be cached.
+<note>
+Before 1.7.8, the response could be cached.
+</note>
 </para>
 
 </directive>
--- 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="14">
+        rev="15">
 
 <section id="summary">
 
@@ -233,6 +233,24 @@ this element to be released, up to the t
 </directive>
 
 
+<directive name="uwsgi_cache_lock_age">
+<syntax><value>time</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+If the last request passed to the uwsgi server
+for populating a new cache element
+has not completed for the specified <value>time</value>,
+one more request may be passed to the uwsgi server.
+</para>
+
+</directive>
+
+
 <directive name="uwsgi_cache_lock_timeout">
 <syntax><value>time</value></syntax>
 <default>5s</default>
@@ -243,6 +261,12 @@ this element to be released, up to the t
 
 <para>
 Sets a timeout for <link id="uwsgi_cache_lock"/>.
+When the <value>time</value> expires,
+the request will be passed to the uwsgi server,
+however, the response will not be cached.
+<note>
+Before 1.7.8, the response could be cached.
+</note>
 </para>
 
 </directive>
--- 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="24">
+        rev="25">
 
 <section id="summary">
 
@@ -240,6 +240,24 @@ fastcgi_cache_key localhost:9000$request
 </directive>
 
 
+<directive name="fastcgi_cache_lock_age">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+Если последний запрос, переданный на FastCGI-сервер
+для заполнения нового элемента кэша,
+не завершился за указанное <value>время</value>,
+на FastCGI-сервер может быть передан ещё один запрос.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_lock_timeout">
 <syntax><value>время</value></syntax>
 <default>5s</default>
@@ -250,6 +268,12 @@ fastcgi_cache_key localhost:9000$request
 
 <para>
 Задаёт таймаут для <link id="fastcgi_cache_lock"/>.
+По истечении указанного <value>времени</value>
+запрос будет передан на FastCGI-сервер,
+однако ответ не будет закэширован.
+<note>
+До версии 1.7.8 такой ответ мог быть закэширован.
+</note>
 </para>
 
 </directive>
--- 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="12">
+        rev="13">
 
 <section id="summary">
 
@@ -232,6 +232,24 @@ scgi_cache_key localhost:9000$request_ur
 </directive>
 
 
+<directive name="scgi_cache_lock_age">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+Если последний запрос, переданный на SCGI-сервер
+для заполнения нового элемента кэша,
+не завершился за указанное <value>время</value>,
+на SCGI-сервер может быть передан ещё один запрос.
+</para>
+
+</directive>
+
+
 <directive name="scgi_cache_lock_timeout">
 <syntax><value>время</value></syntax>
 <default>5s</default>
@@ -242,6 +260,12 @@ scgi_cache_key localhost:9000$request_ur
 
 <para>
 Задаёт таймаут для <link id="scgi_cache_lock"/>.
+По истечении указанного <value>времени</value>
+запрос будет передан на SCGI-сервер,
+однако ответ не будет закэширован.
+<note>
+До версии 1.7.8 такой ответ мог быть закэширован.
+</note>
 </para>
 
 </directive>
--- 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="14">
+        rev="15">
 
 <section id="summary">
 
@@ -232,6 +232,24 @@ uwsgi_cache_key localhost:9000$request_u
 </directive>
 
 
+<directive name="uwsgi_cache_lock_age">
+<syntax><value>время</value></syntax>
+<default>5s</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.7.8</appeared-in>
+
+<para>
+Если последний запрос, переданный на uwsgi-сервер
+для заполнения нового элемента кэша,
+не завершился за указанное <value>время</value>,
+на uwsgi-сервер может быть передан ещё один запрос.
+</para>
+
+</directive>
+
+
 <directive name="uwsgi_cache_lock_timeout">
 <syntax><value>время</value></syntax>
 <default>5s</default>
@@ -242,6 +260,12 @@ uwsgi_cache_key localhost:9000$request_u
 
 <para>
 Задаёт таймаут для <link id="uwsgi_cache_lock"/>.
+По истечении указанного <value>времени</value>
+запрос будет передан на uwsgi-сервер,
+однако ответ не будет закэширован.
+<note>
+До версии 1.7.8 такой ответ мог быть закэширован.
+</note>
 </para>
 
 </directive>