This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch 8.5.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/8.5.x by this push:
new c72f44a Expand the documentation for the address attribute for AJP
c72f44a is described below
commit c72f44a3836cc9e8f29407e4add8603c6c2f17f2
Author: Mark Thomas <[email protected]>
AuthorDate: Thu Mar 5 08:58:59 2020 +0000
Expand the documentation for the address attribute for AJP
---
webapps/docs/changelog.xml | 10 ++++++++++
webapps/docs/config/ajp.xml | 20 +++++++++++++++++---
webapps/docs/config/http.xml | 2 +-
3 files changed, 28 insertions(+), 4 deletions(-)
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 3f46d73..7176753 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -156,6 +156,16 @@
</fix>
</changelog>
</subsection>
+ <subsection name="Web applications">
+ <changelog>
+ <add>
+ Expand the documentation for the <code>address</code> attribute of the
+ AJP Connector and document that the AJP Connector also supports the
+ <code>ipv6v6only</code> attribute with the APR/Native implementaiton.
+ (markt)
+ </add>
+ </changelog>
+ </subsection>
<subsection name="Other">
<changelog>
<add>
diff --git a/webapps/docs/config/ajp.xml b/webapps/docs/config/ajp.xml
index 4cdb371..9968482 100644
--- a/webapps/docs/config/ajp.xml
+++ b/webapps/docs/config/ajp.xml
@@ -321,9 +321,16 @@
</attribute>
<attribute name="address" required="false">
- <p>For servers with more than one IP address, this attribute
- specifies which address will be used for listening on the specified
- port. By default, the loopback address will be used.</p>
+ <p>For servers with more than one IP address, this attribute specifies
+ which address will be used for listening on the specified port. By
+ default, the connector will listen on the loopback address. Unless the
JVM
+ is configured otherwise using system properties, the Java based
connectors
+ (NIO, NIO2) will listen on both IPv4 and IPv6 addresses when configured
+ with either <code>0.0.0.0</code> or <code>::</code>. The APR/native
+ connector will only listen on IPv4 addresses if configured with
+ <code>0.0.0.0</code> and will listen on IPv6 addresses (and optionally
+ IPv4 addresses depending on the setting of <strong>ipv6v6only</strong>)
if
+ configured with <code>::</code>.</p>
</attribute>
<attribute name="allowedRequestAttributesPattern" required="false">
@@ -787,6 +794,13 @@
addition to the common Connector and AJP attributes listed above.</p>
<attributes>
+ <attribute name="ipv6v6only" required="false">
+ <p>If listening on an IPv6 address on a dual stack system, should the
+ connector only listen on the IPv6 address? If not specified the default
+ is <code>false</code> and the connector will listen on the IPv6 address
+ and the equivalent IPv4 address if present.</p>
+ </attribute>
+
<attribute name="pollTime" required="false">
<p>Duration of a poll call in microseconds. Lowering this value will
slightly decrease latency of connections being kept alive in some cases
diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml
index 1f9c23a..cbb5838 100644
--- a/webapps/docs/config/http.xml
+++ b/webapps/docs/config/http.xml
@@ -338,7 +338,7 @@
with either <code>0.0.0.0</code> or <code>::</code>. The APR/native
connector will only listen on IPv4 addresses if configured with
<code>0.0.0.0</code> and will listen on IPv6 addresses (and optionally
- IPv4 addresses depending on the setting of <strong>ipv6onlyv6</strong>)
if
+ IPv4 addresses depending on the setting of <strong>ipv6v6only</strong>)
if
configured with <code>::</code>.</p>
</attribute>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
