2 * IRC - Internet Relay Chat, ircd/m_proto.c
3 * Copyright (C) 1990 Jarkko Oikarinen and
4 * University of Oulu, Computing Center
6 * See file AUTHORS in IRC package for additional names of
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)
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.
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.
24 * @brief Implementation of functions to send common replies to users.
29 #include "ircd_reply.h"
33 #include "ircd_snprintf.h"
41 /* #include <assert.h> -- Now using assert in ircd_log.h */
44 /** Report a protocol violation warning to anyone listening. This can
45 * be easily used to clean up the last couple of parts of the code.
46 * @param[in] cptr Client that violated the protocol.
47 * @param[in] pattern Description of how the protocol was violated.
50 int protocol_violation(struct Client* cptr, const char* pattern, ...)
53 char message[BUFSIZE];
58 vd.vd_format = pattern;
59 va_start(vd.vd_args, pattern);
60 ircd_snprintf(NULL, message, sizeof(message),
61 "Protocol Violation from %s: %v", cli_name(cptr), &vd);
64 sendwallto_group_butone(&me, WALL_DESYNCH, NULL, "%s", message);
68 /** Inform a client that they need to provide more parameters.
69 * @param[in] cptr Taciturn client.
70 * @param[in] cmd Command name.
73 int need_more_params(struct Client* cptr, const char* cmd)
75 send_reply(cptr, ERR_NEEDMOREPARAMS, cmd);
79 /** Send a generic reply to a user.
80 * @param[in] to Client that wants a reply.
81 * @param[in] reply Numeric of message to send.
84 int send_reply(struct Client *to, int reply, ...)
88 const struct Numeric *num;
93 num = get_error_numeric(reply & ~SND_EXPLICIT); /* get reply... */
95 va_start(vd.vd_args, reply);
97 if (reply & SND_EXPLICIT) /* get right pattern */
98 vd.vd_format = (const char *) va_arg(vd.vd_args, char *);
100 vd.vd_format = num->format;
102 assert(0 != vd.vd_format);
105 mb = msgq_make(cli_from(to), "%:#C %s %C %v", &me, num->str, to, &vd);
109 /* send it to the user */
110 send_buffer(to, mb, 0);
114 return 0; /* convenience return */