8255758: JEP 380 spec clarifications

Reviewed-by: dfuchs, alanb
This commit is contained in:
Michael McMahon 2020-11-17 12:12:08 +00:00
parent 3dcde557f7
commit 9d0ee66f2d
3 changed files with 70 additions and 6 deletions

View file

@ -252,7 +252,11 @@ public abstract class ServerSocketChannel
* Each platform enforces an implementation specific, maximum length for the
* name of a <i>Unix Domain</i> socket. This limitation is enforced when a
* channel is bound. The maximum length is typically close to and generally
* not less than 100 bytes.
* not less than 100 bytes. This limitation also applies to <i>automatically</i>
* bound server socket channels. See the <i>Unix domain</i>
* <a href="../../net/doc-files/net-properties.html#Unixdomain">networking
* properties</a> that can be used to select the temporary directory where
* these sockets are created.
*
* @param local
* The address to bind the socket, or {@code null} to bind to
@ -348,9 +352,12 @@ public abstract class ServerSocketChannel
* If this channel's socket has not yet been bound
*
* @throws SecurityException
* If a security manager has been installed
* and it does not permit access to the remote endpoint
* of the new connection
* If a security manager has been installed and this
* channel is bound to an {@link InetSocketAddress}
* and the security manager denies access to the remote endpoint
* of the new connection, or if this channel is bound to a
* {@link UnixDomainSocketAddress} and the security manager
* denies {@link NetPermission}{@code ("accessUnixDomainSocket")}
*
* @throws IOException
* If some other I/O error occurs