2 * ngIRCd -- The Next Generation IRC Daemon
3 * Copyright (c)2001-2013 Alexander Barton (alex@barton.de) and Contributors.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 * Please read the file COPYING, README and AUTHORS for more information.
25 #include "conn-func.h"
28 #include "conn-encoding.h"
30 #include "irc-macros.h"
31 #include "irc-write.h"
42 static char *Option_String PARAMS((CONN_ID Idx));
43 static bool Send_Message PARAMS((CLIENT *Client, REQUEST *Req, int ForceType,
45 static bool Send_Message_Mask PARAMS((CLIENT *from, char *command,
46 char *targetMask, char *message,
48 static bool Help PARAMS((CLIENT *Client, const char *Topic));
51 * Check if a list limit is reached and inform client accordingly.
53 * @param From The client.
54 * @param Count Reply item count.
55 * @param Limit Reply limit.
56 * @param Name Name of the list.
57 * @return true if list limit has been reached; false otherwise.
60 IRC_CheckListTooBig(CLIENT *From, const int Count, const int Limit,
71 (void)IRC_WriteStrClient(From,
72 "NOTICE %s :%s list limit (%d) reached!",
73 Client_ID(From), Name, Limit);
74 IRC_SetPenalty(From, 2);
79 * Handler for the IRC "ERROR" command.
81 * @param Client The client from which this command has been received.
82 * @param Req Request structure with prefix and all parameters.
83 * @return CONNECTED or DISCONNECTED.
86 IRC_ERROR(CLIENT *Client, REQUEST *Req)
88 assert( Client != NULL );
89 assert( Req != NULL );
91 if (Client_Type(Client) != CLIENT_GOTPASS
92 && Client_Type(Client) != CLIENT_GOTPASS_2813
93 && Client_Type(Client) != CLIENT_UNKNOWNSERVER
94 && Client_Type(Client) != CLIENT_SERVER
95 && Client_Type(Client) != CLIENT_SERVICE) {
96 LogDebug("Ignored ERROR command from \"%s\" ...",
98 IRC_SetPenalty(Client, 2);
103 Log(LOG_NOTICE, "Got ERROR from \"%s\"!",
104 Client_Mask(Client));
106 Log(LOG_NOTICE, "Got ERROR from \"%s\": \"%s\"!",
107 Client_Mask(Client), Req->argv[0]);
113 * Handler for the IRC "KILL" command.
115 * This function implements the IRC command "KILL" which is used to selectively
116 * disconnect clients. It can be used by IRC operators and servers, for example
117 * to "solve" nick collisions after netsplits. See RFC 2812 section 3.7.1.
119 * Please note that this function is also called internally, without a real
120 * KILL command being received over the network! Client is Client_ThisServer()
121 * in this case, and the prefix in Req is NULL.
123 * @param Client The client from which this command has been received or
124 * Client_ThisServer() when generated interanlly.
125 * @param Req Request structure with prefix and all parameters.
126 * @return CONNECTED or DISCONNECTED.
129 IRC_KILL(CLIENT *Client, REQUEST *Req)
132 char reason[COMMAND_LEN];
134 assert (Client != NULL);
135 assert (Req != NULL);
137 if (Client_Type(Client) != CLIENT_SERVER && !Op_Check(Client, Req))
138 return Op_NoPrivileges(Client, Req);
140 /* Get prefix (origin); use the client if no prefix is given. */
142 prefix = Client_Search(Req->prefix);
146 /* Log a warning message and use this server as origin when the
147 * prefix (origin) is invalid. And this is the reason why we don't
148 * use the _IRC_GET_SENDER_OR_RETURN_ macro above! */
150 Log(LOG_WARNING, "Got KILL with invalid prefix: \"%s\"!",
152 prefix = Client_ThisServer();
155 if (Client != Client_ThisServer())
156 Log(LOG_NOTICE|LOG_snotice,
157 "Got KILL command from \"%s\" for \"%s\": \"%s\".",
158 Client_Mask(prefix), Req->argv[0], Req->argv[1]);
160 /* Build reason string: Prefix the "reason" if the originator is a
161 * regular user, so users can't spoof KILLs of servers. */
162 if (Client_Type(Client) == CLIENT_USER)
163 snprintf(reason, sizeof(reason), "KILLed by %s: %s",
164 Client_ID(Client), Req->argv[1]);
166 strlcpy(reason, Req->argv[1], sizeof(reason));
168 return IRC_KillClient(Client, prefix, Req->argv[0], reason);
172 * Handler for the IRC "NOTICE" command.
174 * @param Client The client from which this command has been received.
175 * @param Req Request structure with prefix and all parameters.
176 * @return CONNECTED or DISCONNECTED.
179 IRC_NOTICE(CLIENT *Client, REQUEST *Req)
181 return Send_Message(Client, Req, CLIENT_USER, false);
185 * Handler for the IRC "PRIVMSG" command.
187 * @param Client The client from which this command has been received.
188 * @param Req Request structure with prefix and all parameters.
189 * @return CONNECTED or DISCONNECTED.
192 IRC_PRIVMSG(CLIENT *Client, REQUEST *Req)
194 return Send_Message(Client, Req, CLIENT_USER, true);
198 * Handler for the IRC "SQUERY" command.
200 * @param Client The client from which this command has been received.
201 * @param Req Request structure with prefix and all parameters.
202 * @return CONNECTED or DISCONNECTED.
205 IRC_SQUERY(CLIENT *Client, REQUEST *Req)
207 return Send_Message(Client, Req, CLIENT_SERVICE, true);
211 * Handler for the IRC "TRACE" command.
213 * @param Client The client from which this command has been received.
214 * @param Req Request structure with prefix and all parameters.
215 * @return CONNECTED or DISCONNECTED.
218 IRC_TRACE(CLIENT *Client, REQUEST *Req)
220 CLIENT *from, *target, *c;
222 char user[CLIENT_USER_LEN];
224 assert(Client != NULL);
227 IRC_SetPenalty(Client, 3);
229 _IRC_GET_SENDER_OR_RETURN_(from, Req, Client)
230 _IRC_GET_TARGET_SERVER_OR_RETURN_(target, Req, 0, from)
232 /* Forward command to other server? */
233 if (target != Client_ThisServer()) {
234 /* Send RPL_TRACELINK back to initiator */
235 idx = Client_Conn(Client);
237 idx2 = Client_Conn(Client_NextHop(target));
240 if (!IRC_WriteStrClient(from, RPL_TRACELINK_MSG,
241 Client_ID(from), PACKAGE_NAME,
242 PACKAGE_VERSION, Client_ID(target),
243 Client_ID(Client_NextHop(target)),
245 time(NULL) - Conn_StartTime(idx2),
246 Conn_SendQ(idx), Conn_SendQ(idx2)))
249 /* Forward command */
250 IRC_WriteStrClientPrefix(target, from, "TRACE %s", Req->argv[0]);
254 /* Infos about all connected servers */
257 if (Client_Conn(c) > NONE) {
259 if (Client_Type(c) == CLIENT_SERVER) {
261 strlcpy(user, Client_User(c), sizeof(user));
263 strlcpy(user, "unknown", sizeof(user));
264 if (!IRC_WriteStrClient(from,
266 Client_ID(from), Client_ID(c),
267 user, Client_Hostname(c),
268 Client_Mask(Client_ThisServer()),
269 Option_String(Client_Conn(c))))
272 if (Client_Type(c) == CLIENT_USER
273 && Client_HasMode(c, 'o')) {
275 if (!IRC_WriteStrClient(from,
276 RPL_TRACEOPERATOR_MSG,
277 Client_ID(from), Client_ID(c)))
281 c = Client_Next( c );
284 return IRC_WriteStrClient(from, RPL_TRACEEND_MSG, Client_ID(from),
285 Conf_ServerName, PACKAGE_NAME,
286 PACKAGE_VERSION, NGIRCd_DebugLevel);
290 * Handler for the IRC "HELP" command.
292 * @param Client The client from which this command has been received.
293 * @param Req Request structure with prefix and all parameters.
294 * @return CONNECTED or DISCONNECTED.
297 IRC_HELP(CLIENT *Client, REQUEST *Req)
301 assert(Client != NULL);
304 IRC_SetPenalty(Client, 2);
306 if ((Req->argc == 0 && array_bytes(&Conf_Helptext) > 0)
307 || (Req->argc >= 1 && strcasecmp(Req->argv[0], "Commands") != 0)) {
308 /* Help text available and requested */
310 return Help(Client, Req->argv[0]);
312 if (!Help(Client, "Intro"))
317 cmd = Parse_GetCommandStruct();
319 if (!IRC_WriteStrClient(Client, "NOTICE %s :%s",
320 Client_ID(Client), cmd->name))
328 * Kill an client identified by its nick name.
330 * Please note that after killig a client, its CLIENT cond CONNECTION
331 * structures are invalid. So the caller must make sure on its own not to
332 * access data of probably killed clients after calling this function!
334 * @param Client The client from which the command leading to the KILL has
335 * been received, or NULL. The KILL will no be forwarded in this
336 * direction. Only relevant when From is set, too.
337 * @param From The client from which the command originated, or NULL for
339 * @param Nick The nick name to kill.
340 * @param Reason Text to send as reason to the client and other servers.
343 IRC_KillClient(CLIENT *Client, CLIENT *From, const char *Nick, const char *Reason)
346 CONN_ID my_conn, conn;
349 /* Do we know such a client in the network? */
350 c = Client_Search(Nick);
352 LogDebug("Client with nick \"%s\" is unknown, not forwaring.", Nick);
356 /* Inform other servers */
357 IRC_WriteStrServersPrefix(From ? Client : NULL,
358 From ? From : Client_ThisServer(),
359 "KILL %s :%s", Nick, Reason);
361 if (Client_Type(c) != CLIENT_USER && Client_Type(c) != CLIENT_GOTNICK) {
362 /* Target of this KILL is not a regular user, this is
363 * invalid! So we ignore this case if we received a
364 * regular KILL from the network and try to kill the
365 * client/connection anyway (but log an error!) if the
366 * origin is the local server. */
368 if (Client != Client_ThisServer()) {
369 /* Invalid KILL received from remote */
370 if (Client_Type(c) == CLIENT_SERVER)
371 msg = ERR_CANTKILLSERVER_MSG;
373 msg = ERR_NOPRIVILEGES_MSG;
374 return IRC_WriteErrClient(Client, msg, Client_ID(Client));
378 "Got KILL for invalid client type: %d, \"%s\"!",
379 Client_Type(c), Nick);
382 /* Save ID of this connection */
383 my_conn = Client_Conn(Client);
385 /* Kill the client NOW:
386 * - Close the local connection (if there is one),
387 * - Destroy the CLIENT structure for remote clients.
388 * Note: Conn_Close() removes the CLIENT structure as well. */
389 conn = Client_Conn(c);
391 Conn_Close(conn, NULL, Reason, true);
393 Client_Destroy(c, NULL, Reason, false);
395 /* Are we still connected or were we killed, too? */
396 if (my_conn > NONE && Conn_GetClient(my_conn))
403 * Send help for a given topic to the client.
405 * @param Client The client requesting help.
406 * @param Topoc The help topic requested.
407 * @return CONNECTED or DISCONNECTED.
410 Help(CLIENT *Client, const char *Topic)
413 size_t helptext_len, len_str, idx_start, lines = 0;
414 bool in_article = false;
416 assert(Client != NULL);
417 assert(Topic != NULL);
419 helptext_len = array_bytes(&Conf_Helptext);
420 line = array_start(&Conf_Helptext);
421 while (helptext_len > 0) {
422 len_str = strlen(line) + 1;
423 assert(helptext_len >= len_str);
424 helptext_len -= len_str;
427 /* The first character in each article text line must
428 * be a TAB (ASCII 9) character which will be stripped
429 * in the output. If it is not a TAB, the end of the
430 * article has been reached. */
431 if (line[0] != '\t') {
438 /* A single '.' character indicates an empty line */
439 if (line[1] == '.' && line[2] == '\0')
444 if (!IRC_WriteStrClient(Client, "NOTICE %s :%s",
451 if (line[0] == '-' && line[1] == ' '
452 && strcasecmp(&line[2], Topic) == 0)
459 /* Help topic not found (or empty)! */
460 if (!IRC_WriteStrClient(Client, "NOTICE %s :No help for \"%s\" found!",
461 Client_ID(Client), Topic))
468 * Get pointer to a static string representing the connection "options".
470 * @param Idx Connection index.
471 * @return Pointer to static (global) string buffer.
475 Option_String(CONN_ID Idx)
477 Option_String(UNUSED CONN_ID Idx)
480 static char option_txt[8];
487 options = Conn_Options(Idx);
488 strcpy(option_txt, "F"); /* No idea what this means, but the
489 * original ircd sends it ... */
491 if(options & CONN_SSL) /* SSL encrypted link */
492 strlcat(option_txt, "s", sizeof(option_txt));
495 if(options & CONN_ZIP) /* zlib compression enabled */
496 strlcat(option_txt, "z", sizeof(option_txt));
498 LogDebug(" *** %d: %d = %s", Idx, options, option_txt);
501 } /* Option_String */
504 Send_Message(CLIENT * Client, REQUEST * Req, int ForceType, bool SendErrors)
509 char *currentTarget = Req->argv[0];
510 char *lastCurrentTarget = NULL;
511 char *message = NULL;
513 assert(Client != NULL);
516 if (Req->argc == 0) {
519 return IRC_WriteErrClient(Client, ERR_NORECIPIENT_MSG,
520 Client_ID(Client), Req->command);
522 if (Req->argc == 1) {
525 return IRC_WriteErrClient(Client, ERR_NOTEXTTOSEND_MSG,
531 IRC_SetPenalty(Client, 2);
532 return IRC_WriteErrClient(Client, ERR_NEEDMOREPARAMS_MSG,
533 Client_ID(Client), Req->command);
536 if (Client_Type(Client) == CLIENT_SERVER)
537 from = Client_Search(Req->prefix);
541 return IRC_WriteErrClient(Client, ERR_NOSUCHNICK_MSG,
542 Client_ID(Client), Req->prefix);
545 if (Client_Conn(Client) > NONE)
546 message = Conn_EncodingFrom(Client_Conn(Client), Req->argv[1]);
549 message = Req->argv[1];
551 /* handle msgtarget = msgto *("," msgto) */
552 currentTarget = strtok_r(currentTarget, ",", &lastCurrentTarget);
553 ngt_UpperStr(Req->command);
555 while (currentTarget) {
556 /* Check for and handle valid <msgto> of form:
558 * msgto = channel / ( user [ "%" host ] "@" servername )
559 * msgto =/ ( user "%" host ) / targetmask
560 * msgto =/ nickname / ( nickname "!" user "@" host )
562 if (strchr(currentTarget, '!') == NULL)
564 cl = Client_Search(currentTarget);
569 /* If currentTarget isn't a nickname check for:
570 * user ["%" host] "@" servername
572 * nickname "!" user "@" host
574 char target[COMMAND_LEN];
578 char * server = NULL;
580 strlcpy(target, currentTarget, COMMAND_LEN);
581 server = strchr(target, '@');
586 host = strchr(target, '%');
591 user = strchr(target, '!');
593 /* msgto form: nick!user@host */
597 host = server; /* not "@server" but "@host" */
602 for (cl = Client_First(); cl != NULL; cl = Client_Next(cl)) {
603 if (Client_Type(cl) != CLIENT_USER &&
604 Client_Type(cl) != CLIENT_SERVICE)
606 if (nick != NULL && host != NULL) {
607 if (strcasecmp(nick, Client_ID(cl)) == 0 &&
608 strcasecmp(user, Client_User(cl)) == 0 &&
609 strcasecmp(host, Client_HostnameDisplayed(cl)) == 0)
614 if (strcasecmp(user, Client_User(cl)) != 0)
616 if (host != NULL && strcasecmp(host,
617 Client_HostnameDisplayed(cl)) != 0)
619 if (server != NULL && strcasecmp(server,
620 Client_ID(Client_Introducer(cl))) != 0)
627 /* Target is a user, enforce type */
629 if (Client_Type(cl) != ForceType &&
630 !(ForceType == CLIENT_USER &&
631 (Client_Type(cl) == CLIENT_USER ||
632 Client_Type(cl) == CLIENT_SERVICE))) {
634 if (Client_Type(cl) != ForceType) {
636 if (SendErrors && !IRC_WriteErrClient(
637 from, ERR_NOSUCHNICK_MSG,Client_ID(from),
640 goto send_next_target;
644 if (ForceType == CLIENT_SERVICE &&
645 (Conn_Options(Client_Conn(Client_NextHop(cl)))
647 /* SQUERY command but RFC 1459 link: convert
648 * request to PRIVMSG command */
649 Req->command = "PRIVMSG";
652 if (Client_HasMode(cl, 'b') &&
653 !Client_HasMode(from, 'R') &&
654 !Client_HasMode(from, 'o') &&
655 !(Client_Type(from) == CLIENT_SERVER) &&
656 !(Client_Type(from) == CLIENT_SERVICE)) {
657 if (SendErrors && !IRC_WriteErrClient(from,
659 Client_ID(from), Client_ID(cl)))
661 goto send_next_target;
664 if (Client_HasMode(cl, 'C')) {
665 cl2chan = Channel_FirstChannelOf(cl);
667 chan = Channel_GetChannel(cl2chan);
668 if (Channel_IsMemberOf(chan, from))
670 cl2chan = Channel_NextChannelOf(cl, cl2chan);
673 if (SendErrors && !IRC_WriteErrClient(
674 from, ERR_NOTONSAMECHANNEL_MSG,
675 Client_ID(from), Client_ID(cl)))
677 goto send_next_target;
681 if (SendErrors && (Client_Type(Client) != CLIENT_SERVER)
682 && Client_HasMode(cl, 'a')) {
684 if (!IRC_WriteStrClient(from, RPL_AWAY_MSG,
690 if (Client_Conn(from) > NONE) {
691 Conn_UpdateIdle(Client_Conn(from));
693 if (!IRC_WriteStrClientPrefix(cl, from, "%s %s :%s",
694 Req->command, Client_ID(cl),
697 } else if (ForceType != CLIENT_SERVICE
698 && (chan = Channel_Search(currentTarget))) {
699 if (!Channel_Write(chan, from, Client, Req->command,
700 SendErrors, message))
702 } else if (ForceType != CLIENT_SERVICE
703 /* $#: server/target mask, RFC 2812, sec. 3.3.1 */
704 && strchr("$#", currentTarget[0])
705 && strchr(currentTarget, '.')) {
707 if (!Send_Message_Mask(from, Req->command, currentTarget,
708 message, SendErrors))
713 if (!IRC_WriteErrClient(from, ERR_NOSUCHNICK_MSG,
714 Client_ID(from), currentTarget))
719 currentTarget = strtok_r(NULL, ",", &lastCurrentTarget);
721 Conn_SetPenalty(Client_Conn(Client), 1);
728 Send_Message_Mask(CLIENT * from, char * command, char * targetMask,
729 char * message, bool SendErrors)
733 char *mask = targetMask + 1;
734 const char *check_wildcards;
738 if (!Client_HasMode(from, 'o')) {
741 return IRC_WriteErrClient(from, ERR_NOPRIVILEGES_MSG,
746 * RFC 2812, sec. 3.3.1 requires that targetMask have at least one
747 * dot (".") and no wildcards ("*", "?") following the last one.
749 check_wildcards = strrchr(targetMask, '.');
750 assert(check_wildcards != NULL);
751 if (check_wildcards &&
752 check_wildcards[strcspn(check_wildcards, "*?")])
756 return IRC_WriteErrClient(from, ERR_WILDTOPLEVEL, targetMask);
759 /* #: hostmask, see RFC 2812, sec. 3.3.1 */
760 if (targetMask[0] == '#') {
761 for (cl = Client_First(); cl != NULL; cl = Client_Next(cl)) {
762 if (Client_Type(cl) != CLIENT_USER)
764 client_match = MatchCaseInsensitive(mask, Client_Hostname(cl));
766 if (!IRC_WriteStrClientPrefix(cl, from, "%s %s :%s",
767 command, Client_ID(cl), message))
771 assert(targetMask[0] == '$'); /* $: server mask, see RFC 2812, sec. 3.3.1 */
772 for (cl = Client_First(); cl != NULL; cl = Client_Next(cl)) {
773 if (Client_Type(cl) != CLIENT_USER)
775 client_match = MatchCaseInsensitive(mask,
776 Client_ID(Client_Introducer(cl)));
778 if (!IRC_WriteStrClientPrefix(cl, from, "%s %s :%s",
779 command, Client_ID(cl), message))
784 } /* Send_Message_Mask */