8373704: Improve "SocketException: Protocol family unavailable" message

MBaesken · MBaesken · commit 8839f6c228c5 · 2026-01-29T15:23:49.000Z
Backport-of: 163038222a371c07aff8bce50eee55bb389104d0
diff --git a/src/java.base/unix/native/libnet/net_util_md.c b/src/java.base/unix/native/libnet/net_util_md.c
@@ -282,7 +282,7 @@ NET_InetAddressToSockaddr(JNIEnv *env, jobject iaObj, int port,
     } else {
         jint address;
         if (family != java_net_InetAddress_IPv4) {
-            JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "Protocol family unavailable");
+            JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "IPv6 protocol family unavailable");
             return -1;
         }
         address = getInetAddress_addr(env, iaObj);
diff --git a/src/java.base/windows/native/libnet/net_util_md.c b/src/java.base/windows/native/libnet/net_util_md.c
@@ -513,7 +513,7 @@ NET_InetAddressToSockaddr(JNIEnv *env, jobject iaObj, int port,
     } else {
         jint address;
         if (family != java_net_InetAddress_IPv4) {
-            JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "Protocol family unavailable");
+            JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "IPv6 protocol family unavailable");
             return -1;
         }
         address = getInetAddress_addr(env, iaObj);

Original file line number	Diff line number	Diff line change
`@@ -282,7 +282,7 @@ NET_InetAddressToSockaddr(JNIEnv *env, jobject iaObj, int port,`
`282`	`282`	`} else {`
`283`	`283`	`jint address;`
`284`	`284`	`if (family != java_net_InetAddress_IPv4) {`
`285`		`- JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "Protocol family unavailable");`
	`285`	`+ JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "IPv6 protocol family unavailable");`
`286`	`286`	`return -1;`
`287`	`287`	`}`
`288`	`288`	`address = getInetAddress_addr(env, iaObj);`
Original file line number	Diff line number	Diff line change
`@@ -513,7 +513,7 @@ NET_InetAddressToSockaddr(JNIEnv *env, jobject iaObj, int port,`
`513`	`513`	`} else {`
`514`	`514`	`jint address;`
`515`	`515`	`if (family != java_net_InetAddress_IPv4) {`
`516`		`- JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "Protocol family unavailable");`
	`516`	`+ JNU_ThrowByName(env, JNU_JAVANETPKG "SocketException", "IPv6 protocol family unavailable");`
`517`	`517`	`return -1;`
`518`	`518`	`}`
`519`	`519`	`address = getInetAddress_addr(env, iaObj);`