1// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5#ifndef NET_SOCKET_SOCKET_H_ 6#define NET_SOCKET_SOCKET_H_ 7 8#include "net/base/completion_callback.h" 9 10namespace net { 11 12class IOBuffer; 13 14// Represents a read/write socket. 15class Socket { 16 public: 17 virtual ~Socket() {} 18 19 // Reads data, up to buf_len bytes, from the socket. The number of bytes 20 // read is returned, or an error is returned upon failure. Zero is returned 21 // to indicate end-of-file. ERR_IO_PENDING is returned if the operation 22 // could not be completed synchronously, in which case the result will be 23 // passed to the callback when available. If the operation is not completed 24 // immediately, the socket acquires a reference to the provided buffer until 25 // the callback is invoked or the socket is destroyed. 26 virtual int Read(IOBuffer* buf, int buf_len, 27 CompletionCallback* callback) = 0; 28 29 // Writes data, up to buf_len bytes, to the socket. Note: only part of the 30 // data may be written! The number of bytes written is returned, or an error 31 // is returned upon failure. ERR_IO_PENDING is returned if the operation 32 // could not be completed synchronously, in which case the result will be 33 // passed to the callback when available. If the operation is not completed 34 // immediately, the socket acquires a reference to the provided buffer until 35 // the callback is invoked or the socket is destroyed. 36 // Implementations of this method should not modify the contents of the actual 37 // buffer that is written to the socket. 38 virtual int Write(IOBuffer* buf, int buf_len, 39 CompletionCallback* callback) = 0; 40 41 // Set the receive buffer size (in bytes) for the socket. 42 // Note: changing this value can effect the TCP window size on some platforms. 43 // Returns true on success, or false on failure. 44 virtual bool SetReceiveBufferSize(int32 size) = 0; 45 46 // Set the send buffer size (in bytes) for the socket. 47 // Note: changing this value can effect the TCP window size on some platforms. 48 // Returns true on success, or false on failure. 49 virtual bool SetSendBufferSize(int32 size) = 0; 50}; 51 52} // namespace net 53 54#endif // NET_SOCKET_SOCKET_H_ 55