Make realname Kill blocks more predictable, and add username="x" field.
[ircu2.10.12-pk.git] / ircd / s_stats.c
1 /*
2  * IRC - Internet Relay Chat, ircd/s_stats.c
3  * Copyright (C) 2000 Joseph Bongaarts
4  *
5  * See file AUTHORS in IRC package for additional names of
6  * the programmers.
7  *
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)
11  * any later version.
12  *
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.
17  *
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.
21  */
22 #include "config.h"
23
24 #include "class.h"
25 #include "client.h"
26 #include "gline.h"
27 #include "hash.h"
28 #include "ircd.h"
29 #include "ircd_chattr.h"
30 #include "ircd_events.h"
31 #include "ircd_features.h"
32 #include "ircd_crypt.h"
33 #include "ircd_log.h"
34 #include "ircd_reply.h"
35 #include "ircd_string.h"
36 #include "listener.h"
37 #include "list.h"
38 #include "match.h"
39 #include "motd.h"
40 #include "msg.h"
41 #include "msgq.h"
42 #include "numeric.h"
43 #include "numnicks.h"
44 #include "querycmds.h"
45 #include "res.h"
46 #include "s_bsd.h"
47 #include "s_conf.h"
48 #include "s_debug.h"
49 #include "s_misc.h"
50 #include "s_serv.h"
51 #include "s_stats.h"
52 #include "s_user.h"
53 #include "send.h"
54 #include "struct.h"
55 #include "userload.h"
56
57 #include <stdio.h>
58 #include <stdlib.h>
59 #include <string.h>
60 #include <sys/time.h>
61
62 /** @file
63  * @brief Report configuration lines and other statistics from this
64  * server.
65  * @version $Id$
66  *
67  * Note: The info is reported in the order the server uses
68  *       it--not reversed as in ircd.conf!
69  */
70
71 /* The statsinfo array should only be used in this file, but just TRY
72  * telling the compiler that you want to forward declare a static
73  * array without specifying a length, and see how it responds.  So we
74  * forward declare it "extern".
75  */
76 extern struct StatDesc statsinfo[];
77
78 /** Report items from #GlobalConfList.
79  * Uses sd->sd_funcdata as a filter for ConfItem::status.
80  * @param[in] sptr Client requesting statistics.
81  * @param[in] sd Stats descriptor for request.
82  * @param[in] param Extra parameter from user (ignored).
83  */
84 static void
85 stats_configured_links(struct Client *sptr, const struct StatDesc* sd,
86                        char* param)
87 {
88   static char null[] = "<NULL>";
89   struct ConfItem *tmp;
90   unsigned short int port;
91   int maximum;
92   char *host, *pass, *name, *username, *hub_limit;
93
94   for (tmp = GlobalConfList; tmp; tmp = tmp->next)
95   {
96     if ((tmp->status & sd->sd_funcdata))
97     {
98       host = BadPtr(tmp->host) ? null : tmp->host;
99       pass = BadPtr(tmp->passwd) ? null : tmp->passwd;
100       name = BadPtr(tmp->name) ? null : tmp->name;
101       username = BadPtr(tmp->username) ? null : tmp->username;
102       hub_limit = BadPtr(tmp->hub_limit) ? null : tmp->hub_limit;
103       maximum = tmp->maximum;
104       port = tmp->address.port;
105
106       if (tmp->status & CONF_UWORLD)
107         send_reply(sptr, RPL_STATSULINE, host);
108       else if (tmp->status & CONF_SERVER)
109         send_reply(sptr, RPL_STATSCLINE, name, "", "*", port, maximum, hub_limit, get_conf_class(tmp));
110       else if (tmp->status & CONF_CLIENT)
111         send_reply(sptr, RPL_STATSILINE,
112                    (tmp->host ? tmp->host : "*"), maximum,
113                    (name[0] == ':' ? "0" : ""), (tmp->name ? tmp->name : "*"),
114                    port, get_conf_class(tmp));
115       else if (tmp->status & CONF_OPERATOR)
116         send_reply(sptr, RPL_STATSOLINE, username, host, name, get_conf_class(tmp));
117     }
118   }
119 }
120
121 /** Report connection rules from conf_get_crule_list().
122  * Uses sd->sd_funcdata as a filter for CRuleConf::type.
123  * @param[in] to Client requesting statistics.
124  * @param[in] sd Stats descriptor for request.
125  * @param[in] param Extra parameter from user (ignored).
126  */
127 static void
128 stats_crule_list(struct Client* to, const struct StatDesc *sd,
129                  char *param)
130 {
131   const struct CRuleConf* p = conf_get_crule_list();
132
133   for ( ; p; p = p->next)
134   {
135     if (p->type & sd->sd_funcdata)
136       send_reply(to, RPL_STATSDLINE, sd->sd_c, p->hostmask, p->rule);
137   }
138 }
139
140 /** Report active event engine name.
141  * @param[in] to Client requesting statistics.
142  * @param[in] sd Stats descriptor for request (ignored).
143  * @param[in] param Extra parameter from user (ignored).
144  */
145 static void
146 stats_engine(struct Client *to, const struct StatDesc *sd, char *param)
147 {
148   send_reply(to, RPL_STATSENGINE, engine_name());
149 }
150
151 /** Report client access lists.
152  * @param[in] to Client requesting statistics.
153  * @param[in] sd Stats descriptor for request.
154  * @param[in] param Filter for hostname or IP (NULL to show all).
155  */
156 static void
157 stats_access(struct Client *to, const struct StatDesc *sd, char *param)
158 {
159   struct ConfItem *aconf;
160   int wilds = 0;
161   int count = 1000;
162
163   if (!param)
164   {
165     stats_configured_links(to, sd, param);
166     return;
167   }
168
169   wilds = string_has_wildcards(param);
170
171   for (aconf = GlobalConfList; aconf; aconf = aconf->next)
172   {
173     if (aconf->status != CONF_CLIENT)
174       continue;
175     if ((!wilds && (!match(aconf->host, param) ||
176                     !match(aconf->name, param))) ||
177         (wilds && (!mmatch(param, aconf->host) ||
178                    !mmatch(param, aconf->name))))
179     {
180       send_reply(to, RPL_STATSILINE, 'I', aconf->host, aconf->name,
181                  aconf->address.port, get_conf_class(aconf));
182       if (--count == 0)
183         break;
184     }
185   }
186 }
187
188
189 /** Report DenyConf entries.
190  * @param[in] to Client requesting list.
191  */
192 static void
193 report_deny_list(struct Client* to)
194 {
195   const struct DenyConf* p = conf_get_deny_list();
196   for ( ; p; p = p->next)
197     send_reply(to, RPL_STATSKLINE, p->bits > 0 ? 'k' : 'K',
198                p->usermask ? p->usermask : "*",
199                p->hostmask ? p->hostmask : "*",
200                p->message ? p->message : "(none)",
201                p->realmask ? p->realmask : "*");
202 }
203
204 /** Report K/k-lines to a user.
205  * @param[in] sptr Client requesting statistics.
206  * @param[in] sd Stats descriptor for request (ignored).
207  * @param[in] mask Filter for hostmasks to show.
208  */
209 static void
210 stats_klines(struct Client *sptr, const struct StatDesc *sd, char *mask)
211 {
212   int wilds = 0;
213   int count = 3;
214   int limit_query = 0;
215   char *user  = 0;
216   char *host;
217   const struct DenyConf* conf;
218
219   if (!IsAnOper(sptr))
220     limit_query = 1;
221
222   if (!mask)
223   {
224     if (limit_query)
225       need_more_params(sptr, "STATS K");
226     else
227       report_deny_list(sptr);
228     return;
229   }
230
231   if (!limit_query)
232   {
233     wilds = string_has_wildcards(mask);
234     count = 1000;
235   }
236   if ((host = strchr(mask, '@')))
237   {
238     user = mask;
239     *host++ = '\0';
240   }
241   else
242     host = mask;
243
244   for (conf = conf_get_deny_list(); conf; conf = conf->next)
245   {
246     if ((!wilds && ((user || conf->hostmask) &&
247                     !match(conf->hostmask, host) &&
248                     (!user || !match(conf->usermask, user)))) ||
249         (wilds && !mmatch(host, conf->hostmask) &&
250          (!user || !mmatch(user, conf->usermask))))
251     {
252       send_reply(sptr, RPL_STATSKLINE, conf->bits > 0 ? 'k' : 'K',
253                  conf->usermask ? conf->usermask : "*",
254                  conf->hostmask ? conf->hostmask : "*",
255                  conf->message ? conf->message : "(none)",
256                  conf->realmask ? conf->realmask : "*");
257       if (--count == 0)
258         return;
259     }
260   }
261 }
262
263 /** Report on servers and/or clients connected to the network.
264  * @param[in] sptr Client requesting statistics.
265  * @param[in] sd Stats descriptor for request (ignored).
266  * @param[in] name Filter for client names to show.
267  */
268 static void
269 stats_links(struct Client* sptr, const struct StatDesc* sd, char* name)
270 {
271   struct Client *acptr;
272   int i;
273   int wilds = 0;
274
275   if (name)
276     wilds = string_has_wildcards(name);
277
278   /*
279    * Send info about connections which match, or all if the
280    * mask matches me.name.  Only restrictions are on those who
281    * are invisible not being visible to 'foreigners' who use
282    * a wild card based search to list it.
283    */
284   send_reply(sptr, SND_EXPLICIT | RPL_STATSLINKINFO, "Connection SendQ "
285              "SendM SendKBytes RcveM RcveKBytes :Open since");
286     for (i = 0; i <= HighestFd; i++)
287     {
288       if (!(acptr = LocalClientArray[i]))
289         continue;
290       /* Don't return clients when this is a request for `all' */
291       if (!name && IsUser(acptr))
292         continue;
293       /* Don't show invisible people to non opers unless they know the nick */
294       if (IsInvisible(acptr) && (!name || wilds) && !IsAnOper(acptr) &&
295           (acptr != sptr))
296         continue;
297       /* Only show the ones that match the given mask - if any */
298       if (name && wilds && match(name, cli_name(acptr)))
299         continue;
300       /* Skip all that do not match the specific query */
301       if (!(!name || wilds) && 0 != ircd_strcmp(name, cli_name(acptr)))
302         continue;
303       send_reply(sptr, SND_EXPLICIT | RPL_STATSLINKINFO,
304                  "%s %u %u %Lu %u %Lu :%Tu",
305                  (*(cli_name(acptr))) ? cli_name(acptr) : "<unregistered>",
306                  (int)MsgQLength(&(cli_sendQ(acptr))), (int)cli_sendM(acptr),
307                  (cli_sendB(acptr) >> 10), (int)cli_receiveM(acptr),
308                  (cli_receiveB(acptr) >> 10), CurrentTime - cli_firsttime(acptr));
309     }
310 }
311
312 /** Report on loaded modules.
313  * @param[in] to Client requesting statistics.
314  * @param[in] sd Stats descriptor for request (ignored).
315  * @param[in] param Extra parameter from user (ignored).
316  */
317 static void
318 stats_modules(struct Client* to, const struct StatDesc* sd, char* param)
319 {
320 crypt_mechs_t* mechs;
321
322   send_reply(to, SND_EXPLICIT | RPL_STATSLLINE, 
323    "Module  Description      Entry Point");
324
325  /* atm the only "modules" we have are the crypto mechanisms,
326     eventualy they'll be part of a global dl module list, for now
327     i'll just output data about them -- hikari */
328
329  if(crypt_mechs_root == NULL)
330   return;
331
332  mechs = crypt_mechs_root->next;
333
334  for(;;)
335  {
336   if(mechs == NULL)
337    return;
338
339   send_reply(to, SND_EXPLICIT | RPL_STATSLLINE, 
340    "%s  %s     0x%X", 
341    mechs->mech->shortname, mechs->mech->description, 
342    mechs->mech->crypt_function);
343
344   mechs = mechs->next;
345  }
346
347 }
348
349 /** Report how many times each command has been used.
350  * @param[in] to Client requesting statistics.
351  * @param[in] sd Stats descriptor for request (ignored).
352  * @param[in] param Extra parameter from user (ignored).
353  */
354 static void
355 stats_commands(struct Client* to, const struct StatDesc* sd, char* param)
356 {
357   struct Message *mptr;
358
359   for (mptr = msgtab; mptr->cmd; mptr++)
360     if (mptr->count)
361       send_reply(to, RPL_STATSCOMMANDS, mptr->cmd, mptr->count, mptr->bytes);
362 }
363
364 /** List channel quarantines.
365  * @param[in] to Client requesting statistics.
366  * @param[in] sd Stats descriptor for request (ignored).
367  * @param[in] param Filter for quarantined channel names.
368  */
369 static void
370 stats_quarantine(struct Client* to, const struct StatDesc* sd, char* param)
371 {
372   struct qline *qline;
373
374   for (qline = GlobalQuarantineList; qline; qline = qline->next)
375   {
376     if (param && match(param, qline->chname)) /* narrow search */
377       continue;
378     send_reply(to, RPL_STATSQLINE, qline->chname, qline->reason);
379   }
380 }
381
382 /** List service pseudo-command mappings.
383  * @param[in] to Client requesting statistics.
384  * @param[in] sd Stats descriptor for request (ignored).
385  * @param[in] param Extra parameter from user (ignored).
386  */
387 static void
388 stats_mapping(struct Client *to, const struct StatDesc* sd, char* param)
389 {
390   struct s_map *map;
391
392   send_reply(to, RPL_STATSRLINE, "Command", "Name", "Prepend", "Target");
393   for (map = GlobalServiceMapList; map; map = map->next) {
394     struct nick_host *nh;
395     for (nh = map->services; nh; nh = nh->next) {
396       send_reply(to, RPL_STATSRLINE, map->command, map->name,
397                  (map->prepend ? map->prepend : "*"), nh->nick);
398     }
399   }
400 }
401
402 /** Report server uptime and maximum connection/client counts.
403  * @param[in] to Client requesting statistics.
404  * @param[in] sd Stats descriptor for request (ignored).
405  * @param[in] param Extra parameter from user (ignored).
406  */
407 static void
408 stats_uptime(struct Client* to, const struct StatDesc* sd, char* param)
409 {
410   time_t nowr;
411
412   nowr = CurrentTime - cli_since(&me);
413   send_reply(to, RPL_STATSUPTIME, nowr / 86400, (nowr / 3600) % 24,
414              (nowr / 60) % 60, nowr % 60);
415   send_reply(to, RPL_STATSCONN, max_connection_count, max_client_count);
416 }
417
418 /** Verbosely report on servers connected to the network.
419  * If sd->sd_funcdata != 0, then display in a more human-friendly format.
420  * @param[in] sptr Client requesting statistics.
421  * @param[in] sd Stats descriptor for request.
422  * @param[in] param Filter for server names to display.
423  */
424 static void
425 stats_servers_verbose(struct Client* sptr, const struct StatDesc* sd,
426                       char* param)
427 {
428   struct Client *acptr;
429   const char *fmt;
430
431   /*
432    * lowercase 'v' is for human-readable,
433    * uppercase 'V' is for machine-readable
434    */
435   if (sd->sd_funcdata) {
436     send_reply(sptr, SND_EXPLICIT | RPL_STATSVERBOSE,
437                "%-20s %-20s Flags Hops Numeric   Lag  RTT   Up Down "
438                "Clients/Max Proto %-10s :Info", "Servername", "Uplink",
439                "LinkTS");
440     fmt = "%-20s %-20s %c%c%c%c  %4i %s %-4i %5i %4i %4i %4i %5i %5i P%-2i   %Tu :%s";
441   } else {
442     fmt = "%s %s %c%c%c%c %i %s %i %i %i %i %i %i %i P%i %Tu :%s";
443   }
444
445   for (acptr = GlobalClientList; acptr; acptr = cli_next(acptr))
446   {
447     if (!IsServer(acptr) && !IsMe(acptr))
448       continue;
449     /* narrow search */
450     if (param && match(param, cli_name(acptr)))
451       continue;
452     send_reply(sptr, SND_EXPLICIT | RPL_STATSVERBOSE, fmt,
453                cli_name(acptr),
454                cli_name(cli_serv(acptr)->up),
455                IsBurst(acptr) ? 'B' : '-',
456                IsBurstAck(acptr) ? 'A' : '-',
457                IsHub(acptr) ? 'H' : '-',
458                IsService(acptr) ? 'S' : '-',
459                cli_hopcount(acptr),
460                NumServ(acptr),
461                base64toint(cli_yxx(acptr)),
462                cli_serv(acptr)->lag,
463                cli_serv(acptr)->asll_rtt,
464                cli_serv(acptr)->asll_to,
465                cli_serv(acptr)->asll_from,
466                (acptr == &me ? UserStats.local_clients : cli_serv(acptr)->clients),
467                cli_serv(acptr)->nn_mask,
468                cli_serv(acptr)->prot,
469                cli_serv(acptr)->timestamp,
470                cli_info(acptr));
471   }
472 }
473
474 #ifdef DEBUGMODE
475 /** Display objects allocated (and total memory used by them) for
476  * several types of structures.
477  * @param[in] to Client requesting statistics.
478  * @param[in] sd Stats descriptor for request (ignored).
479  * @param[in] param Extra parameter from user (ignored).
480  */
481 static void
482 stats_meminfo(struct Client* to, const struct StatDesc* sd, char* param)
483 {
484   class_send_meminfo(to);
485   send_listinfo(to, 0);
486 }
487 #endif
488
489 /** Send a list of available statistics.
490  * @param[in] to Client requesting statistics.
491  * @param[in] sd Stats descriptor for request.
492  * @param[in] param Extra parameter from user (ignored).
493  */
494 static void
495 stats_help(struct Client* to, const struct StatDesc* sd, char* param)
496 {
497   struct StatDesc *asd;
498
499   /* only if it's my user */
500   if (MyUser(to))
501     for (asd = statsinfo; asd->sd_name; asd++)
502       if (asd != sd) /* don't send the help for us */
503         sendcmdto_one(&me, CMD_NOTICE, to, "%C :%c (%s) - %s", to, asd->sd_c,
504                       asd->sd_name, asd->sd_desc);
505 }
506
507 /** Contains information about all statistics. */
508 struct StatDesc statsinfo[] = {
509   { 'a', "nameservers", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_a,
510     report_dns_servers, 0,
511     "DNS servers." },
512   { 'c', "connect", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_c,
513     stats_configured_links, CONF_SERVER,
514     "Remote server connection lines." },
515   { 'd', "maskrules", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_d,
516     stats_crule_list, CRULE_MASK,
517     "Dynamic routing configuration." },
518   { 'D', "crules", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_d,
519     stats_crule_list, CRULE_ALL,
520     "Dynamic routing configuration." },
521   { 'e', "engine", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_e,
522     stats_engine, 0,
523     "Report server event loop engine." },
524   { 'f', "features", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_f,
525     feature_report, 0,
526     "Feature settings." },
527   { 'g', "glines", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_g,
528     gline_stats, 0,
529     "Global bans (G-lines)." },
530   { 'i', "access", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM), FEAT_HIS_STATS_i,
531     stats_access, CONF_CLIENT,
532     "Connection authorization lines." },
533   { 'j', "histogram", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_j,
534     msgq_histogram, 0,
535     "Message length histogram." },
536   { 'J', "jupes", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_J,
537     stats_nickjupes, 0,
538     "Nickname jupes." },
539   { 'k', "klines", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM), FEAT_HIS_STATS_k,
540     stats_klines, 0,
541     "Local bans (K-Lines)." },
542   { 'l', "links", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM | STAT_FLAG_CASESENS),
543     FEAT_HIS_STATS_l,
544     stats_links, 0,
545     "Current connections information." },
546   { 'L', "modules", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM | STAT_FLAG_CASESENS),
547     FEAT_HIS_STATS_L,
548     stats_modules, 0,
549     "Dynamically loaded modules." },
550   { 'm', "commands", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_m,
551     stats_commands, 0,
552     "Message usage information." },
553   { 'o', "operators", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_o,
554     stats_configured_links, CONF_OPERATOR,
555     "Operator information." },
556   { 'p', "ports", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM), FEAT_HIS_STATS_p,
557     show_ports, 0,
558     "Listening ports." },
559   { 'q', "quarantines", (STAT_FLAG_OPERONLY | STAT_FLAG_VARPARAM), FEAT_HIS_STATS_q,
560     stats_quarantine, 0,
561     "Quarantined channels list." },
562   { 'R', "mappings", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_R,
563     stats_mapping, 0,
564     "Service mappings." },
565 #ifdef DEBUGMODE
566   { 'r', "usage", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_r,
567     send_usage, 0,
568     "System resource usage (Debug only)." },
569 #endif
570   { 'T', "motds", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_T,
571     motd_report, 0,
572     "Configured Message Of The Day files." },
573   { 't', "locals", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_t,
574     tstats, 0,
575     "Local connection statistics (Total SND/RCV, etc)." },
576   { 'U', "uworld", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_U,
577     stats_configured_links, CONF_UWORLD,
578     "Service server information." },
579   { 'u', "uptime", (STAT_FLAG_OPERFEAT | STAT_FLAG_CASESENS), FEAT_HIS_STATS_u,
580     stats_uptime, 0,
581     "Current uptime & highest connection count." },
582   { 'v', "vservers", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM | STAT_FLAG_CASESENS), FEAT_HIS_STATS_v,
583     stats_servers_verbose, 1,
584     "Verbose server information." },
585   { 'V', "vserversmach", (STAT_FLAG_OPERFEAT | STAT_FLAG_VARPARAM | STAT_FLAG_CASESENS), FEAT_HIS_STATS_v,
586     stats_servers_verbose, 0,
587     "Verbose server information." },
588   { 'w', "userload", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_w,
589     calc_load, 0,
590     "Userload statistics." },
591 #ifdef DEBUGMODE
592   { 'x', "memusage", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_x,
593     stats_meminfo, 0,
594     "List usage information (Debug only)." },
595 #endif
596   { 'y', "classes", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_y,
597     report_classes, 0,
598     "Connection classes." },
599   { 'z', "memory", STAT_FLAG_OPERFEAT, FEAT_HIS_STATS_z,
600     count_memory, 0,
601     "Memory/Structure allocation information." },
602   { '*', "help", (STAT_FLAG_CASESENS | STAT_FLAG_VARPARAM), FEAT_LAST_F,
603     stats_help, 0,
604     "Send help for stats." },
605   { '\0', 0, FEAT_LAST_F, 0, 0, 0 }
606 };
607
608 /** Maps from characters to statistics descriptors.
609  * Statistics descriptors with no single-character alias are not included.
610  */
611 static struct StatDesc *statsmap[256];
612 /** Number of statistics descriptors. */
613 static int statscount;
614
615 /** Compare two StatDesc structures by long name (StatDesc::sd_name).
616  * @param[in] a_ Pointer to a StatDesc.
617  * @param[in] b_ Pointer to a StatDesc.
618  * @return Less than, equal to, or greater than zero if \a a_ is
619  * lexicographically less than, equal to, or greater than \a b_.
620  */
621 static int
622 stats_cmp(const void *a_, const void *b_)
623 {
624   const struct StatDesc *a = a_;
625   const struct StatDesc *b = b_;
626   return ircd_strcmp(a->sd_name, b->sd_name);
627 }
628
629 /** Compare a StatDesc's name against a string.
630  * @param[in] key Pointer to a null-terminated string.
631  * @param[in] sd_ Pointer to a StatDesc.
632  * @return Less than, equal to, or greater than zero if \a key is
633  * lexicographically less than, equal to, or greater than \a
634  * sd_->sd_name.
635  */
636 static int
637 stats_search(const void *key, const void *sd_)
638 {
639   const struct StatDesc *sd = sd_;
640   return ircd_strcmp(key, sd->sd_name);
641 }
642
643 /** Look up a stats handler.  If name_or_char is just one character
644  * long, use that as a character index; otherwise, look it up by name
645  * in #statsinfo.
646  * @param[in] name_or_char Null-terminated string to look up.
647  * @return The statistics descriptor for \a name_or_char (NULL if none).
648  */
649 const struct StatDesc *
650 stats_find(const char *name_or_char)
651 {
652   if (!name_or_char[1])
653     return statsmap[(int)name_or_char[0]];
654   else
655     return bsearch(name_or_char, statsinfo, statscount, sizeof(statsinfo[0]), stats_search);
656 }
657
658 /** Build statsmap from the statsinfo array. */
659 void
660 stats_init(void)
661 {
662   struct StatDesc *sd;
663   int i;
664
665   /* Make darn sure the statsmap array is initialized to all zeros */
666   for (i = 0; i < 256; i++)
667     statsmap[i] = 0;
668
669   /* Count number of stats entries and sort them. */
670   for (statscount = 0, sd = statsinfo; sd->sd_name; sd++, statscount++) {}
671   qsort(statsinfo, statscount, sizeof(statsinfo[0]), stats_cmp);
672
673   /* Build the mapping */
674   for (sd = statsinfo; sd->sd_name; sd++)
675   {
676     if (!sd->sd_c)
677       continue;
678     else if (sd->sd_flags & STAT_FLAG_CASESENS)
679       /* case sensitive character... */
680       statsmap[(int)sd->sd_c] = sd;
681     else
682     {
683       /* case insensitive--make sure to put in two entries */
684       statsmap[(int)ToLower((int)sd->sd_c)] = sd;
685       statsmap[(int)ToUpper((int)sd->sd_c)] = sd;
686     }
687   }
688 }