X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Scheduler%2FFdEvent.hh;h=6080d0d5ccfd11bd1bebc74f6e2de6cb2f6ab11f;hb=cc2bf0a1a29245d102d1962118fb19ef178393cf;hp=b22c4b2de5f8767e306127691fffc163e16889e1;hpb=ac90835cbb00ca83a51ab9efb23fdcb75518e808;p=senf.git

diff --git a/Scheduler/FdEvent.hh b/Scheduler/FdEvent.hh
index b22c4b2..6080d0d 100644
--- a/Scheduler/FdEvent.hh
+++ b/Scheduler/FdEvent.hh
@@ -51,19 +51,23 @@ namespace scheduler {
 
         The FdEvent class registers a file descriptor for read or write events.
 
-        The type of event is specified using an event mask. Possible events are
+        There are a number of different event types supported for file descriptors. Those are
+        specified using a bit mask. Possible events are
 
         \li \c EV_READ: File descriptor is readable (or at EOF)
         \li \c EV_PRIO: There is out-of-band data available to be read on the file descriptor
         \li \c EV_WRITE: File descriptor is writable
 
-        These event flags can be or-ed together to form an event mask. The callback will be called
-        with those flags set which are currently signaled. There are additional flags which may be
-        set when calling the callback:
-
+        The callback will be called with one additional argument. This argument is the event mask of
+        type int. This mask will tell, which of the registered events are signaled. There are some
+        additional flags which can be set when calling the handler callback:
+        
         \li \c EV_HUP: The other end has closed the connection
         \li \c EV_ERR: Transport error
 
+        Only a single handler may be registered for any combination of file descriptor and event
+        otherwise a DuplicateEventRegistrationException is thrown.
+        
         The file descriptor is specified using an arbitrary handle type which supports the \c
         retrieve_filehandle() protocol: There must be a global function \c retrieve_filehandle
         callable with the handle type. This function must return the file descriptor associated with
@@ -71,9 +75,9 @@ namespace scheduler {
         handles are provided.
 
         The FdEvent class is an implementation of the RAII idiom: The event will be automatically
-        unregistered in the FdEvent destructor. The TimerEvent instance should be created
-        within the same scope or on a scope below where the callback is defined (e.g. if the
-        callback is a member function it should be defined as a class member).
+        unregistered in the FdEvent destructor. The FdEvent instance should be created within the
+        same scope or on a scope below where the callback is defined (e.g. if the callback is a
+        member function it should be defined as a class member).
      */
     class FdEvent
 	: public detail::FIFORunner::TaskInfo,
@@ -87,15 +91,15 @@ namespace scheduler {
 	typedef boost::function<void (int)> Callback;
 
         enum Events { 
-            EV_NONE = 0,
-            EV_READ = detail::FdManager::EV_READ, 
-            EV_PRIO = detail::FdManager::EV_PRIO, 
-            EV_WRITE = detail::FdManager::EV_WRITE,
-            EV_HUP = detail::FdManager::EV_HUP, 
-            EV_ERR = detail::FdManager::EV_ERR,
-            EV_ALL = (detail::FdManager::EV_READ 
+            EV_NONE = 0                             ///< No event
+          , EV_READ = detail::FdManager::EV_READ    ///< fd readable (or EOF)
+          , EV_PRIO = detail::FdManager::EV_PRIO    ///< OOB data available for read
+          , EV_WRITE = detail::FdManager::EV_WRITE  ///< fd writable
+          , EV_HUP = detail::FdManager::EV_HUP      ///< remote end closed connection
+          , EV_ERR = detail::FdManager::EV_ERR      ///< transport error
+          , EV_ALL = (detail::FdManager::EV_READ 
                       | detail::FdManager::EV_WRITE 
-                      | detail::FdManager::EV_PRIO)
+                      | detail::FdManager::EV_PRIO) ///< register all events (read, prio and write)
         };
 
         ///////////////////////////////////////////////////////////////////////////
@@ -134,7 +138,6 @@ namespace scheduler {
 
 	void disable();                 ///< Disable event
 	void enable();                  ///< Enable event
-	bool enabled();                 ///< \c true if event enabled, \c false otherwise
 
 	FdEvent & action(Callback const & cb); ///< Change event callback
 
@@ -153,7 +156,9 @@ namespace scheduler {
 
     private:
 	virtual void signal(int events);
-	virtual void run();
+	virtual void v_run();
+        virtual char const * v_type() const;
+        virtual std::string v_info() const;
 
 	Callback cb_;
 	int fd_;
@@ -167,8 +172,14 @@ namespace scheduler {
         friend class detail::FileDispatcher;
     };
 
-    int retrieve_filehandle(int fd);
+    /** \brief Get file descriptor from handle object
 
+        This function will query the \a handle for it's file descriptor. The real implementation
+        must be provided by a freestanding function \c retrieve_filehandle(Handle const & h) within
+        the namespace of \a Handle.
+     */
+    template <class Handle>
+    int get_descriptor(Handle const & handle);
 }}
 
 ///////////////////////////////hh.e////////////////////////////////////////