1 /* +------------------------------------+
2 * | Inspire Internet Relay Chat Daemon |
3 * +------------------------------------+
5 * InspIRCd: (C) 2002-2010 InspIRCd Development Team
6 * See: http://wiki.inspircd.org/Credits
8 * This program is free but copyrighted software; see
9 * the file COPYING for details.
11 * ---------------------------------------------------
17 #include "socketengine.h"
18 #include "command_parse.h"
20 #include "exitcodes.h"
26 static std::vector<dynamic_reference_base*>* dynrefs = NULL;
28 void dynamic_reference_base::reset_all()
32 for(unsigned int i = 0; i < dynrefs->size(); i++)
33 (*dynrefs)[i]->ClearCache();
36 // Version is a simple class for holding a modules version number
37 Version::Version(const std::string &desc, int flags) : description(desc), Flags(flags)
41 Version::Version(const std::string &desc, int flags, const std::string& linkdata)
42 : description(desc), Flags(flags), link_data(linkdata)
46 Request::Request(Module* src, Module* dst, const char* idstr)
47 : id(idstr), source(src), dest(dst)
54 dest->OnRequest(*this);
57 Event::Event(Module* src, const std::string &eventid) : source(src), id(eventid) { }
61 FOREACH_MOD(I_OnEvent,OnEvent(*this));
64 // These declarations define the behavours of the base class Module (which does nothing at all)
67 CullResult Module::cull()
69 return classbase::cull();
75 ModResult Module::OnSendSnotice(char &snomask, std::string &type, const std::string &message) { return MOD_RES_PASSTHRU; }
76 void Module::OnUserConnect(LocalUser*) { }
77 void Module::OnUserQuit(User*, const std::string&, const std::string&) { }
78 void Module::OnUserDisconnect(LocalUser*) { }
79 void Module::OnUserJoin(Membership*, bool, bool, CUList&) { }
80 void Module::OnPostJoin(Membership*) { }
81 void Module::OnUserPart(Membership*, std::string&, CUList&) { }
82 void Module::OnPreRehash(User*, const std::string&) { }
83 void Module::OnModuleRehash(User*, const std::string&) { }
84 void Module::OnRehash(User*) { }
85 ModResult Module::OnUserPreJoin(User*, Channel*, const char*, std::string&, const std::string&) { return MOD_RES_PASSTHRU; }
86 void Module::OnMode(User*, void*, int, const std::vector<std::string>&, const std::vector<TranslateType>&) { }
87 void Module::OnOper(User*, const std::string&) { }
88 void Module::OnPostOper(User*, const std::string&, const std::string &) { }
89 void Module::OnInfo(User*) { }
90 void Module::OnWhois(User*, User*) { }
91 ModResult Module::OnUserPreInvite(User*, User*, Channel*, time_t) { return MOD_RES_PASSTHRU; }
92 ModResult Module::OnUserPreMessage(User*, void*, int, std::string&, char, CUList&) { return MOD_RES_PASSTHRU; }
93 ModResult Module::OnUserPreNotice(User*, void*, int, std::string&, char, CUList&) { return MOD_RES_PASSTHRU; }
94 ModResult Module::OnUserPreNick(User*, const std::string&) { return MOD_RES_PASSTHRU; }
95 void Module::OnUserPostNick(User*, const std::string&) { }
96 ModResult Module::OnPreMode(User*, User*, Channel*, const std::vector<std::string>&) { return MOD_RES_PASSTHRU; }
97 void Module::On005Numeric(std::string&) { }
98 ModResult Module::OnKill(User*, User*, const std::string&) { return MOD_RES_PASSTHRU; }
99 void Module::OnLoadModule(Module*) { }
100 void Module::OnUnloadModule(Module*) { }
101 void Module::OnBackgroundTimer(time_t) { }
102 ModResult Module::OnPreCommand(std::string&, std::vector<std::string>&, LocalUser*, bool, const std::string&) { return MOD_RES_PASSTHRU; }
103 void Module::OnPostCommand(const std::string&, const std::vector<std::string>&, LocalUser*, CmdResult, const std::string&) { }
104 void Module::OnUserInit(LocalUser*) { }
105 ModResult Module::OnCheckReady(LocalUser*) { return MOD_RES_PASSTHRU; }
106 ModResult Module::OnUserRegister(LocalUser*) { return MOD_RES_PASSTHRU; }
107 ModResult Module::OnUserPreKick(User*, Membership*, const std::string&) { return MOD_RES_PASSTHRU; }
108 void Module::OnUserKick(User*, Membership*, const std::string&, CUList&) { }
109 ModResult Module::OnRawMode(User*, Channel*, const char, const std::string &, bool, int) { return MOD_RES_PASSTHRU; }
110 ModResult Module::OnCheckInvite(User*, Channel*) { return MOD_RES_PASSTHRU; }
111 ModResult Module::OnCheckKey(User*, Channel*, const std::string&) { return MOD_RES_PASSTHRU; }
112 ModResult Module::OnCheckLimit(User*, Channel*) { return MOD_RES_PASSTHRU; }
113 ModResult Module::OnCheckChannelBan(User*, Channel*) { return MOD_RES_PASSTHRU; }
114 ModResult Module::OnCheckBan(User*, Channel*, const std::string&) { return MOD_RES_PASSTHRU; }
115 ModResult Module::OnExtBanCheck(User*, Channel*, char) { return MOD_RES_PASSTHRU; }
116 ModResult Module::OnStats(char, User*, string_list&) { return MOD_RES_PASSTHRU; }
117 ModResult Module::OnChangeLocalUserHost(LocalUser*, const std::string&) { return MOD_RES_PASSTHRU; }
118 ModResult Module::OnChangeLocalUserGECOS(LocalUser*, const std::string&) { return MOD_RES_PASSTHRU; }
119 ModResult Module::OnPreTopicChange(User*, Channel*, const std::string&) { return MOD_RES_PASSTHRU; }
120 void Module::OnEvent(Event&) { }
121 void Module::OnRequest(Request&) { }
122 ModResult Module::OnPassCompare(Extensible* ex, const std::string &password, const std::string &input, const std::string& hashtype) { return MOD_RES_PASSTHRU; }
123 void Module::OnGlobalOper(User*) { }
124 void Module::OnPostConnect(User*) { }
125 ModResult Module::OnAddBan(User*, Channel*, const std::string &) { return MOD_RES_PASSTHRU; }
126 ModResult Module::OnDelBan(User*, Channel*, const std::string &) { return MOD_RES_PASSTHRU; }
127 void Module::OnStreamSocketAccept(StreamSocket*, irc::sockets::sockaddrs*, irc::sockets::sockaddrs*) { }
128 int Module::OnStreamSocketWrite(StreamSocket*, std::string&) { return -1; }
129 void Module::OnStreamSocketClose(StreamSocket*) { }
130 void Module::OnStreamSocketConnect(StreamSocket*) { }
131 int Module::OnStreamSocketRead(StreamSocket*, std::string&) { return -1; }
132 void Module::OnUserMessage(User*, void*, int, const std::string&, char, const CUList&) { }
133 void Module::OnUserNotice(User*, void*, int, const std::string&, char, const CUList&) { }
134 void Module::OnRemoteKill(User*, User*, const std::string&, const std::string&) { }
135 void Module::OnUserInvite(User*, User*, Channel*, time_t) { }
136 void Module::OnPostTopicChange(User*, Channel*, const std::string&) { }
137 void Module::OnGetServerDescription(const std::string&, std::string&) { }
138 void Module::OnSyncUser(User*, Module*, void*) { }
139 void Module::OnSyncChannel(Channel*, Module*, void*) { }
140 void Module::OnSyncNetwork(Module*, void*) { }
141 void Module::ProtoSendMode(void*, TargetTypeFlags, void*, const std::vector<std::string>&, const std::vector<TranslateType>&) { }
142 void Module::OnDecodeMetaData(Extensible*, const std::string&, const std::string&) { }
143 void Module::ProtoSendMetaData(void*, Extensible*, const std::string&, const std::string&) { }
144 void Module::OnWallops(User*, const std::string&) { }
145 void Module::OnChangeHost(User*, const std::string&) { }
146 void Module::OnChangeName(User*, const std::string&) { }
147 void Module::OnChangeIdent(User*, const std::string&) { }
148 void Module::OnAddLine(User*, XLine*) { }
149 void Module::OnDelLine(User*, XLine*) { }
150 void Module::OnExpireLine(XLine*) { }
151 void Module::OnCleanup(int, void*) { }
152 ModResult Module::OnChannelPreDelete(Channel*) { return MOD_RES_PASSTHRU; }
153 void Module::OnChannelDelete(Channel*) { }
154 ModResult Module::OnSetAway(User*, const std::string &) { return MOD_RES_PASSTHRU; }
155 ModResult Module::OnWhoisLine(User*, User*, int&, std::string&) { return MOD_RES_PASSTHRU; }
156 void Module::OnBuildNeighborList(User*, UserChanList&, std::map<User*,bool>&) { }
157 void Module::OnGarbageCollect() { }
158 ModResult Module::OnSetConnectClass(LocalUser* user, ConnectClass* myclass) { return MOD_RES_PASSTHRU; }
159 void Module::OnText(User*, void*, int, const std::string&, char, CUList&) { }
160 void Module::OnRunTestSuite() { }
161 void Module::OnNamesListItem(User*, Membership*, std::string&, std::string&) { }
162 ModResult Module::OnNumeric(User*, unsigned int, const std::string&) { return MOD_RES_PASSTHRU; }
163 void Module::OnHookIO(StreamSocket*, ListenSocket*) { }
164 ModResult Module::OnAcceptConnection(int, ListenSocket*, irc::sockets::sockaddrs*, irc::sockets::sockaddrs*) { return MOD_RES_PASSTHRU; }
165 void Module::OnSendWhoLine(User*, const std::vector<std::string>&, User*, std::string&) { }
167 ModuleManager::ModuleManager() : ModCount(0)
171 ModuleManager::~ModuleManager()
175 bool ModuleManager::Attach(Implementation i, Module* mod)
177 if (Modules.find(mod->ModuleSourceFile) == Modules.end())
178 ServerInstance->Logs->Log("MODULE", DEFAULT, "Module is attaching to hook %d in constructor; this does not handle exceptions correctly!", i);
180 if (std::find(EventHandlers[i].begin(), EventHandlers[i].end(), mod) != EventHandlers[i].end())
183 EventHandlers[i].push_back(mod);
187 bool ModuleManager::Detach(Implementation i, Module* mod)
189 EventHandlerIter x = std::find(EventHandlers[i].begin(), EventHandlers[i].end(), mod);
191 if (x == EventHandlers[i].end())
194 EventHandlers[i].erase(x);
198 void ModuleManager::Attach(Implementation* i, Module* mod, size_t sz)
200 for (size_t n = 0; n < sz; ++n)
204 void ModuleManager::DetachAll(Module* mod)
206 for (size_t n = I_BEGIN + 1; n != I_END; ++n)
207 Detach((Implementation)n, mod);
210 bool ModuleManager::SetPriority(Module* mod, Priority s)
212 for (size_t n = I_BEGIN + 1; n != I_END; ++n)
213 SetPriority(mod, (Implementation)n, s);
218 bool ModuleManager::SetPriority(Module* mod, Implementation i, Priority s, Module* which)
220 /** To change the priority of a module, we first find its position in the vector,
221 * then we find the position of the other modules in the vector that this module
222 * wants to be before/after. We pick off either the first or last of these depending
223 * on which they want, and we make sure our module is *at least* before or after
224 * the first or last of this subset, depending again on the type of priority.
228 /* Locate our module. This is O(n) but it only occurs on module load so we're
229 * not too bothered about it
231 for (size_t x = 0; x != EventHandlers[i].size(); ++x)
233 if (EventHandlers[i][x] == mod)
240 /* Eh? this module doesnt exist, probably trying to set priority on an event
241 * theyre not attached to.
246 size_t swap_pos = my_pos;
250 if (prioritizationState != PRIO_STATE_FIRST)
256 if (prioritizationState != PRIO_STATE_FIRST)
259 swap_pos = EventHandlers[i].size() - 1;
263 /* Find the latest possible position, only searching AFTER our position */
264 for (size_t x = EventHandlers[i].size() - 1; x > my_pos; --x)
266 if (EventHandlers[i][x] == which)
272 // didn't find it - either not loaded or we're already after
275 /* Place this module before a set of other modules */
276 case PRIORITY_BEFORE:
278 for (size_t x = 0; x < my_pos; ++x)
280 if (EventHandlers[i][x] == which)
286 // didn't find it - either not loaded or we're already before
292 /* Do we need to swap? */
293 if (swap_pos != my_pos)
295 // We are going to change positions; we'll need to run again to verify all requirements
296 if (prioritizationState == PRIO_STATE_LAST)
297 prioritizationState = PRIO_STATE_AGAIN;
298 /* Suggestion from Phoenix, "shuffle" the modules to better retain call order */
301 if (my_pos > swap_pos)
304 for (unsigned int j = my_pos; j != swap_pos; j += incrmnt)
306 if (( j + incrmnt > EventHandlers[i].size() - 1) || (j + incrmnt < 0))
309 std::swap(EventHandlers[i][j], EventHandlers[i][j+incrmnt]);
316 bool ModuleManager::CanUnload(Module* mod)
318 std::map<std::string, Module*>::iterator modfind = Modules.find(mod->ModuleSourceFile);
320 if (modfind == Modules.end() || modfind->second != mod)
322 LastModuleError = "Module " + mod->ModuleSourceFile + " is not loaded, cannot unload it!";
323 ServerInstance->Logs->Log("MODULE", DEFAULT, LastModuleError);
326 if (mod->GetVersion().Flags & VF_STATIC)
328 LastModuleError = "Module " + mod->ModuleSourceFile + " not unloadable (marked static)";
329 ServerInstance->Logs->Log("MODULE", DEFAULT, LastModuleError);
335 void ModuleManager::DoSafeUnload(Module* mod)
337 std::map<std::string, Module*>::iterator modfind = Modules.find(mod->ModuleSourceFile);
339 std::vector<reference<ExtensionItem> > items;
340 ServerInstance->Extensions.BeginUnregister(modfind->second, items);
341 /* Give the module a chance to tidy out all its metadata */
342 for (chan_hash::iterator c = ServerInstance->chanlist->begin(); c != ServerInstance->chanlist->end(); c++)
344 mod->OnCleanup(TYPE_CHANNEL,c->second);
345 c->second->doUnhookExtensions(items);
346 const UserMembList* users = c->second->GetUsers();
347 for(UserMembCIter mi = users->begin(); mi != users->end(); mi++)
348 mi->second->doUnhookExtensions(items);
350 for (user_hash::iterator u = ServerInstance->Users->clientlist->begin(); u != ServerInstance->Users->clientlist->end(); u++)
352 mod->OnCleanup(TYPE_USER,u->second);
353 u->second->doUnhookExtensions(items);
355 for(char m='A'; m <= 'z'; m++)
358 mh = ServerInstance->Modes->FindMode(m, MODETYPE_USER);
359 if (mh && mh->creator == mod)
360 ServerInstance->Modes->DelMode(mh);
361 mh = ServerInstance->Modes->FindMode(m, MODETYPE_CHANNEL);
362 if (mh && mh->creator == mod)
363 ServerInstance->Modes->DelMode(mh);
365 for(std::multimap<std::string, ServiceProvider*>::iterator i = DataProviders.begin(); i != DataProviders.end(); )
367 std::multimap<std::string, ServiceProvider*>::iterator curr = i++;
368 if (curr->second->creator == mod)
369 DataProviders.erase(curr);
372 dynamic_reference_base::reset_all();
374 /* Tidy up any dangling resolvers */
375 ServerInstance->Res->CleanResolvers(mod);
377 FOREACH_MOD(I_OnUnloadModule,OnUnloadModule(mod));
381 Modules.erase(modfind);
382 ServerInstance->GlobalCulls.AddItem(mod);
384 ServerInstance->Logs->Log("MODULE", DEFAULT,"Module %s unloaded",mod->ModuleSourceFile.c_str());
386 ServerInstance->BuildISupport();
389 void ModuleManager::UnloadAll()
391 /* We do this more than once, so that any service providers get a
392 * chance to be unhooked by the modules using them, but then get
393 * a chance to be removed themsleves.
395 * Note: this deliberately does NOT delete the DLLManager objects
397 for (int tries = 0; tries < 4; tries++)
399 std::map<std::string, Module*>::iterator i = Modules.begin();
400 while (i != Modules.end())
402 std::map<std::string, Module*>::iterator me = i++;
403 if (CanUnload(me->second))
405 DoSafeUnload(me->second);
408 ServerInstance->GlobalCulls.Apply();
412 std::string& ModuleManager::LastError()
414 return LastModuleError;
417 CmdResult InspIRCd::CallCommandHandler(const std::string &commandname, const std::vector<std::string>& parameters, User* user)
419 return this->Parser->CallHandler(commandname, parameters, user);
422 bool InspIRCd::IsValidModuleCommand(const std::string &commandname, int pcnt, User* user)
424 return this->Parser->IsValidCommand(commandname, pcnt, user);
427 void ModuleManager::AddService(ServiceProvider& item)
429 Module* owner = item.creator;
430 if (Modules.find(owner->ModuleSourceFile) == Modules.end())
431 ServerInstance->Logs->Log("MODULE", DEFAULT, "Module is registering item %s in constructor; this does not handle exceptions correctly!", item.name.c_str());
433 switch (item.service)
435 case SERVICE_COMMAND:
436 if (!ServerInstance->Parser->AddCommand(static_cast<Command*>(&item)))
437 throw ModuleException("Command "+std::string(item.name)+" already exists.");
440 if (!ServerInstance->Modes->AddMode(static_cast<ModeHandler*>(&item)))
441 throw ModuleException("Mode "+std::string(item.name)+" already exists.");
443 case SERVICE_METADATA:
444 ServerInstance->Extensions.Register(static_cast<ExtensionItem*>(&item));
449 DataProviders.insert(std::make_pair(item.name, &item));
450 std::string::size_type slash = item.name.find('/');
451 if (slash != std::string::npos)
453 DataProviders.insert(std::make_pair(item.name.substr(0, slash), &item));
454 DataProviders.insert(std::make_pair(item.name.substr(slash + 1), &item));
459 throw ModuleException("Cannot add unknown service type");
463 void ModuleManager::DelService(ServiceProvider& item)
465 switch (item.service)
468 if (!ServerInstance->Modes->DelMode(static_cast<ModeHandler*>(&item)))
469 throw ModuleException("Mode "+std::string(item.name)+" does not exist.");
474 for(std::multimap<std::string, ServiceProvider*>::iterator i = DataProviders.begin(); i != DataProviders.end(); )
476 std::multimap<std::string, ServiceProvider*>::iterator curr = i++;
477 if (curr->second == &item)
478 DataProviders.erase(curr);
480 dynamic_reference_base::reset_all();
484 throw ModuleException("Cannot delete unknown service type");
488 ServiceProvider* ModuleManager::FindService(ServiceType type, const std::string& name)
495 std::multimap<std::string, ServiceProvider*>::iterator i = DataProviders.find(name);
496 if (i != DataProviders.end() && i->second->service == type)
500 // TODO implement finding of the other types
502 throw ModuleException("Cannot find unknown service type");
506 dynamic_reference_base::dynamic_reference_base(Module* Creator, const std::string& Name)
507 : name(Name), value(NULL), creator(Creator)
510 dynrefs = new std::vector<dynamic_reference_base*>;
511 dynrefs->push_back(this);
514 dynamic_reference_base::~dynamic_reference_base()
516 for(unsigned int i = 0; i < dynrefs->size(); i++)
518 if (dynrefs->at(i) == this)
520 unsigned int last = dynrefs->size() - 1;
522 dynrefs->at(i) = dynrefs->at(last);
523 dynrefs->erase(dynrefs->begin() + last);
524 if (dynrefs->empty())
534 void dynamic_reference_base::SetProvider(const std::string& newname)
540 void dynamic_reference_base::lookup()
543 throw ModuleException("Dynamic reference to '" + name + "' failed to resolve");
546 dynamic_reference_base::operator bool()
550 std::multimap<std::string, ServiceProvider*>::iterator i = ServerInstance->Modules->DataProviders.find(name);
551 if (i != ServerInstance->Modules->DataProviders.end())
552 value = static_cast<DataProvider*>(i->second);
557 void InspIRCd::SendMode(const std::vector<std::string>& parameters, User *user)
559 this->Modes->Process(parameters, user);
563 void InspIRCd::SendGlobalMode(const std::vector<std::string>& parameters, User *user)
565 Modes->Process(parameters, user);
566 if (!Modes->GetLastParse().empty())
567 this->PI->SendMode(parameters[0], Modes->GetLastParseParams(), Modes->GetLastParseTranslate());
570 bool InspIRCd::AddResolver(Resolver* r, bool cached)
573 return this->Res->AddResolverClass(r);
576 r->TriggerCachedResult();
582 Module* ModuleManager::Find(const std::string &name)
584 std::map<std::string, Module*>::iterator modfind = Modules.find(name);
586 if (modfind == Modules.end())
589 return modfind->second;
592 const std::vector<std::string> ModuleManager::GetAllModuleNames(int filter)
594 std::vector<std::string> retval;
595 for (std::map<std::string, Module*>::iterator x = Modules.begin(); x != Modules.end(); ++x)
596 if (!filter || (x->second->GetVersion().Flags & filter))
597 retval.push_back(x->first);
601 ConfigReader::ConfigReader()
604 ServerInstance->Logs->Log("MODULE", DEBUG, "ConfigReader is deprecated in 2.0; "
605 "use ServerInstance->Config->ConfValue(\"key\") or ->ConfTags(\"key\") instead");
609 ConfigReader::~ConfigReader()
613 static ConfigTag* SlowGetTag(const std::string &tag, int index)
615 ConfigTagList tags = ServerInstance->Config->ConfTags(tag);
616 while (tags.first != tags.second)
619 return tags.first->second;
626 std::string ConfigReader::ReadValue(const std::string &tag, const std::string &name, const std::string &default_value, int index, bool allow_linefeeds)
628 std::string result = default_value;
629 if (!SlowGetTag(tag, index)->readString(name, result, allow_linefeeds))
631 this->error = CONF_VALUE_NOT_FOUND;
636 std::string ConfigReader::ReadValue(const std::string &tag, const std::string &name, int index, bool allow_linefeeds)
638 return ReadValue(tag, name, "", index, allow_linefeeds);
641 bool ConfigReader::ReadFlag(const std::string &tag, const std::string &name, const std::string &default_value, int index)
643 bool def = (default_value == "yes");
644 return SlowGetTag(tag, index)->getBool(name, def);
647 bool ConfigReader::ReadFlag(const std::string &tag, const std::string &name, int index)
649 return ReadFlag(tag, name, "", index);
653 int ConfigReader::ReadInteger(const std::string &tag, const std::string &name, const std::string &default_value, int index, bool need_positive)
655 int v = atoi(default_value.c_str());
656 int result = SlowGetTag(tag, index)->getInt(name, v);
658 if ((need_positive) && (result < 0))
660 this->error = CONF_INT_NEGATIVE;
667 int ConfigReader::ReadInteger(const std::string &tag, const std::string &name, int index, bool need_positive)
669 return ReadInteger(tag, name, "", index, need_positive);
672 long ConfigReader::GetError()
674 long olderr = this->error;
679 int ConfigReader::Enumerate(const std::string &tag)
681 ServerInstance->Logs->Log("MODULE", DEBUG, "Module is using ConfigReader::Enumerate on %s; this is slow!",
684 while (SlowGetTag(tag, i)) i++;
688 FileReader::FileReader(const std::string &filename)
693 FileReader::FileReader()
697 std::string FileReader::Contents()
700 for (file_cache::iterator a = this->fc.begin(); a != this->fc.end(); a++)
708 unsigned long FileReader::ContentSize()
710 return this->contentsize;
713 void FileReader::CalcSize()
716 for (file_cache::iterator a = this->fc.begin(); a != this->fc.end(); a++)
717 n += (a->length() + 2);
718 this->contentsize = n;
721 void FileReader::LoadFile(const std::string &filename)
723 std::map<std::string, file_cache>::iterator file = ServerInstance->Config->Files.find(filename);
724 if (file != ServerInstance->Config->Files.end())
726 this->fc = file->second;
731 FILE* f = fopen(filename.c_str(), "r");
734 char linebuf[MAXBUF*10];
735 while (fgets(linebuf, sizeof(linebuf), f))
737 int len = strlen(linebuf);
739 fc.push_back(std::string(linebuf, len - 1));
747 FileReader::~FileReader()
751 bool FileReader::Exists()
753 return (!(fc.size() == 0));
756 std::string FileReader::GetLine(int x)
758 if ((x<0) || ((unsigned)x>fc.size()))
763 int FileReader::FileSize()