Index: sdk/lib/io/secure_server_socket.dart |
diff --git a/sdk/lib/io/secure_server_socket.dart b/sdk/lib/io/secure_server_socket.dart |
index 851b58d3a7a3c6d89a6f31d1e9a95c4101a80aec..5300b314c3ced7d6b8b1a57a55147c467b00fe25 100644 |
--- a/sdk/lib/io/secure_server_socket.dart |
+++ b/sdk/lib/io/secure_server_socket.dart |
@@ -20,12 +20,25 @@ class SecureServerSocket extends Stream<SecureSocket> implements ServerSocket { |
* 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]. |
@@ -47,17 +60,17 @@ class SecureServerSocket extends Stream<SecureSocket> implements ServerSocket { |
* 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)); |
@@ -118,12 +131,25 @@ class RawSecureServerSocket extends Stream<RawSecureSocket> { |
* 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 [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. |
* |
- * If [backlog] has the value of [:0:] a reasonable value will be |
- * chosen by the system. |
+ * 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]. |
@@ -146,11 +172,11 @@ class RawSecureServerSocket extends Stream<RawSecureSocket> { |
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, |