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:49 UTC
[tomcat] branch 9.0.x 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 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push:
new d761e1b1fc Document possibility of file locking on Windows with HTTP/2 sendfile
d761e1b1fc is described below
commit d761e1b1fcce644c0d6dc0352fac22a4e879c03f
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 68564dcf4f..cb89936cc8 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -155,6 +155,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 e54566e0d0..472359637b 100644
--- a/webapps/docs/config/http2.xml
+++ b/webapps/docs/config/http2.xml
@@ -279,6 +279,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