Index: ppapi/cpp/dev/tcp_socket_dev.h |
diff --git a/ppapi/cpp/dev/tcp_socket_dev.h b/ppapi/cpp/dev/tcp_socket_dev.h |
deleted file mode 100644 |
index 4067bf0a0fbda53ad005489dd8fdfabe7b25860d..0000000000000000000000000000000000000000 |
--- a/ppapi/cpp/dev/tcp_socket_dev.h |
+++ /dev/null |
@@ -1,166 +0,0 @@ |
-// Copyright 2013 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_CPP_DEV_TCP_SOCKET_DEV_H_ |
-#define PPAPI_CPP_DEV_TCP_SOCKET_DEV_H_ |
- |
-#include "ppapi/c/dev/ppb_tcp_socket_dev.h" |
-#include "ppapi/cpp/net_address.h" |
-#include "ppapi/cpp/pass_ref.h" |
-#include "ppapi/cpp/resource.h" |
- |
-namespace pp { |
- |
-class CompletionCallback; |
-class InstanceHandle; |
- |
-/// The <code>TCPSocket_Dev</code> class provides TCP socket operations. |
-/// |
-/// Permissions: Apps permission <code>socket</code> with subrule |
-/// <code>tcp-connect</code> is required for <code>Connect()</code>. |
-/// For more details about network communication permissions, please see: |
-/// http://developer.chrome.com/apps/app_network.html |
-class TCPSocket_Dev: public Resource { |
- public: |
- /// Default constructor for creating an is_null() <code>TCPSocket_Dev</code> |
- /// object. |
- TCPSocket_Dev(); |
- |
- /// A constructor used to create a <code>TCPSocket_Dev</code> object. |
- /// |
- /// @param[in] instance The instance with which this resource will be |
- /// associated. |
- explicit TCPSocket_Dev(const InstanceHandle& instance); |
- |
- /// A constructor used when you have received a <code>PP_Resource</code> as a |
- /// return value that has had 1 ref added for you. |
- /// |
- /// @param[in] resource A <code>PPB_TCPSocket_Dev</code> resource. |
- TCPSocket_Dev(PassRef, PP_Resource resource); |
- |
- /// The copy constructor for <code>TCPSocket_Dev</code>. |
- /// |
- /// @param[in] other A reference to another <code>TCPSocket_Dev</code>. |
- TCPSocket_Dev(const TCPSocket_Dev& other); |
- |
- /// The destructor. |
- virtual ~TCPSocket_Dev(); |
- |
- /// The assignment operator for <code>TCPSocket_Dev</code>. |
- /// |
- /// @param[in] other A reference to another <code>TCPSocket_Dev</code>. |
- /// |
- /// @return A reference to this <code>TCPSocket_Dev</code> object. |
- TCPSocket_Dev& operator=(const TCPSocket_Dev& other); |
- |
- /// Static function for determining whether the browser supports the |
- /// <code>PPB_TCPSocket_Dev</code> interface. |
- /// |
- /// @return true if the interface is available, false otherwise. |
- static bool IsAvailable(); |
- |
- /// Connects the socket to the given address. |
- /// |
- /// @param[in] addr A <code>NetAddress</code> object. |
- /// @param[in] callback A <code>CompletionCallback</code> to be called upon |
- /// completion. |
- /// |
- /// @return An int32_t containing an error code from <code>pp_errors.h</code>, |
- /// including (but not limited to): |
- /// - <code>PP_ERROR_NOACCESS</code>: the caller doesn't have required |
- /// permissions. |
- /// - <code>PP_ERROR_ADDRESS_UNREACHABLE</code>: <code>addr</code> is |
- /// unreachable. |
- /// - <code>PP_ERROR_CONNECTION_REFUSED</code>: the connection attempt was |
- /// refused. |
- /// - <code>PP_ERROR_CONNECTION_FAILED</code>: the connection attempt failed. |
- /// - <code>PP_ERROR_CONNECTION_TIMEDOUT</code>: the connection attempt timed |
- /// out. |
- int32_t Connect(const NetAddress& addr, |
- const CompletionCallback& callback); |
- |
- /// Gets the local address of the socket, if it is connected. |
- /// |
- /// @return A <code>NetAddress</code> object. The object will be null |
- /// (i.e., is_null() returns true) on failure. |
- NetAddress GetLocalAddress() const; |
- |
- /// Gets the remote address of the socket, if it is connected. |
- /// |
- /// @return A <code>NetAddress</code> object. The object will be null |
- /// (i.e., is_null() returns true) on failure. |
- NetAddress GetRemoteAddress() const; |
- |
- /// Reads data from the socket. The socket must be connected. It may perform a |
- /// partial read. |
- /// |
- /// <strong>Caveat:</strong> You should be careful about the lifetime of |
- /// <code>buffer</code>. Typically you will use a |
- /// <code>CompletionCallbackFactory</code> to scope callbacks to the lifetime |
- /// of your class. When your class goes out of scope, the callback factory |
- /// will not actually cancel the operation, but will rather just skip issuing |
- /// the callback on your class. This means that if the underlying |
- /// <code>PPB_TCPSocket_Dev</code> resource outlives your class, the browser |
- /// will still try to write into your buffer when the operation completes. |
- /// The buffer must be kept valid until then to avoid memory corruption. |
- /// If you want to release the buffer while the <code>Read()</code> call is |
- /// still pending, you should call <code>Close()</code> to ensure that the |
- /// buffer won't be accessed in the future. |
- /// |
- /// @param[out] buffer The buffer to store the received data on success. It |
- /// must be at least as large as <code>bytes_to_read</code>. |
- /// @param[in] bytes_to_read The number of bytes to read. |
- /// @param[in] callback A <code>CompletionCallback</code> to be called upon |
- /// completion. |
- /// |
- /// @return A non-negative number on success to indicate how many bytes have |
- /// been read, 0 means that end-of-file was reached; otherwise, an error code |
- /// from <code>pp_errors.h</code>. |
- int32_t Read(char* buffer, |
- int32_t bytes_to_read, |
- const CompletionCallback& callback); |
- |
- /// Writes data to the socket. The socket must be connected. It may perform a |
- /// partial write. |
- /// |
- /// @param[in] buffer The buffer containing the data to write. |
- /// @param[in] bytes_to_write The number of bytes to write. |
- /// @param[in] callback A <code>CompletionCallback</code> to be called upon |
- /// completion. |
- /// |
- /// @return A non-negative number on success to indicate how many bytes have |
- /// been written; otherwise, an error code from <code>pp_errors.h</code>. |
- int32_t Write(const char* buffer, |
- int32_t bytes_to_write, |
- const CompletionCallback& callback); |
- |
- /// Cancels all pending reads and writes and disconnects the socket. Any |
- /// pending callbacks will still run, reporting <code>PP_ERROR_ABORTED</code> |
- /// if pending IO was interrupted. After a call to this method, no output |
- /// buffer pointers passed into previous <code>Read()</code> calls will be |
- /// accessed. It is not valid to call <code>Connect()</code> again. |
- /// |
- /// The socket is implicitly closed if it is destroyed, so you are not |
- /// required to call this method. |
- void Close(); |
- |
- /// Sets a socket option on the TCP socket. |
- /// Please see the <code>PP_TCPSocket_Option_Dev</code> description for option |
- /// names, value types and allowed values. |
- /// |
- /// @param[in] name The option to set. |
- /// @param[in] value The option value to set. |
- /// @param[in] callback A <code>CompletionCallback</code> to be called upon |
- /// completion. |
- /// |
- /// @return An int32_t containing an error code from <code>pp_errors.h</code>. |
- //// |
- int32_t SetOption(PP_TCPSocket_Option_Dev name, |
- const Var& value, |
- const CompletionCallback& callback); |
-}; |
- |
-} // namespace pp |
- |
-#endif // PPAPI_CPP_DEV_TCP_SOCKET__DevDEV_H_ |