class AsyncFileOperator

Base class for asynchronous file transfer operations. More...

 
LOGO
 Annotated List  Files  Globals  Hierarchy  Index  Top

Public Types

Public Methods

Protected Methods

Protected Members


Detailed Description

Asynchronous file transfer operations allow data to be transferred to or from user supplied buffers. A callback is invoked on each transfer. Transfer stops when the available buffers are exhausted.

enum Event { DATA = 1, FLUSHING = 2, OS_ERROR = 4, END_OF_FILE = 8, WOULDBLOCK = 16 }

Event

typedef XorpCallback4<void, Event, const uint8_t*, size_t, size_t>::RefPtr Callback

Callback

Callback type user provides when adding buffers to sub-classes AsyncFileOperator. Callback's are on a per buffer basis and invoked any time some I/O is performed. The offset field refers to the offset of the last byte read, or written, from the start of the buffer.

Callback has arguments: ErrorCode e, uint8_t* buffer, size_t buffer_bytes, size_t offset

size_t  buffers_remaining ()

buffers_remaining

[const pure virtual]

Returns: the number of buffers available.

void  flush_buffers ()

flush_buffers

[pure virtual]

Stop asynchronous operation and clear list of buffers.

bool  start ()

start

[pure virtual]

Start asynchronous operation.

Returns: true on success, false if no buffers are available.

void  stop ()

stop

[pure virtual]

Stop asynchronous operation.

inline bool  resume ()

resume

Resume stopped asynchronous operation.

Returns: true on success, false if no buffers are available.

inline bool  running ()

running

[const]

Returns: true if asynchronous I/O is started.

inline XorpFd  fd ()

fd

[const]

Returns: file descriptor undergoing asynchronous operation.

inline int  error ()

error

[const]

Returns: the last error code returned by the underlying OS.

 AsyncFileOperator (EventLoop& e, XorpFd fd)

AsyncFileOperator

[protected]

 ~AsyncFileOperator ()

~AsyncFileOperator

[protected virtual]

EventLoop& _eventloop

_eventloop

[protected]

XorpFd _fd

_fd

[protected]

bool _running

_running

[protected]

int _last_error

_last_error

[protected]


Generated by: pavlin on possum.icir.org on Wed Aug 2 15:35:43 2006, using kdoc $.