2 * InspIRCd -- Internet Relay Chat Daemon
4 * Copyright (C) 2020 Matt Schatz <genius3000@g3k.solutions>
5 * Copyright (C) 2013-2016 Attila Molnar <attilamolnar@hush.com>
6 * Copyright (C) 2013, 2017-2021 Sadie Powell <sadie@witchery.services>
7 * Copyright (C) 2012, 2019 Robby <robby@chatbelgie.be>
8 * Copyright (C) 2010 Craig Edwards <brain@inspircd.org>
9 * Copyright (C) 2009-2010 Daniel De Graaf <danieldg@inspircd.org>
10 * Copyright (C) 2009 Uli Schlachter <psychon@inspircd.org>
11 * Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
12 * Copyright (C) 2006-2008 Robin Burchell <robin+git@viroteck.net>
14 * This file is part of InspIRCd. InspIRCd is free software: you can
15 * redistribute it and/or modify it under the terms of the GNU General Public
16 * License as published by the Free Software Foundation, version 2.
18 * This program is distributed in the hope that it will be useful, but WITHOUT
19 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
20 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
23 * You should have received a copy of the GNU General Public License
24 * along with this program. If not, see <http://www.gnu.org/licenses/>.
40 const std::string& target;
42 std::string FormatTime(time_t ts)
44 std::string timestr(InspIRCd::TimeString(ts, "%Y-%m-%d %H:%M:%S UTC (", true));
45 timestr.append(ConvToStr(ts));
46 timestr.push_back(')');
51 CheckContext(User* u, const std::string& targetstr)
55 Write("START", target);
63 void Write(const std::string& type, const std::string& text)
65 user->WriteRemoteNumeric(RPL_CHECK, type, text);
68 void Write(const std::string& type, time_t ts)
70 user->WriteRemoteNumeric(RPL_CHECK, type, FormatTime(ts));
73 User* GetUser() const { return user; }
75 void DumpListMode(ListModeBase* mode, Channel* chan)
77 const ListModeBase::ModeList* list = mode->GetList(chan);
81 for (ListModeBase::ModeList::const_iterator i = list->begin(); i != list->end(); ++i)
83 CheckContext::List listmode(*this, "listmode");
84 listmode.Add(ConvToStr(mode->GetModeChar()));
85 listmode.Add(i->mask);
86 listmode.Add(i->setter);
87 listmode.Add(FormatTime(i->time));
92 void DumpExt(Extensible* ext)
94 CheckContext::List extlist(*this, "metadata");
95 for(Extensible::ExtensibleStore::const_iterator i = ext->GetExtList().begin(); i != ext->GetExtList().end(); ++i)
97 ExtensionItem* item = i->first;
98 std::string value = item->ToHuman(ext, i->second);
100 Write("meta:" + item->name, value);
101 else if (!item->name.empty())
102 extlist.Add(item->name);
108 class List : public Numeric::GenericBuilder<' ', false, Numeric::WriteRemoteNumericSink>
111 List(CheckContext& context, const char* checktype)
112 : Numeric::GenericBuilder<' ', false, Numeric::WriteRemoteNumericSink>(Numeric::WriteRemoteNumericSink(context.GetUser()), RPL_CHECK, false, (IS_LOCAL(context.GetUser()) ? context.GetUser()->nick.length() : ServerInstance->Config->Limits.NickMax) + strlen(checktype) + 1)
114 GetNumeric().push(checktype).push(std::string());
121 class CommandCheck : public Command
123 UserModeReference snomaskmode;
125 std::string GetSnomasks(User* user)
129 ret = snomaskmode->GetUserParameter(user);
136 static std::string GetAllowedOperOnlyModes(LocalUser* user, ModeType modetype)
139 const ModeParser::ModeHandlerMap& modes = ServerInstance->Modes.GetModes(modetype);
140 for (ModeParser::ModeHandlerMap::const_iterator i = modes.begin(); i != modes.end(); ++i)
142 const ModeHandler* const mh = i->second;
143 if ((mh->NeedsOper()) && (user->HasModePermission(mh)))
144 ret.push_back(mh->GetModeChar());
149 static std::string GetAllowedOperOnlySnomasks(LocalUser* user)
152 for (unsigned char sno = 'A'; sno <= 'z'; ++sno)
153 if (ServerInstance->SNO->IsSnomaskUsable(sno) && user->HasSnomaskPermission(sno))
159 CommandCheck(Module* parent)
160 : Command(parent,"CHECK", 1)
161 , snomaskmode(parent, "snomask")
164 syntax = "<nick>|<ipmask>|<hostmask>|<channel> [<servername>]";
167 CmdResult Handle(User* user, const Params& parameters) CXX11_OVERRIDE
169 if (parameters.size() > 1 && !irc::equals(parameters[1], ServerInstance->Config->ServerName))
174 std::string chliststr;
176 targuser = ServerInstance->FindNick(parameters[0]);
177 targchan = ServerInstance->FindChan(parameters[0]);
180 * Syntax of a /check reply:
181 * :server.name 802 target START <target>
182 * :server.name 802 target <field> :<value>
183 * :server.name 802 target END <target>
186 // Constructor sends START, destructor sends END
187 CheckContext context(user, parameters[0]);
191 LocalUser* loctarg = IS_LOCAL(targuser);
192 /* /check on a user */
193 context.Write("nuh", targuser->GetFullHost());
194 context.Write("realnuh", targuser->GetFullRealHost());
195 context.Write("realname", targuser->GetRealName());
196 context.Write("modes", targuser->GetModeLetters());
197 context.Write("snomasks", GetSnomasks(targuser));
198 context.Write("server", targuser->server->GetName());
199 context.Write("uid", targuser->uuid);
200 context.Write("signon", targuser->signon);
201 context.Write("nickts", targuser->age);
203 context.Write("lastmsg", loctarg->idle_lastmsg);
205 if (targuser->IsAway())
208 context.Write("awaytime", targuser->awaytime);
209 context.Write("awaymsg", targuser->awaymsg);
212 if (targuser->IsOper())
214 OperInfo* oper = targuser->oper;
215 /* user is an oper of type ____ */
216 context.Write("opertype", oper->name);
219 context.Write("chanmodeperms", GetAllowedOperOnlyModes(loctarg, MODETYPE_CHANNEL));
220 context.Write("usermodeperms", GetAllowedOperOnlyModes(loctarg, MODETYPE_USER));
221 context.Write("snomaskperms", GetAllowedOperOnlySnomasks(loctarg));
222 context.Write("commandperms", oper->AllowedOperCommands.ToString());
223 context.Write("permissions", oper->AllowedPrivs.ToString());
229 context.Write("clientaddr", loctarg->client_sa.str());
230 context.Write("serveraddr", loctarg->server_sa.str());
232 std::string classname = loctarg->GetClass()->name;
233 if (!classname.empty())
234 context.Write("connectclass", classname);
236 context.Write("exempt", loctarg->exempt ? "yes" : "no");
239 context.Write("onip", targuser->GetIPString());
241 CheckContext::List chanlist(context, "onchans");
242 for (User::ChanList::iterator i = targuser->chans.begin(); i != targuser->chans.end(); i++)
244 Membership* memb = *i;
245 Channel* c = memb->chan;
246 char prefix = memb->GetPrefixChar();
248 chliststr.push_back(prefix);
249 chliststr.append(c->name);
250 chanlist.Add(chliststr);
256 context.DumpExt(targuser);
260 /* /check on a channel */
261 context.Write("createdat", targchan->age);
263 if (!targchan->topic.empty())
265 /* there is a topic, assume topic related information exists */
266 context.Write("topic", targchan->topic);
267 context.Write("topic_setby", targchan->setby);
268 context.Write("topic_setat", targchan->topicset);
271 context.Write("modes", targchan->ChanModes(true));
272 context.Write("membercount", ConvToStr(targchan->GetUserCounter()));
274 /* now the ugly bit, spool current members of a channel. :| */
276 const Channel::MemberMap& ulist = targchan->GetUsers();
278 /* note that unlike /names, we do NOT check +i vs in the channel */
279 for (Channel::MemberMap::const_iterator i = ulist.begin(); i != ulist.end(); ++i)
282 * Unlike Asuka, I define a clone as coming from the same host. --w00t
284 const UserManager::CloneCounts& clonecount = ServerInstance->Users->GetCloneCounts(i->first);
285 context.Write("member", InspIRCd::Format("%u %s%s (%s)", clonecount.global,
286 i->second->GetAllPrefixChars().c_str(), i->first->GetFullHost().c_str(),
287 i->first->GetRealName().c_str()));
290 const ModeParser::ListModeList& listmodes = ServerInstance->Modes->GetListModes();
291 for (ModeParser::ListModeList::const_iterator i = listmodes.begin(); i != listmodes.end(); ++i)
292 context.DumpListMode(*i, targchan);
294 context.DumpExt(targchan);
298 /* /check on an IP address, or something that doesn't exist */
301 /* hostname or other */
302 const user_hash& users = ServerInstance->Users->GetUsers();
303 for (user_hash::const_iterator a = users.begin(); a != users.end(); ++a)
305 if (InspIRCd::Match(a->second->GetRealHost(), parameters[0], ascii_case_insensitive_map) || InspIRCd::Match(a->second->GetDisplayedHost(), parameters[0], ascii_case_insensitive_map))
307 /* host or vhost matches mask */
308 context.Write("match", ConvToStr(++x) + " " + a->second->GetFullRealHost() + " " + a->second->GetIPString() + " " + a->second->GetRealName());
311 else if (InspIRCd::MatchCIDR(a->second->GetIPString(), parameters[0]))
314 context.Write("match", ConvToStr(++x) + " " + a->second->GetFullRealHost() + " " + a->second->GetIPString() + " " + a->second->GetRealName());
318 context.Write("matches", ConvToStr(x));
321 // END is sent by the CheckContext destructor
325 RouteDescriptor GetRouting(User* user, const Params& parameters) CXX11_OVERRIDE
327 if ((parameters.size() > 1) && (parameters[1].find('.') != std::string::npos))
328 return ROUTE_OPT_UCAST(parameters[1]);
329 return ROUTE_LOCALONLY;
333 class ModuleCheck : public Module
335 CommandCheck mycommand;
337 ModuleCheck() : mycommand(this)
341 Version GetVersion() CXX11_OVERRIDE
343 return Version("Adds the /CHECK command which allows server operators to look up details about a channel, user, IP address, or hostname.", VF_VENDOR|VF_OPTCOMMON);
347 MODULE_INIT(ModuleCheck)