Implement chrome.socket.bind/listen/accept for TCP server socket.

chrome/common/extensions/api/socket.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 namespace socket {
   enum SocketType {
     tcp,
     udp
   };
 
   // The socket options.
   dictionary CreateOptions {
   };
 
   dictionary CreateInfo {
     // The id of the newly created socket.
     long socketId;
   };
 
   callback CreateCallback = void (CreateInfo createInfo);
 
   callback ConnectCallback = void (long result);
 
   callback BindCallback = void (long result);
 
+  callback ListenCallback = void (long result);
+
+  dictionary AcceptInfo {
+    long resultCode;
+    // The id of the accepted socket.
+    long? socketId;
+  };
+
+  callback AcceptCallback = void (AcceptInfo acceptInfo);
+
   dictionary ReadInfo {
     // The resultCode returned from the underlying read() call.
     long resultCode;
 
     ArrayBuffer data;
   };
 
   callback ReadCallback = void (ReadInfo readInfo);
 
   dictionary WriteInfo {
@@ skipping 144 matching lines @@
     // |address| : The address of the remote machine.
     // |port| : The port of the remote machine.
     // |callback| : Called when the send operation completes without blocking
     // or an error occurs.
     static void sendTo(long socketId,
                        ArrayBuffer data,
                        DOMString address,
                        long port,
                        SendToCallback callback);
 
+    // This method applies to TCP sockets only.

[Mihai Parparita -not on Chrome, 2012/09/26 21:50:33]

The documentation strings for these two methods should mention the experimental
permission requirement.

[justinlin, 2012/09/26 23:03:57]

Done.

+    // Listens for connections on the specified port and address. This
+    // effectively makes this a server socket, and client socket
+    // functions (connect, read, write) can no longer be used on this socket.
+    // |socketId| : The socketId.
+    // |address| : The address of the local machine.
+    // |port| : The port of the local machine.
+    // |backlog| : Length of the socket's listen queue.
+    static void listen(long socketId,
+                       DOMString address,
+                       long port,
+                       optional long backlog,
+                       ListenCallback callback);
+
+    // This method applies to TCP sockets only.
+    // Registers a callback function to be called when a connection is
+    // accepted on this listening server socket. Listen must be called first.
+    // If there is already an active accept callback, this callback will be
+    // invoked immediately with an error as the resultCode.
+    // |socketId| : The socketId.
+    // |callback| : The callback is invoked when a new socket is accepted.
+    static void accept(long socketId,
+                       AcceptCallback callback);
+
     // Enables or disables the keep-alive functionality for a TCP connection.
     // |socketId| : The socketId.
     // |enable| : If true, enable keep-alive functionality.
     // |delay| : Set the delay seconds between the last data packet received
     // and the first keepalive probe. Default is 0.
     // |callback| : Called when the setKeepAlive attempt is complete.
     static void setKeepAlive(long socketId,
                              boolean enable,
                              optional long delay,
                              SetKeepAliveCallback callback);
@@ skipping 12 matching lines @@
     // |callback| : Called when the state is available.
     static void getInfo(long socketId,
                         GetInfoCallback callback);
 
     // Retrieves information about local adapters on this system.
     // |callback| : Called when local adapter information is available.
     static void getNetworkList(GetNetworkCallback callback);
   };
 
 };