Mercurial > hg > nginx-site

changeset 826:ddd22f571529

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Variables $pipe, $request_length, $time_iso8601, and $time_local.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 01 Feb 2013 17:34:08 +0400
parents ae15915990ad
children 0753cec83ac4
files xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/ngx_http_log_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_log_module.xml
diffstat 4 files changed, 100 insertions(+), 56 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml	Wed Jan 30 19:52:12 2013 +0400
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Fri Feb 01 17:34:08 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_core_module"
         link="/en/docs/http/ngx_http_core_module.html"
         lang="en"
-        rev="14">
+        rev="15">
 
 <section id="directives" name="Directives">
 
@@ -2804,6 +2804,12 @@
 PID of the worker process
 </tag-desc>
 
+<tag-name id="var_pipe"><var>$pipe</var></tag-name>
+<tag-desc>
+“<literal>p</literal>” if request was pipelined, “<literal>.</literal>”
+otherwise (1.3.12)
+</tag-desc>
+
 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
 <tag-desc>
 same as <var>$args</var>
@@ -2882,6 +2888,11 @@
 directives, and the request URI
 </tag-desc>
 
+<tag-name id="var_request_length"><var>$request_length</var></tag-name>
+<tag-desc>
+request length (including request line, header, and request body) (1.3.12)
+</tag-desc>
+
 <tag-name id="var_request_method"><var>$request_method</var></tag-name>
 <tag-desc>
 request method, usually
@@ -2956,6 +2967,16 @@
 that support the <c-def>TCP_INFO</c-def> socket option
 </tag-desc>
 
+<tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
+<tag-desc>
+local time in the ISO 8601 standard format (1.3.12)
+</tag-desc>
+
+<tag-name id="var_time_local"><var>$time_local</var></tag-name>
+<tag-desc>
+local time in the Common Log Format (1.3.12)
+</tag-desc>
+
 <tag-name id="var_uri"><var>$uri</var></tag-name>
 <tag-desc>
 current URI in request, <link id="location">normalized</link>
--- a/xml/en/docs/http/ngx_http_log_module.xml	Wed Jan 30 19:52:12 2013 +0400
+++ b/xml/en/docs/http/ngx_http_log_module.xml	Fri Feb 01 17:34:08 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_log_module"
         link="/en/docs/http/ngx_http_log_module.html"
         lang="en"
-        rev="7">
+        rev="8">
 
 <section id="summary">
 
@@ -195,38 +195,21 @@
 <tag-name><var>$bytes_sent</var></tag-name>
 <tag-desc>
 the number of bytes sent to a client
-<note>
-Since versions 1.3.8 and 1.2.5 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_bytes_sent">same name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$connection</var></tag-name>
 <tag-desc>
 connection serial number
-<note>
-Since versions 1.3.8 and 1.2.5 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_connection">same name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$connection_requests</var></tag-name>
 <tag-desc>
 the current number of requests made through a connection (1.1.18)
-<note>
-Since versions 1.3.8 and 1.2.5 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_connection_requests">same
-name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$msec</var></tag-name>
 <tag-desc>
 time in seconds with a milliseconds resolution at the time of log write
-<note>
-Since versions 1.3.9 and 1.2.6 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_msec">same name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$pipe</var></tag-name>
@@ -245,19 +228,11 @@
 request processing time in seconds with a milliseconds resolution;
 time elapsed between the first bytes were read from the client and
 the log write after the last bytes were sent to the client
-<note>
-Since versions 1.3.9 and 1.2.6 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_request_time">same name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$status</var></tag-name>
 <tag-desc>
 response status
-<note>
-Since versions 1.3.2 and 1.2.2 there is a common variable with the
-<link doc="ngx_http_core_module.xml" id="var_status">same name</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$time_iso8601</var></tag-name>
@@ -271,6 +246,33 @@
 </tag-desc>
 
 </list>
+
+<note>
+In modern versions of nginx variables
+<link doc="ngx_http_core_module.xml" id="var_status">$status</link>
+(1.3.2, 1.2.2),
+<link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_connection">$connection</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_connection_requests">$connection_requests</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_msec">$msec</link>
+(1.3.9, 1.2.6),
+<link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
+(1.3.9, 1.2.6),
+<link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
+(1.3.12),
+<link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
+(1.3.12),
+<link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
+(1.3.12),
+and
+<link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
+(1.3.12)
+are also available as common variables.
+</note>
+
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Wed Jan 30 19:52:12 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Fri Feb 01 17:34:08 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_core_module"
         link="/ru/docs/http/ngx_http_core_module.html"
         lang="ru"
-        rev="14">
+        rev="15">
 
 <section id="directives" name="Директивы">
 
@@ -2791,6 +2791,12 @@
 номер (PID) рабочего процесса
 </tag-desc>
 
+<tag-name id="var_pipe"><var>$pipe</var></tag-name>
+<tag-desc>
+“<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
+(1.3.12)
+</tag-desc>
+
 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
 <tag-desc>
 то же, что и <var>$args</var>
@@ -2867,6 +2873,11 @@
 <link id="root"/> или <link id="alias"/> и URI запроса
 </tag-desc>
 
+<tag-name id="var_request_length"><var>$request_length</var></tag-name>
+<tag-desc>
+длина запроса (включая строку запроса, заголовок и тело запроса) (1.3.12)
+</tag-desc>
+
 <tag-name id="var_request_method"><var>$request_method</var></tag-name>
 <tag-desc>
 метод запроса, обычно
@@ -2930,6 +2941,16 @@
 статус ответа (1.3.2, 1.2.2)
 </tag-desc>
 
+<tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
+<tag-desc>
+локальное время в формате по стандарту ISO 8601 (1.3.12)
+</tag-desc>
+
+<tag-name id="var_time_local"><var>$time_local</var></tag-name>
+<tag-desc>
+локальное время в Common Log Format (1.3.12)
+</tag-desc>
+
 <tag-name id="var_tcpinfo_">
 <var>$tcpinfo_rtt</var>,
 <var>$tcpinfo_rttvar</var>,
--- a/xml/ru/docs/http/ngx_http_log_module.xml	Wed Jan 30 19:52:12 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_log_module.xml	Fri Feb 01 17:34:08 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_log_module"
         link="/ru/docs/http/ngx_http_log_module.html"
         lang="ru"
-        rev="7">
+        rev="8">
 
 <section id="summary">
 
@@ -193,40 +193,21 @@
 <tag-name><var>$bytes_sent</var></tag-name>
 <tag-desc>
 число байт, переданное клиенту
-<note>
-Начиная с версий 1.3.8 и 1.2.5 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_bytes_sent">тем же
-именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$connection</var></tag-name>
 <tag-desc>
 порядковый номер соединения
-<note>
-Начиная с версий 1.3.8 и 1.2.5 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_connection">тем же
-именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$connection_requests</var></tag-name>
 <tag-desc>
 текущее число запросов в соединении (1.1.18)
-<note>
-Начиная с версий 1.3.8 и 1.2.5 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_connection_requests">тем же
-именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$msec</var></tag-name>
 <tag-desc>
 время в секундах с точностью до миллисекунд на момент записи в лог
-<note>
-Начиная с версий 1.3.9 и 1.2.6 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_msec">тем же именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$pipe</var></tag-name>
@@ -244,19 +225,11 @@
 время обработки запроса в секундах с точностью до миллисекунд;
 время, прошедшее с момента чтения первых байт от клиента до
 момента записи в лог после отправки последних байт клиенту
-<note>
-Начиная с версий 1.3.9 и 1.2.6 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_request_time">тем же именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$status</var></tag-name>
 <tag-desc>
 статус ответа
-<note>
-Начиная с версий 1.3.2 и 1.2.2 существует общая переменная с
-<link doc="ngx_http_core_module.xml" id="var_status">тем же именем</link>.
-</note>
 </tag-desc>
 
 <tag-name><var>$time_iso8601</var></tag-name>
@@ -270,6 +243,33 @@
 </tag-desc>
 
 </list>
+
+<note>
+В современных версиях nginx переменные
+<link doc="ngx_http_core_module.xml" id="var_status">$status</link>
+(1.3.2, 1.2.2),
+<link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_connection">$connection</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_connection_requests">$connection_requests</link>
+(1.3.8, 1.2.5),
+<link doc="ngx_http_core_module.xml" id="var_msec">$msec</link>
+(1.3.9, 1.2.6),
+<link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
+(1.3.9, 1.2.6),
+<link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
+(1.3.12),
+<link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
+(1.3.12),
+<link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
+(1.3.12)
+и
+<link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
+(1.3.12)
+также доступны как общие переменные.
+</note>
+
 </para>
 
 <para>