src/ngircd/irc-macros.h

   1 /*
   2  * ngIRCd -- The Next Generation IRC Daemon
   3  * Copyright (c)2001-2013 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 #ifndef __irc_macros_h__
  13 #define __irc_macros_h__
  14
  15 /**
  16  * @file
  17  * Macros for functions that handle IRC commands.
  18  */
  19
  20 /**
  21  * Make sure that number of passed parameters is less or equal than Max.
  22  *
  23  * If there are more than Max parameters, send an error to the client and
  24  * return from the function.
  25  */
  26 #define _IRC_ARGC_LE_OR_RETURN_(Client, Req, Max) \
  27 if (Req->argc > Max) \
  28         return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG, \
  29                                   Client_ID(Client), Req->command);
  30
  31 /**
  32  * Make sure that number of passed parameters is greater or equal than Min.
  33  *
  34  * If there aren't at least Min parameters, send an error to the client and
  35  * return from the function.
  36  */
  37 #define _IRC_ARGC_GE_OR_RETURN_(Client, Req, Min) \
  38 if (Req->argc < Min) \
  39         return IRC_WriteStrClient(Client, ERR_NEEDMOREPARAMS_MSG, \
  40                                   Client_ID(Client), Req->command);
  41
  42 /**
  43  * Get sender of an IRC command.
  44  *
  45  * The sender is either stored in the prefix if the command has been
  46  * received from a server or set to the client. If the sender is invalid,
  47  * send an error to the client and return from the function.
  48  */
  49 #define _IRC_GET_SENDER_OR_RETURN_(Sender, Req, Client) \
  50         if (Client_Type(Client) == CLIENT_SERVER) \
  51                 Sender = Client_Search(Req->prefix); \
  52         else \
  53                 Sender = Client; \
  54         if (!Sender) \
  55                 return IRC_WriteStrClient(Client, ERR_NOSUCHNICK_MSG, \
  56                                           Client_ID(Client), Req->prefix);
  57
  58 /**
  59  * Get target of an IRC command and make sure that it is a server.
  60  *
  61  * Set the target to the local server if no target parameter is given in the
  62  * received command, and send an error to the client and return from the
  63  * function if the given target isn't resolvable to a server: the target
  64  * parameter can be a server name, a nick name (then the target is set to
  65  * the server to which this nick is connected), or a mask matching at least
  66  * one server name in the network.
  67  */
  68 #define _IRC_GET_TARGET_SERVER_OR_RETURN_(Target, Req, Argc, From) \
  69         if (Req->argc > Argc) { \
  70                 Target = Client_Search(Req->argv[Argc]); \
  71                 if (!Target) \
  72                         Target = Client_SearchServer(Req->argv[Argc]); \
  73                 if (!Target) \
  74                         return IRC_WriteStrClient(From, ERR_NOSUCHSERVER_MSG, \
  75                                           Client_ID(From), Req->argv[Argc]); \
  76                 if (Client_Type(Target) != CLIENT_SERVER) \
  77                         Target = Client_Introducer(Target); \
  78         } else \
  79                 Target = Client_ThisServer();
  80
  81 #endif  /* __irc_macros_h__ */
  82
  83 /* -eof- */