6571950: SSLSocket(raddr, rport, laddr, lport) allows null as laddr that spec doesn't reflect
Summary: add the description that while the local address parameter is null, anyLocalAddress will be used instead.
Reviewed-by: weijun
--- a/jdk/src/share/classes/java/net/Socket.java Fri Apr 11 03:43:18 2008 -0400
+++ b/jdk/src/share/classes/java/net/Socket.java Fri Apr 11 03:50:37 2008 -0400
@@ -1,5 +1,5 @@
/*
- * Copyright 1995-2007 Sun Microsystems, Inc. All Rights Reserved.
+ * Copyright 1995-2008 Sun Microsystems, Inc. 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
@@ -253,7 +253,8 @@
*
* @param host the name of the remote host, or <code>null</code> for the loopback address.
* @param port the remote port
- * @param localAddr the local address the socket is bound to
+ * @param localAddr the local address the socket is bound to, or
+ * <code>null</code> for the <code>anyLocal</code> address.
* @param localPort the local port the socket is bound to, or
* <code>zero</code> for a system selected free port.
* @exception IOException if an I/O error occurs when creating the socket.
--- a/jdk/src/share/classes/javax/net/ssl/SSLSocket.java Fri Apr 11 03:43:18 2008 -0400
+++ b/jdk/src/share/classes/javax/net/ssl/SSLSocket.java Fri Apr 11 03:50:37 2008 -0400
@@ -1,5 +1,5 @@
/*
- * Copyright 1997-2007 Sun Microsystems, Inc. All Rights Reserved.
+ * Copyright 1997-2008 Sun Microsystems, Inc. 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
@@ -212,8 +212,10 @@
* @param host name of the host with which to connect, or
* <code>null</code> for the loopback address.
* @param port number of the server's port
- * @param clientAddress the client's host
- * @param clientPort number of the client's port
+ * @param clientAddress the client's address the socket is bound to, or
+ * <code>null</code> for the <code>anyLocal</code> address.
+ * @param clientPort the client's port the socket is bound to, or
+ * <code>zero</code> for a system selected free port.
* @throws IOException if an I/O error occurs when creating the socket
* @throws SecurityException if a security manager exists and its
* <code>checkConnect</code> method doesn't allow the operation.
@@ -241,8 +243,10 @@
*
* @param address the server's host
* @param port its port
- * @param clientAddress the client's host
- * @param clientPort number of the client's port
+ * @param clientAddress the client's address the socket is bound to, or
+ * <code>null</code> for the <code>anyLocal</code> address.
+ * @param clientPort the client's port the socket is bound to, or
+ * <code>zero</code> for a system selected free port.
* @throws IOException if an I/O error occurs when creating the socket
* @throws SecurityException if a security manager exists and its
* <code>checkConnect</code> method doesn't allow the operation.