# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1481213002 -10800
# Node ID 0882ccb0c00f2729f96aa9c52d3da9fb39b9fb1d
# Parent  7133004fa5b309ff0a0eb4c21c0d4dfa31ed11b1
Documented the $ssl_curves and $ssl_ciphers variables.

diff -r 7133004fa5b3 -r 0882ccb0c00f xml/en/docs/http/ngx_http_ssl_module.xml
--- a/xml/en/docs/http/ngx_http_ssl_module.xml	Thu Dec 08 19:08:30 2016 +0300
+++ b/xml/en/docs/http/ngx_http_ssl_module.xml	Thu Dec 08 19:03:22 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_ssl_module"
         link="/en/docs/http/ngx_http_ssl_module.html"
         lang="en"
-        rev="27">
+        rev="28">
 
 <section id="summary">
 
@@ -762,6 +762,21 @@
 for an established SSL connection;
 </tag-desc>
 
+<tag-name id="var_ssl_ciphers"><var>$ssl_ciphers</var></tag-name>
+<tag-desc>
+returns the list of ciphers supported by the client (1.11.7).
+Known ciphers are listed by names, unknown are shown in hexadecimal,
+for example:
+<example>
+AES128-SHA:AES256-SHA:0x00ff
+</example>
+<note>
+The variable is fully supported only when using OpenSSL version 1.0.2 or higher.
+With older versions, the variable is available
+only for new sessions and lists only known ciphers.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_client_cert"><var>$ssl_client_cert</var></tag-name>
 <tag-desc>
 returns the client certificate in the PEM format
@@ -849,6 +864,23 @@
 </note>
 </tag-desc>
 
+<tag-name id="var_ssl_curves"><var>$ssl_curves</var></tag-name>
+<tag-desc>
+returns the list of curves supported by the client (1.11.7).
+Known curves are listed by names, unknown are shown in hexadecimal,
+for example:
+<example>
+0x001d:prime256v1:secp521r1:secp384r1
+</example>
+<note>
+The variable is supported only when using OpenSSL version 1.0.2 or higher.
+With older versions, the variable value will be an empty string.
+</note>
+<note>
+The variable is available only for new sessions.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
 <tag-desc>
 returns the protocol of an established SSL connection;
diff -r 7133004fa5b3 -r 0882ccb0c00f xml/en/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/en/docs/stream/ngx_stream_ssl_module.xml	Thu Dec 08 19:08:30 2016 +0300
+++ b/xml/en/docs/stream/ngx_stream_ssl_module.xml	Thu Dec 08 19:03:22 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_ssl_module"
         link="/en/docs/stream/ngx_stream_ssl_module.html"
         lang="en"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -435,6 +435,38 @@
 for an established SSL connection;
 </tag-desc>
 
+<tag-name id="var_ssl_ciphers"><var>$ssl_ciphers</var></tag-name>
+<tag-desc>
+returns the list of ciphers supported by the client (1.11.7).
+Known ciphers are listed by names, unknown are shown in hexadecimal,
+for example:
+<example>
+AES128-SHA:AES256-SHA:0x00ff
+</example>
+<note>
+The variable is fully supported only when using OpenSSL version 1.0.2 or higher.
+With older versions, the variable is available
+only for new sessions and lists only known ciphers.
+</note>
+</tag-desc>
+
+<tag-name id="var_ssl_curves"><var>$ssl_curves</var></tag-name>
+<tag-desc>
+returns the list of curves supported by the client (1.11.7).
+Known curves are listed by names, unknown are shown in hexadecimal,
+for example:
+<example>
+0x001d:prime256v1:secp521r1:secp384r1
+</example>
+<note>
+The variable is supported only when using OpenSSL version 1.0.2 or higher.
+With older versions, the variable value will be an empty string.
+</note>
+<note>
+The variable is available only for new sessions.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
 <tag-desc>
 returns the protocol of an established SSL connection;
diff -r 7133004fa5b3 -r 0882ccb0c00f xml/ru/docs/http/ngx_http_ssl_module.xml
--- a/xml/ru/docs/http/ngx_http_ssl_module.xml	Thu Dec 08 19:08:30 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_ssl_module.xml	Thu Dec 08 19:03:22 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_ssl_module"
         link="/ru/docs/http/ngx_http_ssl_module.html"
         lang="ru"
-        rev="27">
+        rev="28">
 
 <section id="summary">
 
@@ -764,6 +764,22 @@
 возвращает строку используемых шифров для установленного SSL-соединения;
 </tag-desc>
 
+<tag-name id="var_ssl_ciphers"><var>$ssl_ciphers</var></tag-name>
+<tag-desc>
+возвращает список шифров, поддерживаемых клиентом (1.11.7).
+Известные шифры указаны по имени, неизвестные указаны в шестнадцатеричном виде,
+например:
+<example>
+AES128-SHA:AES256-SHA:0x00ff
+</example>
+<note>
+Переменная полностью поддерживается при использовании OpenSSL версии 1.0.2
+и выше.
+При использовании более старых версий переменная доступна
+только для новых сессий и может содержать только известные шифры.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_client_cert"><var>$ssl_client_cert</var></tag-name>
 <tag-desc>
 возвращает клиентский сертификат
@@ -851,6 +867,23 @@
 </note>
 </tag-desc>
 
+<tag-name id="var_ssl_curves"><var>$ssl_curves</var></tag-name>
+<tag-desc>
+возвращает список кривых, поддерживаемых клиентом (1.11.7).
+Известные кривые указаны по имени, неизвестные указаны в шестнадцатеричном виде,
+например:
+<example>
+0x001d:prime256v1:secp521r1:secp384r1
+</example>
+<note>
+Переменная поддерживается при использовании OpenSSL версии 1.0.2 и выше.
+При использовании более старых версий значением переменной будет пустая строка.
+</note>
+<note>
+Переменная доступна только для новых сессий.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
 <tag-desc>
 возвращает протокол установленного SSL-соединения;
diff -r 7133004fa5b3 -r 0882ccb0c00f xml/ru/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Thu Dec 08 19:08:30 2016 +0300
+++ b/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Thu Dec 08 19:03:22 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_ssl_module"
         link="/ru/docs/stream/ngx_stream_ssl_module.html"
         lang="ru"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -433,6 +433,39 @@
 возвращает строку используемых шифров для установленного SSL-соединения;
 </tag-desc>
 
+<tag-name id="var_ssl_ciphers"><var>$ssl_ciphers</var></tag-name>
+<tag-desc>
+возвращает список шифров, поддерживаемых клиентом (1.11.7).
+Известные шифры указаны по имени, неизвестные указаны в шестнадцатеричном виде,
+например:
+<example>
+AES128-SHA:AES256-SHA:0x00ff
+</example>
+<note>
+Переменная полностью поддерживается при использовании OpenSSL версии 1.0.2
+и выше.
+При использовании более старых версий переменная доступна
+только для новых сессий и может содержать только известные шифры.
+</note>
+</tag-desc>
+
+<tag-name id="var_ssl_curves"><var>$ssl_curves</var></tag-name>
+<tag-desc>
+возвращает список кривых, поддерживаемых клиентом (1.11.7).
+Известные кривые указаны по имени, неизвестные указаны в шестнадцатеричном виде,
+например:
+<example>
+0x001d:prime256v1:secp521r1:secp384r1
+</example>
+<note>
+Переменная поддерживается при использовании OpenSSL версии 1.0.2 и выше.
+При использовании более старых версий значением переменной будет пустая строка.
+</note>
+<note>
+Переменная доступна только для новых сессий.
+</note>
+</tag-desc>
+
 <tag-name id="var_ssl_protocol"><var>$ssl_protocol</var></tag-name>
 <tag-desc>
 возвращает протокол установленного SSL-соединения;