ACE_SOCK_Stream Class Reference

Defines the methods in the ACE_SOCK_Stream abstraction. More...

#include <SOCK_Stream.h>

Inheritance diagram for ACE_SOCK_Stream:

Inheritance graph
[legend]
Collaboration diagram for ACE_SOCK_Stream:

Collaboration graph
[legend]

List of all members.

Public Types

typedef ACE_INET_Addr PEER_ADDR

Public Member Functions

 ACE_SOCK_Stream (void)
 Constructor.
 ACE_SOCK_Stream (ACE_HANDLE h)
 Constructor (sets the underlying ACE_HANDLE with h).
 ~ACE_SOCK_Stream (void)
 Destructor.
ssize_t send_urg (const void *ptr, size_t len=sizeof(char), const ACE_Time_Value *timeout=0) const
ssize_t recv_urg (void *ptr, size_t len=sizeof(char), const ACE_Time_Value *timeout=0) const
int close_reader (void)
 Close down the reader.
int close_writer (void)
 Close down the writer.
int close (void)
void dump (void) const
 Dump the state of an object.
Counted send/receive methods
The counted send/receive methods attempt to transfer a specified number of bytes even if they must block and retry the operation in order to transfer the entire amount. The time spent blocking for the entire transfer can be limited by a specified ACE_Time_Value object which is a relative time (i.e., a fixed amount of time, not an absolute time of day). These methods return the count of transferred bytes, or -1 if an error occurs or the operation times out before the entire requested amount of data has been transferred. In error or timeout situations it's possible that some data was transferred before the error or timeout. The bytes_transferred parameter is used to obtain the count of bytes transferred before the error or timeout occurred. If the total specified number of bytes is transferred without error, the method return value should equal the value of bytes_transferred.

Parameters:
buf The buffer to write from or receive into.
iov An I/O vector containing a specified number of count/pointer pairs directing the data to be transferred.
iovcnt The number of I/O vectors to be used from iov.
len The number of bytes to transfer.
flags Flags that will be passed through to the recv() system call.
timeout Indicates how long to blocking trying to transfer data. If no timeout is supplied (timeout == 0) the method will wait indefinitely or until an error occurs for the specified number of bytes to be transferred. To avoid any waiting, specify a timeout value with 0 seconds.
bytes_transferred If non-0, points to a location which receives the total number of bytes transferred before the method returns, even if it's less than the number requested.
Return values:
len,the complete number of bytes transferred.
0 EOF, i.e., the peer closed the connection.
-1 an error occurred before the entire amount was transferred. Check errno for more information. If the timeout period is reached, errno is ETIME.
On partial transfers, i.e., if any data is transferred before timeout/error/EOF, *bytes_transferred will contain the number of bytes transferred.

ssize_t recv_n (void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Try to recv exactly len bytes into buf from the connected socket.
ssize_t recv_n (void *buf, size_t len, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Try to recv exactly len bytes into buf from the connected socket.
ssize_t recvv_n (iovec iov[], int iovcnt, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Receive an iovec of size iovcnt from the connected socket.
ssize_t send_n (const void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Try to send exactly len bytes from buf to the connection socket.
ssize_t send_n (const void *buf, size_t len, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Try to send exactly len bytes from buf to the connected socket.
ssize_t send_n (const ACE_Message_Block *message_block, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
ssize_t sendv_n (const iovec iov[], int iovcnt, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0) const
 Send an iovec of size iovcnt to the connected socket.

Public Attributes

 ACE_ALLOC_HOOK_DECLARE
 Declare the dynamic allocation hooks.


Detailed Description

Defines the methods in the ACE_SOCK_Stream abstraction.

This adds additional wrapper methods atop the ACE_SOCK_IO class.

See also:
ACE_SOCK_IO

Member Typedef Documentation

Reimplemented in ACE_LSOCK_Stream.


Constructor & Destructor Documentation

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE ACE_SOCK_Stream::ACE_SOCK_Stream ( void   ) 

Constructor.

ACE_INLINE ACE_SOCK_Stream::ACE_SOCK_Stream ( ACE_HANDLE  h  ) 

Constructor (sets the underlying ACE_HANDLE with h).

ACE_INLINE ACE_SOCK_Stream::~ACE_SOCK_Stream ( void   ) 

Destructor.


Member Function Documentation

ACE_INLINE ssize_t ACE_SOCK_Stream::recv_n ( void *  buf,
size_t  len,
int  flags,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Try to recv exactly len bytes into buf from the connected socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::recv_n ( void *  buf,
size_t  len,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Try to recv exactly len bytes into buf from the connected socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::recvv_n ( iovec  iov[],
int  iovcnt,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Receive an iovec of size iovcnt from the connected socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::send_n ( const void *  buf,
size_t  len,
int  flags,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Try to send exactly len bytes from buf to the connection socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::send_n ( const void *  buf,
size_t  len,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Try to send exactly len bytes from buf to the connected socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::send_n ( const ACE_Message_Block message_block,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Send all the message blocks chained through their next and cont pointers. This call uses the underlying OS gather-write operation to reduce the domain-crossing penalty.

ACE_INLINE ssize_t ACE_SOCK_Stream::sendv_n ( const iovec  iov[],
int  iovcnt,
const ACE_Time_Value timeout = 0,
size_t *  bytes_transferred = 0 
) const

Send an iovec of size iovcnt to the connected socket.

ACE_INLINE ssize_t ACE_SOCK_Stream::send_urg ( const void *  ptr,
size_t  len = sizeof (char),
const ACE_Time_Value timeout = 0 
) const

ACE_INLINE ssize_t ACE_SOCK_Stream::recv_urg ( void *  ptr,
size_t  len = sizeof (char),
const ACE_Time_Value timeout = 0 
) const

ACE_INLINE int ACE_SOCK_Stream::close_reader ( void   ) 

Close down the reader.

ACE_INLINE int ACE_SOCK_Stream::close_writer ( void   ) 

Close down the writer.

int ACE_SOCK_Stream::close ( void   ) 

Close down the socket (we need this to make things work correctly on Win32, which requires use to do a close_writer() before doing the close to avoid losing data).

Reimplemented from ACE_SOCK.

ACE_BEGIN_VERSIONED_NAMESPACE_DECL void ACE_SOCK_Stream::dump ( void   )  const

Dump the state of an object.

Reimplemented from ACE_SOCK_IO.

Reimplemented in ACE_LSOCK_Stream.


Member Data Documentation

Declare the dynamic allocation hooks.

Reimplemented from ACE_SOCK_IO.

Reimplemented in ACE_LSOCK_Stream.


The documentation for this class was generated from the following files:

Generated on Wed Apr 23 02:41:44 2008 for ACE by  doxygen 1.5.5