You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2022/06/23 16:49:11 UTC
[tomcat] branch main updated: Document possibility of file locking on Windows with HTTP/2 sendfile
This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/main by this push:
new 64966542af Document possibility of file locking on Windows with HTTP/2 sendfile
64966542af is described below
commit 64966542af57251400fee18d30906ceaa8568da6
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Thu Jun 23 17:48:08 2022 +0100
Document possibility of file locking on Windows with HTTP/2 sendfile
---
webapps/docs/changelog.xml | 5 +++++
webapps/docs/config/http2.xml | 6 ++++++
2 files changed, 11 insertions(+)
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 5b08100d1a..f33e004e4c 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -177,6 +177,11 @@
Examples. Fix CVE-2022-34305, a low severity XSS vulnerability in the
Form authentication example. (markt)
</fix>
+ <fix>
+ Documentation. Expand the description of the <code>useSendfile</code>
+ attribute for HTTP/2 and reference the possibility of file locking when
+ using this feature on Windows operating systems. (markt)
+ </fix>
</changelog>
</subsection>
<subsection name="Other">
diff --git a/webapps/docs/config/http2.xml b/webapps/docs/config/http2.xml
index 9adacb1d2d..629b135cc2 100644
--- a/webapps/docs/config/http2.xml
+++ b/webapps/docs/config/http2.xml
@@ -196,6 +196,12 @@
<attribute name="useSendfile" required="false">
<p>Use this boolean attribute to enable or disable sendfile capability.
The default value is <code>true</code>.</p>
+ <p>This setting is ignored, and the sendfile capability disabled, if the
+ <strong>useAsyncIO</strong> attribute of the associated
+ <strong>Connector</strong> is set to <code>false</code>.</p>
+ <p>The HTTP/2 sendfile capability uses <a
+ href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/MappedByteBuffer.html"
+ >MappedByteBuffer</a> which is known to cause file locking on Windows.</p>
</attribute>
<attribute name="writeTimeout" required="false">
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org