]> arthur.barton.de Git - ngircd-alex.git/blob - src/ngircd/parse.c
Implemented IRC commands INFO, USERS (dummy), and SUMMON (dummy).
[ngircd-alex.git] / src / ngircd / parse.c
1 /*
2  * ngIRCd -- The Next Generation IRC Daemon
3  * Copyright (c)2001,2002 by Alexander Barton (alex@barton.de)
4  *
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.
10  */
11
12
13 #include "portab.h"
14
15 static char UNUSED id[] = "$Id: parse.c,v 1.72 2008/02/17 13:26:42 alex Exp $";
16
17 /**
18  * @file
19  * IRC command parser and validator.
20  */
21
22 #include "imp.h"
23 #include <assert.h>
24 #include <stdlib.h>
25 #include <stdio.h>
26 #include <string.h>
27 #include <strings.h>
28
29 #include "ngircd.h"
30 #include "defines.h"
31 #include "conn-func.h"
32 #include "client.h"
33 #include "channel.h"
34 #include "log.h"
35 #include "messages.h"
36 #include "tool.h"
37
38 #include "exp.h"
39 #include "parse.h"
40
41 #include "imp.h"
42 #include "irc.h"
43 #include "irc-channel.h"
44 #include "irc-info.h"
45 #include "irc-login.h"
46 #include "irc-mode.h"
47 #include "irc-op.h"
48 #include "irc-oper.h"
49 #include "irc-server.h"
50 #include "irc-write.h"
51 #include "numeric.h"
52
53 #include "exp.h"
54
55 struct _NUMERIC {
56         int numeric;
57         bool (*function) PARAMS(( CLIENT *Client, REQUEST *Request ));
58 };
59
60
61 static COMMAND My_Commands[] =
62 {
63         { "ADMIN", IRC_ADMIN, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
64         { "AWAY", IRC_AWAY, CLIENT_USER, 0, 0, 0 },
65         { "CONNECT", IRC_CONNECT, CLIENT_USER, 0, 0, 0 },
66         { "DIE", IRC_DIE, CLIENT_USER, 0, 0, 0 },
67         { "DISCONNECT", IRC_DISCONNECT, CLIENT_USER, 0, 0, 0 },
68         { "ERROR", IRC_ERROR, 0xFFFF, 0, 0, 0 },
69         { "HELP", IRC_HELP, CLIENT_USER, 0, 0, 0 },
70         { "INFO", IRC_INFO, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
71         { "INVITE", IRC_INVITE, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
72         { "ISON", IRC_ISON, CLIENT_USER, 0, 0, 0 },
73         { "JOIN", IRC_JOIN, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
74         { "KICK", IRC_KICK, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
75         { "KILL", IRC_KILL, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
76         { "LINKS", IRC_LINKS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
77         { "LIST", IRC_LIST, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
78         { "LUSERS", IRC_LUSERS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
79         { "MODE", IRC_MODE, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
80         { "MOTD", IRC_MOTD, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
81         { "NAMES", IRC_NAMES, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
82         { "NICK", IRC_NICK, 0xFFFF, 0, 0, 0 },
83         { "NJOIN", IRC_NJOIN, CLIENT_SERVER, 0, 0, 0 },
84         { "NOTICE", IRC_NOTICE, 0xFFFF, 0, 0, 0 },
85         { "OPER", IRC_OPER, CLIENT_USER, 0, 0, 0 },
86         { "PART", IRC_PART, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
87         { "PASS", IRC_PASS, 0xFFFF, 0, 0, 0 },
88         { "PING", IRC_PING, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
89         { "PONG", IRC_PONG, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
90         { "PRIVMSG", IRC_PRIVMSG, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
91         { "QUIT", IRC_QUIT, 0xFFFF, 0, 0, 0 },
92         { "REHASH", IRC_REHASH, CLIENT_USER, 0, 0, 0 },
93         { "RESTART", IRC_RESTART, CLIENT_USER, 0, 0, 0 },
94         { "SERVER", IRC_SERVER, 0xFFFF, 0, 0, 0 },
95         { "SQUIT", IRC_SQUIT, 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         { "WHO", IRC_WHO, CLIENT_USER, 0, 0, 0 },
107         { "WHOIS", IRC_WHOIS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
108         { "WHOWAS", IRC_WHOWAS, CLIENT_USER|CLIENT_SERVER, 0, 0, 0 },
109 #ifdef IRCPLUS
110         { "CHANINFO", IRC_CHANINFO, CLIENT_SERVER, 0, 0, 0 },
111 #endif
112         { NULL, NULL, 0x0, 0, 0, 0 } /* Ende-Marke */
113 };
114
115 static void Init_Request PARAMS(( REQUEST *Req ));
116
117 static bool Validate_Prefix PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
118 static bool Validate_Command PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
119 static bool Validate_Args PARAMS(( CONN_ID Idx, REQUEST *Req, bool *Closed ));
120
121 static bool Handle_Request PARAMS(( CONN_ID Idx, REQUEST *Req ));
122
123 #define ARRAY_SIZE(x)   (sizeof(x)/sizeof((x)[0]))
124
125 /**
126  * Return the pointer to the global "IRC command structure".
127  * This structure, an array of type "COMMAND" describes all the IRC commands
128  * implemented by ngIRCd and how to handle them.
129  * @return Pointer to the global command structure.
130  */
131 GLOBAL COMMAND *
132 Parse_GetCommandStruct( void )
133 {
134         return My_Commands;
135 } /* Parse_GetCommandStruct */
136
137
138 /**
139  * Parse a command ("request") received from a client.
140  * 
141  * This function is called after the connection layer received a valid CR+LF
142  * terminated line of text: we asume that this is a valid IRC command and
143  * try to do something useful with it :-)
144  *
145  * All errors are reported to the client from which the command has been
146  * received, and if the error is fatal this connection is closed down.
147  *
148  * This function is able to parse the syntax as described in RFC 2812,
149  * section 2.3.
150  *
151  * @param Idx Index of the connection from which the command has been received.
152  * @param Request NULL terminated line of text (the "command").
153  * @return true on success (valid command or "regular" error), false if a
154  *      fatal error occured and the connection has been shut down.
155  */
156 GLOBAL bool
157 Parse_Request( CONN_ID Idx, char *Request )
158 {
159         REQUEST req;
160         char *start, *ptr;
161         bool closed;
162
163         assert( Idx >= 0 );
164         assert( Request != NULL );
165
166 #ifdef SNIFFER
167         if( NGIRCd_Sniffer ) Log( LOG_DEBUG, " <- connection %d: '%s'.", Idx, Request );
168 #endif
169
170         Init_Request( &req );
171
172         /* Fuehrendes und folgendes "Geraffel" verwerfen */
173         ngt_TrimStr( Request );
174
175         /* gibt es ein Prefix? */
176         if( Request[0] == ':' )
177         {
178                 /* Prefix vorhanden */
179                 req.prefix = Request + 1;
180                 ptr = strchr( Request, ' ' );
181                 if( ! ptr )
182                 {
183                         Log( LOG_DEBUG, "Connection %d: Parse error: prefix without command!?", Idx );
184                         return Conn_WriteStr( Idx, "ERROR :Prefix without command!?" );
185                 }
186                 *ptr = '\0';
187 #ifndef STRICT_RFC
188                 /* multiple Leerzeichen als Trenner zwischen
189                  * Prefix und Befehl ignorieren */
190                 while( *(ptr + 1) == ' ' ) ptr++;
191 #endif
192                 start = ptr + 1;
193         }
194         else start = Request;
195
196         /* Befehl */
197         ptr = strchr( start, ' ' );
198         if( ptr )
199         {
200                 *ptr = '\0';
201 #ifndef STRICT_RFC
202                 /* multiple Leerzeichen als Trenner vor
203                  * Parametern ignorieren */
204                 while( *(ptr + 1) == ' ' ) ptr++;
205 #endif
206         }
207         req.command = start;
208
209         /* Argumente, Parameter */
210         if( ptr )
211         {
212                 /* Prinzipiell gibt es welche :-) */
213                 start = ptr + 1;
214                 while( start )
215                 {
216                         /* Parameter-String "zerlegen" */
217                         if( start[0] == ':' )
218                         {
219                                 req.argv[req.argc] = start + 1;
220                                 ptr = NULL;
221                         }
222                         else
223                         {
224                                 req.argv[req.argc] = start;
225                                 ptr = strchr( start, ' ' );
226                                 if( ptr )
227                                 {
228                                         *ptr = '\0';
229 #ifndef STRICT_RFC
230                                         /* multiple Leerzeichen als
231                                          * Parametertrenner ignorieren */
232                                         while( *(ptr + 1) == ' ' ) ptr++;
233 #endif
234                                 }
235                         }
236
237                         req.argc++;
238
239                         if( start[0] == ':' ) break;
240                         if( req.argc > 14 ) break;
241
242                         if( ptr ) start = ptr + 1;
243                         else start = NULL;
244                 }
245         }
246
247         /* Daten validieren */
248         if( ! Validate_Prefix( Idx, &req, &closed )) return ! closed;
249         if( ! Validate_Command( Idx, &req, &closed )) return ! closed;
250         if( ! Validate_Args( Idx, &req, &closed )) return ! closed;
251
252         return Handle_Request( Idx, &req );
253 } /* Parse_Request */
254
255
256 /**
257  * Initialize request structure.
258  * @param Req Request structure to be initialized.
259  */
260 static void
261 Init_Request( REQUEST *Req )
262 {
263         /* Neue Request-Struktur initialisieren */
264
265         int i;
266
267         assert( Req != NULL );
268
269         Req->prefix = NULL;
270         Req->command = NULL;
271         for( i = 0; i < 15; Req->argv[i++] = NULL );
272         Req->argc = 0;
273 } /* Init_Request */
274
275
276 static bool
277 Validate_Prefix( CONN_ID Idx, REQUEST *Req, bool *Closed )
278 {
279         CLIENT *client, *c;
280
281         assert( Idx >= 0 );
282         assert( Req != NULL );
283
284         *Closed = false;
285
286         /* ist ueberhaupt ein Prefix vorhanden? */
287         if( ! Req->prefix ) return true;
288
289         /* Client-Struktur der Connection ermitteln */
290         client = Conn_GetClient( Idx );
291         assert( client != NULL );
292
293         /* nur validieren, wenn bereits registrierte Verbindung */
294         if(( Client_Type( client ) != CLIENT_USER ) && ( Client_Type( client ) != CLIENT_SERVER ) && ( Client_Type( client ) != CLIENT_SERVICE ))
295         {
296                 /* noch nicht registrierte Verbindung.
297                  * Das Prefix wird ignoriert. */
298                 Req->prefix = NULL;
299                 return true;
300         }
301
302         /* pruefen, ob der im Prefix angegebene Client bekannt ist */
303         c = Client_Search( Req->prefix );
304         if( ! c )
305         {
306                 /* im Prefix angegebener Client ist nicht bekannt */
307                 Log( LOG_ERR, "Invalid prefix \"%s\", client not known (connection %d, command %s)!?", Req->prefix, Idx, Req->command );
308                 if( ! Conn_WriteStr( Idx, "ERROR :Invalid prefix \"%s\", client not known!?", Req->prefix )) *Closed = true;
309                 return false;
310         }
311
312         /* pruefen, ob der Client mit dem angegebenen Prefix in Richtung
313          * des Senders liegt, d.h. sicherstellen, dass das Prefix nicht
314          * gefaelscht ist */
315         if( Client_NextHop( c ) != client )
316         {
317                 /* das angegebene Prefix ist aus dieser Richtung, also
318                  * aus der gegebenen Connection, ungueltig! */
319                 Log( LOG_ERR, "Spoofed prefix \"%s\" from \"%s\" (connection %d, command %s)!", Req->prefix, Client_Mask( Conn_GetClient( Idx )), Idx, Req->command );
320                 Conn_Close( Idx, NULL, "Spoofed prefix", true);
321                 *Closed = true;
322                 return false;
323         }
324
325         return true;
326 } /* Validate_Prefix */
327
328
329 static bool
330 Validate_Command( UNUSED CONN_ID Idx, UNUSED REQUEST *Req, bool *Closed )
331 {
332         assert( Idx >= 0 );
333         assert( Req != NULL );
334         *Closed = false;
335
336         return true;
337 } /* Validate_Comman */
338
339
340 static bool
341 Validate_Args( UNUSED CONN_ID Idx, UNUSED REQUEST *Req, bool *Closed )
342 {
343         assert( Idx >= 0 );
344         assert( Req != NULL );
345         *Closed = false;
346
347         return true;
348 } /* Validate_Args */
349
350
351 /* Command is a status code ("numeric") from another server */
352 static bool
353 Handle_Numeric(CLIENT *client, REQUEST *Req)
354 {
355         static const struct _NUMERIC Numerics[] = {
356                 { 005, IRC_Num_ISUPPORT },
357                 { 376, IRC_Num_ENDOFMOTD }
358         };
359         int i, num;
360         char str[LINE_LEN];
361         CLIENT *prefix, *target = NULL;
362
363         /* Determine target */
364         if (Req->argc > 0)
365                 target = Client_Search(Req->argv[0]);
366
367         if (!target) {
368                 /* Status code without target!? */
369                 if (Req->argc > 0)
370                         Log(LOG_WARNING,
371                             "Unknown target for status code %s: \"%s\"",
372                             Req->command, Req->argv[0]);
373                 else
374                         Log(LOG_WARNING,
375                             "Unknown target for status code %s!",
376                             Req->command);
377                 return true;
378         }
379         if (target == Client_ThisServer()) {
380                 /* This server is the target of the numeric */
381                 num = atoi(Req->command);
382
383                 for (i = 0; i < (int) ARRAY_SIZE(Numerics); i++) {
384                         if (num == Numerics[i].numeric)
385                                 return Numerics[i].function(client, Req);
386                 }
387
388                 LogDebug("Ignored status code %s from \"%s\".",
389                          Req->command, Client_ID(client));
390                 return true;
391         }
392
393         /* Determine source */
394         if (! Req->prefix[0]) {
395                 /* Oops, no prefix!? */
396                 Log(LOG_WARNING, "Got status code %s from \"%s\" without prefix!?",
397                                                 Req->command, Client_ID(client));
398                 return true;
399         }
400
401         prefix = Client_Search(Req->prefix);
402         if (! prefix) { /* Oops, unknown prefix!? */
403                 Log(LOG_WARNING, "Got status code %s from unknown source: \"%s\"", Req->command, Req->prefix);
404                 return true;
405         }
406
407         /* Forward status code */
408         strlcpy(str, Req->command, sizeof(str));
409         for (i = 0; i < Req->argc; i++) {
410                 if (i < Req->argc - 1)
411                         strlcat(str, " ", sizeof(str));
412                 else
413                         strlcat(str, " :", sizeof(str));
414                 strlcat(str, Req->argv[i], sizeof(str));
415         }
416         return IRC_WriteStrClientPrefix(target, prefix, "%s", str);
417 }
418
419
420 static bool
421 Handle_Request( CONN_ID Idx, REQUEST *Req )
422 {
423         /* Client-Request verarbeiten. Bei einem schwerwiegenden Fehler
424          * wird die Verbindung geschlossen und false geliefert. */
425         CLIENT *client;
426         bool result = true;
427         int client_type;
428         COMMAND *cmd;
429
430         assert( Idx >= 0 );
431         assert( Req != NULL );
432         assert( Req->command != NULL );
433
434         client = Conn_GetClient( Idx );
435         assert( client != NULL );
436
437         /* Numeric? */
438         client_type = Client_Type(client);
439         if ((client_type == CLIENT_SERVER ||
440              client_type == CLIENT_UNKNOWNSERVER)
441             && strlen(Req->command) == 3 && atoi(Req->command) > 1)
442                 return Handle_Numeric(client, Req);
443
444         cmd = My_Commands;
445         while (cmd->name) {
446                 /* Befehl suchen */
447                 if (strcasecmp(Req->command, cmd->name) != 0) {
448                         cmd++;
449                         continue;
450                 }
451
452                 if (!(client_type & cmd->type))
453                         return IRC_WriteStrClient(client, ERR_NOTREGISTERED_MSG, Client_ID(client));
454
455                 /* Command is allowed for this client: call it and count produced bytes */
456                 Conn_ResetWCounter();
457                 result = (cmd->function)(client, Req);
458                 cmd->bytes += Conn_WCounter();
459
460                 /* Adjust counters */
461                 if (client_type != CLIENT_SERVER)
462                         cmd->lcount++;
463                 else
464                         cmd->rcount++;
465                 return result;
466         }
467
468         if (client_type != CLIENT_USER &&
469             client_type != CLIENT_SERVER &&
470             client_type != CLIENT_SERVICE )
471                 return true;
472
473         /* Unknown command and registered connection: generate error: */
474         LogDebug("Connection %d: Unknown command \"%s\", %d %s,%s prefix.",
475                         Client_Conn( client ), Req->command, Req->argc,
476                         Req->argc == 1 ? "parameter" : "parameters",
477                         Req->prefix ? "" : " no" );
478
479         if (Client_Type(client) != CLIENT_SERVER) {
480                 result = IRC_WriteStrClient(client, ERR_UNKNOWNCOMMAND_MSG,
481                                 Client_ID(client), Req->command);
482                 Conn_SetPenalty(Idx, 1);
483         }
484         return result;
485 } /* Handle_Request */
486
487
488 /* -eof- */