You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by yl...@apache.org on 2023/01/27 17:46:57 UTC
svn commit: r1907039 - in /httpd/httpd/trunk/docs/manual/mod: mod_proxy_wstunnel.html.en.utf8 mod_proxy_wstunnel.html.fr.utf8 mod_proxy_wstunnel.xml.meta
Author: ylavic
Date: Fri Jan 27 17:46:57 2023
New Revision: 1907039
URL: http://svn.apache.org/viewvc?rev=1907039&view=rev
Log:
docs xforms [skip ci]
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.en.utf8
httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8
httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.meta
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.en.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.en.utf8?rev=1907039&r1=1907038&r2=1907039&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.en.utf8 [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.en.utf8 [utf-8] Fri Jan 27 17:46:57 2023
@@ -37,6 +37,12 @@
<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in httpd 2.4.5 and later</td></tr></table>
<h3>Summary</h3>
+ <div class="warning"><h3><a id="deprecation" name="deprecation">Deprecation</a></h3>
+ <p>Since Apache HTTP Server 2.4.47, protocol Upgrade (tunneling) can be better handled by
+ <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
+ <p>See <a href="mod_proxy.html#protoupgrade">Protocol Upgrade</a>.</p>
+ </div>
+
<p>This module <em>requires</em> the service of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.
It provides support for the tunnelling of web
socket connections to a backend websockets server. The connection
@@ -62,18 +68,18 @@ ProxyPass "/" "http://backend.example.c
<p>Load balancing for multiple backends can be achieved using <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>.</p>
-<p>In fact the module can be used to upgrade to other protocols, you can set the <code>upgrade</code>
-parameter in the <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>
-directive to allow the module to accept other protocol.
-NONE means you bypass the check for the header but still upgrade to WebSocket.
-ANY means that <code>Upgrade</code> will read in the request headers and use
-in the response <code>Upgrade</code></p>
-
- <div class="warning"><h3><a id="deprecation" name="deprecation">Deprecation</a></h3>
- <p>Since Apache HTTP Server 2.4.47, protocol Upgrade (tunneling) can be better handled by
- <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
- <p>See <a href="mod_proxy.html#protoupgrade">Protocol Upgrade</a>.</p>
- </div>
+<p>
+The module can also be used to upgrade to other protocols than WebSocket, by setting
+the <var><a href="mod_proxy.html#upgrade">upgrade</a></var> parameter in the
+<code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>
+directive to some custom protocol name.
+Special <code>upgrade=NONE</code> and <code>upgrade=ANY</code> values may be used for
+testing/forcing the upgrade but they are <strong>not recommended</strong> for production for
+security reasons.
+<code>NONE</code> means that the check for the header is omitted but still the upgrade to
+WebSocket still happens.
+<code>ANY</code> means that the upgrade will happen with any protocol asked by the client.
+</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8?rev=1907039&r1=1907038&r2=1907039&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8 [utf-8] Fri Jan 27 17:46:57 2023
@@ -29,8 +29,6 @@
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_wstunnel.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_proxy_wstunnel.html" title="Français"> fr </a></p>
</div>
-<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
- anglaise pour les changements récents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module pour <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> supportant les
websockets</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.meta?rev=1907039&r1=1907038&r2=1907039&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.meta Fri Jan 27 17:46:57 2023
@@ -8,6 +8,6 @@
<variants>
<variant>en</variant>
- <variant outdated="yes">fr</variant>
+ <variant>fr</variant>
</variants>
</metafile>