2005-08-07 Ito Kazumitsu <kaz@maczuka.gcd.org>

       Fixes bug #22929
       * libraries/javalib/java/net/NetworkInterface.java
       (condense): New static private method.
       (getNetworkInterfaces): Call condense().
       (getByName, getByInetAddress): Call getNetworkInterfaces()
       so that condensed result may be returned.

       * vm/reference/java/net/VMNetworkInterface.java (getInterfaces):
       Clarify return value in documentation.

1 files changed, 10 insertions, 0 deletions

diff --git a/vm/reference/java/net/VMNetworkInterface.java b/vm/reference/java/net/VMNetworkInterface.java
index af71ce294..d63de8452 100644
--- a/vm/reference/java/net/VMNetworkInterface.java
+++ b/vm/reference/java/net/VMNetworkInterface.java
@@ -61,6 +61,16 @@ final class VMNetworkInterface
 	System.loadLibrary("javanet");
     }
 
+  /**
+   * Returns a Vector of InetAddresses. The returned value will be
+   * 'condensed', meaning that all elements with the same interface
+   * name will be collapesed into one InetAddress for that name
+   * containing all addresses before the returning the result to the
+   * user. This means the native method can be implemented in a naive
+   * way mapping each address/interface to a name even if that means
+   * that the Vector contains multiple InetAddresses with the same
+   * interface name.
+   */
   public static native Vector getInterfaces()
     throws SocketException;
 }