# HG changeset patch # User Ruslan Ermilov # Date 1523374774 -10800 # Node ID ca7568f67deeff83215c19142dd04c18f3ac4783 # Parent 10751277a8adda282ec58df6292d1cad68005e37 Sorted directives alphabetically. diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_auth_jwt_module.xml --- a/xml/en/docs/http/ngx_http_auth_jwt_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_auth_jwt_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -124,26 +124,6 @@ - -$variable name ... - -http -1.11.10 - - -Sets the variable to a JOSE header parameter -identified by key names. -Name matching starts from the top level of the JSON tree. -For arrays, the variable keeps a list of array elements separated by commas. - -Prior to version 1.13.7, only one key name could be specified, -and the result was undefined for arrays. - - - - - - $variable name ... @@ -172,21 +152,21 @@ - -time -0s + +$variable name ... + http -server -location -1.13.11 +1.11.10 -Sets the maximum allowable leeway to compensate -clock skew when verifying the -exp -and -nbf -JWT claims. +Sets the variable to a JOSE header parameter +identified by key names. +Name matching starts from the top level of the JSON tree. +For arrays, the variable keeps a list of array elements separated by commas. + +Prior to version 1.13.7, only one key name could be specified, +and the result was undefined for arrays. + @@ -209,6 +189,26 @@ + + +time +0s +http +server +location +1.13.11 + + +Sets the maximum allowable leeway to compensate +clock skew when verifying the +exp +and +nbf +JWT claims. + + + + diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_dav_module.xml --- a/xml/en/docs/http/ngx_http_dav_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_dav_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -64,6 +64,22 @@
+ +on | off +off +http +server +location + + +The WebDAV specification only allows creating files in already +existing directories. +This directive allows creating all needed intermediate directories. + + + + + users:permissions ... user:rw @@ -128,22 +144,6 @@ - -on | off -off -http -server -location - - -The WebDAV specification only allows creating files in already -existing directories. -This directive allows creating all needed intermediate directories. - - - - - number 0 diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_grpc_module.xml --- a/xml/en/docs/http/ngx_http_grpc_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_grpc_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -554,6 +554,26 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +http +server +location + + +Enables the specified protocols for requests to a gRPC SSL server. + + + + + on | off off @@ -589,26 +609,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -http -server -location - - -Enables the specified protocols for requests to a gRPC SSL server. - - - - - file diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_gzip_module.xml --- a/xml/en/docs/http/ngx_http_gzip_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_gzip_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -119,6 +119,20 @@ + +1.0 | 1.1 +1.1 +http +server +location + + +Sets the minimum HTTP version of a request required to compress a response. + + + + + length 20 @@ -135,20 +149,6 @@ - -1.0 | 1.1 -1.1 -http -server -location - - -Sets the minimum HTTP version of a request required to compress a response. - - - - - off | diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_js_module.xml --- a/xml/en/docs/http/ngx_http_js_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_js_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -119,18 +119,6 @@
- -file - -http - - -Specifies a file that implements location and variable handlers in njs. - - - - - function @@ -144,6 +132,18 @@ + +file + +http + + +Specifies a file that implements location and variable handlers in njs. + + + + + $variable function diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_proxy_module.xml --- a/xml/en/docs/http/ngx_http_proxy_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_proxy_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -1963,6 +1963,27 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +http +server +location +1.5.6 + + +Enables the specified protocols for requests to a proxied HTTPS server. + + + + + on | off off @@ -1999,27 +2020,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -http -server -location -1.5.6 - - -Enables the specified protocols for requests to a proxied HTTPS server. - - - - - file diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_session_log_module.xml --- a/xml/en/docs/http/ngx_http_session_log_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_session_log_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -51,6 +51,23 @@
+ +name | off +off +http +server +location + + +Enables the use of the specified session log. +The special value off cancels all +session_log directives inherited from the previous +configuration level. + + + + + name @@ -114,23 +131,6 @@ - - -name | off -off -http -server -location - - -Enables the use of the specified session log. -The special value off cancels all -session_log directives inherited from the previous -configuration level. - - - -
diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/http/ngx_http_v2_module.xml --- a/xml/en/docs/http/ngx_http_v2_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/http/ngx_http_v2_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -79,6 +79,22 @@
+ +size +64k +http +server +1.11.0 + + +Sets the size of the buffer per each request +in which the request body may be saved +before it is started to be processed. + + + + + size 8k @@ -98,22 +114,6 @@ - -size -64k -http -server -1.11.0 - - -Sets the size of the buffer per each request -in which the request body may be saved -before it is started to be processed. - - - - - time 3m diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/ngx_core_module.xml --- a/xml/en/docs/ngx_core_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/ngx_core_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -146,6 +146,68 @@ + +variable[=value] +TZ +main + + +By default, nginx removes all environment variables inherited +from its parent process except the TZ variable. +This directive allows preserving some of the inherited variables, +changing their values, or creating new environment variables. +These variables are then: + + + +inherited during a live upgrade +of an executable file; + + + +used by the +ngx_http_perl_module module; + + + +used by worker processes. +One should bear in mind that controlling system libraries in this way +is not always possible as it is common for libraries to check +variables only during initialization, well before they can be set +using this directive. +An exception from this is an above mentioned +live upgrade +of an executable file. + + + + + + +The TZ variable is always inherited and available to the +ngx_http_perl_module +module, unless it is configured explicitly. + + + +Usage example: + +env MALLOC_OPTIONS; +env PERL5LIB=/data/site/modules; +env OPENSSL_ALLOW_PROXY_CERTS=1; + + + + + +The NGINX environment variable is used internally by nginx +and should not be set directly by the user. + + + + + + file [level] logs/error.log error @@ -209,68 +271,6 @@ - -variable[=value] -TZ -main - - -By default, nginx removes all environment variables inherited -from its parent process except the TZ variable. -This directive allows preserving some of the inherited variables, -changing their values, or creating new environment variables. -These variables are then: - - - -inherited during a live upgrade -of an executable file; - - - -used by the -ngx_http_perl_module module; - - - -used by worker processes. -One should bear in mind that controlling system libraries in this way -is not always possible as it is common for libraries to check -variables only during initialization, well before they can be set -using this directive. -An exception from this is an above mentioned -live upgrade -of an executable file. - - - - - - -The TZ variable is always inherited and available to the -ngx_http_perl_module -module, unless it is configured explicitly. - - - -Usage example: - -env MALLOC_OPTIONS; -env PERL5LIB=/data/site/modules; -env OPENSSL_ALLOW_PROXY_CERTS=1; - - - - - -The NGINX environment variable is used internally by nginx -and should not be set directly by the user. - - - - - - diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/stream/ngx_stream_proxy_module.xml --- a/xml/en/docs/stream/ngx_stream_proxy_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -384,6 +384,25 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +stream +server + + +Enables the specified protocols for connections to a proxied server. + + + + + on | off off @@ -417,25 +436,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -stream -server - - -Enables the specified protocols for connections to a proxied server. - - - - - file diff -r 10751277a8ad -r ca7568f67dee xml/en/docs/stream/ngx_stream_zone_sync_module.xml --- a/xml/en/docs/stream/ngx_stream_zone_sync_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/en/docs/stream/ngx_stream_zone_sync_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -111,6 +111,77 @@ + +number size +256 4k|8k +stream +server + + +Sets the number and size of the +per-zone buffers used for pushing zone contents. +By default, the buffer size is equal to one memory page. +This is either 4K or 8K, depending on a platform. + + + + + + +time +1s +stream +server + + +Defines an interval between connection attempts to another cluster node. + + + + + + +time +5s +stream +server + + +Defines a timeout for establishing a connection with another cluster node. + + + + + + +time +1s +stream +server + + +Defines an interval for polling updates in a shared memory zone. + + + + + + +size +4k|8k +stream +server + + +Sets size of a per-connection receive buffer used to parse +incoming stream of synchronization messages. +By default, the buffer size is equal to one memory page. +This is either 4K or 8K, depending on a platform. + + + + + address [resolve] @@ -167,92 +238,6 @@ - -time -1s -stream -server - - -Defines an interval for polling updates in a shared memory zone. - - - - - - -time -5s -stream -server - - -Defines a timeout for establishing a connection with another cluster node. - - - - - - -time -1s -stream -server - - -Defines an interval between connection attempts to another cluster node. - - - - - - -timeout -5s -stream -server - - -Sets the timeout between two successive -read or write operations on connection to another cluster node. -If no data is transmitted within this time, the connection is closed. - - - - - - -number size -256 4k|8k -stream -server - - -Sets the number and size of the -per-zone buffers used for pushing zone contents. -By default, the buffer size is equal to one memory page. -This is either 4K or 8K, depending on a platform. - - - - - - -size -4k|8k -stream -server - - -Sets size of a per-connection receive buffer used to parse -incoming stream of synchronization messages. -By default, the buffer size is equal to one memory page. -This is either 4K or 8K, depending on a platform. - - - - - on | off off @@ -403,6 +388,21 @@ + + +timeout +5s +stream +server + + +Sets the timeout between two successive +read or write operations on connection to another cluster node. +If no data is transmitted within this time, the connection is closed. + + + +
diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_auth_jwt_module.xml --- a/xml/ru/docs/http/ngx_http_auth_jwt_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_auth_jwt_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -122,26 +122,6 @@
- -$переменная имя ... - -http -1.11.10 - - -Устанавливает переменную в параметр заголовка JOSE, -определяемый именами ключей. -Сопоставление имён начинается с верхнего уровня дерева JSON. -Для массива переменная хранит список его элементов, разделяемых запятыми. - -До версии 1.13.7 можно было указать лишь одно имя, -результат для массивов был не определён. - - - - - - $переменная имя ... @@ -170,20 +150,21 @@ - -время -0s + +$переменная имя ... + http -server -location -1.13.11 +1.11.10 -Задаёт максимально допустимое отклонение времени для компенсации -расхождения часов при проверке JWT claims -exp -и -nbf. +Устанавливает переменную в параметр заголовка JOSE, +определяемый именами ключей. +Сопоставление имён начинается с верхнего уровня дерева JSON. +Для массива переменная хранит список его элементов, разделяемых запятыми. + +До версии 1.13.7 можно было указать лишь одно имя, +результат для массивов был не определён. + @@ -206,6 +187,25 @@ + + +время +0s +http +server +location +1.13.11 + + +Задаёт максимально допустимое отклонение времени для компенсации +расхождения часов при проверке JWT claims +exp +и +nbf. + + + +
diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_dav_module.xml --- a/xml/ru/docs/http/ngx_http_dav_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_dav_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -64,6 +64,22 @@
+ +on | off +off +http +server +location + + +По спецификации WebDAV-метод PUT может создавать файл только в +уже существующем каталоге. +Данная директива разрешает создавать все необходимые промежуточные каталоги. + + + + + пользователи:права ... user:rw @@ -130,22 +146,6 @@ - -on | off -off -http -server -location - - -По спецификации WebDAV-метод PUT может создавать файл только в -уже существующем каталоге. -Данная директива разрешает создавать все необходимые промежуточные каталоги. - - - - - число 0 diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_grpc_module.xml --- a/xml/ru/docs/http/ngx_http_grpc_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_grpc_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -552,6 +552,26 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +http +server +location + + +Разрешает указанные протоколы для запросов к gRPC SSL-серверу. + + + + + on | off off @@ -588,26 +608,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -http -server -location - - -Разрешает указанные протоколы для запросов к gRPC SSL-серверу. - - - - - файл diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_gzip_module.xml --- a/xml/ru/docs/http/ngx_http_gzip_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_gzip_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -119,6 +119,20 @@ + +1.0 | 1.1 +1.1 +http +server +location + + +Устанавливает минимальную HTTP-версию запроса, необходимую для сжатия ответа. + + + + + длина 20 @@ -135,20 +149,6 @@ - -1.0 | 1.1 -1.1 -http -server -location - - -Устанавливает минимальную HTTP-версию запроса, необходимую для сжатия ответа. - - - - - off | diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_js_module.xml --- a/xml/ru/docs/http/ngx_http_js_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_js_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -119,6 +119,19 @@
+ +функция + +location +limit_except + + +Задаёт функцию njs в качестве обработчика содержимого location. + + + + + файл @@ -132,19 +145,6 @@ - -функция - -location -limit_except - - -Задаёт функцию njs в качестве обработчика содержимого location. - - - - - $переменная функция diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_proxy_module.xml --- a/xml/ru/docs/http/ngx_http_proxy_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -1966,6 +1966,27 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +http +server +location +1.5.6 + + +Разрешает указанные протоколы для запросов к проксируемому HTTPS-серверу. + + + + + on | off off @@ -2003,27 +2024,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -http -server -location -1.5.6 - - -Разрешает указанные протоколы для запросов к проксируемому HTTPS-серверу. - - - - - файл diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/http/ngx_http_v2_module.xml --- a/xml/ru/docs/http/ngx_http_v2_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/http/ngx_http_v2_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -79,6 +79,22 @@
+ +размер +64k +http +server +1.11.0 + + +Задаёт размер буфера для каждого запроса, +в который может сохраняться тело запроса +до того, как оно начнёт обрабатываться. + + + + + размер 8k @@ -98,22 +114,6 @@ - -размер -64k -http -server -1.11.0 - - -Задаёт размер буфера для каждого запроса, -в который может сохраняться тело запроса -до того, как оно начнёт обрабатываться. - - - - - время 3m diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/ngx_core_module.xml --- a/xml/ru/docs/ngx_core_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/ngx_core_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -146,6 +146,67 @@ + +переменная[=значение] +TZ +main + + +По умолчанию nginx удаляет все переменные окружения, унаследованные +от своего родительского процесса, кроме переменной TZ. +Эта директива позволяет сохранить часть унаследованных переменных, +поменять им значения или же создать новые переменные окружения. +Эти переменные затем: + + + +наследуются во время +обновления исполняемого файла на лету; + + + +используются модулем +ngx_http_perl_module; + + + +используются рабочими процессами. +Следует иметь в виду, что управление поведением системных библиотек +подобным образом возможно не всегда, поскольку зачастую библиотеки используют +переменные только во время инициализации, то есть ещё до того, как их +можно задать с помощью данной директивы. +Исключением из этого является упомянутое выше +обновление исполняемого файла на лету. + + + + + + +Если переменная TZ не описана явно, то она всегда наследуется +и всегда доступна модулю +ngx_http_perl_module. + + + +Пример использования: + +env MALLOC_OPTIONS; +env PERL5LIB=/data/site/modules; +env OPENSSL_ALLOW_PROXY_CERTS=1; + + + + + +Переменная окружения NGINX используется для внутренних целей nginx +и не должна устанавливаться непосредственно самим пользователем. + + + + + + файл [уровень] logs/error.log error @@ -208,67 +269,6 @@ - -переменная[=значение] -TZ -main - - -По умолчанию nginx удаляет все переменные окружения, унаследованные -от своего родительского процесса, кроме переменной TZ. -Эта директива позволяет сохранить часть унаследованных переменных, -поменять им значения или же создать новые переменные окружения. -Эти переменные затем: - - - -наследуются во время -обновления исполняемого файла на лету; - - - -используются модулем -ngx_http_perl_module; - - - -используются рабочими процессами. -Следует иметь в виду, что управление поведением системных библиотек -подобным образом возможно не всегда, поскольку зачастую библиотеки используют -переменные только во время инициализации, то есть ещё до того, как их -можно задать с помощью данной директивы. -Исключением из этого является упомянутое выше -обновление исполняемого файла на лету. - - - - - - -Если переменная TZ не описана явно, то она всегда наследуется -и всегда доступна модулю -ngx_http_perl_module. - - - -Пример использования: - -env MALLOC_OPTIONS; -env PERL5LIB=/data/site/modules; -env OPENSSL_ALLOW_PROXY_CERTS=1; - - - - - -Переменная окружения NGINX используется для внутренних целей nginx -и не должна устанавливаться непосредственно самим пользователем. - - - - - - diff -r 10751277a8ad -r ca7568f67dee xml/ru/docs/stream/ngx_stream_proxy_module.xml --- a/xml/ru/docs/stream/ngx_stream_proxy_module.xml Tue Apr 10 17:16:38 2018 +0300 +++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml Tue Apr 10 18:39:34 2018 +0300 @@ -387,6 +387,25 @@ + + + [SSLv2] + [SSLv3] + [TLSv1] + [TLSv1.1] + [TLSv1.2] + [TLSv1.3] +TLSv1 TLSv1.1 TLSv1.2 +stream +server + + +Разрешает указанные протоколы для соединений с проксируемым сервером. + + + + + on | off off @@ -421,25 +440,6 @@ - - - [SSLv2] - [SSLv3] - [TLSv1] - [TLSv1.1] - [TLSv1.2] - [TLSv1.3] -TLSv1 TLSv1.1 TLSv1.2 -stream -server - - -Разрешает указанные протоколы для соединений с проксируемым сервером. - - - - - файл