]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/users.h
Header update: 2007 -> 2008
[user/henk/code/inspircd.git] / include / users.h
index 17bc9ca2aebdbef53a126fd5b482ca2a429983eb..dbcc345cb316cc65fd06ef54da43601160241211 100644 (file)
@@ -2,7 +2,7 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd: (C) 2002-2007 InspIRCd Development Team
+ *  InspIRCd: (C) 2002-2008 InspIRCd Development Team
  * See: http://www.inspircd.org/wiki/index.php/Credits
  *
  * This program is free but copyrighted software; see
@@ -85,7 +85,7 @@ class CoreExport UserResolver : public Resolver
  private:
        /** User this class is 'attached' to.
         */
-       userrec* bound_user;
+       User* bound_user;
        /** File descriptor teh lookup is bound to
         */
        int bound_fd;
@@ -100,7 +100,7 @@ class CoreExport UserResolver : public Resolver
         * @param qt The query type
         * @param cache Modified by the constructor if the result was cached
         */
-       UserResolver(InspIRCd* Instance, userrec* user, std::string to_resolve, QueryType qt, bool &cache);
+       UserResolver(InspIRCd* Instance, User* user, std::string to_resolve, QueryType qt, bool &cache);
 
        /** Called on successful lookup
         * @param result Result string
@@ -175,10 +175,22 @@ class CoreExport ConnectClass : public classbase
 
 public:
 
+       /** Create a new connect class based on an existing connect class. This is required for std::vector (at least under windows).
+        */
+       ConnectClass(const ConnectClass* source) : classbase(), type(source->type), name(source->name),
+               registration_timeout(source->registration_timeout), flood(source->flood), host(source->host),
+               pingtime(source->pingtime), pass(source->pass), threshold(source->threshold), sendqmax(source->sendqmax),
+               recvqmax(source->recvqmax), maxlocal(source->maxlocal), maxglobal(source->maxglobal), maxchans(source->maxchans),
+               port(source->port), RefCount(0), disabled(false), limit(0)
+       {
+       }
+
        /** Create a new connect class with no settings.
         */
        ConnectClass() : type(CC_DENY), name("unnamed"), registration_timeout(0), flood(0), host(""), pingtime(0), pass(""),
-                       threshold(0), sendqmax(0), recvqmax(0), maxlocal(0), maxglobal(0) { }
+                       threshold(0), sendqmax(0), recvqmax(0), maxlocal(0), maxglobal(0), RefCount(0), disabled(false), limit(0)
+       {
+       }
 
        /** Create a new connect class to ALLOW connections.
         * @param thename Name of the connect class
@@ -197,32 +209,44 @@ public:
                        const std::string &pas, unsigned int thres, unsigned long sendq, unsigned long recvq,
                        unsigned long maxl, unsigned long maxg, unsigned int maxc, int p = 0) :
                        type(CC_ALLOW), name(thename), registration_timeout(timeout), flood(fld), host(hst), pingtime(ping), pass(pas),
-                       threshold(thres), sendqmax(sendq), recvqmax(recvq), maxlocal(maxl), maxglobal(maxg), maxchans(maxc), port(p) { }
+                       threshold(thres), sendqmax(sendq), recvqmax(recvq), maxlocal(maxl), maxglobal(maxg), maxchans(maxc), port(p), RefCount(0), disabled(false), limit(0) { }
 
        /** Create a new connect class to DENY connections
         * @param thename Name of the connect class
         * @param hst The IP mask to deny
         */
        ConnectClass(const std::string &thename, const std::string &hst) : type(CC_DENY), name(thename), registration_timeout(0),
-                       flood(0), host(hst), pingtime(0), pass(""), threshold(0), sendqmax(0), recvqmax(0), maxlocal(0), maxglobal(0), maxchans(0), port(0) { }
+                       flood(0), host(hst), pingtime(0), pass(""), threshold(0), sendqmax(0), recvqmax(0), maxlocal(0), maxglobal(0), maxchans(0), port(0), RefCount(0), disabled(false), limit(0)
+       {
+       }
 
        /* Create a new connect class based on another class
         * @param thename The name of the connect class
         * @param source Another connect class to inherit all but the name from
         */
-       ConnectClass(const std::string &thename, const ConnectClass &source) : type(source.type), name(thename),
-                               registration_timeout(source.registration_timeout), flood(source.flood), host(source.host),
-                               pingtime(source.pingtime), pass(source.pass), threshold(source.threshold), sendqmax(source.sendqmax),
-                               recvqmax(source.recvqmax), maxlocal(source.maxlocal), maxglobal(source.maxglobal), maxchans(source.maxchans),
-                               port(source.port)
+       ConnectClass(const std::string &thename, const ConnectClass* source) : type(source->type), name(thename),
+                               registration_timeout(source->registration_timeout), flood(source->flood), host(source->host),
+                               pingtime(source->pingtime), pass(source->pass), threshold(source->threshold), sendqmax(source->sendqmax),
+                               recvqmax(source->recvqmax), maxlocal(source->maxlocal), maxglobal(source->maxglobal), maxchans(source->maxchans),
+                               port(source->port), RefCount(0), disabled(false), limit(0)
+       {
+       }
+
+       void SetDisabled(bool t)
        {
+               this->disabled = t;
+       }
+
+       bool GetDisabled()
+       {
+               return this->disabled;
        }
 
        /* Update an existing entry with new values
         */
        void Update(unsigned int timeout, unsigned int fld, const std::string &hst, unsigned int ping,
                                const std::string &pas, unsigned int thres, unsigned long sendq, unsigned long recvq,
-                               unsigned long maxl, unsigned long maxg, unsigned int maxc, int p)
+                               unsigned long maxl, unsigned long maxg, unsigned int maxc, int p, unsigned long limit)
        {
                if (timeout)
                        registration_timeout = timeout;
@@ -248,8 +272,24 @@ public:
                        maxchans = maxc;
                if (p)
                        port = p;
+
+               this->limit = limit;
        }
 
+       /** Reference counter. Contains an int as to how many users are connected to this class. :)
+        * This will be 0 if no users are connected. If a <connect> is removed from the config, and there
+        * are 0 users on it - it will go away in RAM. :)
+        */
+       unsigned long RefCount;
+
+       /** If this is true, any attempt to set a user to this class will fail. Default false. This is really private, it's only in the public section thanks to the way this class is written
+        */
+       bool disabled;
+
+       /** How many users may be in this connect class before they are refused? (0 = disabled = default)
+        */
+       unsigned long limit;
+
        int GetMaxChans()
        {
                return maxchans;
@@ -350,11 +390,6 @@ public:
        {
                return maxglobal;
        }
-
-       bool operator= (ConnectClass &other)
-       {
-               return (other.GetName() == name);
-       }
 };
 
 /** Holds a complete list of all channels to which a user has been invited and has not yet joined.
@@ -363,11 +398,11 @@ typedef std::vector<irc::string> InvitedList;
 
 /** Holds a complete list of all allow and deny tags from the configuration file (connection classes)
  */
-typedef std::vector<ConnectClass> ClassVector;
+typedef std::vector<ConnectClass*> ClassVector;
 
 /** Typedef for the list of user-channel records for a user
  */
-typedef std::map<chanrec*, char> UserChanList;
+typedef std::map<Channel*, char> UserChanList;
 
 /** Shorthand for an iterator into a UserChanList
  */
@@ -375,10 +410,10 @@ typedef UserChanList::iterator UCListIter;
 
 /* Required forward declaration
  */
-class userrec;
+class User;
 
 /** Visibility data for a user.
- * If a user has a non-null instance of this class in their userrec,
+ * If a user has a non-null instance of this class in their User,
  * then it is used to determine if this user is visible to other users
  * or not.
  */
@@ -395,7 +430,7 @@ class CoreExport VisData
         * @param user The other user to compare to
         * @return true True if the user is visible to the other user, false if not
         */
-       virtual bool VisibleTo(userrec* user);
+       virtual bool VisibleTo(User* user);
 };
 
 /** Holds all information about a user
@@ -405,12 +440,12 @@ class CoreExport VisData
  * by nickname, or the FindDescriptor method of the InspIRCd class to find a specific user by their
  * file descriptor value.
  */
-class CoreExport userrec : public connection
+class CoreExport User : public connection
 {
  private:
        /** Pointer to creator.
         * This is required to make use of core functions
-        * from within the userrec class.
+        * from within the User class.
         */
        InspIRCd* ServerInstance;
 
@@ -454,17 +489,24 @@ class CoreExport userrec : public connection
         */
        unsigned int MaxChans;
 
+       std::map<std::string, bool>* AllowedOperCommands;
+
  public:
+       /** Contains a pointer to the connect class a user is on from - this will be NULL for remote connections.
+        * The pointer is guarenteed to *always* be valid. :)
+        */
+       ConnectClass *MyClass;
+
        /** Resolvers for looking up this users IP address
         * This will occur if and when res_reverse completes.
-        * When this class completes its lookup, userrec::dns_done
+        * When this class completes its lookup, User::dns_done
         * will be set from false to true.
         */
        UserResolver* res_forward;
 
        /** Resolvers for looking up this users hostname
-        * This is instantiated by userrec::StartDNSLookup(),
-        * and on success, instantiates userrec::res_reverse.
+        * This is instantiated by User::StartDNSLookup(),
+        * and on success, instantiates User::res_reverse.
         */
        UserResolver* res_reverse;
 
@@ -478,7 +520,7 @@ class CoreExport userrec : public connection
 
        /** Starts a DNS lookup of the user's IP.
         * This will cause two UserResolver classes to be instantiated.
-        * When complete, these objects set userrec::dns_done to true.
+        * When complete, these objects set User::dns_done to true.
         */
        void StartDNSLookup();
 
@@ -501,7 +543,7 @@ class CoreExport userrec : public connection
        char ident[IDENTMAX+2];
 
        /** The host displayed to non-opers (used for cloaking etc).
-        * This usually matches the value of userrec::host.
+        * This usually matches the value of User::host.
         */
        char dhost[65];
 
@@ -514,7 +556,7 @@ class CoreExport userrec : public connection
         * this is an array of values in a similar way to channel modes.
         * A value of 1 in field (modeletter-65) indicates that the mode is
         * set, for example, to work out if mode +s is set, we  check the field
-        * userrec::modes['s'-65] != 0.
+        * User::modes['s'-65] != 0.
         * The following RFC characters o, w, s, i have constants defined via an
         * enum, such as UM_SERVERNOTICE and UM_OPETATOR.
         */
@@ -538,12 +580,6 @@ class CoreExport userrec : public connection
         */
        char awaymsg[MAXAWAY+1];
 
-       /** Number of lines the user can place into the buffer
-        * (up to the global NetBufferSize bytes) before they
-        * are disconnected for excess flood
-        */
-       int flood;
-
        /** Timestamp of current time + connection class timeout.
         * This user must send USER/NICK before this timestamp is
         * reached or they will be disconnected.
@@ -563,10 +599,6 @@ class CoreExport userrec : public connection
         */
        bool dns_done;
 
-       /** Number of seconds between PINGs for this user (set from &lt;connect:allow&gt; tag
-        */
-       unsigned int pingmax;
-
        /** Password specified by the user when they registered.
         * This is stored even if the <connect> block doesnt need a password, so that
         * modules may check it.
@@ -586,16 +618,12 @@ class CoreExport userrec : public connection
 
        /** Flood counters - lines received
         */
-       int lines_in;
+       unsigned int lines_in;
 
        /** Flood counters - time lines_in is due to be reset
         */
        time_t reset_due;
 
-       /** Flood counters - Highest value lines_in may reach before the user gets disconnected
-        */
-       long threshold;
-
        /** If this is set to true, then all read operations for the user
         * are dropped into the bit-bucket.
         * This is used by the global CullList, but please note that setting this value
@@ -631,40 +659,33 @@ class CoreExport userrec : public connection
         */
        const char* GetIPString();
 
-       /** Get IP string from sockaddr, using caller-specified buffer
-        * @param buf A buffer to use
-        * @return The IP string
-        */
-       const char* GetIPString(char* buf);
-
        /* Write error string
         */
        std::string WriteError;
 
-       /** Maximum size this user's sendq can become.
-        * Copied from the connect class on connect.
+       /** This is true if the user matched an exception (E:Line). It is used to save time on ban checks.
         */
-       long sendqmax;
+       bool exempt;
 
-       /** Maximum size this user's recvq can become.
-        * Copied from the connect class on connect.
+       /** This value contains how far into the penalty threshold the user is. Once its over
+        * the penalty threshold then commands are held and processed on-timer.
         */
-       long recvqmax;
+       int Penalty;
 
-       /** This is true if the user matched an exception when they connected to the ircd.
-        * It isnt valid after this point, and you should not attempt to do anything with it
-        * after this point, because the eline might be removed at a later time, and/or no
-        * longer be applicable to this user. It is only used to save doing the eline lookup
-        * twice (instead we do it once and set this value).
+       /** True if we are flushing penalty lines
         */
-       bool exempt;
+       bool OverPenalty;
+
+       /** If this bool is set then penalty rules do not apply to this user
+        */
+       bool ExemptFromPenalty;
 
        /** Default constructor
-        * @throw Nothing at present
+        * @throw CoreException if the UID allocated to the user already exists
         * @param Instance Creator instance
         * @param uid User UUID, or empty to allocate one automatically
         */
-       userrec(InspIRCd* Instance, const std::string &uid = "");
+       User(InspIRCd* Instance, const std::string &uid = "");
 
        /** Returns the full displayed host of the user
         * This member function returns the hostname of the user as seen by other users
@@ -747,7 +768,7 @@ class CoreExport userrec : public connection
        virtual void RemoveInvite(const irc::string &channel);
 
        /** Returns true or false for if a user can execute a privilaged oper command.
-        * This is done by looking up their oper type from userrec::oper, then referencing
+        * 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.
         * @param command A command (should be all CAPS)
         * @return True if this user can execute the command
@@ -857,7 +878,7 @@ class CoreExport userrec : public connection
         * @param oreason The quit reason to show to opers
         * @return Although this function has no return type, on exit the user provided will no longer exist.
         */
-       static void QuitUser(InspIRCd* Instance, userrec *user, const std::string &r, const char* oreason = "");
+       static void QuitUser(InspIRCd* Instance, User *user, const std::string &r, const char* oreason = "");
 
        /** Add the user to WHOWAS system
         */
@@ -867,11 +888,11 @@ class CoreExport userrec : public connection
         * This will also give the +o usermode.
         * @param opertype The oper type to oper as
         */
-       void Oper(const std::string &opertype);
+       void Oper(const std::string &opertype, const std::string &opername);
 
        /** Call this method to find the matching <connect> for a user, and to check them against it.
         */
-       void CheckClass(const std::string &explicit_class = "");
+       void CheckClass();
 
        /** Use this method to fully connect a user.
         * This will send the message of the day, check G/K/E lines, etc.
@@ -882,9 +903,9 @@ class CoreExport userrec : public connection
         * You should not call this function directly. It is used by the core
         * to update the users hash entry on a nickchange.
         * @param New new user_hash key
-        * @return Pointer to userrec in hash (usually 'this')
+        * @return Pointer to User in hash (usually 'this')
         */
-       userrec* UpdateNickHash(const char* New);
+       User* UpdateNickHash(const char* New);
 
        /** Force a nickname change.
         * If the nickname change fails (for example, because the nick in question
@@ -896,7 +917,7 @@ class CoreExport userrec : public connection
        bool ForceNickChange(const char* newnick);
 
        /** Add a client to the system.
-        * This will create a new userrec, insert it into the user_hash,
+        * This will create a new User, insert it into the user_hash,
         * initialize it as not yet registered, and add it to the socket engine.
         * @param Instance a pointer to the server instance
         * @param socket The socket id (file descriptor) this user is on
@@ -924,7 +945,7 @@ class CoreExport userrec : public connection
 
        /** Remove all clone counts from the user, you should
         * use this if you change the user's IP address in
-        * userrec::ip after they have registered.
+        * User::ip after they have registered.
         */
        void RemoveCloneCounts();
 
@@ -954,27 +975,27 @@ class CoreExport userrec : public connection
         * @param user The user to prepend the :nick!user@host of
         * @param text A std::string to send to the user
         */
-       void WriteFrom(userrec *user, const std::string &text);
+       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
         * @param text The format string for text to send to the user
         * @param ... POD-type format arguments
         */
-       void WriteFrom(userrec *user, const char* text, ...);
+       void WriteFrom(User *user, const char* text, ...);
 
        /** 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
         */
-       void WriteTo(userrec *dest, const std::string &data);
+       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.
         * @param dest The user to route the message to
         * @param text The format string for text to send to the user
         * @param ... POD-type format arguments
         */
-       void WriteTo(userrec *dest, const char *data, ...);
+       void WriteTo(User *dest, const char *data, ...);
 
        /** 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
@@ -998,7 +1019,7 @@ class CoreExport userrec : public connection
         */
        void WriteCommonExcept(const std::string &text);
 
-       /** Write a quit message to all common users, as in userrec::WriteCommonExcept but with a specific
+       /** Write a quit message to all common users, as in User::WriteCommonExcept but with a specific
         * quit message for opers only.
         * @param normal_text Normal user quit message
         * @param oper_text Oper only quit message
@@ -1022,10 +1043,10 @@ class CoreExport userrec : public connection
         * @param other The other user to compare the channel list against
         * @return True if the given user shares at least one channel with this user
         */
-       bool SharesChannelWith(userrec *other);
+       bool SharesChannelWith(User *other);
 
        /** Change the displayed host of a user.
-        * ALWAYS use this function, rather than writing userrec::dhost directly,
+        * ALWAYS use this function, rather than writing User::dhost directly,
         * as this triggers module events allowing the change to be syncronized to
         * remote servers. This will also emulate a QUIT and rejoin (where configured)
         * before setting their host field.
@@ -1035,7 +1056,7 @@ class CoreExport userrec : public connection
        bool ChangeDisplayedHost(const char* host);
 
        /** Change the ident (username) of a user.
-        * ALWAYS use this function, rather than writing userrec::ident directly,
+        * 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
@@ -1044,7 +1065,7 @@ class CoreExport userrec : public connection
        bool ChangeIdent(const char* newident);
 
        /** Change a users realname field.
-        * ALWAYS use this function, rather than writing userrec::fullname directly,
+        * ALWAYS use this function, rather than writing User::fullname directly,
         * as this triggers module events allowing the change to be syncronized to
         * remote servers.
         * @param gecos The user's new realname
@@ -1067,25 +1088,30 @@ class CoreExport userrec : public connection
         * @param The user to send the channel list to if it is not too long
         * @return This user's channel list
         */
-       std::string ChannelList(userrec* source);
+       std::string ChannelList(User* source);
 
        /** Split the channel list in cl which came from dest, and spool it to this user
         * Used internally by WHOIS
         * @param dest The user the original channel list came from
-        * @param cl The  channel list as a string obtained from userrec::ChannelList()
+        * @param cl The  channel list as a string obtained from User::ChannelList()
         */
-       void SplitChanList(userrec* dest, const std::string &cl);
+       void SplitChanList(User* dest, const std::string &cl);
 
        /** Remove this user from all channels they are on, and delete any that are now empty.
         * This is used by QUIT, and will not send part messages!
         */
        void PurgeEmptyChannels();
 
-       /** Get the connect class which matches this user's host or IP address
-        * @param explicit_name Set this string to tie the user to a specific class name
-        * @return A reference to this user's connect class
+       /** Get the connect class which this user belongs to.
+        * @return A pointer to this user's connect class
         */
-       ConnectClass* GetClass(const std::string &explicit_name = "");
+       ConnectClass *GetClass();
+
+       /** 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.
+        * @return A reference to this user's current connect class.
+        */
+       ConnectClass *SetClass(const std::string &explicit_name = "");
 
        /** Show the message of the day to this user
         */
@@ -1105,6 +1131,14 @@ class CoreExport userrec : public connection
         */
        const char* GetOperQuit();
 
+       /** Increases a user's command penalty by a set amount.
+        */
+       void IncreasePenalty(int increase);
+
+       /** Decreases a user's command penalty by a set amount.
+        */
+       void DecreasePenalty(int decrease);
+
        /** Handle socket event.
         * From EventHandler class.
         * @param et Event type
@@ -1114,7 +1148,7 @@ class CoreExport userrec : public connection
 
        /** Default destructor
         */
-       virtual ~userrec();
+       virtual ~User();
 };
 
 /* Configuration callbacks */