#define MSP_IO_BASE_H_
#include <sigc++/sigc++.h>
+#include <msp/core/mutex.h>
+#include "handle.h"
#include "mode.h"
#include "poll.h"
namespace Msp {
namespace IO {
-struct Handle;
-
/**
Common interface for all I/O objects.
-
-A derived class must call set_events(P_NONE) before it is destroyed to avoid
-leaving stale pointers in an EventDispatcher.
*/
class Base
{
public:
- /** Emitted when there is data available for reading. If all data is not
- read, the signal is emitted again immediately. */
- sigc::signal<void> signal_data_available;
+ /** RAII synchronization primitive. Prevents concurrent access to the
+ target object during the lifetime of the Synchronize object. */
+ class Synchronize
+ {
+ private:
+ Base &io;
+
+ public:
+ Synchronize(Base &);
+ ~Synchronize();
+ };
/** Emitted when there is no more data to be read. */
sigc::signal<void> signal_end_of_file;
seeked) and any data buffered by upper layers needs to be flushed. */
sigc::signal<void> signal_flush_required;
- /** Emitted when the I/O object has closed. */
- sigc::signal<void> signal_closed;
-
- /** Emitted when the mask of interesting events changes. Mainly for use by
- EventDispatcher. */
- sigc::signal<void, PollEvent> signal_events_changed;
-
/** Emitted when the object is deleted. Mainly for use by
EventDispatcher. */
sigc::signal<void> signal_deleted;
protected:
Mode mode;
- PollEvent events;
bool eof_flag;
+ Mutex *mutex;
Base();
private:
was done.
Blocking is enabled by default. */
- virtual void set_block(bool) { }
+ virtual void set_block(bool) = 0;
/** Returns the current mode flags. */
Mode get_mode() const { return mode; }
protected:
+ void check_access(Mode) const;
+
virtual unsigned do_write(const char *, unsigned) = 0;
virtual unsigned do_read(char *, unsigned) = 0;
to end-of-file or non-blocking operation. */
virtual int get();
- /** Returns the end-of-file flag. */
- bool eof() const { return eof_flag; }
-
protected:
- void set_events(PollEvent);
+ void set_eof();
public:
- /** Returns a mask of the currently interesting events. Used by
- EventDispatcher. */
- PollEvent get_events() const { return events; }
-
- /** Returns a handle for polling. Should throw if the object does not have
- an event handle. */
- virtual const Handle &get_event_handle() = 0;
-
- /** Notifies the object of an event. Used by EventDispatcher. */
- void event(PollEvent);
+ /** Returns the end-of-file flag. Note that some types of objects won't
+ indicate end-of-file until you try to read at least one byte past the actual
+ end, while others indicate it when you've read the last byte. */
+ bool eof() const { return eof_flag; }
-protected:
- virtual void on_event(PollEvent) { }
+ /** Returns the system-level handle for the object. Used by Console to
+ perform redirections. */
+ virtual const Handle &get_handle(Mode) = 0;
};
} // namespace IO