15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This file defines the <code>PPB_TCPSocket_Private</code> interface. 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)label Chrome { 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) M17 = 0.3, 122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) M20 = 0.4, 132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) M27 = 0.5 142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)[assert_size(4)] 172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum PP_TCPSocketOption_Private { 182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Special value used for testing. Guaranteed to fail SetOption(). 19eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch PP_TCPSOCKETOPTION_PRIVATE_INVALID = 0, 202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Disable coalescing of small writes to make TCP segments, and instead 222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // deliver data immediately. For SSL sockets, this option must be set before 232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // SSLHandshake() is called. Value type is PP_VARTYPE_BOOL. 24eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch PP_TCPSOCKETOPTION_PRIVATE_NO_DELAY = 1 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The <code>PPB_TCPSocket_Private</code> interface provides TCP socket 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * operations. 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)interface PPB_TCPSocket_Private { 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Allocates a TCP socket resource. 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource Create([in] PP_Instance instance); 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Determines if a given resource is TCP socket. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool IsTCPSocket([in] PP_Resource resource); 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Connects to a TCP port given as a host-port pair. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When a proxy server is used, |host| and |port| refer to the proxy server 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * instead of the destination server. 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t Connect([in] PP_Resource tcp_socket, 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] str_t host, 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint16_t port, 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_CompletionCallback callback); 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Same as Connect(), but connecting to the address given by |addr|. A typical 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * use-case would be for reconnections. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t ConnectWithNetAddress([in] PP_Resource tcp_socket, 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_NetAddress_Private addr, 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_CompletionCallback callback); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Gets the local address of the socket, if it has been connected. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns PP_TRUE on success. 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool GetLocalAddress([in] PP_Resource tcp_socket, 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [out] PP_NetAddress_Private local_addr); 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Gets the remote address of the socket, if it has been connected. 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns PP_TRUE on success. 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool GetRemoteAddress([in] PP_Resource tcp_socket, 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [out] PP_NetAddress_Private remote_addr); 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Does SSL handshake and moves to sending and receiving encrypted data. The 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * socket must have been successfully connected. |server_name| will be 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * compared with the name(s) in the server's certificate during the SSL 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * handshake. |server_port| is only used to identify an SSL server in the SSL 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * session cache. 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When a proxy server is used, |server_name| and |server_port| refer to the 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * destination server. 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If the socket is not connected, or there are pending read/write requests, 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * SSLHandshake() will fail without starting a handshake. Otherwise, any 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * failure during the handshake process will cause the socket to be 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * disconnected. 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t SSLHandshake([in] PP_Resource tcp_socket, 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] str_t server_name, 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] uint16_t server_port, 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_CompletionCallback callback); 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns the server's <code>PPB_X509Certificate_Private</code> for a socket 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * connection if an SSL connection has been established using 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>SSLHandshake</code>. If no SSL connection has been established, a 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * null resource is returned. 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=0.4] 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource GetServerCertificate([in] PP_Resource tcp_socket); 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * NOTE: This function is not implemented and will return 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PP_FALSE</code>. 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Adds a trusted/untrusted chain building certificate to be used for this 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * connection. The <code>certificate</code> must be a 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <code>PPB_X509Certificate_Private<code>. <code>PP_TRUE</code> is returned 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * upon success. 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [version=0.4] 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool AddChainBuildingCertificate([in] PP_Resource tcp_socket, 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Resource certificate, 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_Bool is_trusted); 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Reads data from the socket. The size of |buffer| must be at least as large 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * as |bytes_to_read|. May perform a partial read. Returns the number of bytes 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * read or an error code. If the return value is 0, then it indicates that 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * end-of-file was reached. 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This method won't return more than 1 megabyte, so if |bytes_to_read| 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * exceeds 1 megabyte, it will always perform a partial read. 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Multiple outstanding read requests are not supported. 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t Read([in] PP_Resource tcp_socket, 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [out] str_t buffer, 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] int32_t bytes_to_read, 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_CompletionCallback callback); 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Writes data to the socket. May perform a partial write. Returns the number 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * of bytes written or an error code. 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This method won't write more than 1 megabyte, so if |bytes_to_write| 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * exceeds 1 megabyte, it will always perform a partial write. 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Multiple outstanding write requests are not supported. 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t Write([in] PP_Resource tcp_socket, 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] str_t buffer, 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] int32_t bytes_to_write, 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) [in] PP_CompletionCallback callback); 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Cancels any IO that may be pending, and disconnects the socket. Any pending 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * callbacks will still run, reporting PP_Error_Aborted if pending IO was 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * interrupted. It is NOT valid to call Connect() again after a call to this 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * method. Note: If the socket is destroyed when it is still connected, then 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it will be implicitly disconnected, so you are not required to call this 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * method. 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void Disconnect([in] PP_Resource tcp_socket); 1492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 1502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) /** 1512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) * Sets an option on |tcp_socket|. Supported |name| and |value| parameters 1522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) * are as described for PP_TCPSocketOption_Private. |callback| will be 1532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) * invoked with PP_OK if setting the option succeeds, or an error code 1542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) * otherwise. The socket must be connection before SetOption is called. 1552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) */ 1562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) [version=0.5] 1572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int32_t SetOption([in] PP_Resource tcp_socket, 1582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) [in] PP_TCPSocketOption_Private name, 1592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) [in] PP_Var value, 1602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) [in] PP_CompletionCallback callback); 1612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 163