18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.jdi.connect;
  27 
  28 import java.util.Map;
  29 import java.io.IOException;
  30 import com.sun.jdi.VirtualMachine;
  31 
  32 /**
  33  * A connector which listens for a connection initiated by a target VM.
  34  *
  35  * @author Gordon Hirsch
  36  * @since  1.3
  37  */

  38 public interface ListeningConnector extends Connector {
  39     /**
  40      * Indicates whether this listening connector supports multiple
  41      * connections for a single argument map. If so, a call to
  42      * {@link #startListening} may allow
  43      * multiple target VM to become connected.
  44      *
  45      * @return <code>true</code> if multiple connections are supported;
  46      * <code>false</code> otherwise.
  47      */
  48     boolean supportsMultipleConnections();
  49 
  50     /**
  51      * Listens for one or more connections initiated by target VMs.
  52      * The connector uses the given argument map
  53      * in determining the address at which to listen or else it generates
  54      * an appropriate listen address. In either case, an address string
  55      * is returned from this method which can be used in starting target VMs
  56      * to identify this connector. The format of the address string
  57      * is connector, transport, and, possibly, platform dependent.

  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.jdi.connect;
  27 
  28 import java.util.Map;
  29 import java.io.IOException;
  30 import com.sun.jdi.VirtualMachine;
  31 
  32 /**
  33  * A connector which listens for a connection initiated by a target VM.
  34  *
  35  * @author Gordon Hirsch
  36  * @since  1.3
  37  */
  38 @jdk.Supported
  39 public interface ListeningConnector extends Connector {
  40     /**
  41      * Indicates whether this listening connector supports multiple
  42      * connections for a single argument map. If so, a call to
  43      * {@link #startListening} may allow
  44      * multiple target VM to become connected.
  45      *
  46      * @return <code>true</code> if multiple connections are supported;
  47      * <code>false</code> otherwise.
  48      */
  49     boolean supportsMultipleConnections();
  50 
  51     /**
  52      * Listens for one or more connections initiated by target VMs.
  53      * The connector uses the given argument map
  54      * in determining the address at which to listen or else it generates
  55      * an appropriate listen address. In either case, an address string
  56      * is returned from this method which can be used in starting target VMs
  57      * to identify this connector. The format of the address string
  58      * is connector, transport, and, possibly, platform dependent.