--- /dev/null
+/*
+ * 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.
+ */
+#if 0
+/*
+ * No need to include handlers.h here the signatures must match
+ * and we don't need to force a rebuild of all the handlers everytime
+ * we add a new one to the list. --Bleep
+ */
+#include "handlers.h"
+#endif /* 0 */
+#include "client.h"
+#include "hash.h"
+#include "ircd_reply.h"
+#include "ircd_string.h"
+#include "ircd.h"
+#include "msg.h"
+#include "numeric.h"
+#include "numnicks.h"
+#include "s_debug.h"
+#include "send.h"
+
+#include <assert.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[])
+{
+ struct Client* acptr;
+ char* destination;
+ assert(0 != cptr);
+ assert(cptr == sptr);
+
+ if (parc < 2 || EmptyString(parv[1]))
+ return send_error_to_client(sptr, ERR_NOORIGIN);
+
+ destination = parv[2]; /* Will get NULL or pointer (parc >= 2!!) */
+
+ if (!EmptyString(destination) && 0 != ircd_strcmp(destination, me.name)) {
+ if ((acptr = FindServer(destination)))
+ /*
+ * NOTE: can't send the origin string to servers, since this is a client,
+ * we could get garbage, and the link between us and the pingee wouldn't
+ * know who to send it to.
+ * sendto_one(acptr, "%s%s PING %s :%s", NumNick(sptr), parv[1], destination);
+ */
+ sendto_one(acptr, "%s%s " TOK_PING " %s :%s", NumNick(sptr), sptr->name, destination);
+ else
+ sendto_one(sptr, err_str(ERR_NOSUCHSERVER), me.name, sptr->name, 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 = cptr->name;
+
+ if (strlen(origin) > 64)
+ origin[64] = '\0';
+ sendto_one(sptr, ":%s PONG %s :%s", me.name, me.name, 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 template
+ */
+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
+ */
+#if 0
+ sendto_one(sptr, err_str(ERR_NOORIGIN), me.name, parv[0]);
+#endif
+ return 0;
+ }
+ origin = parv[1];
+ destination = parv[2]; /* Will get NULL or pointer (parc >= 2!!) */
+
+ if (!EmptyString(destination) && 0 != ircd_strcmp(destination, me.name)) {
+ if ((acptr = FindServer(destination))) {
+ /*
+ * Servers can just forward the origin
+ */
+ if (IsServer(sptr))
+ /*
+ * servers don't normally send pings to remote servers
+ */
+ sendto_one(acptr, "%s " TOK_PING " %s :%s", NumServ(sptr), origin, destination);
+ else
+ sendto_one(acptr, "%s%s " TOK_PING " %s :%s", NumNick(sptr), origin, destination);
+ }
+ else {
+ /*
+ * this can happen if server split before the ping got here
+ */
+ sendto_one(sptr, err_str(ERR_NOSUCHSERVER), me.name, sptr->name, destination);
+ }
+ }
+ else {
+ /*
+ * send pong back
+ * NOTE: sptr is never local so if pong handles numerics everywhere we
+ * could send a numeric here.
+ */
+ sendto_one(sptr, "%s " TOK_PONG " %s :%s", NumServ(&me), me.name, origin);
+ }
+ return 0;
+}
+
+
+#if 0
+/*
+ * m_ping
+ *
+ * parv[0] = sender prefix
+ * parv[1] = origin
+ * parv[2] = destination
+ */
+int m_ping(struct Client *cptr, struct Client *sptr, int parc, char *parv[])
+{
+ struct Client *acptr;
+ char *origin, *destination;
+
+ if (parc < 2 || *parv[1] == '\0')
+ {
+ sendto_one(sptr, err_str(ERR_NOORIGIN), me.name, parv[0]);
+ return 0;
+ }
+ origin = parv[1];
+ destination = parv[2]; /* Will get NULL or pointer (parc >= 2!!) */
+
+ acptr = FindClient(origin);
+ if (acptr && acptr != sptr)
+ origin = cptr->name;
+
+ if (!EmptyString(destination) && 0 != ircd_strcmp(destination, me.name) != 0)
+ {
+ if ((acptr = FindServer(destination)))
+ sendto_one(acptr, ":%s PING %s :%s", parv[0], origin, destination);
+ else
+ {
+ sendto_one(sptr, err_str(ERR_NOSUCHSERVER),
+ me.name, parv[0], destination);
+ return 0;
+ }
+ }
+ else
+ sendto_one(sptr, ":%s PONG %s :%s", me.name, me.name, origin);
+ return 0;
+}
+#endif
+