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-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org