]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/users.h
ListModeBase: Minor changes to original u_listmode code
[user/henk/code/inspircd.git] / include / users.h
index cdc0d80783265a085bcfeb6b5e04ef15c91d8be3..b9807a1586e8ee862d8ba8d75646ed6433ee9cf6 100644 (file)
@@ -29,6 +29,7 @@
 #include "inspsocket.h"
 #include "dns.h"
 #include "mode.h"
+#include "membership.h"
 
 /** connect class types
  */
@@ -59,7 +60,7 @@ enum UserModes {
  */
 enum RegistrationState {
 
-#ifndef WIN32   // Burlex: This is already defined in win32, luckily it is still 0.
+#ifndef _WIN32   // Burlex: This is already defined in win32, luckily it is still 0.
        REG_NONE = 0,           /* Has sent nothing */
 #endif
 
@@ -266,10 +267,6 @@ class CoreExport User : public Extensible
         */
        time_t signon;
 
-       /** Time that the connection last sent a message, used to calculate idle time
-        */
-       time_t idle_lastmsg;
-
        /** Client address that the user is connected from.
         * Do not modify this value directly, use SetClientIP() to change it.
         * Port is not valid for remote users.
@@ -346,12 +343,6 @@ class CoreExport User : public Extensible
         */
        unsigned int registered:3;
 
-       /** True when DNS lookups are completed.
-        * The UserResolver classes res_forward and res_reverse will
-        * set this value once they complete.
-        */
-       unsigned int dns_done:1;
-
        /** Whether or not to send an snotice about this user's quitting
         */
        unsigned int quietquit:1;
@@ -363,27 +354,13 @@ class CoreExport User : public Extensible
         */
        unsigned int quitting:1;
 
-       /** Recursion fix: user is out of SendQ and will be quit as soon as possible.
-        * This can't be handled normally because QuitUser itself calls Write on other
-        * users, which could trigger their SendQ to overrun.
-        */
-       unsigned int quitting_sendq:1;
-
-       /** This is true if the user matched an exception (E:Line). It is used to save time on ban checks.
-        */
-       unsigned int exempt:1;
-
-       /** has the user responded to their previous ping?
-        */
-       unsigned int lastping:1;
-
        /** What type of user is this? */
        const unsigned int usertype:2;
 
        /** Get client IP string from sockaddr, using static internal buffer
         * @return The IP string
         */
-       const char* GetIPString();
+       const std::string& GetIPString();
 
        /** Get CIDR mask, using default range, for this user
         */
@@ -392,34 +369,25 @@ class CoreExport User : public Extensible
        /** Sets the client IP for this user
         * @return true if the conversion was successful
         */
-       bool SetClientIP(const char* sip);
+       virtual bool SetClientIP(const char* sip, bool recheck_eline = true);
 
-       /** Sets the client IP for this user
-        * @return true always
-        */
-       bool SetClientIP(irc::sockets::sockaddrs *sa);
+       virtual void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
 
        /** Constructor
         * @throw CoreException if the UID allocated to the user already exists
         */
        User(const std::string &uid, const std::string& srv, int objtype);
 
-       /** Check if the user matches a G or K line, and disconnect them if they do.
-        * @param doZline True if ZLines should be checked (if IP has changed since initial connect)
-        * Returns true if the user matched a ban, false else.
-        */
-       bool CheckLines(bool doZline = false);
-
        /** Returns the full displayed host of the user
         * This member function returns the hostname of the user as seen by other users
-        * on the server, in nick!ident&at;host form.
+        * on the server, in nick!ident\@host form.
         * @return The full masked host of the user
         */
        virtual const std::string& GetFullHost();
 
        /** Returns the full real host of the user
         * This member function returns the hostname of the user as seen by other users
-        * on the server, in nick!ident&at;host form. If any form of hostname cloaking is in operation,
+        * on the server, in nick!ident\@host form. If any form of hostname cloaking is in operation,
         * e.g. through a module, then this method will ignore it and return the true hostname.
         * @return The full real host of the user
         */
@@ -456,7 +424,7 @@ class CoreExport User : public Extensible
        void SetNoticeMask(unsigned char sm, bool value);
 
        /** Create a displayable mode string for this users umodes
-        * @param The mode string
+        * @param showparameters The mode string
         */
        const char* FormatModes(bool showparameters = false);
 
@@ -500,27 +468,23 @@ class CoreExport User : public Extensible
        virtual bool HasModePermission(unsigned char mode, ModeType type);
 
        /** Creates a wildcard host.
-        * Takes a buffer to use and fills the given buffer with the host in the format *!*@hostname
-        * @return The wildcarded hostname in *!*@host form
+        * Takes a buffer to use and fills the given buffer with the host in the format *!*\@hostname
+        * @return The wildcarded hostname in *!*\@host form
         */
        char* MakeWildHost();
 
        /** Creates a usermask with real host.
-        * Takes a buffer to use and fills the given buffer with the hostmask in the format user@host
-        * @return the usermask in the format user@host
+        * Takes a buffer to use and fills the given buffer with the hostmask in the format user\@host
+        * @return the usermask in the format user\@host
         */
        const std::string& MakeHost();
 
        /** Creates a usermask with real ip.
-        * Takes a buffer to use and fills the given buffer with the ipmask in the format user@ip
-        * @return the usermask in the format user@ip
+        * Takes a buffer to use and fills the given buffer with the ipmask in the format user\@ip
+        * @return the usermask in the format user\@ip
         */
        const std::string& MakeHostIP();
 
-       /** Add the user to WHOWAS system
-        */
-       void AddToWhoWas();
-
        /** Oper up the user using the given opertype.
         * This will also give the +o usermode.
         */
@@ -569,34 +533,35 @@ class CoreExport User : public Extensible
 
        void WriteNumeric(unsigned int numeric, const std::string &text);
 
-       /** Write text to this user, appending CR/LF and prepending :nick!user@host of the user provided in the first parameter.
-        * @param user The user to prepend the :nick!user@host of
+       /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
+        * @param user The user to prepend the :nick!user\@host of
         * @param text A std::string to send to the user
         */
        void WriteFrom(User *user, const std::string &text);
 
-       /** Write text to this user, appending CR/LF and prepending :nick!user@host of the user provided in the first parameter.
-        * @param user The user to prepend the :nick!user@host of
+       /** Write text to this user, appending CR/LF and prepending :nick!user\@host of the user provided in the first parameter.
+        * @param user The user to prepend the :nick!user\@host of
         * @param text The format string for text to send to the user
         * @param ... POD-type format arguments
         */
        void WriteFrom(User *user, const char* text, ...) CUSTOM_PRINTF(3, 4);
 
-       /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user@host.
+       /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user\@host.
         * @param dest The user to route the message to
-        * @param text A std::string to send to the user
+        * @param data A std::string to send to the user
         */
        void WriteTo(User *dest, const std::string &data);
 
-       /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user@host.
+       /** Write text to the user provided in the first parameter, appending CR/LF, and prepending THIS user's :nick!user\@host.
         * @param dest The user to route the message to
-        * @param text The format string for text to send to the user
+        * @param data The format string for text to send to the user
         * @param ... POD-type format arguments
         */
        void WriteTo(User *dest, const char *data, ...) CUSTOM_PRINTF(3, 4);
 
-       /** Write to all users that can see this user (including this user in the list), appending CR/LF
-        * @param text A std::string to send to the users
+       /** Write to all users that can see this user (including this user in the list if include_self is true), appending CR/LF
+        * @param line A std::string to send to the users
+        * @param include_self Should the message be sent back to the author?
         */
        void WriteCommonRaw(const std::string &line, bool include_self = true);
 
@@ -643,7 +608,7 @@ class CoreExport User : public Extensible
         * Run this after the item in question has changed.
         * You should not need to use this function, call ChangeDisplayedHost instead
         *
-        * @param The entire QUIT line, including the source using the old value
+        * @param quitline The entire QUIT line, including the source using the old value
         */
        void DoHostCycle(const std::string &quitline);
 
@@ -661,7 +626,7 @@ class CoreExport User : public Extensible
         * ALWAYS use this function, rather than writing User::ident directly,
         * as this correctly causes the user to seem to quit (where configured)
         * before setting their ident field.
-        * @param host The new ident to set
+        * @param newident The new ident to set
         * @return True if the change succeeded, false if it didn't
         */
        bool ChangeIdent(const char* newident);
@@ -740,38 +705,36 @@ class CoreExport UserIOHandler : public StreamSocket
 
 typedef unsigned int already_sent_t;
 
-class CoreExport LocalUser : public User
+class CoreExport LocalUser : public User, public InviteBase
 {
-       /** A list of channels the user has a pending invite to.
-        * Upon INVITE channels are added, and upon JOIN, the
-        * channels are removed from this list.
-        */
-       InvitedList invites;
-
  public:
        LocalUser(int fd, irc::sockets::sockaddrs* client, irc::sockets::sockaddrs* server);
        CullResult cull();
 
        UserIOHandler eh;
 
+       /** Position in UserManager::local_users
+        */
+       LocalUserList::iterator localuseriter;
+
        /** Stats counter for bytes inbound
         */
-       int bytes_in;
+       unsigned int bytes_in;
 
        /** Stats counter for bytes outbound
         */
-       int bytes_out;
+       unsigned int bytes_out;
 
        /** Stats counter for commands inbound
         */
-       int cmds_in;
+       unsigned int cmds_in;
 
        /** Stats counter for commands outbound
         */
-       int cmds_out;
+       unsigned int cmds_out;
 
        /** Password specified by the user when they registered (if any).
-        * This is stored even if the <connect> block doesnt need a password, so that
+        * This is stored even if the \<connect> block doesnt need a password, so that
         * modules may check it.
         */
        std::string password;
@@ -782,7 +745,7 @@ class CoreExport LocalUser : public User
 
        ConnectClass* GetClass();
 
-       /** Call this method to find the matching <connect> for a user, and to check them against it.
+       /** Call this method to find the matching \<connect> for a user, and to check them against it.
         */
        void CheckClass();
 
@@ -795,10 +758,34 @@ class CoreExport LocalUser : public User
         */
        int GetServerPort();
 
+       /** Recursion fix: user is out of SendQ and will be quit as soon as possible.
+        * This can't be handled normally because QuitUser itself calls Write on other
+        * users, which could trigger their SendQ to overrun.
+        */
+       unsigned int quitting_sendq:1;
+
+       /** True when DNS lookups are completed.
+        * The UserResolver classes res_forward and res_reverse will
+        * set this value once they complete.
+        */
+       unsigned int dns_done:1;
+
+       /** has the user responded to their previous ping?
+        */
+       unsigned int lastping:1;
+
+       /** This is true if the user matched an exception (E:Line). It is used to save time on ban checks.
+        */
+       unsigned int exempt:1;
+
        /** Used by PING checking code
         */
        time_t nping;
 
+       /** Time that the connection last sent a message, used to calculate idle time
+        */
+       time_t idle_lastmsg;
+
        /** This value contains how far into the penalty threshold the user is.
         * This is used either to enable fake lag or for excess flood quits
         */
@@ -817,17 +804,27 @@ class CoreExport LocalUser : public User
         */
        void StartDNSLookup();
 
+       /** Check if the user matches a G or K line, and disconnect them if they do.
+        * @param doZline True if ZLines should be checked (if IP has changed since initial connect)
+        * Returns true if the user matched a ban, false else.
+        */
+       bool CheckLines(bool doZline = false);
+
        /** Use this method to fully connect a user.
         * This will send the message of the day, check G/K/E lines, etc.
         */
        void FullConnect();
 
        /** Set the connect class to which this user belongs to.
-        * @param explicit_name Set this string to tie the user to a specific class name. Otherwise, the class is fitted by checking <connect> tags from the configuration file.
+        * @param explicit_name Set this string to tie the user to a specific class name. Otherwise, the class is fitted by checking \<connect> tags from the configuration file.
         * @return A reference to this user's current connect class.
         */
        void SetClass(const std::string &explicit_name = "");
 
+       bool SetClientIP(const char* sip, bool recheck_eline = true);
+
+       void SetClientIP(const irc::sockets::sockaddrs& sa, bool recheck_eline = true);
+
        void SendText(const std::string& line);
        void Write(const std::string& text);
        void Write(const char*, ...) CUSTOM_PRINTF(2, 3);
@@ -835,7 +832,7 @@ class CoreExport LocalUser : public User
        /** Returns the list of channels this user has been invited to but has not yet joined.
         * @return A list of channels the user is invited to
         */
-       InvitedList* GetInviteList();
+       InviteList& GetInviteList();
 
        /** Returns true if a user is invited to a channel.
         * @param channel A channel name to look up
@@ -856,6 +853,8 @@ class CoreExport LocalUser : public User
         */
        void RemoveInvite(const irc::string &channel);
 
+       void RemoveExpiredInvites();
+
        /** Returns true or false for if a user can execute a privilaged oper command.
         * This is done by looking up their oper type from User::oper, then referencing
         * this to their oper classes and checking the commands they can execute.
@@ -940,7 +939,6 @@ class CoreExport UserResolver : public Resolver
        bool fwd;
  public:
        /** Create a resolver.
-        * @param Instance The creating instance
         * @param user The user to begin lookup on
         * @param to_resolve The IP or host to resolve
         * @param qt The query type