| OLD | NEW |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef NET_SOCKET_SOCKET_H_ | 5 #ifndef NET_SOCKET_SOCKET_H_ |
| 6 #define NET_SOCKET_SOCKET_H_ | 6 #define NET_SOCKET_SOCKET_H_ |
| 7 | 7 |
| 8 #include "net/base/completion_callback.h" | 8 #include "net/base/completion_callback.h" |
| 9 #include "net/base/net_export.h" | 9 #include "net/base/net_export.h" |
| 10 | 10 |
| (...skipping 10 matching lines...) Expand all Loading... |
| 21 // read is returned, or an error is returned upon failure. | 21 // read is returned, or an error is returned upon failure. |
| 22 // ERR_SOCKET_NOT_CONNECTED should be returned if the socket is not currently | 22 // ERR_SOCKET_NOT_CONNECTED should be returned if the socket is not currently |
| 23 // connected. Zero is returned once to indicate end-of-file; the return value | 23 // connected. Zero is returned once to indicate end-of-file; the return value |
| 24 // of subsequent calls is undefined, and may be OS dependent. ERR_IO_PENDING | 24 // of subsequent calls is undefined, and may be OS dependent. ERR_IO_PENDING |
| 25 // is returned if the operation could not be completed synchronously, in which | 25 // is returned if the operation could not be completed synchronously, in which |
| 26 // case the result will be passed to the callback when available. If the | 26 // case the result will be passed to the callback when available. If the |
| 27 // operation is not completed immediately, the socket acquires a reference to | 27 // operation is not completed immediately, the socket acquires a reference to |
| 28 // the provided buffer until the callback is invoked or the socket is | 28 // the provided buffer until the callback is invoked or the socket is |
| 29 // closed. If the socket is Disconnected before the read completes, the | 29 // closed. If the socket is Disconnected before the read completes, the |
| 30 // callback will not be invoked. | 30 // callback will not be invoked. |
| 31 virtual int Read(IOBuffer* buf, int buf_len, | 31 virtual int Read(IOBuffer* buf, |
| 32 int buf_len, |
| 32 const CompletionCallback& callback) = 0; | 33 const CompletionCallback& callback) = 0; |
| 33 | 34 |
| 34 // Writes data, up to |buf_len| bytes, to the socket. Note: data may be | 35 // Writes data, up to |buf_len| bytes, to the socket. Note: data may be |
| 35 // written partially. The number of bytes written is returned, or an error | 36 // written partially. The number of bytes written is returned, or an error |
| 36 // is returned upon failure. ERR_SOCKET_NOT_CONNECTED should be returned if | 37 // is returned upon failure. ERR_SOCKET_NOT_CONNECTED should be returned if |
| 37 // the socket is not currently connected. The return value when the | 38 // the socket is not currently connected. The return value when the |
| 38 // connection is closed is undefined, and may be OS dependent. ERR_IO_PENDING | 39 // connection is closed is undefined, and may be OS dependent. ERR_IO_PENDING |
| 39 // is returned if the operation could not be completed synchronously, in which | 40 // is returned if the operation could not be completed synchronously, in which |
| 40 // case the result will be passed to the callback when available. If the | 41 // case the result will be passed to the callback when available. If the |
| 41 // operation is not completed immediately, the socket acquires a reference to | 42 // operation is not completed immediately, the socket acquires a reference to |
| 42 // the provided buffer until the callback is invoked or the socket is | 43 // the provided buffer until the callback is invoked or the socket is |
| 43 // closed. Implementations of this method should not modify the contents | 44 // closed. Implementations of this method should not modify the contents |
| 44 // of the actual buffer that is written to the socket. If the socket is | 45 // of the actual buffer that is written to the socket. If the socket is |
| 45 // Disconnected before the write completes, the callback will not be invoked. | 46 // Disconnected before the write completes, the callback will not be invoked. |
| 46 virtual int Write(IOBuffer* buf, int buf_len, | 47 virtual int Write(IOBuffer* buf, |
| 48 int buf_len, |
| 47 const CompletionCallback& callback) = 0; | 49 const CompletionCallback& callback) = 0; |
| 48 | 50 |
| 49 // Set the receive buffer size (in bytes) for the socket. | 51 // Set the receive buffer size (in bytes) for the socket. |
| 50 // Note: changing this value can affect the TCP window size on some platforms. | 52 // Note: changing this value can affect the TCP window size on some platforms. |
| 51 // Returns a net error code. | 53 // Returns a net error code. |
| 52 virtual int SetReceiveBufferSize(int32 size) = 0; | 54 virtual int SetReceiveBufferSize(int32 size) = 0; |
| 53 | 55 |
| 54 // Set the send buffer size (in bytes) for the socket. | 56 // Set the send buffer size (in bytes) for the socket. |
| 55 // Note: changing this value can affect the TCP window size on some platforms. | 57 // Note: changing this value can affect the TCP window size on some platforms. |
| 56 // Returns a net error code. | 58 // Returns a net error code. |
| 57 virtual int SetSendBufferSize(int32 size) = 0; | 59 virtual int SetSendBufferSize(int32 size) = 0; |
| 58 }; | 60 }; |
| 59 | 61 |
| 60 } // namespace net | 62 } // namespace net |
| 61 | 63 |
| 62 #endif // NET_SOCKET_SOCKET_H_ | 64 #endif // NET_SOCKET_SOCKET_H_ |
| OLD | NEW |