Change the signature for all network bind calls.

sdk/lib/io/secure_server_socket.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * The [SecureServerSocket] is a server socket, providing a stream of high-level
  * [Socket]s.
  *
  * See [SecureSocket] for more info.
  */
 class SecureServerSocket extends Stream<SecureSocket> implements ServerSocket {
   final RawSecureServerSocket _socket;
 
   SecureServerSocket._(RawSecureServerSocket this._socket);
 
   /**
    * Returns a future for a [SecureServerSocket]. When the future
    * completes the server socket is bound to the given [address] and
    * [port] and has started listening on it.
    *
-   * If [port] has the value [:0:] (the default) an ephemeral port will
-   * be chosen by the system. The actual port used can be retrieved
-   * using the [port] getter.
+   * The [address] can either be a [String] or an
+   * [InternetAddress]. If [address] is a [String], [bind] will
+   * perform a [InternetAddress.lookup] and use the first value in the
+   * list. To listen on the loopback adapter, which will allow only
+   * incoming connections from the local host, use the value
+   * [InternetAddress.LOOPBACK_IP_V4] or
+   * [InternetAddress.LOOPBACK_IP_V6]. To allow for incoming
+   * connection from the network use either one of the values
+   * [InternetAddress.ANY_IP_V4] or [InternetAddress.ANY_IP_V6] to
+   * bind to all interfaces or the IP address of a specific interface.
    *
-   * If [backlog] has the value of [:0:] a reasonable value will be
-   * chosen by the system.
+   * If [port] has the value [:0:] an ephemeral port will be chosen by
+   * the system. The actual port used can be retrieved using the
+   * [port] getter.
+   *
+   * The optional argument [backlog] can be used to specify the listen
+   * backlog for the underlying OS listen setup. If [backlog] has the
+   * value of [:0:] (the default) a reasonable value will be chosen by
+   * the system.
    *
    * Incoming client connections are promoted to secure connections, using
    * the server certificate given by [certificateName].
    *
    * [address] must be given as a numeric address, not a host name.
    *
    * [certificateName] is the nickname or the distinguished name (DN) of
    * the certificate in the certificate database. It is looked up in the
    * NSS certificate database set by SecureSocket.setCertificateDatabase.
    * If [certificateName] contains "CN=", it is assumed to be a distinguished
    * name.  Otherwise, it is looked up as a nickname.
    *
    * To request or require that clients authenticate by providing an SSL (TLS)
    * client certificate, set the optional parameter [requestClientCertificate]
    * or [requireClientCertificate] to true.  Requiring a certificate implies
    * requesting a certificate, so one doesn't need to set both to true.
    * To check whether a client certificate was received, check
    * SecureSocket.peerCertificate after connecting.  If no certificate
    * was received, the result will be null.
    */
   static Future<SecureServerSocket> bind(
-      String address,
+      address,
       int port,
-      int backlog,
       String certificateName,
-      {bool requestClientCertificate: false,
+      {int backlog: 0,
+       bool requestClientCertificate: false,
        bool requireClientCertificate: false}) {
     return RawSecureServerSocket.bind(
         address,
         port,
-        backlog,
         certificateName,
+        backlog: backlog,
         requestClientCertificate: requestClientCertificate,
         requireClientCertificate: requireClientCertificate).then(
             (serverSocket) => new SecureServerSocket._(serverSocket));
   }
 
   StreamSubscription<SecureSocket> listen(void onData(SecureSocket socket),
                                           {void onError(error),
                                            void onDone(),
                                            bool cancelOnError}) {
     return _socket.map((rawSocket) => new SecureSocket._(rawSocket))
@@ skipping 40 matching lines @@
         onPause: _onPauseStateChange,
         onResume: _onPauseStateChange,
         onCancel: _onSubscriptionStateChange);
   }
 
   /**
    * Returns a future for a [RawSecureServerSocket]. When the future
    * completes the server socket is bound to the given [address] and
    * [port] and has started listening on it.
    *
-   * If [port] has the value [:0:] (the default) an ephemeral port will
-   * be chosen by the system. The actual port used can be retrieved
-   * using the [port] getter.
+   * The [address] can either be a [String] or an
+   * [InternetAddress]. If [address] is a [String], [bind] will
+   * perform a [InternetAddress.lookup] and use the first value in the
+   * list. To listen on the loopback adapter, which will allow only
+   * incoming connections from the local host, use the value
+   * [InternetAddress.LOOPBACK_IP_V4] or
+   * [InternetAddress.LOOPBACK_IP_V6]. To allow for incoming
+   * connection from the network use either one of the values
+   * [InternetAddress.ANY_IP_V4] or [InternetAddress.ANY_IP_V6] to
+   * bind to all interfaces or the IP address of a specific interface.
    *
-   * If [backlog] has the value of [:0:] a reasonable value will be
-   * chosen by the system.
+   * If [port] has the value [:0:] an ephemeral port will be chosen by
+   * the system. The actual port used can be retrieved using the
+   * [port] getter.
+   *
+   * The optional argument [backlog] can be used to specify the listen
+   * backlog for the underlying OS listen setup. If [backlog] has the
+   * value of [:0:] (the default) a reasonable value will be chosen by
+   * the system.
    *
    * Incoming client connections are promoted to secure connections,
    * using the server certificate given by [certificateName].
    *
    * [address] must be given as a numeric address, not a host name.
    *
    * [certificateName] is the nickname or the distinguished name (DN) of
    * the certificate in the certificate database. It is looked up in the
    * NSS certificate database set by SecureSocket.setCertificateDatabase.
    * If [certificateName] contains "CN=", it is assumed to be a distinguished
    * name.  Otherwise, it is looked up as a nickname.
    *
    * To request or require that clients authenticate by providing an SSL (TLS)
    * client certificate, set the optional parameters requestClientCertificate or
    * requireClientCertificate to true.  Require implies request, so one doesn't
    * need to specify both.  To check whether a client certificate was received,
    * check SecureSocket.peerCertificate after connecting.  If no certificate
    * was received, the result will be null.
    */
   static Future<RawSecureServerSocket> bind(
       String address,
       int port,
-      int backlog,
       String certificateName,
-      {bool requestClientCertificate: false,
+      {int backlog: 0,
+       bool requestClientCertificate: false,
        bool requireClientCertificate: false}) {
-    return RawServerSocket.bind(address, port, backlog)
+    return RawServerSocket.bind(address, port, backlog: backlog)
         .then((serverSocket) => new RawSecureServerSocket._(
             serverSocket,
             certificateName,
             requestClientCertificate,
             requireClientCertificate));
   }
 
   StreamSubscription<RawSecureSocket> listen(void onData(RawSecureSocket s),
                                              {void onError(error),
                                               void onDone(),
@@ skipping 64 matching lines @@
       _subscription = _socket.listen(_onData,
                                      onDone: _onDone,
                                      onError: _onError);
     } else {
       close();
     }
   }
 }