changeset 1503:a9ffc9dd41e0

Added the "ngx_stream_access_module" module.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 10 Jun 2015 14:02:58 +0300
parents b628e042a15e
children 0b89d1e54e8f
files xml/en/GNUmakefile xml/en/docs/index.xml xml/en/docs/stream/ngx_stream_access_module.xml xml/ru/GNUmakefile xml/ru/docs/index.xml xml/ru/docs/stream/ngx_stream_access_module.xml
diffstat 6 files changed, 34 insertions(+), 49 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/GNUmakefile
+++ b/xml/en/GNUmakefile
@@ -91,6 +91,7 @@ REFS =									\
 		mail/ngx_mail_proxy_module				\
 		mail/ngx_mail_smtp_module				\
 		mail/ngx_mail_ssl_module				\
+		stream/ngx_stream_access_module				\
 		stream/ngx_stream_core_module				\
 		stream/ngx_stream_proxy_module				\
 		stream/ngx_stream_ssl_module				\
--- a/xml/en/docs/index.xml
+++ b/xml/en/docs/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx documentation"
          link="/en/docs/"
          lang="en"
-         rev="19"
+         rev="20"
          toc="no">
 
 
@@ -477,6 +477,11 @@ ngx_stream_core_module</link>
 </listitem>
 
 <listitem>
+<link doc="stream/ngx_stream_access_module.xml">
+ngx_stream_access_module</link>
+</listitem>
+
+<listitem>
 <link doc="stream/ngx_stream_proxy_module.xml">
 ngx_stream_proxy_module</link>
 </listitem>
copy from xml/en/docs/http/ngx_http_access_module.xml
copy to xml/en/docs/stream/ngx_stream_access_module.xml
--- a/xml/en/docs/http/ngx_http_access_module.xml
+++ b/xml/en/docs/stream/ngx_stream_access_module.xml
@@ -7,26 +7,18 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Module ngx_http_access_module"
-        link="/en/docs/http/ngx_http_access_module.html"
+<module name="Module ngx_stream_access_module"
+        link="/en/docs/stream/ngx_stream_access_module.html"
         lang="en"
-        rev="3">
+        rev="1">
 
 <section id="summary">
 
 <para>
-The <literal>ngx_http_access_module</literal> module allows
+The <literal>ngx_stream_access_module</literal> module (1.9.2) allows
 limiting access to certain client addresses.
 </para>
 
-<para>
-Access can also be limited by
-<link doc="ngx_http_auth_basic_module.xml">password</link> or by the
-<link doc="ngx_http_auth_request_module.xml">result of subrequest</link>.
-Simultaneous limitation of access by address and by password is controlled
-by the <link doc="ngx_http_core_module.xml" id="satisfy"/> directive.
-</para>
-
 </section>
 
 
@@ -34,7 +26,8 @@ by the <link doc="ngx_http_core_module.x
 
 <para>
 <example>
-location / {
+server {
+    ...
     deny  192.168.1.1;
     allow 192.168.1.0/24;
     allow 10.1.1.0/16;
@@ -50,9 +43,6 @@ In this example, access is allowed only 
 <literal>10.1.1.0/16</literal> and <literal>192.168.1.0/24</literal>
 excluding the address <literal>192.168.1.1</literal>,
 and for IPv6 network <literal>2001:0db8::/32</literal>.
-In case of a lot of rules, the use of the
-<link doc="ngx_http_geo_module.xml">ngx_http_geo_module</link>
-module variables is preferable.
 </para>
 
 </section>
@@ -67,14 +57,12 @@ module variables is preferable.
     <literal>unix:</literal> |
     <literal>all</literal></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 <context>server</context>
-<context>location</context>
-<context>limit_except</context>
 
 <para>
 Allows access for the specified network or address.
-If the special value <literal>unix:</literal> is specified (1.5.1),
+If the special value <literal>unix:</literal> is specified,
 allows access for all UNIX-domain sockets.
 </para>
 
@@ -88,14 +76,12 @@ allows access for all UNIX-domain socket
     <literal>unix:</literal> |
     <literal>all</literal></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 <context>server</context>
-<context>location</context>
-<context>limit_except</context>
 
 <para>
 Denies access for the specified network or address.
-If the special value <literal>unix:</literal> is specified (1.5.1),
+If the special value <literal>unix:</literal> is specified,
 denies access for all UNIX-domain sockets.
 </para>
 
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -81,6 +81,7 @@ REFS =									\
 		mail/ngx_mail_proxy_module				\
 		mail/ngx_mail_smtp_module				\
 		mail/ngx_mail_ssl_module				\
+		stream/ngx_stream_access_module				\
 
 TOP =									\
 		download						\
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -8,7 +8,7 @@
 <article name="nginx: документация"
          link="/ru/docs/"
          lang="ru"
-         rev="19"
+         rev="20"
          toc="no">
 
 
@@ -481,6 +481,11 @@ ngx_stream_core_module</link> [en]
 </listitem>
 
 <listitem>
+<link doc="stream/ngx_stream_access_module.xml">
+ngx_stream_access_module</link>
+</listitem>
+
+<listitem>
 <link doc="../../en/docs/stream/ngx_stream_proxy_module.xml">
 ngx_stream_proxy_module</link> [en]
 </listitem>
copy from xml/ru/docs/http/ngx_http_access_module.xml
copy to xml/ru/docs/stream/ngx_stream_access_module.xml
--- a/xml/ru/docs/http/ngx_http_access_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_access_module.xml
@@ -7,26 +7,18 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Модуль ngx_http_access_module"
-        link="/ru/docs/http/ngx_http_access_module.html"
+<module name="Модуль ngx_stream_access_module"
+        link="/ru/docs/stream/ngx_stream_access_module.html"
         lang="ru"
-        rev="3">
+        rev="1">
 
 <section id="summary">
 
 <para>
-Модуль <literal>ngx_http_access_module</literal> позволяет
+Модуль <literal>ngx_stream_access_module</literal> (1.9.2) позволяет
 ограничить доступ для определённых адресов клиентов.
 </para>
 
-<para>
-Ограничить доступ можно также по
-<link doc="ngx_http_auth_basic_module.xml">паролю</link> или по
-<link doc="ngx_http_auth_basic_module.xml">результату подзапроса</link>.
-Одновременное ограничение доступа по адресу и паролю управляется
-директивой <link doc="ngx_http_core_module.xml" id="satisfy"/>.
-</para>
-
 </section>
 
 
@@ -34,7 +26,8 @@
 
 <para>
 <example>
-location / {
+server {
+    ...
     deny  192.168.1.1;
     allow 192.168.1.0/24;
     allow 10.1.1.0/16;
@@ -50,8 +43,6 @@ location / {
 <literal>10.1.1.0/16</literal> и <literal>192.168.1.0/24</literal>,
 кроме адреса <literal>192.168.1.1</literal>,
 и для IPv6-сети <literal>2001:0db8::/32</literal>.
-Если правил много, то лучше воспользоваться переменными модуля
-<link doc="ngx_http_geo_module.xml">ngx_http_geo_module</link>.
 </para>
 
 </section>
@@ -66,14 +57,12 @@ location / {
     <literal>unix:</literal> |
     <literal>all</literal></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 <context>server</context>
-<context>location</context>
-<context>limit_except</context>
 
 <para>
 Разрешает доступ для указанной сети или адреса.
-Если указано специальное значение <literal>unix:</literal> (1.5.1),
+Если указано специальное значение <literal>unix:</literal>,
 разрешает доступ для всех UNIX-сокетов.
 </para>
 
@@ -87,14 +76,12 @@ location / {
     <literal>unix:</literal> |
     <literal>all</literal></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 <context>server</context>
-<context>location</context>
-<context>limit_except</context>
 
 <para>
 Запрещает доступ для указанной сети или адреса.
-Если указано специальное значение <literal>unix:</literal> (1.5.1),
+Если указано специальное значение <literal>unix:</literal>,
 запрещает доступ для всех UNIX-сокетов.
 </para>