8323089: networkaddress.cache.ttl is not a system property

GoeLin · GoeLin · commit 07069506ce76 · 2026-04-22T07:18:03.000Z
Reviewed-by: mdoerr
Backport-of: efa071dd06deca6f49a22ddde02d13401e583a46
diff --git a/src/java.base/share/classes/java/net/InetAddress.java b/src/java.base/share/classes/java/net/InetAddress.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2023, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -165,8 +165,8 @@
  * caching. Likewise, a system admin can configure a different
  * negative caching TTL value when needed.
  *
- * <p> Two Java security properties control the TTL values used for
- *  positive and negative host name resolution caching:
+ * <p> Two Java {@linkplain java.security.Security security} properties control
+ *  the TTL values used for positive and negative host name resolution caching:
  *
  * <dl style="margin-left:2em">
  * <dt><b>networkaddress.cache.ttl</b></dt>
diff --git a/src/java.base/share/classes/java/net/doc-files/net-properties.html b/src/java.base/share/classes/java/net/doc-files/net-properties.html
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML>
 <!--
- Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
+ Copyright (c) 1998, 2024, Oracle and/or its affiliates. All rights reserved.
  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 
  This code is free software; you can redistribute it and/or modify it
@@ -261,22 +261,22 @@ <H2>Address Cache</H2>
 have to access the naming service. These properties allow for some
 tuning on how the cache is operating.</P>
 <UL>
-	<LI><P><B>{@systemProperty networkaddress.cache.ttl}</B> (default: see below)<BR>
+	<LI><P><B>{@code networkaddress.cache.ttl}</B> (default: see below)<BR>
 	Value is an integer corresponding to the number of seconds successful
 	name lookups will be kept in the cache. A value of -1, or any other
 	negative value for that matter,	indicates a &ldquo;cache forever&rdquo;
 	policy, while a value of 0 (zero) means no caching. The default value
 	is -1 (forever) if a security manager is installed, and implementation-specific
 	when no security manager is installed.</P>
-	<LI><P><B>{@systemProperty networkaddress.cache.negative.ttl}</B> (default: {@code 10})<BR>
+	<LI><P><B>{@code networkaddress.cache.negative.ttl}</B> (default: {@code 10})<BR>
 	Value is an integer corresponding to the number of seconds an
 	unsuccessful name lookup will be kept in the cache. A value of -1,
 	or any negative value, means &ldquo;cache forever&rdquo;, while a
 	value of 0 (zero) means no caching.</P>
 </UL>
 <P>Since these 2 properties are part of the security policy, they are
 not set by either the -D option or the {@code System.setProperty()} API,
-instead they are set as security properties.</P>
+instead they are set as {@linkplain java.security.Security security} properties.</P>
 <a id="Unixdomain"></a>
 <H2>Unix domain sockets</H2>
 <p>

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/*`
`2`		`- * Copyright (c) 1995, 2023, Oracle and/or its affiliates. All rights reserved.`
	`2`	`+ * Copyright (c) 1995, 2024, Oracle and/or its affiliates. All rights reserved.`
`3`	`3`	`* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.`
`4`	`4`	`*`
`5`	`5`	`* This code is free software; you can redistribute it and/or modify it`
`@@ -165,8 +165,8 @@`
`165`	`165`	`* caching. Likewise, a system admin can configure a different`
`166`	`166`	`* negative caching TTL value when needed.`
`167`	`167`	`*`
`168`		`- * <p> Two Java security properties control the TTL values used for`
`169`		`- * positive and negative host name resolution caching:`
	`168`	`+ * <p> Two Java {@linkplain java.security.Security security} properties control`
	`169`	`+ * the TTL values used for positive and negative host name resolution caching:`
`170`	`170`	`*`
`171`	`171`	`* <dl style="margin-left:2em">`
`172`	`172`	`* <dt><b>networkaddress.cache.ttl</b></dt>`