]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - include/mode.h
Valgrind cleanup: deallocate RFC modes, clientlist, and uuidlist
[user/henk/code/inspircd.git] / include / mode.h
index f6022c0901e80a577e00e05578d6fcd66772cc11..da202c2364c5f09e2a2703f36ef72d878a3bc50c 100644 (file)
@@ -2,8 +2,8 @@
  *       | Inspire Internet Relay Chat Daemon |
  *       +------------------------------------+
  *
- *  InspIRCd: (C) 2002-2008 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.
@@ -17,6 +17,7 @@
 /* Forward declarations. */
 class User;
 
+#include "ctables.h"
 #include "channels.h"
 
 /**
@@ -90,7 +91,7 @@ typedef std::pair<bool,std::string> ModePair;
  * mode is expected to have a parameter, then this is
  * equivalent to returning MODEACTION_DENY.
  */
-class CoreExport ModeHandler : public Extensible
+class CoreExport ModeHandler : public classbase
 {
  protected:
        /**
@@ -125,6 +126,10 @@ class CoreExport ModeHandler : public Extensible
         * MODETYPE_CHANNEL.
         */
        ModeType m_type;
+       /**
+        * The mode parameter translation type
+        */
+       TranslateType m_paramtype;
        /**
         * True if the mode requires oper status
         * to set.
@@ -161,7 +166,8 @@ class CoreExport ModeHandler : public Extensible
         * and the rank values OP_VALUE, HALFOP_VALUE and VOICE_VALUE respectively. Any prefixes you define should have unique values proportional
         * to these three defaults or proportional to another mode in a module you depend on. See src/cmode_o.cpp as an example.
         */
-       ModeHandler(InspIRCd* Instance, char modeletter, int parameters_on, int parameters_off, bool listmode, ModeType type, bool operonly, char mprefix = 0, char prefixrequired = '%');
+       ModeHandler(InspIRCd* Instance, char modeletter, int parameters_on, int parameters_off, bool listmode, ModeType type, bool operonly,
+               char mprefix = 0, char prefixrequired = '%', TranslateType translate = TR_TEXT);
        /**
         * The default destructor does nothing
         */
@@ -191,9 +197,13 @@ class CoreExport ModeHandler : public Extensible
         */
        virtual unsigned int GetPrefixRank();
        /**
-        * Returns the modes type
+        * Returns the mode's type
         */
        ModeType GetModeType();
+       /**
+        * Returns the mode's parameter translation type
+        */
+       TranslateType GetTranslateType();
        /**
         * Returns true if the mode can only be set/unset by an oper
         */
@@ -211,6 +221,10 @@ class CoreExport ModeHandler : public Extensible
         */
        char GetModeChar();
 
+       /** For user modes, return the current parameter, if any
+        */
+       virtual std::string GetUserParameter(User* useor);
+
        /**
         * Called when a mode change for your mode occurs.
         * @param source Contains the user setting the mode.
@@ -232,6 +246,14 @@ class CoreExport ModeHandler : public Extensible
         */
        virtual void DisplayList(User* user, Channel* channel);
 
+       /** In the event that the mode should be given a parameter, and no parameter was provided, this method is called.
+        * This allows you to give special information to the user, or handle this any way you like.
+        * @param user The user issuing the mode change
+        * @param dest For user mode changes, the target of the mode. For channel mode changes, NULL.
+        * @param channel For channel mode changes, the target of the mode. For user mode changes, NULL.
+        */
+       virtual void OnParameterMissing(User* user, User* dest, Channel* channel);
+
        /**
         * If your mode is a listmode, this method will be called to display an empty list (just the end of list numeric)
         * @param user The user issuing the command
@@ -244,14 +266,12 @@ class CoreExport ModeHandler : public Extensible
         * override this function and use it to return true or false. The default implementation just returns true if
         * theirs < ours. This will only be called for non-listmodes with parameters, when adding the mode and where
         * theirs == ours (therefore the default implementation will always return false).
-        * @param theirs The timestamp of the remote side
-        * @param ours The timestamp of the local side
         * @param their_param Their parameter if the mode has a parameter
         * @param our_param Our parameter if the mode has a parameter
         * @param channel The channel we are checking against
         * @return True if the other side wins the merge, false if we win the merge for this mode.
         */
-       virtual bool CheckTimeStamp(time_t theirs, time_t ours, const std::string &their_param, const std::string &our_param, Channel* channel);
+       virtual bool CheckTimeStamp(std::string &their_param, const std::string &our_param, Channel* channel);
 
        /**
         * When a remote server needs to bounce a set of modes, it will call this method for every mode
@@ -276,7 +296,7 @@ class CoreExport ModeHandler : public Extensible
         * your mode properly from each user.
         * @param user The user which the server wants to remove your mode from
         */
-       virtual void RemoveMode(User* user);
+       virtual void RemoveMode(User* user, irc::modestacker* stack = NULL);
 
        /**
         * When a MODETYPE_CHANNEL mode handler is being removed, the server will call this method for every channel on the server.
@@ -286,20 +306,46 @@ class CoreExport ModeHandler : public Extensible
         * your mode properly from each channel. Note that in the case of listmodes, you should remove the entire list of items.
         * @param channel The channel which the server wants to remove your mode from
         */
-       virtual void RemoveMode(Channel* channel);
+       virtual void RemoveMode(Channel* channel, irc::modestacker* stack = NULL);
 
        char GetNeededPrefix();
 
        void SetNeededPrefix(char needsprefix);
 };
 
+/** A prebuilt mode handler which handles a simple user mode, e.g. no parameters, usable by any user, with no extra
+ * behaviour to the mode beyond the basic setting and unsetting of the mode, not allowing the mode to be set if it
+ * is already set and not allowing it to be unset if it is already unset.
+ * An example of a simple user mode is user mode +w.
+ */
+class CoreExport SimpleUserModeHandler : public ModeHandler
+{
+ public:
+       SimpleUserModeHandler(InspIRCd* Instance, char modeletter);
+       virtual ~SimpleUserModeHandler();
+       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, bool servermode = false);
+};
+
+/** A prebuilt mode handler which handles a simple channel mode, e.g. no parameters, usable by any user, with no extra
+ * behaviour to the mode beyond the basic setting and unsetting of the mode, not allowing the mode to be set if it
+ * is already set and not allowing it to be unset if it is already unset.
+ * An example of a simple channel mode is channel mode +s.
+ */
+class CoreExport SimpleChannelModeHandler : public ModeHandler
+{
+ public:
+       SimpleChannelModeHandler(InspIRCd* Instance, char modeletter);
+       virtual ~SimpleChannelModeHandler();
+       virtual ModeAction OnModeChange(User* source, User* dest, Channel* channel, std::string &parameter, bool adding, bool servermode = false);
+};
+
 /**
  * The ModeWatcher class can be used to alter the behaviour of a mode implemented
  * by the core or by another module. To use ModeWatcher, derive a class from it,
  * and attach it to the mode using Server::AddModeWatcher and Server::DelModeWatcher.
  * A ModeWatcher will be called both before and after the mode change.
  */
-class CoreExport ModeWatcher : public Extensible
+class CoreExport ModeWatcher : public classbase
 {
  protected:
        /**
@@ -392,17 +438,33 @@ class CoreExport ModeParser : public classbase
         * Used by ModeParser::Process.
         */
        void DisplayCurrentModes(User *user, User* targetuser, Channel* targetchannel, const char* text);
+       /** Displays the value of a list mode
+        * Used by ModeParser::Process.
+        */
+       void DisplayListModes(User* user, Channel* chan, std::string &mode_sequence);
+
+       /**
+        * Attempts to apply a mode change to a user or channel
+        */
+       ModeAction TryMode(User* user, User* targu, Channel* targc, bool adding, unsigned char mode, std::string &param, bool servermode, bool SkipACL);
 
        /** The string representing the last set of modes to be parsed.
         * Use GetLastParse() to get this value, to be used for  display purposes.
         */
        std::string LastParse;
+       std::vector<std::string> LastParseParams;
+       std::vector<TranslateType> LastParseTranslate;
+
+       unsigned int sent[256];
+
+       unsigned int seq;
 
  public:
 
        /** The constructor initializes all the RFC basic modes by using ModeParserAddMode().
         */
        ModeParser(InspIRCd* Instance);
+       ~ModeParser();
 
        /** Used to check if user 'd' should be allowed to do operation 'MASK' on channel 'chan'.
         * for example, should 'user A' be able to 'op' on 'channel B'.
@@ -418,22 +480,24 @@ class CoreExport ModeParser : public classbase
         * E.g.
         *
         * nick -> nick!*@*
-        * 
+        *
         * nick!ident -> nick!ident@*
-        * 
+        *
         * host.name -> *!*@host.name
-        * 
+        *
         * ident@host.name -> *!ident@host.name
         *
         * This method can be used on both IPV4 and IPV6 user masks.
         */
        static void CleanMask(std::string &mask);
-       /** Get the last string to be processed, as it was sent to the user or channel. 
+       /** Get the last string to be processed, as it was sent to the user or channel.
         * Use this to display a string you just sent to be parsed, as the actual output
         * may be different to what you sent after it has been 'cleaned up' by the parser.
         * @return Last parsed string, as seen by users.
         */
        const std::string& GetLastParse();
+       const std::vector<std::string>& GetLastParseParams() { return LastParseParams; }
+       const std::vector<TranslateType>& GetLastParseTranslate() { return LastParseTranslate; }
        /** Add a mode to the mode parser.
         * @return True if the mode was successfully added.
         */
@@ -466,13 +530,12 @@ class CoreExport ModeParser : public classbase
        /** Process a set of mode changes from a server or user.
         * @param parameters The parameters of the mode change, in the format
         * they would be from a MODE command.
-        * @param pcnt The number of items in the parameters array
         * @param user The user setting or removing the modes. When the modes are set
         * by a server, an 'uninitialized' User is used, where *user::nick == NULL
         * and *user->server == NULL.
         * @param servermode True if a server is setting the mode.
         */
-       void Process(const char* const* parameters, int pcnt, User *user, bool servermode);
+       void Process(const std::vector<std::string>& parameters, User *user, bool servermode, bool merge = false);
 
        /** Find the mode handler for a given mode and type.
         * @param modeletter mode letter to search for
@@ -503,9 +566,14 @@ class CoreExport ModeParser : public classbase
         */
        std::string ParaModeList();
 
-       /** Generates the CHANMODES= 005 sequence
+       /** Generates a list of modes, comma seperated by type:
+        *  1; Listmodes EXCEPT those with a prefix
+        *  2; Modes that take a param when adding or removing
+        *  3; Modes that only take a param when adding
+        *  4; Modes that dont take a param
         */
-       std::string ChanModes();
+       std::string GiveModeList(ModeMasks m);
+
        /** Used by this class internally during std::sort and 005 generation
         */
        static bool PrefixComparison(prefixtype one, prefixtype two);
@@ -520,10 +588,11 @@ class CoreExport ModeParser : public classbase
         * similar purposes.
         * @param user The username to look up
         * @param channel The channel name to look up the privilages of the user for
+        * @param nick_suffix true (the default) if you want nicknames in the mode string, for easy
+        * use with the mode stacker, false if you just want the "avh" part of "avh nick nick nick".
         * @return The mode string.
         */
-       std::string ModeString(User* user, Channel* channel);
+       std::string ModeString(User* user, Channel* channel, bool nick_suffix = true);
 };
 
 #endif
-