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 command parser and validator.
28 #include "conn-func.h"
40 #include "irc-channel.h"
42 #include "irc-login.h"
46 #include "irc-server.h"
47 #include "irc-write.h"
54 bool (*function) PARAMS(( CLIENT *Client, REQUEST *Request ));
58 static COMMAND My_Commands[] =
60 { "ADMIN", IRC_ADMIN, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
61 { "AWAY", IRC_AWAY, CLIENT_USER, 0, 0, 0 },
62 { "CONNECT", IRC_CONNECT, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
63 { "DIE", IRC_DIE, CLIENT_USER, 0, 0, 0 },
64 { "DISCONNECT", IRC_DISCONNECT, CLIENT_USER, 0, 0, 0 },
65 { "ERROR", IRC_ERROR, 0xFFFF, 0, 0, 0 },
66 { "HELP", IRC_HELP, CLIENT_USER, 0, 0, 0 },
67 { "INFO", IRC_INFO, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
68 { "INVITE", IRC_INVITE, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
69 { "ISON", IRC_ISON, CLIENT_USER, 0, 0, 0 },
70 { "JOIN", IRC_JOIN, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
71 { "KICK", IRC_KICK, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
72 { "KILL", IRC_KILL, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
73 { "LINKS", IRC_LINKS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
74 { "LIST", IRC_LIST, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
75 { "LUSERS", IRC_LUSERS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
76 { "MODE", IRC_MODE, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
77 { "MOTD", IRC_MOTD, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
78 { "NAMES", IRC_NAMES, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
79 { "NICK", IRC_NICK, 0xFFFF, 0, 0, 0 },
80 { "NJOIN", IRC_NJOIN, CLIENT_SERVER, 0, 0, 0 },
81 { "NOTICE", IRC_NOTICE, 0xFFFF, 0, 0, 0 },
82 { "OPER", IRC_OPER, CLIENT_USER, 0, 0, 0 },
83 { "PART", IRC_PART, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
84 { "PASS", IRC_PASS, 0xFFFF, 0, 0, 0 },
85 { "PING", IRC_PING, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
86 { "PONG", IRC_PONG, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
87 { "PRIVMSG", IRC_PRIVMSG, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
88 { "QUIT", IRC_QUIT, 0xFFFF, 0, 0, 0 },
89 { "REHASH", IRC_REHASH, CLIENT_USER, 0, 0, 0 },
90 { "RESTART", IRC_RESTART, CLIENT_USER, 0, 0, 0 },
91 { "SERVER", IRC_SERVER, 0xFFFF, 0, 0, 0 },
92 { "SERVICE", IRC_SERVICE, 0xFFFF, 0, 0, 0 },
93 { "SERVLIST", IRC_SERVLIST, CLIENT_USER, 0, 0, 0 },
94 { "SQUERY", IRC_SQUERY, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
95 { "SQUIT", IRC_SQUIT, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
96 { "STATS", IRC_STATS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
97 { "SUMMON", IRC_SUMMON, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
98 { "TIME", IRC_TIME, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
99 { "TOPIC", IRC_TOPIC, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
100 { "TRACE", IRC_TRACE, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
101 { "USER", IRC_USER, 0xFFFF, 0, 0, 0 },
102 { "USERHOST", IRC_USERHOST, CLIENT_USER, 0, 0, 0 },
103 { "USERS", IRC_USERS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
104 { "VERSION", IRC_VERSION, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
105 { "WALLOPS", IRC_WALLOPS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
106 { "WEBIRC", IRC_WEBIRC, CLIENT_UNKNOWN, 0, 0, 0 },
107 { "WHO", IRC_WHO, CLIENT_USER, 0, 0, 0 },
108 { "WHOIS", IRC_WHOIS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
109 { "WHOWAS", IRC_WHOWAS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
111 { "CHANINFO", IRC_CHANINFO, CLIENT_SERVER, 0, 0, 0 },
113 { NULL, NULL, 0x0, 0, 0, 0 } /* Ende-Marke */
116 static void Init_Request PARAMS(( REQUEST *Req ));
118 static bool Validate_Prefix PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
119 static bool Validate_Command PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
120 static bool Validate_Args PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
122 static bool Handle_Request PARAMS(( CONN_ID Idx, REQUEST *Req ));
124 #define ARRAY_SIZE(x) (sizeof(x)/sizeof((x)[0]))
127 * Return the pointer to the global "IRC command structure".
128 * This structure, an array of type "COMMAND" describes all the IRC commands
129 * implemented by ngIRCd and how to handle them.
130 * @return Pointer to the global command structure.
133 Parse_GetCommandStruct( void )
136 } /* Parse_GetCommandStruct */
140 * Parse a command ("request") received from a client.
142 * This function is called after the connection layer received a valid CR+LF
143 * terminated line of text: we asume that this is a valid IRC command and
144 * try to do something useful with it :-)
146 * All errors are reported to the client from which the command has been
147 * received, and if the error is fatal this connection is closed down.
149 * This function is able to parse the syntax as described in RFC 2812,
152 * @param Idx Index of the connection from which the command has been received.
153 * @param Request NULL terminated line of text (the "command").
154 * @return true on success (valid command or "regular" error), false if a
155 * fatal error occured and the connection has been shut down.
158 Parse_Request( CONN_ID Idx, char *Request )
165 assert( Request != NULL );
168 if( NGIRCd_Sniffer ) Log( LOG_DEBUG, " <- connection %d: '%s'.", Idx, Request );
171 Init_Request( &req );
173 /* remove leading & trailing whitespace */
174 ngt_TrimStr( Request );
176 if( Request[0] == ':' )
179 req.prefix = Request + 1;
180 ptr = strchr( Request, ' ' );
183 LogDebug("Connection %d: Parse error: prefix without command!?", Idx);
184 return Conn_WriteStr( Idx, "ERROR :Prefix without command!?" );
188 /* ignore multiple spaces between prefix and command */
189 while( *(ptr + 1) == ' ' ) ptr++;
193 else start = Request;
195 ptr = strchr( start, ' ' );
200 /* ignore multiple spaces between parameters */
201 while( *(ptr + 1) == ' ' ) ptr++;
206 /* Arguments, Parameters */
212 if( start[0] == ':' )
214 req.argv[req.argc] = start + 1;
219 req.argv[req.argc] = start;
220 ptr = strchr( start, ' ' );
225 while( *(ptr + 1) == ' ' ) ptr++;
232 if( start[0] == ':' ) break;
233 if( req.argc > 14 ) break;
235 if( ptr ) start = ptr + 1;
240 if( ! Validate_Prefix( Idx, &req, &closed )) return ! closed;
241 if( ! Validate_Command( Idx, &req, &closed )) return ! closed;
242 if( ! Validate_Args( Idx, &req, &closed )) return ! closed;
244 return Handle_Request( Idx, &req );
245 } /* Parse_Request */
249 * Initialize request structure.
250 * @param Req Request structure to be initialized.
253 Init_Request( REQUEST *Req )
255 /* Neue Request-Struktur initialisieren */
259 assert( Req != NULL );
263 for( i = 0; i < 15; Req->argv[i++] = NULL );
269 Validate_Prefix( CONN_ID Idx, REQUEST *Req, bool *Closed )
274 assert( Req != NULL );
278 if( ! Req->prefix ) return true;
280 client = Conn_GetClient( Idx );
281 assert( client != NULL );
283 /* only validate if this connection is already registered */
284 if(( Client_Type( client ) != CLIENT_USER ) && ( Client_Type( client ) != CLIENT_SERVER ) && ( Client_Type( client ) != CLIENT_SERVICE ))
286 /* not registered, ignore prefix */
291 /* check if client in prefix is known */
292 c = Client_Search( Req->prefix );
295 Log( LOG_ERR, "Invalid prefix \"%s\", client not known (connection %d, command %s)!?", Req->prefix, Idx, Req->command );
296 if( ! Conn_WriteStr( Idx, "ERROR :Invalid prefix \"%s\", client not known!?", Req->prefix )) *Closed = true;
300 /* check if the client named in the prefix is expected
301 * to come from that direction */
302 if( Client_NextHop( c ) != client )
304 Log( LOG_ERR, "Spoofed prefix \"%s\" from \"%s\" (connection %d, command %s)!", Req->prefix, Client_Mask( Conn_GetClient( Idx )), Idx, Req->command );
305 Conn_Close( Idx, NULL, "Spoofed prefix", true);
311 } /* Validate_Prefix */
315 Validate_Command( UNUSED CONN_ID Idx, UNUSED REQUEST *Req, bool *Closed )
318 assert( Req != NULL );
322 } /* Validate_Comman */
327 Validate_Args(CONN_ID Idx, REQUEST *Req, bool *Closed)
329 Validate_Args(UNUSED CONN_ID Idx, UNUSED REQUEST *Req, bool *Closed)
340 assert( Req != NULL );
342 /* CR and LF are never allowed in command parameters.
343 * But since we do accept lines terminated only with CR or LF in
344 * "non-RFC-compliant mode" (besides the correct CR+LF combination),
345 * this check can only trigger in "strict RFC" mode; therefore we
346 * optimize it away otherwise ... */
347 for (i = 0; i < Req->argc; i++) {
348 if (strchr(Req->argv[i], '\r') || strchr(Req->argv[i], '\n')) {
350 "Invalid character(s) in parameter (connection %d, command %s)!?",
352 if (!Conn_WriteStr(Idx,
353 "ERROR :Invalid character(s) in parameter!"))
361 } /* Validate_Args */
364 /* Command is a status code ("numeric") from another server */
366 Handle_Numeric(CLIENT *client, REQUEST *Req)
368 static const struct _NUMERIC Numerics[] = {
369 { 5, IRC_Num_ISUPPORT },
371 { 376, IRC_Num_ENDOFMOTD }
375 CLIENT *prefix, *target = NULL;
377 /* Determine target */
379 if (strcmp(Req->argv[0], "*") != 0)
380 target = Client_Search(Req->argv[0]);
382 target = Client_ThisServer();
386 /* Status code without target!? */
389 "Unknown target for status code %s: \"%s\"",
390 Req->command, Req->argv[0]);
393 "Unknown target for status code %s!",
397 if (target == Client_ThisServer()) {
398 /* This server is the target of the numeric */
399 num = atoi(Req->command);
401 for (i = 0; i < (int) ARRAY_SIZE(Numerics); i++) {
402 if (num == Numerics[i].numeric) {
403 if (!Numerics[i].function)
405 return Numerics[i].function(client, Req);
409 LogDebug("Ignored status code %s from \"%s\".",
410 Req->command, Client_ID(client));
414 /* Determine source */
415 if (! Req->prefix[0]) {
416 /* Oops, no prefix!? */
417 Log(LOG_WARNING, "Got status code %s from \"%s\" without prefix!?",
418 Req->command, Client_ID(client));
422 prefix = Client_Search(Req->prefix);
423 if (! prefix) { /* Oops, unknown prefix!? */
424 Log(LOG_WARNING, "Got status code %s from unknown source: \"%s\"", Req->command, Req->prefix);
428 /* Forward status code */
429 strlcpy(str, Req->command, sizeof(str));
430 for (i = 0; i < Req->argc; i++) {
431 if (i < Req->argc - 1)
432 strlcat(str, " ", sizeof(str));
434 strlcat(str, " :", sizeof(str));
435 strlcat(str, Req->argv[i], sizeof(str));
437 return IRC_WriteStrClientPrefix(target, prefix, "%s", str);
442 Handle_Request( CONN_ID Idx, REQUEST *Req )
450 assert( Req != NULL );
451 assert( Req->command != NULL );
453 client = Conn_GetClient( Idx );
454 assert( client != NULL );
457 client_type = Client_Type(client);
458 if ((client_type == CLIENT_SERVER ||
459 client_type == CLIENT_UNKNOWNSERVER)
460 && strlen(Req->command) == 3 && atoi(Req->command) > 1)
461 return Handle_Numeric(client, Req);
465 if (strcasecmp(Req->command, cmd->name) != 0) {
470 if (!(client_type & cmd->type))
471 return IRC_WriteStrClient(client, ERR_NOTREGISTERED_MSG, Client_ID(client));
473 /* Command is allowed for this client: call it and count produced bytes */
474 Conn_ResetWCounter();
475 result = (cmd->function)(client, Req);
476 cmd->bytes += Conn_WCounter();
478 /* Adjust counters */
479 if (client_type != CLIENT_SERVER)
486 if (client_type != CLIENT_USER &&
487 client_type != CLIENT_SERVER &&
488 client_type != CLIENT_SERVICE )
491 /* Unknown command and registered connection: generate error: */
492 LogDebug("Connection %d: Unknown command \"%s\", %d %s,%s prefix.",
493 Client_Conn( client ), Req->command, Req->argc,
494 Req->argc == 1 ? "parameter" : "parameters",
495 Req->prefix ? "" : " no" );
497 if (Client_Type(client) != CLIENT_SERVER) {
498 result = IRC_WriteStrClient(client, ERR_UNKNOWNCOMMAND_MSG,
499 Client_ID(client), Req->command);
500 Conn_SetPenalty(Idx, 1);
503 } /* Handle_Request */