2 * ngIRCd -- The Next Generation IRC Daemon
3 * Copyright (c)2001-2010 Alexander Barton (alex@barton.de)
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.
16 * IRC channel commands
28 #include "conn-func.h"
35 #include "irc-write.h"
39 #include "irc-channel.h"
43 * Part from all channels.
45 * RFC 2812, (3.2.1 Join message Command):
46 * Note that this message accepts a special argument ("0"), which is a
47 * special request to leave all channels the user is currently a member of.
48 * The server will process this message as if the user had sent a PART
49 * command (See Section 3.2.2) for each channel he is a member of.
51 * @param client Client that initiated the part request
52 * @param target Client that should part all joined channels
53 * @returns CONNECTED or DISCONNECTED
56 part_from_all_channels(CLIENT* client, CLIENT *target)
61 while ((cl2chan = Channel_FirstChannelOf(target))) {
62 chan = Channel_GetChannel(cl2chan);
63 assert( chan != NULL );
64 Channel_Part(target, client, Channel_Name(chan), Client_ID(target));
67 } /* part_from_all_channels */
71 * Check weather a local client is allowed to join an already existing
74 * @param Client Client that sent the JOIN command
75 * @param chan Channel to check
76 * @param channame Name of the channel
77 * @param key Provided channel key (or NULL)
78 * @returns true if client is allowed to join, false otherwise
81 join_allowed(CLIENT *Client, CHANNEL *chan, const char *channame,
84 bool is_invited, is_banned;
85 const char *channel_modes;
87 /* Allow IRC operators to overwrite channel limits */
88 if (strchr(Client_Modes(Client), 'o'))
91 is_banned = Lists_Check(Channel_GetListBans(chan), Client);
92 is_invited = Lists_Check(Channel_GetListInvites(chan), Client);
94 if (is_banned && !is_invited) {
95 /* Client is banned from channel (and not on invite list) */
96 IRC_WriteStrClient(Client, ERR_BANNEDFROMCHAN_MSG,
97 Client_ID(Client), channame);
101 channel_modes = Channel_Modes(chan);
102 if (strchr(channel_modes, 'i') && !is_invited) {
103 /* Channel is "invite-only" and client is not on invite list */
104 IRC_WriteStrClient(Client, ERR_INVITEONLYCHAN_MSG,
105 Client_ID(Client), channame);
109 if (!Channel_CheckKey(chan, Client, key ? key : "")) {
110 /* Channel is protected by a channel key and the client
111 * didn't specify the correct one */
112 IRC_WriteStrClient(Client, ERR_BADCHANNELKEY_MSG,
113 Client_ID(Client), channame);
117 if (strchr(channel_modes, 'l') &&
118 (Channel_MaxUsers(chan) <= Channel_MemberCount(chan))) {
119 /* There are more clints joined to this channel than allowed */
120 IRC_WriteStrClient(Client, ERR_CHANNELISFULL_MSG,
121 Client_ID(Client), channame);
125 if (strchr(channel_modes, 'z') && !Conn_UsesSSL(Client_Conn(Client))) {
126 /* Only "secure" clients are allowed, but clients doesn't
127 * use SSL encryption */
128 IRC_WriteStrClient(Client, ERR_SECURECHANNEL_MSG,
129 Client_ID(Client), channame);
133 if (strchr(channel_modes, 'O') && !Client_OperByMe(Client)) {
134 /* Only IRC operators are allowed! */
135 IRC_WriteStrClient(Client, ERR_OPONLYCHANNEL_MSG,
136 Client_ID(Client), channame);
140 if (strchr(channel_modes, 'R') && !strchr(Client_Modes(Client), 'R')) {
141 /* Only registered users are allowed! */
142 IRC_WriteStrClient(Client, ERR_REGONLYCHANNEL_MSG,
143 Client_ID(Client), channame);
152 * Set user channel modes.
154 * @param chan Channel
155 * @param target User to set modes for
156 * @param flags Channel modes to add
159 join_set_channelmodes(CHANNEL *chan, CLIENT *target, const char *flags)
163 Channel_UserModeAdd(chan, target, *flags);
168 /* If channel persistent and client is ircop: make client chanop */
169 if (strchr(Channel_Modes(chan), 'P') && strchr(Client_Modes(target), 'o'))
170 Channel_UserModeAdd(chan, target, 'o');
171 } /* join_set_channelmodes */
175 * Forward JOIN command to a specific server
177 * This function diffentiates between servers using RFC 2813 mode that
178 * support the JOIN command with appended ASCII 7 character and channel
179 * modes, and servers using RFC 1459 protocol which require separate JOIN
182 * @param To Forward JOIN (and MODE) command to this peer server
183 * @param Prefix Client used to prefix the genrated commands
184 * @param Data Parameters of JOIN command to forward, probably
185 * containing channel modes separated by ASCII 7.
188 cb_join_forward(CLIENT *To, CLIENT *Prefix, void *Data)
191 char str[COMMAND_LEN], *ptr = NULL;
193 strlcpy(str, (char *)Data, sizeof(str));
194 conn = Client_Conn(To);
196 if (Conn_Options(conn) & CONN_RFC1459) {
197 /* RFC 1459 compatibility mode, appended modes are NOT
198 * supported, so strip them off! */
199 ptr = strchr(str, 0x7);
204 IRC_WriteStrClientPrefix(To, Prefix, "JOIN %s", str);
206 IRC_WriteStrClientPrefix(To, Prefix, "MODE %s +%s %s", str, ptr,
208 } /* cb_join_forward */
212 * Forward JOIN command to all servers
214 * This function calls cb_join_forward(), which differentiates between
215 * protocol implementations (e.g. RFC 2812, RFC 1459).
217 * @param Client Client used to prefix the genrated commands
218 * @param target Forward JOIN (and MODE) command to this peer server
219 * @param chan Channel structure
220 * @param channame Channel name
223 join_forward(CLIENT *Client, CLIENT *target, CHANNEL *chan,
224 const char *channame)
226 char modes[CHANNEL_MODE_LEN], str[COMMAND_LEN];
228 /* RFC 2813, 4.2.1: channel modes are separated from the channel
229 * name with ASCII 7, if any, and not spaces: */
230 strlcpy(&modes[1], Channel_UserModes(chan, target), sizeof(modes) - 1);
236 /* forward to other servers (if it is not a local channel) */
237 if (!Channel_IsLocal(chan)) {
238 snprintf(str, sizeof(str), "%s%s", channame, modes);
239 IRC_WriteStrServersPrefixFlag_CB(Client, target, '\0',
240 cb_join_forward, str);
243 /* tell users in this channel about the new client */
244 IRC_WriteStrChannelPrefix(Client, chan, target, false,
245 "JOIN :%s", channame);
247 /* syncronize channel modes */
249 IRC_WriteStrChannelPrefix(Client, chan, target, false,
250 "MODE %s +%s %s", channame,
251 &modes[1], Client_ID(target));
257 * Aknowledge user JOIN request and send "channel info" numerics.
259 * @param Client Client used to prefix the genrated commands
260 * @param target Forward commands/numerics to this user
261 * @param chan Channel structure
262 * @param channame Channel name
265 join_send_topic(CLIENT *Client, CLIENT *target, CHANNEL *chan,
266 const char *channame)
270 if (Client_Type(Client) != CLIENT_USER)
272 /* acknowledge join */
273 if (!IRC_WriteStrClientPrefix(Client, target, "JOIN :%s", channame))
276 /* Send topic to client, if any */
277 topic = Channel_Topic(chan);
278 assert(topic != NULL);
280 if (!IRC_WriteStrClient(Client, RPL_TOPIC_MSG,
281 Client_ID(Client), channame, topic))
284 if (!IRC_WriteStrClient(Client, RPL_TOPICSETBY_MSG,
285 Client_ID(Client), channame,
286 Channel_TopicWho(chan),
287 Channel_TopicTime(chan)))
291 /* send list of channel members to client */
292 if (!IRC_Send_NAMES(Client, chan))
294 return IRC_WriteStrClient(Client, RPL_ENDOFNAMES_MSG, Client_ID(Client),
296 } /* join_send_topic */
300 * Handler for the IRC "JOIN" command.
302 * See RFC 2812, 3.2.1 "Join message"; RFC 2813, 4.2.1 "Join message".
304 * @param Client The client from which this command has been received
305 * @param Req Request structure with prefix and all parameters
306 * @returns CONNECTED or DISCONNECTED
309 IRC_JOIN( CLIENT *Client, REQUEST *Req )
311 char *channame, *key = NULL, *flags, *lastkey = NULL, *lastchan = NULL;
315 assert( Client != NULL );
316 assert( Req != NULL );
318 /* Bad number of arguments? */
319 if (Req->argc < 1 || Req->argc > 2)
320 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
321 Client_ID(Client), Req->command);
323 /* Who is the sender? */
324 if (Client_Type(Client) == CLIENT_SERVER)
325 target = Client_Search(Req->prefix);
330 return IRC_WriteStrClient(Client, ERR_NOSUCHNICK_MSG, Client_ID(Client), Req->prefix);
332 /* Is argument "0"? */
333 if (Req->argc == 1 && !strncmp("0", Req->argv[0], 2))
334 return part_from_all_channels(Client, target);
336 /* Are channel keys given? */
338 key = strtok_r(Req->argv[1], ",", &lastkey);
340 channame = Req->argv[0];
341 channame = strtok_r(channame, ",", &lastchan);
343 /* Make sure that "channame" is not the empty string ("JOIN :") */
345 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
346 Client_ID(Client), Req->command);
351 /* Did the server include channel-user-modes? */
352 if (Client_Type(Client) == CLIENT_SERVER) {
353 flags = strchr(channame, 0x7);
360 chan = Channel_Search(channame);
361 if (!chan && Conf_PredefChannelsOnly) {
362 /* channel must be created, but server does not allow this */
363 IRC_WriteStrClient(Client, ERR_BANNEDFROMCHAN_MSG, Client_ID(Client), channame);
368 if (Client_Type(Client) == CLIENT_USER) {
369 /* Test if the user has reached the channel limit */
370 if ((Conf_MaxJoins > 0) &&
371 (Channel_CountForUser(Client) >= Conf_MaxJoins))
372 return IRC_WriteStrClient(Client,
373 ERR_TOOMANYCHANNELS_MSG,
374 Client_ID(Client), channame);
376 /* Already existing channel: check if the
377 * client is allowed to join */
378 if (!join_allowed(Client, chan, channame, key))
381 /* New channel: first user will become channel
382 * operator unless this is a modeless channel */
383 if (*channame != '+')
387 /* Local client: update idle time */
388 Conn_UpdateIdle(Client_Conn(Client));
390 /* Remote server: we don't need to know whether the
391 * client is invited or not, but we have to make sure
392 * that the "one shot" entries (generated by INVITE
393 * commands) in this list become deleted when a user
394 * joins a channel this way. */
396 (void)Lists_Check(Channel_GetListInvites(chan),
400 /* Join channel (and create channel if it doesn't exist) */
401 if (!Channel_Join(target, channame))
404 if (!chan) { /* channel is new; it has been created above */
405 chan = Channel_Search(channame);
406 assert(chan != NULL);
407 if (Channel_IsModeless(chan)) {
408 Channel_ModeAdd(chan, 't'); /* /TOPIC not allowed */
409 Channel_ModeAdd(chan, 'n'); /* no external msgs */
412 assert(chan != NULL);
414 join_set_channelmodes(chan, target, flags);
416 join_forward(Client, target, chan, channame);
418 if (!join_send_topic(Client, target, chan, channame))
419 break; /* write error */
422 channame = strtok_r(NULL, ",", &lastchan);
424 key = strtok_r(NULL, ",", &lastkey);
431 * Handler for the IRC "PART" command.
433 * See RFC 2812, 3.2.2: "Part message".
435 * @param Client The client from which this command has been received
436 * @param Req Request structure with prefix and all parameters
437 * @returns CONNECTED or DISCONNECTED
440 IRC_PART(CLIENT * Client, REQUEST * Req)
445 assert(Client != NULL);
448 if (Req->argc < 1 || Req->argc > 2)
449 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
450 Client_ID(Client), Req->command);
453 if (Client_Type(Client) == CLIENT_SERVER)
454 target = Client_Search(Req->prefix);
458 return IRC_WriteStrClient(Client, ERR_NOSUCHNICK_MSG,
459 Client_ID(Client), Req->prefix);
461 /* Loop over all the given channel names */
462 chan = strtok(Req->argv[0], ",");
464 /* Make sure that "chan" is not the empty string ("PART :") */
466 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
467 Client_ID(Client), Req->command);
470 Channel_Part(target, Client, chan,
471 Req->argc > 1 ? Req->argv[1] : Client_ID(target));
472 chan = strtok(NULL, ",");
475 /* Update idle time, if local client */
476 if (Client_Conn(Client) > NONE)
477 Conn_UpdateIdle(Client_Conn(Client));
484 * Handler for the IRC "TOPIC" command.
486 * See RFC 2812, 3.2.4 "Topic message".
488 * @param Client The client from which this command has been received
489 * @param Req Request structure with prefix and all parameters
490 * @returns CONNECTED or DISCONNECTED
493 IRC_TOPIC( CLIENT *Client, REQUEST *Req )
498 bool onchannel, topicok, use_servermode, r;
500 assert( Client != NULL );
501 assert( Req != NULL );
503 if (Req->argc < 1 || Req->argc > 2)
504 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
505 Client_ID(Client), Req->command);
507 if (Client_Type(Client) == CLIENT_SERVER)
508 from = Client_Search(Req->prefix);
513 return IRC_WriteStrClient(Client, ERR_NOSUCHNICK_MSG,
514 Client_ID(Client), Req->prefix);
516 chan = Channel_Search(Req->argv[0]);
518 return IRC_WriteStrClient(from, ERR_NOSUCHCHANNEL_MSG,
519 Client_ID(from), Req->argv[0]);
521 Channel_CheckAdminRights(chan, Client, from,
522 &onchannel, &topicok, &use_servermode);
524 if (!onchannel && !topicok)
525 return IRC_WriteStrClient(from, ERR_NOTONCHANNEL_MSG,
526 Client_ID(from), Req->argv[0]);
528 if (Req->argc == 1) {
529 /* Request actual topic */
530 topic = Channel_Topic(chan);
532 r = IRC_WriteStrClient(from, RPL_TOPIC_MSG,
534 Channel_Name(chan), topic);
538 r = IRC_WriteStrClient(from, RPL_TOPICSETBY_MSG,
541 Channel_TopicWho(chan),
542 Channel_TopicTime(chan));
547 return IRC_WriteStrClient(from, RPL_NOTOPIC_MSG,
552 if (strchr(Channel_Modes(chan), 't')) {
553 /* Topic Lock. Is the user a channel or IRC operator? */
555 return IRC_WriteStrClient(from, ERR_CHANOPRIVSNEEDED_MSG,
561 Channel_SetTopic(chan, from, Req->argv[1]);
562 LogDebug("%s \"%s\" set topic on \"%s\": %s",
563 Client_TypeText(from), Client_Mask(from), Channel_Name(chan),
564 Req->argv[1][0] ? Req->argv[1] : "<none>");
567 from = Client_ThisServer();
569 /* Update channel and forward new topic to other servers */
570 if (!Channel_IsLocal(chan))
571 IRC_WriteStrServersPrefix(Client, from, "TOPIC %s :%s",
572 Req->argv[0], Req->argv[1]);
573 IRC_WriteStrChannelPrefix(Client, chan, from, false, "TOPIC %s :%s",
574 Req->argv[0], Req->argv[1]);
576 if (Client_Type(Client) == CLIENT_USER)
577 return IRC_WriteStrClientPrefix(Client, Client, "TOPIC %s :%s",
578 Req->argv[0], Req->argv[1]);
585 * Handler for the IRC "LIST" command.
587 * See RFC 2812, 3.2.6 "List message".
589 * This implementation handles the local case as well as the forwarding of the
590 * LIST command to other servers in the IRC network.
592 * @param Client The client from which this command has been received
593 * @param Req Request structure with prefix and all parameters
594 * @returns CONNECTED or DISCONNECTED
597 IRC_LIST( CLIENT *Client, REQUEST *Req )
601 CLIENT *from, *target;
603 assert( Client != NULL );
604 assert( Req != NULL );
606 /* Bad number of prameters? */
608 return IRC_WriteStrClient( Client, ERR_NEEDMOREPARAMS_MSG,
609 Client_ID( Client ), Req->command );
612 pattern = strtok( Req->argv[0], "," );
616 /* Get sender from prefix, if any */
617 if( Client_Type( Client ) == CLIENT_SERVER )
618 from = Client_Search( Req->prefix );
623 return IRC_WriteStrClient( Client, ERR_NOSUCHSERVER_MSG,
624 Client_ID( Client ), Req->prefix );
628 /* Forward to other server? */
629 target = Client_Search( Req->argv[1] );
630 if(( ! target ) || ( Client_Type( target ) != CLIENT_SERVER ))
631 return IRC_WriteStrClient( from, ERR_NOSUCHSERVER_MSG,
632 Client_ID( Client ), Req->argv[1] );
634 if( target != Client_ThisServer( ))
636 /* Target is indeed an other server, forward it! */
637 return IRC_WriteStrClientPrefix( target, from,
638 "LIST %s :%s", Client_ID( from ),
645 /* Loop through all the channels */
646 chan = Channel_First( );
649 /* Check search pattern */
650 if( Match( pattern, Channel_Name( chan )))
653 if( ! strchr( Channel_Modes( chan ), 's' ) ||
654 Channel_IsMemberOf( chan, from ))
656 if( ! IRC_WriteStrClient( from,
657 RPL_LIST_MSG, Client_ID( from ),
658 Channel_Name( chan ),
659 Channel_MemberCount( chan ),
660 Channel_Topic( chan )))
664 chan = Channel_Next( chan );
667 /* Get next name ... */
669 pattern = strtok( NULL, "," );
674 return IRC_WriteStrClient( from, RPL_LISTEND_MSG, Client_ID( from ));
679 * Handler for the IRC+ command "CHANINFO".
681 * See doc/Protocol.txt, section II.3:
682 * "Exchange channel-modes, topics, and persistent channels".
684 * @param Client The client from which this command has been received
685 * @param Req Request structure with prefix and all parameters
686 * @returns CONNECTED or DISCONNECTED
689 IRC_CHANINFO( CLIENT *Client, REQUEST *Req )
691 char modes_add[COMMAND_LEN], l[16], *ptr;
696 assert( Client != NULL );
697 assert( Req != NULL );
699 /* Bad number of parameters? */
700 if (Req->argc < 2 || Req->argc == 4 || Req->argc > 5)
701 return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG,
702 Client_ID(Client), Req->command);
704 /* Compatibility kludge */
705 if( Req->argc == 5 ) arg_topic = 4;
706 else if( Req->argc == 3 ) arg_topic = 2;
710 from = Client_Search( Req->prefix );
711 if( ! from ) return IRC_WriteStrClient( Client, ERR_NOSUCHNICK_MSG, Client_ID( Client ), Req->prefix );
713 /* Search or create channel */
714 chan = Channel_Search( Req->argv[0] );
715 if( ! chan ) chan = Channel_Create( Req->argv[0] );
716 if( ! chan ) return CONNECTED;
718 if( Req->argv[1][0] == '+' )
720 ptr = Channel_Modes( chan );
723 /* OK, this channel doesn't have modes jet, set the received ones: */
724 Channel_SetModes( chan, &Req->argv[1][1] );
728 if( strchr( Channel_Modes( chan ), 'k' )) Channel_SetKey( chan, Req->argv[2] );
729 if( strchr( Channel_Modes( chan ), 'l' )) Channel_SetMaxUsers( chan, atol( Req->argv[3] ));
733 /* Delete modes which we never want to inherit */
734 Channel_ModeDel( chan, 'l' );
735 Channel_ModeDel( chan, 'k' );
738 strcpy( modes_add, "" );
739 ptr = Channel_Modes( chan );
744 snprintf( l, sizeof( l ), " %lu", Channel_MaxUsers( chan ));
745 strlcat( modes_add, l, sizeof( modes_add ));
749 strlcat( modes_add, " ", sizeof( modes_add ));
750 strlcat( modes_add, Channel_Key( chan ), sizeof( modes_add ));
755 /* Inform members of this channel */
756 IRC_WriteStrChannelPrefix( Client, chan, from, false, "MODE %s +%s%s", Req->argv[0], Channel_Modes( chan ), modes_add );
759 else Log( LOG_WARNING, "CHANINFO: invalid MODE format ignored!" );
764 ptr = Channel_Topic( chan );
765 if(( ! *ptr ) && ( Req->argv[arg_topic][0] ))
767 /* OK, there is no topic jet */
768 Channel_SetTopic(chan, Client, Req->argv[arg_topic]);
769 IRC_WriteStrChannelPrefix(Client, chan, from, false,
770 "TOPIC %s :%s", Req->argv[0], Channel_Topic(chan));
774 /* Forward CHANINFO to other serevrs */
775 if( Req->argc == 5 ) IRC_WriteStrServersPrefixFlag( Client, from, 'C', "CHANINFO %s %s %s %s :%s", Req->argv[0], Req->argv[1], Req->argv[2], Req->argv[3], Req->argv[4] );
776 else if( Req->argc == 3 ) IRC_WriteStrServersPrefixFlag( Client, from, 'C', "CHANINFO %s %s :%s", Req->argv[0], Req->argv[1], Req->argv[2] );
777 else IRC_WriteStrServersPrefixFlag( Client, from, 'C', "CHANINFO %s %s", Req->argv[0], Req->argv[1] );