Add TCP socket mojo interfaces

mojo/services/public/interfaces/network/tcp_bound_socket.mojom

+// Copyright 2014 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.
+
+import "mojo/services/public/interfaces/network/net_address.mojom"
+import "mojo/services/public/interfaces/network/network_error.mojom"
+import "mojo/services/public/interfaces/network/tcp_client_socket.mojom"
+import "mojo/services/public/interfaces/network/tcp_server_socket.mojom"
+
+module mojo {
+
+// Represents a TCP socket that is bound to a local address and port, but
+// is not yet in a listening or connected state.
+//
+// A bound socket can be used to create a server socket listening on the
+// local address, or it can be used to create a client socket by connecting to
+// a remote host.
+interface TCPBoundSocket {
+  // Puts the socket into server mode, awaiting incoming connections.
+  //
+  // Once this function is called, neither StartListening nor Connect can be
+  // used on this socket again.
+  StartListening(TCPServerSocket& server);

[wtc, 2014/10/03 22:37:43]

Should we expose the 'backlog' input parameter of the listen() BSD socket
function?

http://pubs.opengroup.org/onlinepubs/7908799/xns/listen.html

[brettw, 2014/10/03 22:54:44]

Yes, a previous patch had this but this caused the code review to go off into
places I didn't want to go, so I just removed it and will hardcode it to 2 or
something until we feel like designing a system for doing options.

+
+  // Puts this socket into client mode by connecting to a remote host. If you
+  // do not care about the local address or port, you can call
+  // NetworkService.CreateTCPClientSocket to connect directly and skip the
+  // "bound" state.
+  //
+  // Once this function is called, neither StartListening nor Connect can be
+  // used on this socket again.
+  Connect(NetAddress remote_address,
+          handle<data_pipe_consumer> send_stream,
+          handle<data_pipe_producer> receive_stream,
+          TCPClientSocket& client_socket)
+      => (NetworkError result);
+};
+
+}