Add functionality to pppapi TCPSocket to support secure sockets in flash

ppapi/api/private/ppb_tcp_socket_private.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.
  */
 
 /**
  * This file defines the <code>PPB_TCPSocket_Private</code> interface.
  */
 
 label Chrome {
-  M17 = 0.3
+  M17 = 0.3,
+  M19 = 0.4

[yzshen1, 2012/04/06 19:24:33]

M20?

[raymes, 2012/04/06 23:22:47]

Done.

 };
 
 /**
  * The <code>PPB_TCPSocket_Private</code> interface provides TCP socket
  * operations.
  */
 interface PPB_TCPSocket_Private {
   /**
    * Allocates a TCP socket resource.
    */
@@ skipping 48 matching lines @@
    * SSLHandshake() will fail without starting a handshake. Otherwise, any
    * failure during the handshake process will cause the socket to be
    * disconnected.
    */
   int32_t SSLHandshake([in] PP_Resource tcp_socket,
                        [in] str_t server_name,
                        [in] uint16_t server_port,
                        [in] PP_CompletionCallback callback);
 
   /**
+   * Returns the server's <code>PPB_Flash_X509Certificate</code> for a socket

[yzshen1, 2012/04/06 19:24:33]

Please update the name to PPB_X509Certificate_Private.

[raymes, 2012/04/06 23:22:47]

Done.

+   * connection if an SSL connection has been established using
+   * <code>SSL_Handshake</code>. If no SSL connection has been established, a

[yzshen1, 2012/04/06 19:24:33]

No underscore in the middle.

[raymes, 2012/04/06 23:22:47]

Done.

+   * null resource is returned.
+   */
+  [version=0.4]
+  PP_Resource GetServerCertificate([in] PP_Resource tcp_socket);
+
+  /**
+   * NOTE: This function is not implemented and will return
+   * <code>PP_FALSE</code>.
+   * Add a trusted/untrusted chain building certificate to be used for this

[yzshen1, 2012/04/06 19:24:33]

Add -> Adds.

[raymes, 2012/04/06 23:22:47]

Done.

+   * connection. The <code>PP_Resource</code> must be a

[yzshen1, 2012/04/06 19:24:33]

PP_Resource -> certificate, please.

[raymes, 2012/04/06 23:22:47]

Done.

+   * <code>PPB_Flash_X509Certificate<code>. <code>PP_TRUE</code> is returned

[yzshen1, 2012/04/06 19:24:33]

Please update the name to PPB_X509Certificate_Private.

[raymes, 2012/04/06 23:22:47]

Done.

+   * upon success.
+   */
+  [version=0.4]
+  PP_Bool AddChainBuildingCertificate([in] PP_Resource tcp_socket,
+                                      [in] PP_Resource certificate,
+                                      [in] PP_Bool is_trusted);
+
+  /**
    * 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([in] PP_Resource tcp_socket,
                [out] str_t buffer,
@@ skipping 15 matching lines @@
   /**
    * 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([in] PP_Resource tcp_socket);
 };