ircd/m_ping.c

   1 /*
   2  * IRC - Internet Relay Chat, ircd/m_ping.c
   3  * Copyright (C) 1990 Jarkko Oikarinen and
   4  *                    University of Oulu, Computing Center
   5  *
   6  * See file AUTHORS in IRC package for additional names of
   7  * the programmers.
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 1, or (at your option)
  12  * any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22  *
  23  * $Id$
  24  */
  25
  26 /*
  27  * Stupid ircd Tricks
  28  * Excerpt from conversation on #coder-com:
  29  *  > the number horks it
  30  *  <Gte-> yea
  31  *  > thinks it's a numeric?
  32  *  > no
  33  *  <Gte-> hm
  34  *  > why would the number hork it
  35  *  <Gte-> why is it even looking up servers in a client ping :)
  36  *  > it's a server ping
  37  *  <Gte-> true
  38  *  > oh
  39  *  > I know why :)
  40  *  >   origin = parv[1];
  41  *  >   destination = parv[2];
  42  *  >   acptr = FindClient(origin);
  43  *  >   if (acptr && acptr != sptr)
  44  *  >     origin = cptr->name;
  45  *  > heh, that's a bug :)
  46  *  <Gte-> yea, client/server handling in the same function sucks :P
  47  *  > blindly pass a bogus origin around, and where do you send the reply to?
  48  *  <Gte-> I tried /quote ping 12345 uworld.blah.net locally, and uworld
  49  *  +recieved -> ":Gte- PING N :Uworld.blah.net"
  50  *  <Gte-> oh no, sorry, I did ping N :)
  51  *  > right, it's broken
  52  *  <Gte-> good thing it doesn't have a fit replying to it
  53  *  > hmm
  54  *  *** plano.tx.us.undernet.org: PONG received from plano.tx.us.undernet.org
  55  *  > you can send a number for the first ping .. but if you ping a remote server
  56  *  +it goes to the remote end where it's received as a unsolicited pong by the
  57  *  +server closest to the target
  58  *  > hahaha
  59  *  <Gte-> cool
  60  *  <Gte-> Parsing: :Gte PING 12345 :widnes.uk.eu.blah.net
  61  *  <Gte-> Sending [:widnes.uk.eu.blah.net PONG widnes.uk.eu.blah.net
  62  *  +:12345] to alphatest.blah.net
  63  *  <Gte-> Parsing: :alphatest.blah.net 402 widnes.uk.eu.blah.net
  64  *  +12345 :No such server
  65  *  > oh even better, the pongee sends no such server :)
  66  *  > bwhahahah
  67  *  <Gte-> for a second, I thought you could trigger a loop, which would be
  68  *  +hideously nasty, but it doesn't look like
  69  *  > it goes a ------ > b ------- > c ------- > d then c <------- d then c -----
  70  *  +> d :)
  71  *  <Gte-> weeee
  72  *  <Gte-> [04:15] -> Server: ping Gte- Dallas-R.Tx.US.Undernet.org
  73  *  <Gte-> *** PONG from Dallas-R.Tx.US.Undernet.org: Gte-
  74  *  <Gte-> there we go
  75  *  <Gte-> I can get a ping reply from a server I'm not on :)
  76  */
  77 /*
  78  * m_functions execute protocol messages on this server:
  79  *
  80  *    cptr    is always NON-NULL, pointing to a *LOCAL* client
  81  *            structure (with an open socket connected!). This
  82  *            identifies the physical socket where the message
  83  *            originated (or which caused the m_function to be
  84  *            executed--some m_functions may call others...).
  85  *
  86  *    sptr    is the source of the message, defined by the
  87  *            prefix part of the message if present. If not
  88  *            or prefix not found, then sptr==cptr.
  89  *
  90  *            (!IsServer(cptr)) => (cptr == sptr), because
  91  *            prefixes are taken *only* from servers...
  92  *
  93  *            (IsServer(cptr))
  94  *                    (sptr == cptr) => the message didn't
  95  *                    have the prefix.
  96  *
  97  *                    (sptr != cptr && IsServer(sptr) means
  98  *                    the prefix specified servername. (?)
  99  *
 100  *                    (sptr != cptr && !IsServer(sptr) means
 101  *                    that message originated from a remote
 102  *                    user (not local).
 103  *
 104  *            combining
 105  *
 106  *            (!IsServer(sptr)) means that, sptr can safely
 107  *            taken as defining the target structure of the
 108  *            message in this server.
 109  *
 110  *    *Always* true (if 'parse' and others are working correct):
 111  *
 112  *    1)      sptr->from == cptr  (note: cptr->from == cptr)
 113  *
 114  *    2)      MyConnect(sptr) <=> sptr == cptr (e.g. sptr
 115  *            *cannot* be a local connection, unless it's
 116  *            actually cptr!). [MyConnect(x) should probably
 117  *            be defined as (x == x->from) --msa ]
 118  *
 119  *    parc    number of variable parameter strings (if zero,
 120  *            parv is allowed to be NULL)
 121  *
 122  *    parv    a NULL terminated list of parameter pointers,
 123  *
 124  *                    parv[0], sender (prefix string), if not present
 125  *                            this points to an empty string.
 126  *                    parv[1]...parv[parc-1]
 127  *                            pointers to additional parameters
 128  *                    parv[parc] == NULL, *always*
 129  *
 130  *            note:   it is guaranteed that parv[0]..parv[parc-1] are all
 131  *                    non-NULL pointers.
 132  */
 133 #include "config.h"
 134
 135 #include "client.h"
 136 #include "hash.h"
 137 #include "ircd_reply.h"
 138 #include "ircd_string.h"
 139 #include "ircd.h"
 140 #include "msg.h"
 141 #include "numeric.h"
 142 #include "numnicks.h"
 143 #include "s_debug.h"
 144 #include "send.h"
 145
 146 #include <assert.h>
 147 #include <string.h>
 148
 149 /*
 150  * m_ping - generic message handler
 151  *
 152  * parv[0] = sender prefix
 153  * parv[1] = origin
 154  * parv[2] = destination
 155  */
 156 int m_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
 157 {
 158   assert(0 != cptr);
 159   assert(cptr == sptr);
 160
 161   if (parc < 2 || EmptyString(parv[1]))
 162     return send_reply(sptr, ERR_NOORIGIN);
 163
 164   sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, origin);
 165   return 0;
 166 }
 167
 168 /*
 169  * mo_ping - oper message handler
 170  *
 171  * parv[0] = sender prefix
 172  * parv[1] = origin
 173  * parv[2] = destination
 174  */
 175 int mo_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
 176 {
 177   struct Client* acptr;
 178   char*          destination;
 179   assert(0 != cptr);
 180   assert(cptr == sptr);
 181
 182   if (parc < 2 || EmptyString(parv[1]))
 183     return send_reply(sptr, ERR_NOORIGIN);
 184
 185   destination = parv[2];        /* Will get NULL or pointer (parc >= 2!!) */
 186
 187   if (!EmptyString(destination) && 0 != ircd_strcmp(destination, cli_name(&me))) {
 188     if ((acptr = FindServer(destination)))
 189       sendcmdto_one(sptr, CMD_PING, acptr, "%C :%s", sptr, destination);
 190     else
 191       send_reply(sptr, ERR_NOSUCHSERVER, destination);
 192   }
 193   else {
 194     /*
 195      * NOTE: clients rely on this to return the origin string.
 196      * it's pointless to send more than 64 bytes back tho'
 197      */
 198     char* origin = parv[1];
 199
 200     /* Is this supposed to be here? */
 201     acptr = FindClient(origin);
 202     if (acptr && acptr != sptr)
 203       origin = cli_name(cptr);
 204
 205     if (strlen(origin) > 64)
 206       origin[64] = '\0';
 207     sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, origin);
 208   }
 209   return 0;
 210 }
 211
 212 /*
 213  * Extension notes
 214  *
 215  * <Vek> bleep:  here's the change you make to PING:
 216  * <Vek> F TOK_PING F G 7777777777.7777777
 217  * <Vek> then optional parameter for further enhancement
 218  * <Vek> G TOK_PONG G F 7777777777.7777777 0.1734637
 219  */
 220
 221 /*
 222  * ms_ping - server message handler template
 223  */
 224 int ms_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
 225 {
 226   struct Client* acptr;
 227   char*          origin;
 228   char*          destination;
 229
 230   assert(0 != cptr);
 231   assert(0 != sptr);
 232   assert(IsServer(cptr));
 233
 234   if (parc < 2 || EmptyString(parv[1])) {
 235     /*
 236      * don't bother sending the error back
 237      */
 238     return 0;
 239   }
 240   origin      = parv[1];
 241   destination = parv[2];        /* Will get NULL or pointer (parc >= 2!!) */
 242
 243   if (!EmptyString(destination) && 0 != ircd_strcmp(destination, cli_name(&me))) {
 244     if ((acptr = FindServer(destination))) {
 245       /*
 246        * Servers can just forward the origin
 247        */
 248       sendcmdto_one(sptr, CMD_PING, acptr, "%s :%s", origin, destination);
 249     }
 250     else {
 251       /*
 252        * this can happen if server split before the ping got here
 253        */
 254       send_reply(sptr, ERR_NOSUCHSERVER, destination);
 255     }
 256   }
 257   else {
 258     /*
 259      * send pong back
 260      * NOTE:  sptr is never local so if pong handles numerics everywhere we
 261      * could send a numeric here.
 262      */
 263     sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, origin);
 264   }
 265   return 0;
 266 }