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/03/15 21:06:16 UTC
[tomcat] branch main updated: Correct docs for common Connector properties
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 7dd8ae1 Correct docs for common Connector properties
7dd8ae1 is described below
commit 7dd8ae1a1b97991d7a6513b63685ae2b350d2af8
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Tue Mar 15 21:06:02 2022 +0000
Correct docs for common Connector properties
---
webapps/docs/changelog.xml | 5 +++
webapps/docs/config/ajp.xml | 70 ++++++++++++++++++++++++++++++------------
webapps/docs/config/http.xml | 72 ++++++++++++++++++++++----------------------
3 files changed, 92 insertions(+), 55 deletions(-)
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 4e9018b..88d940f 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -116,6 +116,11 @@
<bug>65952</bug>: Align <code>--add-opens</code> configuration for jsvc
with the current Tomcat scripts. (markt)
</fix>
+ <fix>
+ Correct the AJP and HTTP/1.1 Connector configuration pages in the
+ documentation web application to show which attributes are applicable to
+ all Connectors and which are implementation specific. (markt)
+ </fix>
</changelog>
</subsection>
<subsection name="Other">
diff --git a/webapps/docs/config/ajp.xml b/webapps/docs/config/ajp.xml
index 3188454..6850854 100644
--- a/webapps/docs/config/ajp.xml
+++ b/webapps/docs/config/ajp.xml
@@ -81,16 +81,10 @@
<attributes>
- <attribute name="ajpFlush" required="false">
- <p>A boolean value which can be used to enable or disable sending
- AJP flush messages to the fronting proxy whenever an explicit
- flush happens. The default value is <code>true</code>.<br/>
- An AJP flush message is a SEND_BODY_CHUNK packet with no body content.
- Proxy implementations like mod_jk or mod_proxy_ajp will flush the
- data buffered in the web server to the client when they receive
- such a packet. Setting this to <code>false</code> can reduce
- AJP packet traffic but might delay sending packets to the client.
- At the end of the response, AJP does always flush to the client.</p>
+ <attribute name="allowBackslash" required="false">
+ <p>If this is <code>true</code> the '\' character will be permitted as a
+ path delimiter.</p>
+ <p>If not specified, the default value of <code>false</code> will be used.</p>
</attribute>
<attribute name="allowTrace" required="false">
@@ -104,6 +98,15 @@
30000 (30 seconds).</p>
</attribute>
+ <attribute name="discardFacades" required="false">
+ <p>A boolean value which can be used to enable or disable the recycling
+ of the facade objects that isolate the container internal request
+ processing objects. If set to <code>true</code> the facades will be
+ set for garbage collection after every request, otherwise they will be
+ reused. This setting has no effect when the security manager is enabled.
+ If not specified, this attribute is set to <code>true</code>.</p>
+ </attribute>
+
<attribute name="enableLookups" required="false">
<p>Set to <code>true</code> if you want calls to
<code>request.getRemoteHost()</code> to perform DNS lookups in
@@ -124,11 +127,21 @@
If not specified the default value is <code>reject</code>.</p>
</attribute>
- <attribute name="maxHeaderCount" required="false">
- <p>The maximum number of headers in a request that are allowed by the
- container. A request that contains more headers than the specified limit
- will be rejected. A value of less than 0 means no limit.
- If not specified, a default of 100 is used.</p>
+ <attribute name="enforceEncodingInGetWriter" required="false">
+ <p>If this is <code>true</code> then
+ a call to <code>Response.getWriter()</code> if no character encoding
+ has been specified will result in subsequent calls to
+ <code>Response.getCharacterEncoding()</code> returning
+ <code>ISO-8859-1</code> and the <code>Content-Type</code> response header
+ will include a <code>charset=ISO-8859-1</code> component. (SRV.15.2.22.1)</p>
+ <p>If not specified, the default specification compliant value of
+ <code>true</code> will be used.</p>
+ </attribute>
+
+ <attribute name="maxCookieCount" required="false">
+ <p>The maximum number of cookies that are permitted for a request. A value
+ of less than zero means no limit. If not specified, a default value of 200
+ will be used.</p>
</attribute>
<attribute name="maxParameterCount" required="false">
@@ -229,6 +242,12 @@
number specified here.</p>
</attribute>
+ <attribute name="rejectSuspiciousURIs" required="false">
+ <p>Should this <strong>Connector</strong> reject a requests if the URI
+ matches one of the suspicious URIs patterns identified by the Servlet 6.0
+ specification? The default value is <code>false</code>.</p>
+ </attribute>
+
<attribute name="scheme" required="false">
<p>Set this attribute to the name of the protocol you wish to have
returned by calls to <code>request.getScheme()</code>. For
@@ -322,6 +341,18 @@
with either <code>0.0.0.0</code> or <code>::</code>.</p>
</attribute>
+ <attribute name="ajpFlush" required="false">
+ <p>A boolean value which can be used to enable or disable sending
+ AJP flush messages to the fronting proxy whenever an explicit
+ flush happens. The default value is <code>true</code>.<br/>
+ An AJP flush message is a SEND_BODY_CHUNK packet with no body content.
+ Proxy implementations like mod_jk or mod_proxy_ajp will flush the
+ data buffered in the web server to the client when they receive
+ such a packet. Setting this to <code>false</code> can reduce
+ AJP packet traffic but might delay sending packets to the client.
+ At the end of the response, AJP does always flush to the client.</p>
+ </attribute>
+
<attribute name="allowedRequestAttributesPattern" required="false">
<p>The AJP protocol passes some information from the reverse proxy to the
AJP connector using request attributes. These attributes are:</p>
@@ -415,10 +446,11 @@
maxConnections feature and connections will not be counted.</p>
</attribute>
- <attribute name="maxCookieCount" required="false">
- <p>The maximum number of cookies that are permitted for a request. A value
- of less than zero means no limit. If not specified, a default value of 200
- will be used.</p>
+ <attribute name="maxHeaderCount" required="false">
+ <p>The maximum number of headers in a request that are allowed by the
+ container. A request that contains more headers than the specified limit
+ will be rejected. A value of less than 0 means no limit.
+ If not specified, a default of 100 is used.</p>
</attribute>
<attribute name="maxThreads" required="false">
diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml
index 1dd1ee0..6ddf476 100644
--- a/webapps/docs/config/http.xml
+++ b/webapps/docs/config/http.xml
@@ -94,31 +94,6 @@
30000 (30 seconds).</p>
</attribute>
- <attribute name="continueResponseTiming" required="false">
- <p>When to respond with a <code>100</code> intermediate response code to a
- request containing an <code>Expect: 100-continue</code> header.
- The following values may used:
- <ul>
- <li><code>immediately</code> - an intermediate 100 status response
- will be returned as soon as practical</li>
- <li><code>onRead</code> - an intermediate 100 status
- response will be returned only when the Servlet reads the request body,
- allowing the servlet to inspect the headers and possibly respond
- before the user agent sends a possibly large request body.</li>
- </ul>
- </p>
- </attribute>
-
- <attribute name="defaultSSLHostConfigName" required="false">
- <p>The name of the default <strong>SSLHostConfig</strong> that will be
- used for secure connections (if this connector is configured for secure
- connections) if the client connection does not provide SNI or if the SNI
- is provided but does not match any configured
- <strong>SSLHostConfig</strong>. If not specified the default value of
- <code>_default_</code> will be used. Provided values are always converted
- to lower case.</p>
- </attribute>
-
<attribute name="discardFacades" required="false">
<p>A boolean value which can be used to enable or disable the recycling
of the facade objects that isolate the container internal request
@@ -159,11 +134,10 @@
<code>true</code> will be used.</p>
</attribute>
- <attribute name="maxHeaderCount" required="false">
- <p>The maximum number of headers in a request that are allowed by the
- container. A request that contains more headers than the specified limit
- will be rejected. A value of less than 0 means no limit.
- If not specified, a default of 100 is used.</p>
+ <attribute name="maxCookieCount" required="false">
+ <p>The maximum number of cookies that are permitted for a request. A value
+ of less than zero means no limit. If not specified, a default value of 200
+ will be used.</p>
</attribute>
<attribute name="maxParameterCount" required="false">
@@ -450,6 +424,31 @@
</p>
</attribute>
+ <attribute name="continueResponseTiming" required="false">
+ <p>When to respond with a <code>100</code> intermediate response code to a
+ request containing an <code>Expect: 100-continue</code> header.
+ The following values may used:
+ <ul>
+ <li><code>immediately</code> - an intermediate 100 status response
+ will be returned as soon as practical</li>
+ <li><code>onRead</code> - an intermediate 100 status
+ response will be returned only when the Servlet reads the request body,
+ allowing the servlet to inspect the headers and possibly respond
+ before the user agent sends a possibly large request body.</li>
+ </ul>
+ </p>
+ </attribute>
+
+ <attribute name="defaultSSLHostConfigName" required="false">
+ <p>The name of the default <strong>SSLHostConfig</strong> that will be
+ used for secure connections (if this connector is configured for secure
+ connections) if the client connection does not provide SNI or if the SNI
+ is provided but does not match any configured
+ <strong>SSLHostConfig</strong>. If not specified the default value of
+ <code>_default_</code> will be used. Provided values are always converted
+ to lower case.</p>
+ </attribute>
+
<attribute name="disableUploadTimeout" required="false">
<p>This flag allows the servlet container to use a different, usually
longer connection timeout during data upload. If not specified, this
@@ -495,18 +494,19 @@
maxConnections feature and connections will not be counted.</p>
</attribute>
- <attribute name="maxCookieCount" required="false">
- <p>The maximum number of cookies that are permitted for a request. A value
- of less than zero means no limit. If not specified, a default value of 200
- will be used.</p>
- </attribute>
-
<attribute name="maxExtensionSize" required="false">
<p>Limits the total length of chunk extensions in chunked HTTP requests.
If the value is <code>-1</code>, no limit will be imposed. If not
specified, the default value of <code>8192</code> will be used.</p>
</attribute>
+ <attribute name="maxHeaderCount" required="false">
+ <p>The maximum number of headers in a request that are allowed by the
+ container. A request that contains more headers than the specified limit
+ will be rejected. A value of less than 0 means no limit.
+ If not specified, a default of 100 is used.</p>
+ </attribute>
+
<attribute name="maxHttpHeaderSize" required="false">
<p>The maximum size of the request and response HTTP header, specified
in bytes. If not specified, this attribute is set to 8192 (8 KB).</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org