src/java.base/share/classes/java/nio/channels/ServerSocketChannel.java
branchunixdomainchannels
changeset 59076 998df1368cca
parent 59074 7917f95f74c4
child 59078 4e648a2d8480
--- a/src/java.base/share/classes/java/nio/channels/ServerSocketChannel.java	Thu Nov 14 09:06:10 2019 +0000
+++ b/src/java.base/share/classes/java/nio/channels/ServerSocketChannel.java	Thu Nov 14 10:16:28 2019 +0000
@@ -218,16 +218,19 @@
      * <p> Note, for <i>Unix Domain</i> channels, a file is created in the file-system
      * with the same path name as this channel's bound {@link UnixDomainSocketAddress}.
      * This file persists after the channel is closed, and must be removed before
-     * another channel can bind to the same name.
+     * another channel can bind to the same name. Also, <i>Unix Domain</i> ServerSocketChannels
+     * must be bound to an explicit address. 
      *
      * @param   local
-     *          The address to bind the socket, or {@code null} to bind to an
-     *          automatically assigned socket address
+     *          The address to bind the socket, or {@code null} to bind an <i>IP</i> channel to
+     *          an automatically assigned socket address
      * @param   backlog
      *          The maximum number of pending connections
      *
      * @return  This channel
      *
+     * @throws  BindException
+     *          If this is a <i>Unix domain</i> channel and {@code local} is {@code null}
      * @throws  AlreadyBoundException
      *          If the socket is already bound
      * @throws  UnsupportedAddressTypeException