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 e7462cc Expand the documentation for the address attribute for AJP
e7462cc is described below
commit e7462cc9dedbcc8037715ee57af858eff9e72feb
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Thu Mar 5 08:58:59 2020 +0000
Expand the documentation for the address attribute for AJP
---
webapps/docs/changelog.xml | 6 ++++++
webapps/docs/config/ajp.xml | 20 +++++++++++++++++---
webapps/docs/config/http.xml | 2 +-
3 files changed, 24 insertions(+), 4 deletions(-)
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index a7bf76f..a90c1a9 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -182,6 +182,12 @@
not being used else clients will be unable to connect to the JMX
server.
(markt)
</fix>
+ <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">
diff --git a/webapps/docs/config/ajp.xml b/webapps/docs/config/ajp.xml
index 9a170df..f1405c5 100644
--- a/webapps/docs/config/ajp.xml
+++ b/webapps/docs/config/ajp.xml
@@ -313,9 +313,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">
@@ -786,6 +793,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 b15853d..f952701 100644
--- a/webapps/docs/config/http.xml
+++ b/webapps/docs/config/http.xml
@@ -322,7 +322,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: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
