summaryrefslogtreecommitdiff
path: root/docs/manual
diff options
context:
space:
mode:
authorYann Ylavic <ylavic@apache.org>2021-05-12 10:10:36 +0000
committerYann Ylavic <ylavic@apache.org>2021-05-12 10:10:36 +0000
commit4b5394837f82c9c3bb8bdd1191520b6cb55debd6 (patch)
tree7575c5f3bdf84e9d7585936e2042a849275ebbd9 /docs/manual
parent958c12bd6a4f2339e380bbadd6238a139166bdd7 (diff)
downloadhttpd-4b5394837f82c9c3bb8bdd1191520b6cb55debd6.tar.gz
mod_proxy_wstunnel: Add ProxyWebsocketFallbackToProxyHttp.
Allows to opt-out the fallback to mod_proxy_http to handle WebSocket upgrade, and let mod_proxy_wstunnel handle the requests as in 2.4.46 and earlier. Update docs. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1889792 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual')
-rw-r--r--docs/manual/mod/mod_proxy_wstunnel.xml20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_proxy_wstunnel.xml b/docs/manual/mod/mod_proxy_wstunnel.xml
index 519523080c..2c1c2748e6 100644
--- a/docs/manual/mod/mod_proxy_wstunnel.xml
+++ b/docs/manual/mod/mod_proxy_wstunnel.xml
@@ -72,6 +72,26 @@ in the response <code>Upgrade</code></p>
<seealso><module>mod_proxy</module></seealso>
<directivesynopsis>
+<name>ProxyWebsocketFallbackToProxyHttp</name>
+<description>Instructs this module to let <module>mod_proxy_http</module> handle the request</description>
+<syntax>ProxyWebsocketFallbackToProxyHttp On|Off</syntax>
+<default>ProxyWebsocketFallbackToProxyHttp On</default>
+<compatibility>Available in httpd 2.4.48 and later</compatibility>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Since httpd 2.4.47, <module>mod_proxy_http</module> can handle WebSocket
+ upgrading and tunneling in accordance to RFC 7230, this directive controls
+ whether <module>mod_proxy_wstunnel</module> should hand over to
+ <module>mod_proxy_http</module> to this, which is the case by default.</p>
+ <p>Setting to <em>Off</em> lets <module>mod_proxy_wstunnel</module> handle
+ WebSocket requests as in httpd 2.4.46 and earlier.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
<name>ProxyWebsocketAsync</name>
<description>Instructs this module to try to create an asynchronous tunnel</description>
<syntax>ProxyWebsocketAsync ON|OFF</syntax>