2 * IRC - Internet Relay Chat, ircd/m_xquery.c
3 * Copyright (C) 2010 Kevin L. Mitchell <klmitch@mit.edu>
5 * See file AUTHORS in IRC package for additional names of
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 1, or (at your option)
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 * m_functions execute protocol messages on this server:
28 * cptr is always NON-NULL, pointing to a *LOCAL* client
29 * structure (with an open socket connected!). This
30 * identifies the physical socket where the message
31 * originated (or which caused the m_function to be
32 * executed--some m_functions may call others...).
34 * sptr is the source of the message, defined by the
35 * prefix part of the message if present. If not
36 * or prefix not found, then sptr==cptr.
38 * (!IsServer(cptr)) => (cptr == sptr), because
39 * prefixes are taken *only* from servers...
42 * (sptr == cptr) => the message didn't
45 * (sptr != cptr && IsServer(sptr) means
46 * the prefix specified servername. (?)
48 * (sptr != cptr && !IsServer(sptr) means
49 * that message originated from a remote
54 * (!IsServer(sptr)) means that, sptr can safely
55 * taken as defining the target structure of the
56 * message in this server.
58 * *Always* true (if 'parse' and others are working correct):
60 * 1) sptr->from == cptr (note: cptr->from == cptr)
62 * 2) MyConnect(sptr) <=> sptr == cptr (e.g. sptr
63 * *cannot* be a local connection, unless it's
64 * actually cptr!). [MyConnect(x) should probably
65 * be defined as (x == x->from) --msa ]
67 * parc number of variable parameter strings (if zero,
68 * parv is allowed to be NULL)
70 * parv a NULL terminated list of parameter pointers,
72 * parv[0], sender (prefix string), if not present
73 * this points to an empty string.
74 * parv[1]...parv[parc-1]
75 * pointers to additional parameters
76 * parv[parc] == NULL, *always*
78 * note: it is guaranteed that parv[0]..parv[parc-1] are all
86 #include "ircd_reply.h"
87 #include "ircd_string.h"
96 * m_xquery - extension message handler
98 * parv[0] = sender prefix
99 * parv[1] = target server
100 * parv[2] = routing information
101 * parv[3] = extension message
103 int mo_xquery(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
105 struct Client* acptr;
107 if (parc < 4) /* have enough parameters? */
108 return need_more_params(sptr, "XQUERY");
110 /* Look up the target server */
111 if (!(acptr = find_match_server(parv[1])))
112 return send_reply(sptr, ERR_NOSUCHSERVER, parv[1]);
114 /* If it's to us, do nothing; otherwise, forward the query */
116 sendcmdto_one(sptr, CMD_XQUERY, acptr, "%C %s :%s", acptr, parv[2],
123 * ms_xquery - extension message handler
125 * parv[0] = sender prefix
126 * parv[1] = target server numeric
127 * parv[2] = routing information
128 * parv[3] = extension message
130 int ms_xquery(struct Client* cptr, struct Client* sptr, int parc, char* parv[])
132 struct Client* acptr;
134 if (parc < 4) /* have enough parameters? */
135 return need_more_params(sptr, "XQUERY");
137 /* Look up the target server */
138 if (!(acptr = FindNServer(parv[1])))
139 return send_reply(sptr, SND_EXPLICIT | ERR_NOSUCHSERVER,
140 "* :Server has disconnected");
142 /* Forward the query to its destination */
144 sendcmdto_one(sptr, CMD_XQUERY, acptr, "%C %s :%s", acptr, parv[2],
146 else /* if it's to us, log it */
147 log_write(LS_SYSTEM, L_NOTICE, 0, "Received extension query from "
148 "%#C to %#C routing %s; message: %s", sptr, acptr,