]> git.donarmstrong.com Git - infobot.git/blob - src/CommandStubs.pl
- we now check if CODEREF exists.
[infobot.git] / src / CommandStubs.pl
1 #
2 # User Command Extension Stubs
3 #
4
5 if (&IsParam("useStrict")) { use strict; }
6
7 $babel_lang_regex = "fr|sp|po|pt|it|ge|de|gr|en";
8
9 ### COMMAND HOOK IMPLEMENTATION.
10 # addCmdHook("SECTION", 'TEXT_HOOK',
11 #       (CODEREF        => 'Blah', 
12 #       Forker          => 1,
13 #       CheckModule     => 1,                   # ???
14 #       Module          => 'blah.pl'            # preload module.
15 #       Identifier      => 'config_label',      # change to Config?
16 #       Help            => 'help_label',
17 #       Cmdstats        => 'text_label',)
18 #}
19 ###
20
21 sub addCmdHook {
22     my ($hashname, $ident, %hash) = @_;
23
24     if (exists ${"hooks_$hashname"}{$ident}) {
25 ###     &WARN("aCH: cmd hooks \%$hashname{$ident} already exists.");
26         return;
27     }
28
29     &VERB("aCH: added $ident",2);       # use $hash{'Identifier'}?
30     ### hrm... prevent warnings?
31     ${"hooks_$hashname"}{$ident} = \%hash;
32 }
33
34 # RUN IF ADDRESSED.
35 sub parseCmdHook {
36     my ($hashname, $line) = @_;
37     $line =~ /^(\S+)( (.*))?$/;
38     my $cmd     = $1;   # command name is whitespaceless.
39     my $flatarg = $3;
40     my @args    = split(/\s+/, $flatarg || '');
41     my $done    = 0;
42
43     &shmFlush();
44
45     if (!defined %{"hooks_$hashname"}) {
46         &WARN("cmd hooks \%$hashname does not exist.");
47         return 0;
48     }
49
50     foreach (keys %{"hooks_$hashname"}) {
51         my $ident = $_;
52
53         next unless ($cmd =~ /^$ident$/i);
54
55         if ($done) {
56             &WARN("pCH: Multiple hook match: $ident");
57             next;
58         }
59
60         &status("hooks($hashname): $cmd matched '$ident'");
61         my %hash = %{ ${"hooks_$hashname"}{$ident} };
62
63         if (!scalar keys %hash) {
64             &WARN("CmdHook: hash is NULL?");
65             return 1;
66         }
67
68         if ($hash{NoArgs} and $flatarg) {
69             &DEBUG("cmd $ident does not take args; skipping.");
70             next;
71         }
72
73         if (!exists $hash{CODEREF}) {
74             &ERROR("CODEREF undefined for $cmd or $ident.");
75             return 1;
76         }
77
78         ### DEBUG.
79         foreach (keys %hash) {
80             &VERB(" $cmd->$_ => '$hash{$_}'.",2);
81         }
82
83         ### HELP.
84         if (exists $hash{'Help'} and !scalar(@args)) {
85             &help( $hash{'Help'} );
86             return 1;
87         }
88
89         ### IDENTIFIER.
90         if (exists $hash{'Identifier'}) {
91             return 1 unless (&hasParam($hash{'Identifier'}));
92         }
93
94         ### USER FLAGS.
95         if (exists $hash{'UserFlag'}) {
96             return 1 unless (&hasFlag($hash{'UserFlag'}));
97         }
98
99         ### FORKER,IDENTIFIER,CODEREF.
100         if (exists $hash{'Forker'}) {
101             $hash{'Identifier'} .= "-" if ($hash{'Forker'} eq "NULL");
102
103             if (exists $hash{'ArrayArgs'}) {
104                 &Forker($hash{'Identifier'}, sub { \&{$hash{'CODEREF'}}(@args) } );
105             } else {
106                 &Forker($hash{'Identifier'}, sub { \&{$hash{'CODEREF'}}($flatarg) } );
107             }
108
109         } else {
110             if (exists $hash{'Module'}) {
111                 &loadMyModule($myModules{ $hash{'Module'} });
112             }
113
114             # check if CODEREF exists.
115             if (!defined &{ $hash{'CODEREF'} }) {
116                 &WARN("coderef $hash{'CODEREF'} don't exist.");
117                 return 1;
118             }
119
120             if (exists $hash{'ArrayArgs'}) {
121                 &{$hash{'CODEREF'}}(@args);
122             } else {
123                 &{$hash{'CODEREF'}}($flatarg);
124             }
125         }
126
127         ### CMDSTATS.
128         if (exists $hash{'Cmdstats'}) {
129             $cmdstats{ $hash{'Cmdstats'} }++;
130         }
131
132         &VERB("hooks: End of command.",2);
133
134         $done = 1;
135     }
136
137     return 1 if ($done);
138     return 0;
139 }
140
141 ###
142 ### START ADDING HOOKS.
143 ###
144 &addCmdHook("extra", 'd?bugs', ('CODEREF' => 'debianBugs',
145         'Forker' => 1, 'Identifier' => 'debianExtra',
146         'Cmdstats' => 'Debian Bugs') );
147 &addCmdHook("extra", 'dauthor', ('CODEREF' => 'Debian::searchAuthor',
148         'Forker' => 1, 'Identifier' => 'debian',
149         'Cmdstats' => 'Debian Author Search', 'Help' => "dauthor" ) );
150 &addCmdHook("extra", '(d|search)desc', ('CODEREF' => 'Debian::searchDescFE',
151         'Forker' => 1, 'Identifier' => 'debian',
152         'Cmdstats' => 'Debian Desc Search', 'Help' => "ddesc" ) );
153 &addCmdHook("extra", 'dnew', ('CODEREF' => 'DebianNew',
154         'Identifier' => 'debian' ) );
155 &addCmdHook("extra", 'dincoming', ('CODEREF' => 'Debian::generateIncoming',
156         'Forker' => 1, 'Identifier' => 'debian' ) );
157 &addCmdHook("extra", 'dstats', ('CODEREF' => 'Debian::infoStats',
158         'Forker' => 1, 'Identifier' => 'debian',
159         'Cmdstats' => 'Debian Statistics' ) );
160 &addCmdHook("extra", 'd?contents', ('CODEREF' => 'Debian::searchContents',
161         'Forker' => 1, 'Identifier' => 'debian',
162         'Cmdstats' => 'Debian Contents Search', 'Help' => "contents" ) );
163 &addCmdHook("extra", 'd?find', ('CODEREF' => 'Debian::DebianFind',
164         'Forker' => 1, 'Identifier' => 'debian',
165         'Cmdstats' => 'Debian Search', 'Help' => "find" ) );
166 &addCmdHook("extra", 'insult', ('CODEREF' => 'Insult::Insult',
167         'Forker' => 1, 'Identifier' => 'insult', 'Help' => "insult" ) );
168 &addCmdHook("extra", 'kernel', ('CODEREF' => 'Kernel::Kernel',
169         'Forker' => 1, 'Identifier' => 'kernel',
170         'Cmdstats' => 'Kernel', 'NoArgs' => 1) );
171 &addCmdHook("extra", 'listauth', ('CODEREF' => 'CmdListAuth',
172         'Identifier' => 'search', Module => 'factoids', 
173         'Help' => 'listauth') );
174 &addCmdHook("extra", 'quote', ('CODEREF' => 'Quote::Quote',
175         'Forker' => 1, 'Identifier' => 'quote',
176         'Help' => 'quote', 'Cmdstats' => 'Quote') );
177 &addCmdHook("extra", 'countdown', ('CODEREF' => 'Countdown',
178         'Module' => 'countdown', 'Identifier' => 'countdown',
179         'Cmdstats' => 'Countdown') );
180 &addCmdHook("extra", 'lart', ('CODEREF' => 'lart',
181         'Identifier' => 'lart', 'Help' => 'lart') );
182 &addCmdHook("extra", 'convert', ('CODEREF' => 'convert',
183         'Forker' => 1, 'Identifier' => 'units',
184         'Help' => 'convert') );
185 &addCmdHook("extra", '(cookie|random)', ('CODEREF' => 'cookie',
186         'Forker' => 1, 'Identifier' => 'factoids') );
187 &addCmdHook("extra", 'u(ser)?info', ('CODEREF' => 'userinfo',
188         'Identifier' => 'userinfo', 'Help' => 'userinfo',
189         'Module' => 'userinfo') );
190 &addCmdHook("extra", 'rootWarn', ('CODEREF' => 'CmdrootWarn',
191         'Identifier' => 'rootWarn', 'Module' => 'rootwarn') );
192 &addCmdHook("extra", 'seen', ('CODEREF' => 'seen', 'Identifier' =>
193         'seen') );
194 &addCmdHook("extra", 'dict', ('CODEREF' => 'Dict::Dict',
195         'Identifier' => 'dict', 'Help' => 'dict',
196         'Forker' => 1, 'Cmdstats' => 'Dict') );
197 &addCmdHook("extra", 'slashdot', ('CODEREF' => 'Slashdot::Slashdot',
198         'Identifier' => 'slashdot', 'Forker' => 1,
199         'Cmdstats' => 'Slashdot') );
200 &addCmdHook("extra", 'uptime', ('CODEREF' => 'uptime', 'Identifier' => 'uptime',
201         'Cmdstats' => 'Uptime') );
202 &addCmdHook("extra", 'nullski', ('CODEREF' => 'nullski', ) );
203 &addCmdHook("extra", '(fm|freshmeat)', ('CODEREF' => 'Freshmeat::Freshmeat',
204         'Identifier' => 'freshmeat', 'Cmdstats' => 'Freshmeat',
205         'Forker' => 1, 'Help' => 'freshmeat') );
206 &addCmdHook("extra", 'verstats', ('CODEREF' => 'do_verstats' ) );
207
208 ###
209 ### END OF ADDING HOOKS.
210 ###
211 &status("CMD: loaded ".scalar(keys %hooks_extra)." EXTRA command hooks.");
212
213 sub Modules {
214     if (!defined $message) {
215         &WARN("Modules: message is undefined. should never happen.");
216         return;
217     }
218
219     # babel bot: Jonathan Feinberg++
220     if (&IsChanConf("babelfish") and $message =~ m{
221                 ^\s*
222                 (?:babel(?:fish)?|x|xlate|translate)
223                 \s+
224                 (to|from)               # direction of translation (through)
225                 \s+
226                 ($babel_lang_regex)\w*  # which language?
227                 \s*
228                 (.+)                    # The phrase to be translated
229         }xoi) {
230
231         &Forker("babelfish", sub { &babel::babelfish(lc $1, lc $2, $3); } );
232
233         $cmdstats{'BabelFish'}++;
234         return;
235     }
236
237     if (&IsChanConf("debian")) {
238         my $debiancmd    = 'conflicts?|depends?|desc|file|info|provides?';
239         $debiancmd      .= '|recommends?|suggests?|maint|maintainer';
240         if ($message =~ /^($debiancmd)(\s+(.*))?$/i) {
241             my $package = lc $3;
242
243             if (defined $package) {
244                 &Forker("debian", sub { &Debian::infoPackages($1, $package); } );
245             } else {
246                 &help($1);
247             }
248
249             return;
250         }
251     }
252
253     # google searching. Simon++
254     if (&IsChanConf("wwwsearch") and $message =~ /^(?:search\s+)?(\S+)\s+for\s+['"]?(.*?)['"]?\s*\?*$/i) {
255         return unless (&hasParam("wwwsearch"));
256
257         &Forker("wwwsearch", sub { &W3Search::W3Search($1,$2); } );
258
259         $cmdstats{'WWWSearch'}++;
260         return;
261     }
262
263     # list{keys|values}. xk++. Idea taken from #linuxwarez@EFNET
264     if ($message =~ /^list(\S+)( (.*))?$/i) {
265         return unless (&hasParam("search"));
266
267         my $thiscmd     = lc($1);
268         my $args        = $3;
269         $args           =~ s/\s+$//g;
270         # suggested by asuffield nad \broken.
271         if ($args =~ /^["']/ and $args =~ /["']$/) {
272             &DEBUG("list*: removed quotes.");
273             $args       =~ s/^["']|["']$//g;
274         }
275
276         $thiscmd =~ s/^vals$/values/;
277         return if ($thiscmd ne "keys" && $thiscmd ne "values");
278
279         # Usage:
280         if (!defined $args) {
281             &help("list". $thiscmd);
282             return;
283         }
284
285         if (length $args == 1) {
286             &msg($who,"search string is too short.");
287             return;
288         }
289
290         &Forker("search", sub { &Search::Search($thiscmd, $args); } );
291
292         $cmdstats{'Factoid Search'}++;
293         return;
294     }
295
296     # Nickometer. Adam Spiers++
297     if ($message =~ /^(?:lame|nick)ometer(?: for)? (\S+)/i) {
298         return unless (&hasParam("nickometer"));
299
300         my $term = (lc $1 eq 'me') ? $who : $1;
301
302         &loadMyModule($myModules{'nickometer'});
303
304         if ($term =~ /^$mask{chan}$/) {
305             &status("Doing nickometer for chan $term.");
306
307             if (!&validChan($term)) {
308                 &msg($who, "error: channel is invalid.");
309                 return;
310             }
311
312             # step 1.
313             my %nickometer;
314             foreach (keys %{ $channels{lc $term}{''} }) {
315                 my $str   = $_;
316                 if (!defined $str) {
317                     &WARN("nickometer: nick in chan $term undefined?");
318                     next;
319                 }
320
321                 my $value = &nickometer($str);
322                 $nickometer{$value}{$str} = 1;
323             }
324
325             # step 2.
326             ### TODO: compact with map?
327             my @list;
328             foreach (sort {$b <=> $a} keys %nickometer) {
329                 my $str = join(", ", sort keys %{$nickometer{$_}});
330                 push(@list, "$str ($_%)");
331             }
332
333             &pSReply( &formListReply(0, "Nickometer list for $term ", @list) );
334             &DEBUG("test.");
335
336             return;
337         }
338
339         my $percentage = &nickometer($term);
340
341         if ($percentage =~ /NaN/) {
342             $percentage = "off the scale";
343         } else {
344             $percentage = sprintf("%0.4f", $percentage);
345             $percentage =~ s/\.?0+$//;
346             $percentage .= '%';
347         }
348
349         if ($msgType eq 'public') {
350             &say("'$term' is $percentage lame, $who");
351         } else {
352             &msg($who, "the 'lame nick-o-meter' reading for $term is $percentage, $who");
353         }
354
355         return;
356     }
357
358     # Topic management. xk++
359     # may want to add a flag(??) for topic in the near future. -xk
360     if ($message =~ /^topic(\s+(.*))?$/i) {
361         return unless (&hasParam("topic"));
362
363         my $chan        = $talkchannel;
364         my @args        = split / /, $2 || "";
365
366         if (!scalar @args) {
367             &msg($who,"Try 'help topic'");
368             return;
369         }
370
371         $chan           = lc(shift @args) if ($msgType eq 'private');
372         my $thiscmd     = shift @args;
373
374         # topic over public:
375         if ($msgType eq 'public' && $thiscmd =~ /^#/) {
376             &msg($who, "error: channel argument is not required.");
377             &msg($who, "\002Usage\002: topic <CMD>");
378             return;
379         }
380
381         # topic over private:
382         if ($msgType eq 'private' && $chan !~ /^#/) {
383             &msg($who, "error: channel argument is required.");
384             &msg($who, "\002Usage\002: topic #channel <CMD>");
385             return;
386         }
387
388         if (&validChan($chan) == 0) {
389             &msg($who,"error: invalid channel \002$chan\002");
390             return;
391         }
392
393         # for semi-outsiders.
394         if (!&IsNickInChan($who,$chan)) {
395             &msg($who, "Failed. You ($who) are not in $chan, hey?");
396             return;
397         }
398
399         # now lets do it.
400         &loadMyModule($myModules{'topic'});
401         &Topic($chan, $thiscmd, join(' ', @args));
402         $cmdstats{'Topic'}++;
403         return;
404     }
405
406     # wingate.
407     if ($message =~ /^wingate$/i) {
408         return unless (&hasParam("wingate"));
409
410         my $reply = "Wingate statistics: scanned \002"
411                         .scalar(keys %wingate)."\002 hosts";
412         my $queue = scalar(keys %wingateToDo);
413         if ($queue) {
414             $reply .= ".  I have \002$queue\002 hosts in the queue";
415             $reply .= ".  Started the scan ".&Time2String(time() - $wingaterun)." ago";
416         }
417
418         &performStrictReply("$reply.");
419
420         return;
421     }
422
423     # do nothing and let the other routines have a go
424     return "CONTINUE";
425 }
426
427 # Freshmeat. xk++
428 sub freshmeat {
429     my ($query) = @_;
430
431     if (!defined $query) {
432         &help("freshmeat");
433         &msg($who, "I have \002".&countKeys("freshmeat")."\002 entries.");
434         return;
435     }
436
437     &Freshmeat::Freshmeat($query);
438 }
439
440 # Uptime. xk++
441 sub uptime {
442     my $count = 1;
443     &msg($who, "- Uptime for $ident -");
444     &msg($who, "Now: ". &Time2String(&uptimeNow()) ." running $bot_version");
445
446     foreach (&uptimeGetInfo()) {
447         /^(\d+)\.\d+ (.*)/;
448         my $time = &Time2String($1);
449         my $info = $2;
450
451         &msg($who, "$count: $time $2");
452         $count++;
453     }
454 }
455
456 # seen.
457 sub seen {
458     my($person) = @_;
459
460     if (!defined $person) {
461         &help("seen");
462
463         my $i = &countKeys("seen");
464         &msg($who,"there ". &fixPlural("is",$i) ." \002$i\002 ".
465                 "seen ". &fixPlural("entry",$i) ." that I know of.");
466
467         return;
468     }
469
470     my @seen;
471     $person =~ s/\?*$//;
472
473     &seenFlush();       # very evil hack. oh well, better safe than sorry.
474
475     ### TODO: Support &dbGetRowInfo(); like in &FactInfo();
476     my $select = "nick,time,channel,host,message";
477     if ($person eq "random") {
478         @seen = &randKey("seen", $select);
479     } else {
480         @seen = &dbGet("seen", "nick", $person, $select);
481     }
482
483     if (scalar @seen < 2) {
484         foreach (@seen) {
485             &DEBUG("seen: _ => '$_'.");
486         }
487         &performReply("i haven't seen '$person'");
488         return;
489     }
490
491     # valid seen.
492     my $reply;
493     ### TODO: multi channel support. may require &IsNick() to return
494     ### all channels or something.
495     my @chans = &GetNickInChans($seen[0]);
496     if (scalar @chans) {
497         $reply = "$seen[0] is currently on";
498
499         foreach (@chans) {
500             $reply .= " ".$_;
501             next unless (exists $userstats{lc $seen[0]}{'Join'});
502             $reply .= " (".&Time2String(time() - $userstats{lc $seen[0]}{'Join'}).")";
503         }
504
505         if (&IsParam("seenStats")) {
506             my $i;
507             $i = $userstats{lc $seen[0]}{'Count'};
508             $reply .= ".  Has said a total of \002$i\002 messages" if (defined $i);
509             $i = $userstats{lc $seen[0]}{'Time'};
510             $reply .= ".  Is idling for ".&Time2String(time() - $i) if (defined $i);
511         }
512     } else {
513         my $howlong = &Time2String(time() - $seen[1]);
514         $reply = "$seen[0] <$seen[3]> was last seen on IRC ".
515                  "in channel $seen[2], $howlong ago, ".
516                  "saying\002:\002 '$seen[4]'.";
517     }
518
519     &performStrictReply($reply);
520     return;
521 }
522
523 # User Information Services. requested by Flugh.
524 sub userinfo {
525     my ($arg) = join(' ',@_);
526
527     if ($arg =~ /^set(\s+(.*))?$/i) {
528         $arg = $2;
529         if (!defined $arg) {
530             &help("userinfo set");
531             return;
532         }
533
534         &UserInfoSet(split /\s+/, $arg, 2);
535     } elsif ($arg =~ /^unset(\s+(.*))?$/i) {
536         $arg = $2;
537         if (!defined $arg) {
538             &help("userinfo unset");
539             return;
540         }
541
542         &UserInfoSet($arg, "");
543     } else {
544         &UserInfoGet($arg);
545     }
546 }
547
548 # cookie (random). xk++
549 sub cookie {
550     my ($arg) = @_;
551
552     # lets find that secret cookie.
553     my $target          = ($msgType ne 'public') ? $who : $talkchannel;
554     my $cookiemsg       = &getRandom(keys %{$lang{'cookie'}});
555     my ($key,$value);
556
557     ### WILL CHEW TONS OF MEM.
558     ### TODO: convert this to a Forker function!
559     if ($arg) {
560         my @list = &searchTable("factoids", "factoid_key", "factoid_value", $arg);
561         $key  = &getRandom(@list);
562         $val  = &getFactInfo("factoids", $key, "factoid_value");
563     } else {
564         ($key,$value) = &randKey("factoids","factoid_key,factoid_value");
565     }
566
567     for ($cookiemsg) {
568         s/##KEY/\002$key\002/;
569         s/##VALUE/$value/;
570         s/##WHO/$who/;
571         s/\$who/$who/;  # cheap fix.
572         s/(\S+)?\s*<\S+>/$1 /;
573         s/\s+/ /g;
574     }
575
576     if ($cookiemsg =~ s/^ACTION //i) {
577         &action($target, $cookiemsg);
578     } else {
579         &msg($target, $cookiemsg);
580     }
581 }
582
583 sub convert {
584     my $arg = join(' ',@_);
585     my ($from,$to) = ('','');
586
587     ($from,$to) = ($1,$2) if ($arg =~ /^(.*?) to (.*)$/i);
588     ($from,$to) = ($2,$1) if ($arg =~ /^(.*?) from (.*)$/i);
589
590     if (!$to or !$from) {
591         &msg($who, "Invalid format!");
592         &help("convert");
593         return;
594     }
595
596     &Units::convertUnits($from, $to);
597
598     return;
599 }
600
601 sub lart {
602     my ($target) = &fixString($_[0]);
603     my $extra   = 0;
604     my $chan    = $talkchannel;
605
606     if ($msgType eq 'private') {
607         if ($target =~ /^($mask{chan})\s+(.*)$/) {
608             $chan       = $1;
609             $target     = $2;
610             $extra      = 1;
611         } else {
612             &msg($who, "error: invalid format or missing arguments.");
613             &help("lart");
614             return;
615         }
616     }
617
618     my $line = &getRandomLineFromFile($bot_misc_dir. "/blootbot.lart");
619     if (defined $line) {
620         if ($target =~ /^(me|you|itself|\Q$ident\E)$/i) {
621             $line =~ s/WHO/$who/g;
622         } else {
623             $line =~ s/WHO/$target/g;
624         }
625         $line .= ", courtesy of $who" if ($extra);
626
627         &action($chan, $line);
628     } else {
629         &status("lart: error reading file?");
630     }
631 }
632
633 sub DebianNew {
634     my $idx   = "debian/Packages-woody.idx";
635     my $error = 0;
636     my %pkg;
637     my @new;
638
639     $error++ unless ( -e $idx);
640     $error++ unless ( -e "$idx-old");
641
642     if ($error) {
643         $error = "no woody/woody-old index file found.";
644         &ERROR("Debian: $error");
645         &msg($who, $error);
646         return;
647     }
648
649     open(IDX1, $idx);
650     open(IDX2, "$idx-old");
651
652     while (<IDX2>) {
653         chop;
654         next if (/^\*/);
655
656         $pkg{$_} = 1;
657     }
658     close IDX2;
659
660     open(IDX1,$idx);
661     while (<IDX1>) {
662         chop;
663         next if (/^\*/);
664         next if (exists $pkg{$_});
665
666         push(@new);
667     }
668     close IDX1;
669
670     &::performStrictReply( &::formListReply(0, "New debian packages:", @new) );
671 }
672
673 sub do_verstats {
674     my ($chan)  = @_;
675
676     if (!defined $chan) {
677         &help("verstats");
678         return;
679     }
680
681     if (!&validChan($chan)) {
682         &msg($who, "chan $chan is invalid.");
683         return;
684     }
685
686     if (scalar @vernick > scalar(keys %{ $channels{lc $chan}{''} })/4) {
687         &msg($who, "verstats already in progress for someone else.");
688         return;
689     }
690
691     &msg($who, "Sending CTCP VERSION...");
692     $conn->ctcp("VERSION", $chan);
693     $cache{verstats}{chan}      = $chan;
694     $cache{verstats}{who}       = $who;
695     $cache{verstats}{msgType}   = $msgType;
696
697     $conn->schedule(60, sub {
698         my $vtotal      = 0;
699         my $c           = lc $cache{verstats}{chan};
700         my $total       = keys %{ $channels{$c}{''} };
701         $chan           = $c;
702         $who            = $cache{verstats}{who};
703         $msgType        = $cache{verstats}{msgType};
704         delete $cache{verstats};        # sufficient?
705
706         foreach (keys %ver) {
707             $vtotal     += scalar keys %{ $ver{$_} };
708         }
709
710         my %sorted;
711         my $unknown     = $total - $vtotal;
712         my $perc        = sprintf("%.1f", $unknown * 100 / $total);
713         $perc           =~ s/.0$//;
714         $sorted{$perc}{"unknown/cloak"} = "$unknown ($perc%)";
715
716         foreach (keys %ver) {
717             my $count   = scalar keys %{ $ver{$_} };
718             $perc       = sprintf("%.01f", $count * 100 / $total);
719             $perc       =~ s/.0$//;     # lame compression.
720
721             $sorted{$perc}{$_} = "$count ($perc%)";
722         }
723
724         ### can be compressed to a map?
725         my @list;
726         foreach ( sort { $b <=> $a } keys %sorted ) {
727             my $perc = $_;
728             foreach (sort keys %{ $sorted{$perc} }) {
729                 push(@list, "$_ - $sorted{$perc}{$_}");
730             }
731         }
732
733         &pSReply( &formListReply(0, "IRC Client versions for $c ", @list) );
734
735         # clean up not-needed data structures.
736         undef %ver;
737         undef @vernick;
738     } );
739
740     return;
741 }
742
743 sub nullski { my ($arg) = @_; return unless (defined $arg);
744         foreach (`$arg`) { &msg($who,$_); } }
745
746 1;