]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/socketengine.h
Update all wiki links to point to the new wiki. This was done automatically with...
[user/henk/code/inspircd.git] / include / socketengine.h
index 87913f0dbc8cca68bc7dd4574212d903afd60a50..16913972d8d578e9cd881beff1e87346a0e6b5af 100644 (file)
@@ -2,8 +2,8 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
- * See: http://www.inspircd.org/wiki/index.php/Credits
+ *  InspIRCd: (C) 2002-2009 InspIRCd Development Team
+ * See: http://wiki.inspircd.org/Credits
  *
  * This program is free but copyrighted software; see
  *            the file COPYING for details.
@@ -38,6 +38,7 @@ enum EventType
 };
 
 class InspIRCd;
+class Module;
 
 /** This class is a basic I/O handler class.
  * Any object which wishes to receive basic I/O events
@@ -68,7 +69,28 @@ class CoreExport EventHandler : public Extensible
         * other forms of IPC.
         */
        int fd;
+
+       /** Pointer to the module which has hooked the given EventHandler for IO events.
+        */
+       Module *IOHook;
  public:
+
+       /** Return the current hooker of IO events for this socket, or NULL.
+        * @return Hooker module, if set, or NULL.
+        */
+       Module *GetIOHook();
+
+       /** Set a module as hooking IO events on this socket.
+        * @param IOHooker The module hooking IO
+        * @return True if the hook could be added, false otherwise.
+        */
+       bool AddIOHook(Module *IOHooker);
+
+       /** Remove IO hooking from a module
+        * @return True if hooking was successfully removed, false otherwise.
+        */
+       bool DelIOHook();
+
        /** Get the current file descriptor
         * @return The file descriptor of this handler
         */
@@ -84,7 +106,7 @@ class CoreExport EventHandler : public Extensible
 
        /** Constructor
         */
-       EventHandler() {}
+       EventHandler();
 
        /** Destructor
         */
@@ -166,9 +188,22 @@ protected:
        int CurrentSetSize;
        /** Reference table, contains all current handlers
         */
-       EventHandler* ref[MAX_DESCRIPTORS];
+       EventHandler** ref;
+
+       int MAX_DESCRIPTORS;
+
+       size_t indata;
+       size_t outdata;
+       time_t lastempty;
+
+       void UpdateStats(size_t len_in, size_t len_out);
 public:
 
+       double TotalEvents;
+       double ReadEvents;
+       double WriteEvents;
+       double ErrorEvents;
+
        /** Constructor.
         * The constructor transparently initializes
         * the socket engine which the ircd is using.
@@ -276,7 +311,122 @@ public:
         * given event handler are within sensible ranges
         * which can be handled by the socket engine.
         */
-       bool BoundsCheckFd(EventHandler* eh);
+       virtual bool BoundsCheckFd(EventHandler* eh);
+
+       /** Abstraction for BSD sockets accept(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Accept(EventHandler* fd, sockaddr *addr, socklen_t *addrlen);
+
+       /** Abstraction for BSD sockets close(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Close(EventHandler* fd);
+
+       /** Abstraction for BSD sockets close(2).
+        * This function should emulate its namesake system call exactly.
+        * This function should emulate its namesake system call exactly.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Close(int fd);
+
+       /** Abstraction for BSD sockets send(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Send(EventHandler* fd, const void *buf, size_t len, int flags);
+
+       /** Abstraction for BSD sockets recv(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Recv(EventHandler* fd, void *buf, size_t len, int flags);
+
+       /** Abstraction for BSD sockets recvfrom(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int RecvFrom(EventHandler* fd, void *buf, size_t len, int flags, sockaddr *from, socklen_t *fromlen);
+
+       /** Abstraction for BSD sockets sendto(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int SendTo(EventHandler* fd, const void *buf, size_t len, int flags, const sockaddr *to, socklen_t tolen);
+
+       /** Abstraction for BSD sockets connect(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Connect(EventHandler* fd, const sockaddr *serv_addr, socklen_t addrlen);
+
+       /** Make a file descriptor blocking.
+        * @param fd a file descriptor to set to blocking mode
+        * @return 0 on success, -1 on failure, errno is set appropriately.
+        */
+       virtual int Blocking(int fd);
+
+       /** Make a file descriptor nonblocking.
+        * @param fd A file descriptor to set to nonblocking mode
+        * @return 0 on success, -1 on failure, errno is set appropriately.
+        */
+       virtual int NonBlocking(int fd);
+
+       /** Abstraction for BSD sockets shutdown(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Shutdown(EventHandler* fd, int how);
+
+       /** Abstraction for BSD sockets shutdown(2).
+        * This function should emulate its namesake system call exactly.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Shutdown(int fd, int how);
+
+       /** Abstraction for BSD sockets bind(2).
+        * This function should emulate its namesake system call exactly.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Bind(int fd, const sockaddr *my_addr, socklen_t addrlen);
+
+       /** Abstraction for BSD sockets listen(2).
+        * This function should emulate its namesake system call exactly.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int Listen(int sockfd, int backlog);
+
+       /** Abstraction for BSD sockets getsockname(2).
+        * This function should emulate its namesake system call exactly.
+        * @param fd This version of the call takes an EventHandler instead of a bare file descriptor.
+        * @return This method should return exactly the same values as the system call it emulates.
+        */
+       virtual int GetSockName(EventHandler* fd, sockaddr *name, socklen_t* namelen);
+
+       /** This function is called immediately after fork().
+        * Some socket engines (notably kqueue) cannot have their
+        * handles inherited by forked processes. This method
+        * allows for the socket engine to re-create its handle
+        * after the daemon forks as the socket engine is created
+        * long BEFORE the daemon forks.
+        * @return void, but it is acceptable for this function to bail back to
+        * the shell or operating system on fatal error.
+        */
+       virtual void RecoverFromFork();
+
+       /** Get data transfer statistics, kilobits per second in and out and total.
+        */
+       void GetStats(float &kbitpersec_in, float &kbitpersec_out, float &kbitpersec_total);
 };
 
 #endif