X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fu_listmode.h;h=6c6e2ca28fbc63374a5e9c096e824eb390983c48;hb=3f971b447fae258a92f2cc6645497cce93f1c04e;hp=a2a3940451ff3fd99216dce2000d299c5a9a2b31;hpb=4e7fa39cc520bef9381f092f29b7fa8c17a9fd4a;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/include/u_listmode.h b/include/u_listmode.h index a2a394045..6c6e2ca28 100644 --- a/include/u_listmode.h +++ b/include/u_listmode.h @@ -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 @@ -14,24 +14,10 @@ #ifndef INSPIRCD_LISTMODE_PROVIDER #define INSPIRCD_LISTMODE_PROVIDER -#include -#include -#include -#include -#include "users.h" -#include "channels.h" -#include "modules.h" #include "wildcard.h" -#include "inspircd.h" - -/* $ModDesc: Provides support for easily creating listmodes, stores the time set, the user, and a parameter. */ - -/* Updated to use the config tag if it exists */ -/* Written by Om , December 2005. */ -/* Based on code previously written by Om - April 2005 */ -/* Updated to new API July 8th 2006 by Brain */ -/* Originally based on m_chanprotect and m_silence */ +/** Get the time as a string + */ inline std::string stringtime() { std::ostringstream TIME; @@ -58,39 +44,77 @@ public: unsigned int limit; }; -// Just defining the type we use for the exception list here... +/** Items stored in the channel's list + */ typedef std::vector modelist; +/** Max items per channel by name + */ typedef std::vector limitlist; +/** A request used to check if a user is on a channel's list or not + */ class ListModeRequest : public Request { public: - userrec* user; - chanrec* chan; - - ListModeRequest(Module* sender, Module* target, userrec* u, chanrec* c) : Request(sender, target, "LM_CHECKLIST"), user(u), chan(c) + User* user; + Channel* chan; + + /** Check if a user is on a channel's list. + * The Event::Send() event returns true if the user is on the channel's list. + * @param sender Sending module + * @param target Target module + * @param u User to check against + * @param c Channel to check against + */ + ListModeRequest(Module* sender, Module* target, User* u, Channel* c) : Request(sender, target, "LM_CHECKLIST"), user(u), chan(c) { } + /** Destructor + */ ~ListModeRequest() { } }; -/** The base class for listmodes defined by u_listmode.h +/** The base class for list modes, should be inherited. */ class ListModeBase : public ModeHandler { protected: + /** Storage key + */ std::string infokey; + /** Numeric to use when outputting the list + */ std::string listnumeric; + /** Numeric to indicate end of list + */ std::string endoflistnumeric; + /** String to send for end of list + */ std::string endofliststring; + /** Automatically tidy up entries + */ bool tidy; + /** Config tag to check for max items per channel + */ std::string configtag; + /** Limits on a per-channel basis read from the tag + * specified in ListModeBase::configtag + */ limitlist chanlimits; public: + /** Constructor. + * @param Instance The creator of this class + * @param modechar Mode character + * @param eolstr End of list string + * @pram lnum List numeric + * @param eolnum End of list numeric + * @param autotidy Automatically tidy list entries on add + * @param ctag Configuration tag to get limits from + */ ListModeBase(InspIRCd* Instance, char modechar, const std::string &eolstr, const std::string &lnum, const std::string &eolnum, bool autotidy, const std::string &ctag = "banlist") : ModeHandler(Instance, modechar, 1, 1, true, MODETYPE_CHANNEL, false), listnumeric(lnum), endoflistnumeric(eolnum), endofliststring(eolstr), tidy(autotidy), configtag(ctag) { @@ -98,7 +122,9 @@ class ListModeBase : public ModeHandler infokey = "listbase_mode_" + std::string(1, mode) + "_list"; } - std::pair ModeSet(userrec* source, userrec* dest, chanrec* channel, const std::string ¶meter) + /** See mode.h + */ + std::pair ModeSet(User*, User*, Channel* channel, const std::string ¶meter) { modelist* el; channel->GetExt(infokey, el); @@ -115,7 +141,11 @@ class ListModeBase : public ModeHandler return std::make_pair(false, parameter); } - virtual void DisplayList(userrec* user, chanrec* channel) + /** Display the list for this mode + * @param user The user to send the list to + * @param channel The channel the user is requesting the list for + */ + virtual void DisplayList(User* user, Channel* channel) { modelist* el; channel->GetExt(infokey, el); @@ -129,7 +159,16 @@ class ListModeBase : public ModeHandler user->WriteServ("%s %s %s :%s", endoflistnumeric.c_str(), user->nick, channel->name, endofliststring.c_str()); } - virtual void RemoveMode(chanrec* channel) + virtual void DisplayEmptyList(User* user, Channel* channel) + { + user->WriteServ("%s %s %s :%s", endoflistnumeric.c_str(), user->nick, channel->name, endofliststring.c_str()); + } + + /** Remove all instances of the mode from a channel. + * See mode.h + * @param channel The channel to remove all instances of the mode from + */ + virtual void RemoveMode(Channel* channel, irc::modestacker* stack) { modelist* el; channel->GetExt(infokey, el); @@ -139,30 +178,39 @@ class ListModeBase : public ModeHandler std::deque stackresult; const char* mode_junk[MAXMODES+2]; mode_junk[0] = channel->name; - userrec* n = new userrec(ServerInstance); - n->SetFd(FD_MAGIC_NUMBER); + for (modelist::iterator it = el->begin(); it != el->end(); it++) { - modestack.Push(this->GetModeChar(), assign(it->mask)); + if (stack) + stack->Push(this->GetModeChar(), assign(it->mask)); + else + modestack.Push(this->GetModeChar(), assign(it->mask)); } + + if (stack) + return; + while (modestack.GetStackedLine(stackresult)) { for (size_t j = 0; j < stackresult.size(); j++) { mode_junk[j+1] = stackresult[j].c_str(); } - ServerInstance->SendMode(mode_junk, stackresult.size() + 1, n); - } - delete n; + ServerInstance->SendMode(mode_junk, stackresult.size() + 1, ServerInstance->FakeClient); + } } } - virtual void RemoveMode(userrec* user) + /** See mode.h + */ + virtual void RemoveMode(User*, irc::modestacker* stack) { /* Listmodes dont get set on users */ } + /** Perform a rehash of this mode's configuration data + */ virtual void DoRehash() { ConfigReader Conf(ServerInstance); @@ -188,12 +236,18 @@ class ListModeBase : public ModeHandler } } - virtual void DoImplements(char* List) + /** Populate the Implements list with the correct events for a List Mode + */ + virtual void DoImplements(Module* m) { - List[I_OnChannelDelete] = List[I_OnSyncChannel] = List[I_OnCleanup] = List[I_OnRehash] = 1; + Implementation eventlist[] = { I_OnChannelDelete, I_OnSyncChannel, I_OnCleanup, I_OnRehash }; + ServerInstance->Modules->Attach(eventlist, m, 4); } - virtual ModeAction OnModeChange(userrec* source, userrec* dest, chanrec* channel, std::string ¶meter, bool adding) + /** Handle the list mode. + * See mode.h + */ + virtual ModeAction OnModeChange(User* source, User*, Channel* channel, std::string ¶meter, bool adding, bool servermode) { // Try and grab the list modelist* el; @@ -251,7 +305,7 @@ class ListModeBase : public ModeHandler // And now add the mask onto the list... ListItem e; e.mask = assign(parameter); - e.nick = source->nick; + e.nick = servermode ? ServerInstance->Config->ServerName : source->nick; e.time = stringtime(); el->push_back(e); @@ -269,7 +323,7 @@ class ListModeBase : public ModeHandler /* List is full, give subclass a chance to send a custom message */ if (!TellListTooLong(source, channel, parameter)) { - source->WriteServ("478 %s %s %s :Channel ban/ignore list is full", source->nick, channel->name, parameter.c_str()); + source->WriteNumeric(478, "%s %s %s :Channel ban/ignore list is full", source->nick, channel->name, parameter.c_str()); } parameter = ""; @@ -309,32 +363,44 @@ class ListModeBase : public ModeHandler return MODEACTION_DENY; } + /** Get Extensible key for this mode + */ virtual std::string& GetInfoKey() { return infokey; } - virtual void DoChannelDelete(chanrec* chan) + /** Handle channel deletion. + * See modules.h. + * @param chan Channel being deleted + */ + virtual void DoChannelDelete(Channel* chan) { - modelist* list; - chan->GetExt(infokey, list); + modelist* mlist; + chan->GetExt(infokey, mlist); - if (list) + if (mlist) { chan->Shrink(infokey); - delete list; + delete mlist; } } - virtual void DoSyncChannel(chanrec* chan, Module* proto, void* opaque) + /** Syncronize channel item list with another server. + * See modules.h + * @param chan Channel to syncronize + * @param proto Protocol module pointer + * @param opaque Opaque connection handle + */ + virtual void DoSyncChannel(Channel* chan, Module* proto, void* opaque) { - modelist* list; - chan->GetExt(infokey, list); + modelist* mlist; + chan->GetExt(infokey, mlist); irc::modestacker modestack(true); std::deque stackresult; - if (list) + if (mlist) { - for (modelist::iterator it = list->begin(); it != list->end(); it++) + for (modelist::iterator it = mlist->begin(); it != mlist->end(); it++) { modestack.Push(std::string(1, mode)[0], assign(it->mask)); } @@ -347,27 +413,56 @@ class ListModeBase : public ModeHandler } } - virtual void DoCleanup(int target_type, void* item) + /** Clean up module on unload + * @param target_type Type of target to clean + * @param item Item to clean + */ + virtual void DoCleanup(int, void*) { } - virtual bool ValidateParam(userrec* source, chanrec* channel, std::string ¶meter) + /** Validate parameters. + * Overridden by implementing module. + * @param source Source user adding the parameter + * @param channel Channel the parameter is being added to + * @param parameter The actual parameter being added + * @return true if the parameter is valid + */ + virtual bool ValidateParam(User*, Channel*, std::string&) { return true; } - virtual bool TellListTooLong(userrec* source, chanrec* channel, std::string ¶meter) + /** Tell the user the list is too long. + * Overridden by implementing module. + * @param source Source user adding the parameter + * @param channel Channel the parameter is being added to + * @param parameter The actual parameter being added + * @return Ignored + */ + virtual bool TellListTooLong(User*, Channel*, std::string&) { return false; } - virtual void TellAlreadyOnList(userrec* source, chanrec* channel, std::string ¶meter) + /** Tell the user an item is already on the list. + * Overridden by implementing module. + * @param source Source user adding the parameter + * @param channel Channel the parameter is being added to + * @param parameter The actual parameter being added + */ + virtual void TellAlreadyOnList(User*, Channel*, std::string&) { } - virtual void TellNotSet(userrec* source, chanrec* channel, std::string ¶meter) + /** Tell the user that the parameter is not in the list. + * Overridden by implementing module. + * @param source Source user removing the parameter + * @param channel Channel the parameter is being removed from + * @param parameter The actual parameter being removed + */ + virtual void TellNotSet(User*, Channel*, std::string&) { - } };