trunk/modules/m_admin.c

/*
 *  ircd-hybrid: an advanced Internet Relay Chat Daemon(ircd).
 *
 *  Copyright (C) 2002 by the past and present ircd coders, and others.
 *
 *  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 2 of the License, 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 *  USA
 */

/*! \file m_admin.c
 * \brief Includes required functions for processing the ADMIN command.
 * \version $Id$
 */

#include "stdinc.h"
#include "handlers.h"
#include "client.h"
#include "ircd.h"
#include "numeric.h"
#include "s_conf.h"
#include "s_serv.h"
#include "send.h"
#include "msg.h"
#include "parse.h"
#include "modules.h"
#include "irc_string.h"


/*! \brief Sends administrative information about this server.
 *
 * \param source_p Pointer to client to report to
 */
static void
do_admin(struct Client *source_p)
{
  const char *me_name;
  const char *nick;

  sendto_realops_flags(UMODE_SPY, L_ALL,
                       "ADMIN requested by %s (%s@%s) [%s]",
                       source_p->name, source_p->username,
                       source_p->host, source_p->servptr->name);

  me_name = ID_or_name(&me, source_p->from);
  nick = ID_or_name(source_p, source_p->from);

  sendto_one(source_p, form_str(RPL_ADMINME),
             me_name, nick, me.name);
  if (AdminInfo.name != NULL)
    sendto_one(source_p, form_str(RPL_ADMINLOC1),
               me_name, nick, AdminInfo.name);
  if (AdminInfo.description != NULL)
    sendto_one(source_p, form_str(RPL_ADMINLOC2),
               me_name, nick, AdminInfo.description);
  if (AdminInfo.email != NULL)
    sendto_one(source_p, form_str(RPL_ADMINEMAIL),
               me_name, nick, AdminInfo.email);
}

/*! \brief ADMIN command handler (called by unregistered,
 *         locally connected clients)
 *
 * \param client_p Pointer to allocated Client struct with physical connection
 *                 to this server, i.e. with an open socket connected.
 * \param source_p Pointer to allocated Client struct from which the message
 *                 originally comes from.  This can be a local or remote client.
 * \param parc     Integer holding the number of supplied arguments.
 * \param parv     Argument vector where parv[0] .. parv[parc-1] are non-NULL
 *                 pointers.
 * \note Valid arguments for this command are:
 *      - parv[0] = sender prefix
 */
static void
mr_admin(struct Client *client_p, struct Client *source_p,
         int parc, char *parv[])
{
  static time_t last_used = 0;

  ClearCap(client_p, CAP_TS6);

  if ((last_used + ConfigFileEntry.pace_wait_simple) > CurrentTime)
  {
    sendto_one(source_p, form_str(RPL_LOAD2HI),
               me.name, EmptyString(parv[0]) ? "*" : parv[0]);
    return;
  }

  last_used = CurrentTime;

  do_admin(source_p);
}

/*! \brief NICK command handler (called by already registered,
 *         locally connected clients)
 *
 * \param client_p Pointer to allocated Client struct with physical connection
 *                 to this server, i.e. with an open socket connected.
 * \param source_p Pointer to allocated Client struct from which the message
 *                 originally comes from.  This can be a local or remote client.
 * \param parc     Integer holding the number of supplied arguments.
 * \param parv     Argument vector where parv[0] .. parv[parc-1] are non-NULL
 *                 pointers.
 * \note Valid arguments for this command are:
 *      - parv[0] = sender prefix
 *      - parv[1] = nickname/servername
 */
static void
m_admin(struct Client *client_p, struct Client *source_p,
        int parc, char *parv[])
{
  static time_t last_used = 0;

  if ((last_used + ConfigFileEntry.pace_wait_simple) > CurrentTime)
  {
    sendto_one(source_p,form_str(RPL_LOAD2HI),
               me.name, source_p->name);
    return;
  }

  last_used = CurrentTime;

  if (!ConfigFileEntry.disable_remote)
    if (hunt_server(client_p, source_p, ":%s ADMIN :%s", 1,
                    parc, parv) != HUNTED_ISME)
      return;

  do_admin(source_p);
}

/*! \brief ADMIN command handler (called by operators and
 *         remotely connected clients)
 *
 * \param client_p Pointer to allocated Client struct with physical connection
 *                 to this server, i.e. with an open socket connected.
 * \param source_p Pointer to allocated Client struct from which the message
 *                 originally comes from.  This can be a local or remote client.
 * \param parc     Integer holding the number of supplied arguments.
 * \param parv     Argument vector where parv[0] .. parv[parc-1] are non-NULL
 *                 pointers.
 * \note Valid arguments for this command are:
 *      - parv[0] = sender prefix
 *      - parv[1] = nickname/servername
 */
static void
ms_admin(struct Client *client_p, struct Client *source_p,
         int parc, char *parv[])
{
  if (hunt_server(client_p, source_p, ":%s ADMIN :%s", 1,
                  parc, parv) != HUNTED_ISME)
    return;

  if (IsClient(source_p))
    do_admin(source_p);
}

static struct Message admin_msgtab = {
  "ADMIN", 0, 0, 0, MAXPARA, MFLG_SLOW | MFLG_UNREG, 0,
  {mr_admin, m_admin, ms_admin, m_ignore, ms_admin, m_ignore}
};

static void
module_init(void)
{
  mod_add_cmd(&admin_msgtab);
}

static void
module_exit(void)
{
  mod_del_cmd(&admin_msgtab);
}

struct module module_entry = {
  .node    = { NULL, NULL, NULL },
  .name    = NULL,
  .version = "$Revision$",
  .handle  = NULL,
  .modinit = module_init,
  .modexit = module_exit,
  .flags   = 0
};
Revision:	1230
Committed:	Thu Sep 22 19:41:19 2011 UTC (13 years, 11 months ago) by michael
Content type:	text/x-csrc
Original Path:	*ircd-hybrid-8/modules/m_admin.c*
File size:	6059 byte(s)
Log Message:	- cleanup module loader. Make module api more flexible
#	Content
1	/*
2	* ircd-hybrid: an advanced Internet Relay Chat Daemon(ircd).
3	*
4	* Copyright (C) 2002 by the past and present ircd coders, and others.
5	*
6	* This program is free software; you can redistribute it and/or modify
7	* it under the terms of the GNU General Public License as published by
8	* the Free Software Foundation; either version 2 of the License, or
9	* (at your option) any later version.
10	*
11	* This program is distributed in the hope that it will be useful,
12	* but WITHOUT ANY WARRANTY; without even the implied warranty of
13	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	* GNU General Public License for more details.
15	*
16	* You should have received a copy of the GNU General Public License
17	* along with this program; if not, write to the Free Software
18	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19	* USA
20	*/
21
22	/*! \file m_admin.c
23	* \brief Includes required functions for processing the ADMIN command.
24	* \version $Id$
25	*/
26
27	#include "stdinc.h"
28	#include "handlers.h"
29	#include "client.h"
30	#include "ircd.h"
31	#include "numeric.h"
32	#include "s_conf.h"
33	#include "s_serv.h"
34	#include "send.h"
35	#include "msg.h"
36	#include "parse.h"
37	#include "modules.h"
38	#include "irc_string.h"
39
40
41
42	/*! \brief Sends administrative information about this server.
43	*
44	* \param source_p Pointer to client to report to
45	*/
46	static void
47	do_admin(struct Client *source_p)
48	{
49	const char *me_name;
50	const char *nick;
51
52	sendto_realops_flags(UMODE_SPY, L_ALL,
53	"ADMIN requested by %s (%s@%s) [%s]",
54	source_p->name, source_p->username,
55	source_p->host, source_p->servptr->name);
56
57	me_name = ID_or_name(&me, source_p->from);
58	nick = ID_or_name(source_p, source_p->from);
59
60	sendto_one(source_p, form_str(RPL_ADMINME),
61	me_name, nick, me.name);
62	if (AdminInfo.name != NULL)
63	sendto_one(source_p, form_str(RPL_ADMINLOC1),
64	me_name, nick, AdminInfo.name);
65	if (AdminInfo.description != NULL)
66	sendto_one(source_p, form_str(RPL_ADMINLOC2),
67	me_name, nick, AdminInfo.description);
68	if (AdminInfo.email != NULL)
69	sendto_one(source_p, form_str(RPL_ADMINEMAIL),
70	me_name, nick, AdminInfo.email);
71	}
72
73	/*! \brief ADMIN command handler (called by unregistered,
74	* locally connected clients)
75	*
76	* \param client_p Pointer to allocated Client struct with physical connection
77	* to this server, i.e. with an open socket connected.
78	* \param source_p Pointer to allocated Client struct from which the message
79	* originally comes from. This can be a local or remote client.
80	* \param parc Integer holding the number of supplied arguments.
81	* \param parv Argument vector where parv[0] .. parv[parc-1] are non-NULL
82	* pointers.
83	* \note Valid arguments for this command are:
84	* - parv[0] = sender prefix
85	*/
86	static void
87	mr_admin(struct Client client_p, struct Client source_p,
88	int parc, char *parv[])
89	{
90	static time_t last_used = 0;
91
92	ClearCap(client_p, CAP_TS6);
93
94	if ((last_used + ConfigFileEntry.pace_wait_simple) > CurrentTime)
95	{
96	sendto_one(source_p, form_str(RPL_LOAD2HI),
97	me.name, EmptyString(parv[0]) ? "*" : parv[0]);
98	return;
99	}
100
101	last_used = CurrentTime;
102
103	do_admin(source_p);
104	}
105
106	/*! \brief NICK command handler (called by already registered,
107	* locally connected clients)
108	*
109	* \param client_p Pointer to allocated Client struct with physical connection
110	* to this server, i.e. with an open socket connected.
111	* \param source_p Pointer to allocated Client struct from which the message
112	* originally comes from. This can be a local or remote client.
113	* \param parc Integer holding the number of supplied arguments.
114	* \param parv Argument vector where parv[0] .. parv[parc-1] are non-NULL
115	* pointers.
116	* \note Valid arguments for this command are:
117	* - parv[0] = sender prefix
118	* - parv[1] = nickname/servername
119	*/
120	static void
121	m_admin(struct Client client_p, struct Client source_p,
122	int parc, char *parv[])
123	{
124	static time_t last_used = 0;
125
126	if ((last_used + ConfigFileEntry.pace_wait_simple) > CurrentTime)
127	{
128	sendto_one(source_p,form_str(RPL_LOAD2HI),
129	me.name, source_p->name);
130	return;
131	}
132
133	last_used = CurrentTime;
134
135	if (!ConfigFileEntry.disable_remote)
136	if (hunt_server(client_p, source_p, ":%s ADMIN :%s", 1,
137	parc, parv) != HUNTED_ISME)
138	return;
139
140	do_admin(source_p);
141	}
142
143	/*! \brief ADMIN command handler (called by operators and
144	* remotely connected clients)
145	*
146	* \param client_p Pointer to allocated Client struct with physical connection
147	* to this server, i.e. with an open socket connected.
148	* \param source_p Pointer to allocated Client struct from which the message
149	* originally comes from. This can be a local or remote client.
150	* \param parc Integer holding the number of supplied arguments.
151	* \param parv Argument vector where parv[0] .. parv[parc-1] are non-NULL
152	* pointers.
153	* \note Valid arguments for this command are:
154	* - parv[0] = sender prefix
155	* - parv[1] = nickname/servername
156	*/
157	static void
158	ms_admin(struct Client client_p, struct Client source_p,
159	int parc, char *parv[])
160	{
161	if (hunt_server(client_p, source_p, ":%s ADMIN :%s", 1,
162	parc, parv) != HUNTED_ISME)
163	return;
164
165	if (IsClient(source_p))
166	do_admin(source_p);
167	}
168
169	static struct Message admin_msgtab = {
170	"ADMIN", 0, 0, 0, MAXPARA, MFLG_SLOW \| MFLG_UNREG, 0,
171	{mr_admin, m_admin, ms_admin, m_ignore, ms_admin, m_ignore}
172	};
173
174	static void
175	module_init(void)
176	{
177	mod_add_cmd(&admin_msgtab);
178	}
179
180	static void
181	module_exit(void)
182	{
183	mod_del_cmd(&admin_msgtab);
184	}
185
186	struct module module_entry = {
187	.node = { NULL, NULL, NULL },
188	.name = NULL,
189	.version = "$Revision$",
190	.handle = NULL,
191	.modinit = module_init,
192	.modexit = module_exit,
193	.flags = 0
194	};