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