From 2a929b864dee92bbfdad3a2da72be9aa1cd70379 Mon Sep 17 00:00:00 2001
From: michaelm <unknown>
Date: Mon, 30 Jul 2012 22:32:59 +0100
Subject: [PATCH] 7120665: Change Java SE spec so that external networking not
 required Reviewed-by: alanb

---
 src/share/classes/java/net/NetworkInterface.java | 6 ++++--
 src/share/classes/java/net/package.html          | 1 +
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/share/classes/java/net/NetworkInterface.java b/src/share/classes/java/net/NetworkInterface.java
index b6cd711bb..aa8e0bcff 100644
--- a/src/share/classes/java/net/NetworkInterface.java
+++ b/src/share/classes/java/net/NetworkInterface.java
@@ -326,8 +326,10 @@ public final class NetworkInterface {
     }
 
     /**
-     * Returns all the interfaces on this machine. Returns null if no
-     * network interfaces could be found on this machine.
+     * Returns all the interfaces on this machine. The {@code Enumeration}
+     * contains at least one element, possibly representing a loopback
+     * interface that only supports communication between entities on
+     * this machine.
      *
      * NOTE: can use getNetworkInterfaces()+getInetAddresses()
      *       to obtain all IP addresses for this node
diff --git a/src/share/classes/java/net/package.html b/src/share/classes/java/net/package.html
index c0146760d..b5bd261be 100644
--- a/src/share/classes/java/net/package.html
+++ b/src/share/classes/java/net/package.html
@@ -65,6 +65,7 @@ Provides the classes for implementing networking applications.
 <p>Sending and receiving with TCP sockets is done through InputStreams and OutputStreams which can be obtained via the {@link java.net.Socket#getInputStream} and {@link java.net.Socket#getOutputStream} methods.</p>
 <h2>Interfaces</h2>
 <p>The {@link java.net.NetworkInterface} class provides APIs to browse and query all the networking interfaces (e.g. ethernet connection or PPP endpoint) of the local machine. It is through that class that you can check if any of the local interfaces is configured to support IPv6.</p>
+<p>Note, all conforming implementations must support at least one {@code NetworkInterface} object, which must either be connected to a network, or be a "loopback" interface that can only communicate with entities on the same machine.</p>
 
 <h2>High level API</h2>
 <p>A number of classes in the java.net package do provide for a much higher level of abstraction and allow for easy access to resources on the network. The classes are:
-- 
GitLab