X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fsnomasks.h;h=e1af1a1099c998484d780e7a2cd657e0b35478dd;hb=6dd331262aa8f989657891e27b8891ee6a00016c;hp=db8be55f88cf7babb10368c2e3acd01144b620fd;hpb=f2acdbc3820f0f4f5ef76a0a64e73d2a320df91f;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/include/snomasks.h b/include/snomasks.h index db8be55f8..e1af1a109 100644 --- a/include/snomasks.h +++ b/include/snomasks.h @@ -2,8 +2,8 @@ * | Inspire Internet Relay Chat Daemon | * +------------------------------------+ * - * InspIRCd: (C) 2002-2007 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. @@ -14,15 +14,36 @@ #ifndef __SNOMASKS_H__ #define __SNOMASKS_H__ -#include -#include -#include -#include "configreader.h" -#include "inspircd.h" +class Snomask : public Extensible +{ + private: + InspIRCd *ServerInstance; + + public: + char MySnomask; + std::string Description; + std::string LastMessage; + bool LastBlocked; + unsigned int Count; + + /** Create a new Snomask + */ + Snomask(InspIRCd* Instance, char snomask, const std::string &description) : ServerInstance(Instance), MySnomask(snomask), Description(description), LastMessage(""), Count(0) + { + } + + /** Sends a message to all opers with this snomask. + */ + void SendMessage(const std::string &message); + + /** Sends out the (last message repeated N times) message + */ + void Flush(); +}; /** A list of snomasks which are valid, and their descriptive texts */ -typedef std::map SnoList; +typedef std::map SnoList; /** Snomask manager handles routing of SNOMASK (usermode +n) messages to opers. * Modules and the core can enable and disable snomask characters. If they do, @@ -34,9 +55,11 @@ class CoreExport SnomaskManager : public Extensible /** Creator/owner */ InspIRCd* ServerInstance; + /** Currently active snomask list */ SnoList SnoMasks; + /** Set up the default (core available) snomask chars */ void SetupDefaults(); @@ -44,6 +67,7 @@ class CoreExport SnomaskManager : public Extensible /** Create a new SnomaskManager */ SnomaskManager(InspIRCd* Instance); + /** Delete SnomaskManager */ ~SnomaskManager(); @@ -58,23 +82,51 @@ class CoreExport SnomaskManager : public Extensible * exists. */ bool EnableSnomask(char letter, const std::string &description); + /** Disable a snomask. * @param letter The snomask letter to disable. * @return True if the snomask was disabled, false if it didn't * exist. */ bool DisableSnomask(char letter); - /** Write to all users with a given snomask. + + /** Write to all users with a given snomask (local server only) * @param letter The snomask letter to write to * @param text The text to send to the users */ void WriteToSnoMask(char letter, const std::string &text); - /** Write to all users with a given snomask. + + /** Write to all users with a given snomask (local server only) * @param letter The snomask letter to write to * @param text A format string containing text to send * @param ... Format arguments */ - void WriteToSnoMask(char letter, const char* text, ...); + void WriteToSnoMask(char letter, const char* text, ...) CUSTOM_PRINTF(3, 4); + + /** Write to all users with a given snomask (sent globally) + * @param letter The snomask letter to write to + * @param text The text to send to the users + */ + void WriteGlobalSno(char letter, const std::string &text); + + /** Write to all users with a given snomask (sent globally) + * @param letter The snomask letter to write to + * @param text A format string containing text to send + * @param ... Format arguments + */ + void WriteGlobalSno(char letter, const char* text, ...) CUSTOM_PRINTF(3, 4); + + + /** Called once per 5 seconds from the mainloop, this flushes any cached + * snotices. The way the caching works is as follows: + * Calls to WriteToSnoMask write to a cache, if the call is the same as it was + * for the previous call, then a count is incremented. If it is different, + * the previous message it just sent normally via NOTICE (with count if > 1) + * and the new message is cached. This acts as a sender in case the number of notices + * is not particularly significant, in order to keep notices going out. + */ + void FlushSnotices(); + /** Check if a snomask is enabled. * @param letter The snomask letter to check. * @return True if the snomask has been enabled.