Doxyfy s_numeric.c.
[ircu2.10.12-pk.git] / ircd / s_numeric.c
1 /*
2  * IRC - Internet Relay Chat, ircd/s_numeric.c
3  * Copyright (C) 1990 Jarkko Oikarinen
4  *
5  * Numerous fixes by Markku Savela
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 1, or (at your option)
10  * any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20  *
21  * $Id$
22  */
23 #include "config.h"
24
25 #include "s_numeric.h"
26 #include "channel.h"
27 #include "client.h"
28 #include "hash.h"
29 #include "ircd.h"
30 #include "ircd_features.h"
31 #include "ircd_snprintf.h"
32 #include "numnicks.h"
33 #include "send.h"
34 #include "struct.h"
35
36
37 /*
38  * do_numeric()
39  * Rewritten by Nemesi, Jan 1999, to support numeric nicks in parv[1]
40  *
41  * Called when we get a numeric message from a remote _server_ and we are
42  * supposed to forward it somewhere. Note that we always ignore numerics sent
43  * to 'me' and simply drop the message if we can't handle with this properly:
44  * the savy approach is NEVER generate an error in response to an... error :)
45  */
46
47 /** Forwards a numeric message from a remote server.
48  * @param numeric Value of numeric message.
49  * @param nnn If non-zero, treat parv[1] as a numnick; else as a client name.
50  * @param cptr Client that originated the numeric.
51  * @param sptr Peer that sent us the numeric.
52  * @param parc Count of valid arguments in \a parv.
53  * @param parv Argument list.
54  * @return Zero (always).
55  */
56 int do_numeric(int numeric, int nnn, struct Client *cptr, struct Client *sptr,
57     int parc, char *parv[])
58 {
59   struct Client *acptr = 0;
60   struct Channel *achptr = 0;
61   char num[4];
62
63   /* Avoid trash, we need it to come from a server and have a target  */
64   if ((parc < 2) || !IsServer(sptr))
65     return 0;
66
67   /* Who should receive this message ? Will we do something with it ?
68      Note that we use findUser functions, so the target can't be neither
69      a server, nor a channel (?) nor a list of targets (?) .. u2.10
70      should never generate numeric replies to non-users anyway
71      Ahem... it can be a channel actually, csc bots use it :\ --Nem */
72
73   if (IsChannelName(parv[1]))
74     achptr = FindChannel(parv[1]);
75   else
76     acptr = (nnn) ? (findNUser(parv[1])) : (FindUser(parv[1]));
77
78   if (((!acptr) || (cli_from(acptr) == cptr)) && !achptr)
79     return 0;
80
81   /* Remap low number numerics, not that I understand WHY.. --Nemesi  */
82   /* numerics below 100 talk about the current 'connection', you're not
83    * connected to a remote server so it doesn't make sense to send them
84    * remotely - but the information they contain may be useful, so we
85    * remap them up.  Weird, but true.  -- Isomer */
86   if (numeric < 100)
87     numeric += 100;
88
89   ircd_snprintf(0, num, sizeof(num), "%03d", numeric);
90
91   /* Since 2.10.10.pl14 we rewrite numerics from remote servers to appear to
92    * come from the local server
93    */
94   if (acptr)
95     sendcmdto_one((feature_bool(FEAT_HIS_REWRITE) && !IsOper(acptr)) ?
96                     &me : sptr,
97                   num, num, acptr, "%C %s", acptr, parv[2]);
98   else
99     sendcmdto_channel_butone((feature_bool(FEAT_HIS_REWRITE) && !IsOper(acptr)) ?
100                                &me : sptr,
101                              num, num, achptr, cptr, SKIP_DEAF | SKIP_BURST,
102                              "%H %s", achptr, parv[2]);
103   return 0;
104 }