]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/inspsocket.h
Remove the Kiwi links from the readme.
[user/henk/code/inspircd.git] / include / inspsocket.h
index 258d186b9d0d178f49309cb30847b37ea38e4886..f9cc87b1daf679473cd0b88d03d85bf8601e40dd 100644 (file)
@@ -1,11 +1,17 @@
 /*
  * InspIRCd -- Internet Relay Chat Daemon
  *
+ *   Copyright (C) 2020 Matt Schatz <genius3000@g3k.solutions>
+ *   Copyright (C) 2019 linuxdaemon <linuxdaemon.irc@gmail.com>
+ *   Copyright (C) 2013, 2015-2016 Attila Molnar <attilamolnar@hush.com>
+ *   Copyright (C) 2012-2013, 2017-2019 Sadie Powell <sadie@witchery.services>
+ *   Copyright (C) 2012 Robby <robby@chatbelgie.be>
+ *   Copyright (C) 2009 Uli Schlachter <psychon@inspircd.org>
  *   Copyright (C) 2009 Daniel De Graaf <danieldg@inspircd.org>
- *   Copyright (C) 2007-2008 Robin Burchell <robin+git@viroteck.net>
+ *   Copyright (C) 2007-2009 Robin Burchell <robin+git@viroteck.net>
  *   Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
- *   Copyright (C) 2006-2007 Craig Edwards <craigedwards@brainbox.cc>
- *   Copyright (C) 2006 Oliver Lupton <oliverlupton@gmail.com>
+ *   Copyright (C) 2006, 2010 Craig Edwards <brain@inspircd.org>
+ *   Copyright (C) 2006 Oliver Lupton <om@inspircd.org>
  *
  * This file is part of InspIRCd.  InspIRCd is free software: you can
  * redistribute it and/or modify it under the terms of the GNU General Public
@@ -98,7 +104,7 @@ class CoreExport SocketTimeout : public Timer
 
        /** Handle tick event
         */
-       virtual bool Tick(time_t now);
+       bool Tick(time_t now) CXX11_OVERRIDE;
 };
 
 /**
@@ -219,7 +225,20 @@ class CoreExport StreamSocket : public EventHandler
                size_t nbytes;
        };
 
+       /** The type of socket this IOHook represents. */
+       enum Type
+       {
+               SS_UNKNOWN,
+               SS_USER
+       };
+
  private:
+       /** Whether this socket should close once its sendq is empty */
+       bool closeonempty;
+
+       /** Whether the socket is currently closing or not, used to avoid repeatedly closing a closed socket */
+       bool closing;
+
        /** The IOHook that handles raw I/O for this socket, or NULL */
        IOHook* iohook;
 
@@ -262,9 +281,23 @@ class CoreExport StreamSocket : public EventHandler
        int HookChainRead(IOHook* hook, std::string& rq);
 
  protected:
+       /** The data which has been received from the socket. */
        std::string recvq;
+
+       /** Swaps the internals of this StreamSocket with another one.
+        * @param other A StreamSocket to swap internals with.
+        */
+       void SwapInternals(StreamSocket& other);
+
  public:
-       StreamSocket() : iohook(NULL) { }
+       const Type type;
+       StreamSocket(Type sstype = SS_UNKNOWN)
+               : closeonempty(false)
+               , closing(false)
+               , iohook(NULL)
+               , type(sstype)
+       {
+       }
        IOHook* GetIOHook() const;
        void AddIOHook(IOHook* hook);
        void DelIOHook();
@@ -297,6 +330,13 @@ class CoreExport StreamSocket : public EventHandler
        /** Called when the socket gets an error from socket engine or IO hook */
        virtual void OnError(BufferedSocketError e) = 0;
 
+       /** Called when the endpoint addresses are changed.
+        * @param local The new local endpoint.
+        * @param remote The new remote endpoint.
+        * @return true if the connection is still open, false if it has been closed
+        */
+       virtual bool OnSetEndPoint(const irc::sockets::sockaddrs& local, const irc::sockets::sockaddrs& remote);
+
        /** Send the given data out the socket, either now or when writes unblock
         */
        void WriteData(const std::string& data);
@@ -315,14 +355,23 @@ class CoreExport StreamSocket : public EventHandler
         * Close the socket, remove from socket engine, etc
         */
        virtual void Close();
+
+       /** If writeblock is true then only close the socket if all data has been sent. Otherwise, close immediately. */
+       void Close(bool writeblock);
+
        /** This ensures that close is called prior to destructor */
-       virtual CullResult cull() CXX11_OVERRIDE;
+       CullResult cull() CXX11_OVERRIDE;
 
        /** Get the IOHook of a module attached to this socket
         * @param mod Module whose IOHook to return
         * @return IOHook belonging to the module or NULL if the module haven't attached an IOHook to this socket
         */
        IOHook* GetModHook(Module* mod) const;
+
+       /** Get the last IOHook attached to this socket
+        * @return The last IOHook attached to this socket or NULL if no IOHooks are attached
+        */
+       IOHook* GetLastHook() const;
 };
 /**
  * BufferedSocket is an extendable socket class which modules
@@ -361,12 +410,11 @@ class CoreExport BufferedSocket : public StreamSocket
         * This will create a socket, register with socket engine, and start the asynchronous
         * connection process. If an error is detected at this point (such as out of file descriptors),
         * OnError will be called; otherwise, the state will become CONNECTING.
-        * @param ipaddr Address to connect to
-        * @param aport Port to connect on
+        * @param dest Remote endpoint to connect to.
+        * @param bind Local endpoint to connect from.
         * @param maxtime Time to wait for connection
-        * @param connectbindip Address to bind to (if NULL, no bind will be done)
         */
-       void DoConnect(const std::string& ipaddr, int aport, unsigned int maxtime, const std::string& connectbindip);
+       void DoConnect(const irc::sockets::sockaddrs& dest, const irc::sockets::sockaddrs& bind, unsigned int maxtime);
 
        /** This method is called when an outbound connection on your socket is
         * completed.
@@ -376,7 +424,7 @@ class CoreExport BufferedSocket : public StreamSocket
        /** When there is data waiting to be read on a socket, the OnDataReady()
         * method is called.
         */
-       virtual void OnDataReady() CXX11_OVERRIDE = 0;
+       void OnDataReady() CXX11_OVERRIDE = 0;
 
        /**
         * When an outbound connection fails, and the attempt times out, you
@@ -393,7 +441,6 @@ class CoreExport BufferedSocket : public StreamSocket
  protected:
        void OnEventHandlerWrite() CXX11_OVERRIDE;
        BufferedSocketError BeginConnect(const irc::sockets::sockaddrs& dest, const irc::sockets::sockaddrs& bind, unsigned int timeout);
-       BufferedSocketError BeginConnect(const std::string& ipaddr, int aport, unsigned int maxtime, const std::string& connectbindip);
 };
 
 inline IOHook* StreamSocket::GetIOHook() const { return iohook; }