Mercurial > hg > nginx-site
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 Tue Dec 25 16:26:39 2012 +0000 +++ b/xml/en/docs/http/ngx_http_geo_module.xml Wed Dec 26 05:05:29 2012 +0000 @@ -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 @@ <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 @@ </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 @@ <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 @@ 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 Tue Dec 25 16:26:39 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_geo_module.xml Wed Dec 26 05:05:29 2012 +0000 @@ -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 @@ </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 @@ <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 @@ В отличие от обычных адресов, доверенные адреса проверяются последовательно. <note> -IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1. +Доверенные IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1. </note> </tag-desc>