changeset 797:55b633342309

Documented "geo" support of IPv6 address prefixes.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 26 Dec 2012 05:05:29 +0000
parents a2f75649204c
children bc4923434591
files xml/en/docs/http/ngx_http_geo_module.xml xml/ru/docs/http/ngx_http_geo_module.xml
diffstat 2 files changed, 37 insertions(+), 13 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_geo_module.xml
+++ b/xml/en/docs/http/ngx_http_geo_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_geo_module"
         link="/en/docs/http/ngx_http_geo_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -28,9 +28,13 @@ whose values depend on the client IP add
 <example>
 geo $geo {
     default        0;
-    127.0.0.1/32   2;
+
+    127.0.0.1      2;
     192.168.1.0/24 1;
     10.1.0.0/16    1;
+
+    ::1            2;
+    2001:0db8::/32 1;
 }
 </example>
 </para>
@@ -71,7 +75,14 @@ then the “<literal>255.255.255.255</literal>” address is used.
 </para>
 
 <para>
-Addresses are specified as CIDR or ranges (0.7.23).
+Addresses are specified either as prefixes in CIDR notation
+(including individual addresses) or as ranges (0.7.23).
+<note>
+IPv6 prefixes are supported starting from version 1.3.10.
+</note>
+</para>
+
+<para>
 The following special parameters are also supported:
 <list type="tag">
 
@@ -84,8 +95,9 @@ deletes the specified network (0.7.23).
 <tag-desc>
 a value of variable if the client address does not
 match any of the specified addresses.
-When CIDR is used, “<literal>0.0.0.0/0</literal>” can be written
-instead of <literal>default</literal>.
+When addresses are specified in CIDR notation,
+“<literal>0.0.0.0/0</literal>” and “<literal>::/0</literal>”
+can be used instead of <literal>default</literal>.
 When <literal>default</literal> is not specified, the default
 value will be an empty string.
 </tag-desc>
@@ -105,7 +117,7 @@ header field will be used instead.
 In contrast to the regular addresses, trusted addresses are
 checked sequentially.
 <note>
-IPv6 addresses are supported starting from versions 1.3.0 and 1.2.1.
+Trusted IPv6 addresses are supported starting from versions 1.3.0 and 1.2.1.
 </note>
 </tag-desc>
 
--- a/xml/ru/docs/http/ngx_http_geo_module.xml
+++ b/xml/ru/docs/http/ngx_http_geo_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_geo_module"
         link="/ru/docs/http/ngx_http_geo_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -28,9 +28,13 @@
 <example>
 geo $geo {
     default        0;
-    127.0.0.1/32   2;
+
+    127.0.0.1      2;
     192.168.1.0/24 1;
     10.1.0.0/16    1;
+
+    ::1            2;
+    2001:0db8::/32 1;
 }
 </example>
 </para>
@@ -72,7 +76,14 @@ geo $arg_remote_addr $geo {
 </para>
 
 <para>
-Адреса задаются в виде CIDR или в виде диапазонов (0.7.23).
+Адреса задаются либо префиксами в формате CIDR
+(включая одиночные адреса), либо в виде диапазонов (0.7.23).
+<note>
+IPv6-префиксы поддерживаются начиная с версии 1.3.10.
+</note>
+</para>
+
+<para>
 Также поддерживаются следующие специальные параметры:
 <list type="tag">
 
@@ -84,9 +95,10 @@ geo $arg_remote_addr $geo {
 <tag-name><literal>default</literal></tag-name>
 <tag-desc>
 значение переменной, если адрес клиента не соответствует
-ни одному заданному адресу.
-При использовании CIDR вместо <literal>default</literal> можно
-также написать “<literal>0.0.0.0/0</literal>”.
+ни одному из заданных адресов.
+При задании адресов в формате CIDR
+вместо <literal>default</literal> можно использовать
+“<literal>0.0.0.0/0</literal>” и “<literal>::/0</literal>”.
 Если параметр <literal>default</literal> не указан, значением
 по умолчанию будет пустая строка.
 </tag-desc>
@@ -105,7 +117,7 @@ geo $arg_remote_addr $geo {
 В отличие от обычных адресов, доверенные адреса проверяются
 последовательно.
 <note>
-IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1.
+Доверенные IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1.
 </note>
 </tag-desc>