Define PPB_Flash_TCPSocket and PPB_Flash_SSLSocket.

TEST=None
BUG=None

Review URL: http://codereview.chromium.org/7191005

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@91150 0039d316-1c4b-4281-b951-d872f2087c98

2 files changed, 89 insertions, 6 deletions

diff --git a/ppapi/c/private/ppb_flash_net_connector.h b/ppapi/c/private/ppb_flash_net_connector.h
index 2cc25bb..188dbef 100644
--- a/ppapi/c/private/ppb_flash_net_connector.h
+++ b/ppapi/c/private/ppb_flash_net_connector.h
@@ -9,15 +9,10 @@
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/private/ppb_flash_file.h"  // For |PP_FileHandle|.
+#include "ppapi/c/private/ppb_flash_tcp_socket.h"
 
 #define PPB_FLASH_NETCONNECTOR_INTERFACE "PPB_Flash_NetConnector;0.1"
 
-// This is an opaque type holding a network address.
-struct PP_Flash_NetAddress {
-  uint32_t size;
-  char data[128];
-};
-
 struct PPB_Flash_NetConnector {
   PP_Resource (*Create)(PP_Instance instance_id);
   PP_Bool (*IsFlashNetConnector)(PP_Resource resource_id);
diff --git a/ppapi/c/private/ppb_flash_tcp_socket.h b/ppapi/c/private/ppb_flash_tcp_socket.h
new file mode 100644
index 0000000..6577631
--- /dev/null
+++ b/ppapi/c/private/ppb_flash_tcp_socket.h
@@ -0,0 +1,88 @@
+// Copyright (c) 2011 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.
+
+#ifndef PPAPI_C_PRIVATE_PPB_FLASH_TCP_SOCKET_H_
+#define PPAPI_C_PRIVATE_PPB_FLASH_TCP_SOCKET_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_completion_callback.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_stdint.h"
+
+// This is an opaque type holding a network address.
+struct PP_Flash_NetAddress {
+  uint32_t size;
+  char data[128];
+};
+
+#define PPB_FLASH_TCPSOCKET_INTERFACE "PPB_Flash_TCPSocket;0.1"
+
+struct PPB_Flash_TCPSocket {
+  PP_Resource (*Create)(PP_Instance instance);
+
+  PP_Bool (*IsFlashTCPSocket)(PP_Resource resource);
+
+  // Connects to a TCP port given as a host-port pair.
+  int32_t (*Connect)(PP_Resource tcp_socket,
+                     const char* host,
+                     uint16_t port,
+                     struct PP_CompletionCallback callback);
+
+  // Same as Connect(), but connecting to the address given by |addr|. A typical
+  // use-case would be for reconnections.
+  int32_t (*ConnectWithNetAddress)(PP_Resource tcp_socket,
+                                   const struct PP_Flash_NetAddress* addr,
+                                   struct PP_CompletionCallback callback);
+
+  // Gets the local address of the socket, if it has been connected.
+  // Returns PP_TRUE on success.
+  PP_Bool (*GetLocalAddress)(PP_Resource tcp_socket,
+                             struct PP_Flash_NetAddress* local_addr);
+
+  // Gets the remote address of the socket, if it has been connected.
+  // Returns PP_TRUE on success.
+  PP_Bool (*GetRemoteAddress)(PP_Resource tcp_socket,
+                              struct PP_Flash_NetAddress* remote_addr);
+
+  // Does SSL handshake and moves to sending and receiving encrypted data. The
+  // socket must have been successfully connected. |server_name| will be
+  // compared with the name(s) in the server's certificate during the SSL
+  // handshake.
+  int32_t (*InitiateSSL)(PP_Resource tcp_socket,
+                         const char* server_name,
+                         struct PP_CompletionCallback callback);
+
+  // Reads data from the socket. The size of |buffer| must be at least as large
+  // as |bytes_to_read|. May perform a partial read. Returns the number of bytes
+  // read or an error code. If the return value is 0, then it indicates that
+  // end-of-file was reached.
+  // This method won't return more than 1 megabyte, so if |bytes_to_read|
+  // exceeds 1 megabyte, it will always perform a partial read.
+  // Multiple outstanding read requests are not supported.
+  int32_t (*Read)(PP_Resource tcp_socket,
+                  char* buffer,
+                  int32_t bytes_to_read,
+                  struct PP_CompletionCallback callback);
+
+  // Writes data to the socket. May perform a partial write. Returns the number
+  // of bytes written or an error code.
+  // This method won't write more than 1 megabyte, so if |bytes_to_write|
+  // exceeds 1 megabyte, it will always perform a partial write.
+  // Multiple outstanding write requests are not supported.
+  int32_t (*Write)(PP_Resource tcp_socket,
+                   const char* buffer,
+                   int32_t bytes_to_write,
+                   struct PP_CompletionCallback callback);
+
+  // Cancels any IO that may be pending, and disconnects the socket. Any pending
+  // callbacks will still run, reporting PP_Error_Aborted if pending IO was
+  // interrupted. It is NOT valid to call Connect() again after a call to this
+  // method. Note: If the socket is destroyed when it is still connected, then
+  // it will be implicitly disconnected, so you are not required to call this
+  // method.
+  void (*Disconnect)(PP_Resource tcp_socket);
+};
+
+#endif  // PPAPI_C_PRIVATE_PPB_FLASH_TCP_SOCKET_H_