+/*
+ * IRC - Internet Relay Chat, ircd/m_ping.c
+ * Copyright (C) 1990 Jarkko Oikarinen and
+ * University of Oulu, Computing Center
+ *
+ * See file AUTHORS in IRC package for additional names of
+ * the programmers.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 1, or (at your option)
+ * any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ *
+ * $Id$
+ */
+
+/*
+ * Stupid ircd Tricks
+ * Excerpt from conversation on #coder-com:
+ * > the number horks it
+ * <Gte-> yea
+ * > thinks it's a numeric?
+ * > no
+ * <Gte-> hm
+ * > why would the number hork it
+ * <Gte-> why is it even looking up servers in a client ping :)
+ * > it's a server ping
+ * <Gte-> true
+ * > oh
+ * > I know why :)
+ * > origin = parv[1];
+ * > destination = parv[2];
+ * > acptr = FindClient(origin);
+ * > if (acptr && acptr != sptr)
+ * > origin = cptr->name;
+ * > heh, that's a bug :)
+ * <Gte-> yea, client/server handling in the same function sucks :P
+ * > blindly pass a bogus origin around, and where do you send the reply to?
+ * <Gte-> I tried /quote ping 12345 uworld.blah.net locally, and uworld
+ * +recieved -> ":Gte- PING N :Uworld.blah.net"
+ * <Gte-> oh no, sorry, I did ping N :)
+ * > right, it's broken
+ * <Gte-> good thing it doesn't have a fit replying to it
+ * > hmm
+ * *** plano.tx.us.undernet.org: PONG received from plano.tx.us.undernet.org
+ * > you can send a number for the first ping .. but if you ping a remote server
+ * +it goes to the remote end where it's received as a unsolicited pong by the
+ * +server closest to the target
+ * > hahaha
+ * <Gte-> cool
+ * <Gte-> Parsing: :Gte PING 12345 :widnes.uk.eu.blah.net
+ * <Gte-> Sending [:widnes.uk.eu.blah.net PONG widnes.uk.eu.blah.net
+ * +:12345] to alphatest.blah.net
+ * <Gte-> Parsing: :alphatest.blah.net 402 widnes.uk.eu.blah.net
+ * +12345 :No such server
+ * > oh even better, the pongee sends no such server :)
+ * > bwhahahah
+ * <Gte-> for a second, I thought you could trigger a loop, which would be
+ * +hideously nasty, but it doesn't look like
+ * > it goes a ------ > b ------- > c ------- > d then c <------- d then c -----
+ * +> d :)
+ * <Gte-> weeee
+ * <Gte-> [04:15] -> Server: ping Gte- Dallas-R.Tx.US.Undernet.org
+ * <Gte-> *** PONG from Dallas-R.Tx.US.Undernet.org: Gte-
+ * <Gte-> there we go
+ * <Gte-> I can get a ping reply from a server I'm not on :)
+ */
+/*
+ * m_functions execute protocol messages on this server:
+ *
+ * cptr is always NON-NULL, pointing to a *LOCAL* client
+ * structure (with an open socket connected!). This
+ * identifies the physical socket where the message
+ * originated (or which caused the m_function to be
+ * executed--some m_functions may call others...).
+ *
+ * sptr is the source of the message, defined by the
+ * prefix part of the message if present. If not
+ * or prefix not found, then sptr==cptr.
+ *
+ * (!IsServer(cptr)) => (cptr == sptr), because
+ * prefixes are taken *only* from servers...
+ *
+ * (IsServer(cptr))
+ * (sptr == cptr) => the message didn't
+ * have the prefix.
+ *
+ * (sptr != cptr && IsServer(sptr) means
+ * the prefix specified servername. (?)
+ *
+ * (sptr != cptr && !IsServer(sptr) means
+ * that message originated from a remote
+ * user (not local).
+ *
+ * combining
+ *
+ * (!IsServer(sptr)) means that, sptr can safely
+ * taken as defining the target structure of the
+ * message in this server.
+ *
+ * *Always* true (if 'parse' and others are working correct):
+ *
+ * 1) sptr->from == cptr (note: cptr->from == cptr)
+ *
+ * 2) MyConnect(sptr) <=> sptr == cptr (e.g. sptr
+ * *cannot* be a local connection, unless it's
+ * actually cptr!). [MyConnect(x) should probably
+ * be defined as (x == x->from) --msa ]
+ *
+ * parc number of variable parameter strings (if zero,
+ * parv is allowed to be NULL)
+ *
+ * parv a NULL terminated list of parameter pointers,
+ *
+ * parv[0], sender (prefix string), if not present
+ * this points to an empty string.
+ * parv[1]...parv[parc-1]
+ * pointers to additional parameters
+ * parv[parc] == NULL, *always*
+ *
+ * note: it is guaranteed that parv[0]..parv[parc-1] are all
+ * non-NULL pointers.
+ */
+#include "config.h"
+
+#include "client.h"
+#include "hash.h"
+#include "ircd_log.h"
+#include "ircd_reply.h"
+#include "ircd_string.h"
+#include "ircd.h"
+#include "msg.h"
+#include "numeric.h"
+#include "numnicks.h"
+#include "opercmds.h"
+#include "s_debug.h"
+#include "send.h"
+
+/* #include <assert.h> -- Now using assert in ircd_log.h */
+#include <stdlib.h>
+#include <string.h>
+
+/*
+ * m_ping - generic message handler
+ *
+ * parv[0] = sender prefix
+ * parv[1] = origin
+ * parv[2] = destination
+ */
+int m_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
+{
+ assert(0 != cptr);
+ assert(cptr == sptr);
+
+ if (parc < 2 || EmptyString(parv[1]))
+ return send_reply(sptr, ERR_NOORIGIN);
+
+ sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, parv[1]);
+ return 0;
+}
+
+/*
+ * mo_ping - oper message handler
+ *
+ * parv[0] = sender prefix
+ * parv[1] = origin
+ * parv[2] = destination
+ */
+int mo_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
+{
+ struct Client* acptr;
+ char *destination;
+ assert(0 != cptr);
+ assert(cptr == sptr);
+
+ if (parc < 2 || EmptyString(parv[1]))
+ return send_reply(sptr, ERR_NOORIGIN);
+
+ destination = parv[2]; /* Will get NULL or pointer (parc >= 2!!) */
+
+ if (!EmptyString(destination) && 0 != ircd_strcmp(destination, cli_name(&me))) {
+ if ((acptr = FindServer(destination)))
+ sendcmdto_one(sptr, CMD_PING, acptr, "%C :%s", sptr, destination);
+ else
+ send_reply(sptr, ERR_NOSUCHSERVER, destination);
+ }
+ else {
+ /*
+ * NOTE: clients rely on this to return the origin string.
+ * it's pointless to send more than 64 bytes back tho'
+ */
+ char* origin = parv[1];
+
+ /* Is this supposed to be here? */
+ acptr = FindClient(origin);
+ if (acptr && acptr != sptr)
+ origin = cli_name(cptr);
+
+ if (strlen(origin) > 64)
+ origin[64] = '\0';
+ sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, origin);
+ }
+ return 0;
+}
+
+/*
+ * Extension notes
+ *
+ * <Vek> bleep: here's the change you make to PING:
+ * <Vek> F TOK_PING F G 7777777777.7777777
+ * <Vek> then optional parameter for further enhancement
+ * <Vek> G TOK_PONG G F 7777777777.7777777 0.1734637
+ */
+
+/*
+ * ms_ping - server message handler
+ */
+int ms_ping(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
+{
+ struct Client* acptr;
+ char* origin;
+ char* destination;
+
+ assert(0 != cptr);
+ assert(0 != sptr);
+ assert(IsServer(cptr));
+
+ if (parc < 2 || EmptyString(parv[1])) {
+ /*
+ * don't bother sending the error back
+ */
+ return 0;
+ }
+ origin = parv[1];
+ destination = parv[2]; /* Will get NULL or pointer (parc >= 2!!) */
+
+ if (parc > 3)
+ {
+ /* AsLL ping, send reply back */
+ int diff = atoi(militime_float(parv[3]));
+ sendcmdto_one(&me, CMD_PONG, sptr, "%C %s %s %i %s", &me, origin,
+ parv[3], diff, militime_float(NULL));
+ return 0;
+ }
+ if (!EmptyString(destination) && 0 != ircd_strcmp(destination, cli_name(&me))) {
+ if ((acptr = FindServer(destination))) {
+ /*
+ * Servers can just forward the origin
+ */
+ sendcmdto_one(sptr, CMD_PING, acptr, "%s :%s", origin, destination);
+ }
+ else {
+ /*
+ * this can happen if server split before the ping got here
+ */
+ send_reply(sptr, ERR_NOSUCHSERVER, destination);
+ }
+ }
+ else {
+ /*
+ * send pong back
+ * NOTE: sptr is never local so if pong handles numerics everywhere we
+ * could send a numeric here.
+ */
+ sendcmdto_one(&me, CMD_PONG, sptr, "%C :%s", &me, origin);
+ }
+ return 0;
+}