# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1635801384 0
# Node ID a281f61b5ad859739eca422550430a1b389c5ebc
# Parent  d164091873143ab144b7ce90a670927743bf45a1
Documented the ssl_alpn directive.

diff -r d16409187314 -r a281f61b5ad8 xml/en/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/en/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:06:06 2021 +0000
+++ b/xml/en/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:16:24 2021 +0000
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_ssl_module"
         link="/en/docs/stream/ngx_stream_ssl_module.html"
         lang="en"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -79,6 +79,35 @@
 
 <section id="directives" name="Directives">
 
+<directive name="ssl_alpn">
+<syntax><value>protocol</value> ...</syntax>
+<default/>
+<context>stream</context>
+<context>server</context>
+<appeared-in>1.21.4</appeared-in>
+
+<para>
+Specifies the list of supported
+<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link> protocols.
+One of the protocols must be
+<link id="var_ssl_alpn_protocol">negotiated</link> if the client uses ALPN:
+<example>
+map $ssl_alpn_protocol $proxy {
+    h2                127.0.0.1:8001;
+    http/1.1          127.0.0.1:8002;
+}
+
+server {
+    listen      12346;
+    proxy_pass  $proxy;
+    ssl_alpn    h2 http/1.1;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="ssl_certificate">
 <syntax><value>file</value></syntax>
 <default/>
diff -r d16409187314 -r a281f61b5ad8 xml/ru/docs/stream/ngx_stream_ssl_module.xml
--- a/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:06:06 2021 +0000
+++ b/xml/ru/docs/stream/ngx_stream_ssl_module.xml	Mon Nov 01 21:16:24 2021 +0000
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_ssl_module"
         link="/ru/docs/stream/ngx_stream_ssl_module.html"
         lang="ru"
-        rev="26">
+        rev="27">
 
 <section id="summary">
 
@@ -79,6 +79,36 @@
 
 <section id="directives" name="Директивы">
 
+<directive name="ssl_alpn">
+<syntax><value>протокол</value> ...</syntax>
+<default/>
+<context>stream</context>
+<context>server</context>
+<appeared-in>1.21.4</appeared-in>
+
+<para>
+Задаёт список поддерживаемых
+протоколов
+<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link>.
+Один из протоколов должен быть
+<link id="var_ssl_alpn_protocol">согласован</link>, если клиент использует ALPN:
+<example>
+map $ssl_alpn_protocol $proxy {
+    h2                 127.0.0.1:8001;
+    http/1.1           127.0.0.1:8002;
+}
+
+server {
+    listen      12346;
+    proxy_pass  $proxy;
+    ssl_alpn    h2 http/1.1;
+}
+</example>
+</para>
+
+</directive>
+
+
 <directive name="ssl_certificate">
 <syntax><value>файл</value></syntax>
 <default/>