Fix create_sysop.pl to work on base git install
[spider.git] / perl / DXCommandmode.pm
1 #!/usr/bin/perl
2 #
3 # This module impliments the user facing command mode for a dx cluster
4 #
5 # Copyright (c) 1998 Dirk Koopman G1TLH
6 #
7 #
8
9
10 package DXCommandmode;
11
12 #use POSIX;
13
14 @ISA = qw(DXChannel);
15
16 use 5.10.1;
17
18 use POSIX qw(:math_h);
19 use DXUtil;
20 use DXChannel;
21 use DXUser;
22 use DXVars;
23 use DXDebug;
24 use DXM;
25 use DXLog;
26 use DXLogPrint;
27 use DXBearing;
28 use CmdAlias;
29 use Filter;
30 use Minimuf;
31 use DXDb;
32 use AnnTalk;
33 use WCY;
34 use Sun;
35 use Internet;
36 use Script;
37 use QSL;
38 use DB_File;
39 use VE7CC;
40 use DXXml;
41 use AsyncMsg;
42 use JSON;
43 use Time::HiRes qw(gettimeofday tv_interval);
44
45 use Mojo::IOLoop;
46 use DXSubprocess;
47 use Mojo::UserAgent;
48
49 use strict;
50 use vars qw(%Cache %cmd_cache $errstr %aliases $scriptbase %nothereslug
51         $maxbadcount $msgpolltime $default_pagelth $cmdimportdir $users $maxusers);
52
53 %Cache = ();                                    # cache of dynamically loaded routine's mod times
54 %cmd_cache = ();                                # cache of short names
55 $errstr = ();                                   # error string from eval
56 %aliases = ();                                  # aliases for (parts of) commands
57 $scriptbase = "$main::root/scripts"; # the place where all users start scripts go
58 $maxbadcount = 3;                               # no of bad words allowed before disconnection
59 $msgpolltime = 3600;                    # the time between polls for new messages 
60 $cmdimportdir = "$main::root/cmd_import"; # the base directory for importing command scripts 
61                                           # this does not exist as default, you need to create it manually
62 $users = 0;                                       # no of users on this node currently
63 $maxusers = 0;                            # max no users on this node for this run
64
65 #
66 # obtain a new connection this is derived from dxchannel
67 #
68
69 sub new 
70 {
71         my $self = DXChannel::alloc(@_);
72
73         # routing, this must go out here to prevent race condx
74         my $pkg = shift;
75         my $call = shift;
76 #       my @rout = $main::routeroot->add_user($call, Route::here(1));
77         DXProt::_add_thingy($main::routeroot, [$call, 0, 0, 1, undef, undef, $self->hostname], );
78
79         # ALWAYS output the user
80         my $ref = Route::User::get($call);
81         if ($ref) {
82                 $main::me->route_pc16($main::mycall, undef, $main::routeroot, $ref);
83                 $main::me->route_pc92a($main::mycall, undef, $main::routeroot, $ref) unless $DXProt::pc92_slug_changes;
84         }
85
86         return $self;
87 }
88
89 # this is how a a connection starts, you get a hello message and the motd with
90 # possibly some other messages asking you to set various things up if you are
91 # new (or nearly new and slacking) user.
92
93 sub start
94
95         my ($self, $line, $sort) = @_;
96         my $user = $self->{user};
97         my $call = $self->{call};
98         my $name = $user->{name};
99         
100         # log it
101         my $host = $self->{conn}->peerhost;
102         $host ||= "AGW Port #$self->{conn}->{agwport}" if exists $self->{conn}->{agwport};
103         $host ||= "unknown";
104         $self->{hostname} = $host;
105
106         $self->{name} = $name ? $name : $call;
107         $self->send($self->msg('l2',$self->{name}));
108         $self->state('prompt');         # a bit of room for further expansion, passwords etc
109         $self->{priv} = $user->priv || 0;
110         $self->{lang} = $user->lang || $main::lang || 'en';
111         my $pagelth = $user->pagelth;
112         $pagelth = $default_pagelth unless defined $pagelth;
113         $self->{pagelth} = $pagelth;
114         ($self->{width}) = $line =~ /width=(\d+)/; $line =~ s/\s*width=\d+\s*//;
115         if ($line =~ /host=/) {
116                 my ($h) = $line =~ /host=(\d+\.\d+\.\d+\.\d+)/;
117                 $line =~ s/\s*host=\d+\.\d+\.\d+\.\d+// if $h;
118                 unless ($h) {
119                         ($h) = $line =~ /host=([\da..fA..F:]+)/;
120                         $line =~ s/\s*host=[\da..fA..F:]+// if $h;
121                 }
122                 $self->{hostname} = $h if $h;
123         }
124         $self->{width} = 80 unless $self->{width} && $self->{width} > 80;
125         $self->{consort} = $line;       # save the connection type
126
127         LogDbg('DXCommand', "$call connected from $self->{hostname}");
128
129         # set some necessary flags on the user if they are connecting
130         $self->{beep} = $user->wantbeep;
131         $self->{ann} = $user->wantann;
132         $self->{wwv} = $user->wantwwv;
133         $self->{wcy} = $user->wantwcy;
134         $self->{talk} = $user->wanttalk;
135         $self->{wx} = $user->wantwx;
136         $self->{dx} = $user->wantdx;
137         $self->{logininfo} = $user->wantlogininfo;
138         $self->{ann_talk} = $user->wantann_talk;
139         $self->{wantrbn} = $user->wantrbn;
140         $self->{here} = 1;
141         $self->{prompt} = $user->prompt if $user->prompt;
142         $self->{lastmsgpoll} = 0;
143
144         # sort out new dx spot stuff
145         $user->wantdxcq(0) unless defined $user->{wantdxcq};
146         $user->wantdxitu(0) unless defined $user->{wantdxitu};  
147         $user->wantusstate(0) unless defined $user->{wantusstate};
148
149         # sort out registration
150         if ($main::reqreg == 1) {
151                 $self->{registered} = $user->registered;
152         } elsif ($main::reqreg == 2) {
153                 $self->{registered} = !$user->registered;
154         } else {
155                 $self->{registered} = 1;
156         }
157
158         # establish slug queue, if required
159         $self->{sluggedpc11s} = [];
160         $self->{isslugged} = $DXProt::pc92_slug_changes + $main::systime if $DXProt::pc92_slug_changes;
161
162         # send the relevant MOTD
163         $self->send_motd;
164
165         # sort out privilege reduction
166         $self->{priv} = 0 unless $self->{hostname} eq '127.0.0.1' || $self->{hostname} eq '::1' || $self->conn->{usedpasswd};
167
168         # get the filters
169         my $nossid = $call;
170         $nossid =~ s/-\d+$//;
171         
172         $self->{spotsfilter} = Filter::read_in('spots', $call, 0) 
173                 || Filter::read_in('spots', $nossid, 0)
174                         || Filter::read_in('spots', 'user_default', 0);
175         $self->{wwvfilter} = Filter::read_in('wwv', $call, 0) 
176                 || Filter::read_in('wwv', $nossid, 0) 
177                         || Filter::read_in('wwv', 'user_default', 0);
178         $self->{wcyfilter} = Filter::read_in('wcy', $call, 0) 
179                 || Filter::read_in('wcy', $nossid, 0) 
180                         || Filter::read_in('wcy', 'user_default', 0);
181         $self->{annfilter} = Filter::read_in('ann', $call, 0) 
182                 || Filter::read_in('ann', $nossid, 0) 
183                         || Filter::read_in('ann', 'user_default', 0) ;
184         $self->{rbnfilter} = Filter::read_in('rbn', $call, 0) 
185                 || Filter::read_in('rbn', $nossid, 0)
186                 || Filter::read_in('rbn', 'user_default', 0);
187         
188         # clean up qra locators
189         my $qra = $user->qra;
190         $qra = undef if ($qra && !DXBearing::is_qra($qra));
191         unless ($qra) {
192                 my $lat = $user->lat;
193                 my $long = $user->long;
194                 $user->qra(DXBearing::lltoqra($lat, $long)) if (defined $lat && defined $long);  
195         }
196
197         # decide on echo
198         my $echo = $user->wantecho;
199         unless ($echo) {
200                 $self->send_now('E', "0");
201                 $self->send($self->msg('echow'));
202                 $self->conn->echo($echo) if $self->conn->can('echo');
203         }
204         
205         $self->tell_login('loginu');
206         $self->tell_buddies('loginb');
207         
208         # do we need to send a forward/opernam?
209         my $lastoper = $user->lastoper || 0;
210         my $homenode = $user->homenode || ""; 
211         if ($homenode eq $main::mycall && $main::systime >= $lastoper + $DXUser::lastoperinterval) {
212                 run_cmd($main::me, "forward/opernam $call");
213                 $user->lastoper($main::systime + ((int rand(10)) * 86400));
214         }
215
216         # run a script send the output to the punter
217         my $script = new Script(lc $call) || new Script('user_default');
218         $script->run($self) if $script;
219
220         # send cluster info
221         $self->send($self->run_cmd("show/cluster"));
222
223         # send prompts for qth, name and things
224         $self->send($self->msg('namee1')) if !$user->name;
225         $self->send($self->msg('qthe1')) if !$user->qth;
226         $self->send($self->msg('qll')) if !$user->qra || (!$user->lat && !$user->long);
227         $self->send($self->msg('hnodee1')) if !$user->qth;
228         $self->send($self->msg('m9')) if DXMsg::for_me($call);
229
230         # send out any buddy messages for other people that are online
231         foreach my $call (@{$user->buddies}) {
232                 my $ref = Route::User::get($call);
233                 if ($ref) {
234                         foreach my $node ($ref->parents) {
235                                 $self->send($self->msg($node eq $main::mycall ? 'loginb' : 'loginbn', $call, $node));
236                         } 
237                 }
238         }
239
240         $self->lastmsgpoll($main::systime);
241         $self->prompt;
242 }
243
244 #
245 # This is the normal command prompt driver
246 #
247
248 sub normal
249 {
250         my $self = shift;
251         my $cmdline = shift;
252         my @ans;
253
254         # save this for them's that need it
255         my $rawline = $cmdline;
256         
257         # remove leading and trailing spaces
258         $cmdline =~ s/^\s*(.*)\s*$/$1/;
259         
260         if ($self->{state} eq 'page') {
261                 my $i = $self->{pagelth};
262                 my $ref = $self->{pagedata};
263                 my $tot = @$ref;
264                 
265                 # abort if we get a line starting in with a
266                 if ($cmdline =~ /^a/io) {
267                         undef $ref;
268                         $i = 0;
269                 }
270         
271                 # send a tranche of data
272                 while ($i-- > 0 && @$ref) {
273                         my $line = shift @$ref;
274                         $line =~ s/\s+$//o;     # why am having to do this? 
275                         $self->send($line);
276                 }
277                 
278                 # reset state if none or else chuck out an intermediate prompt
279                 if ($ref && @$ref) {
280                         $tot -= $self->{pagelth};
281                         $self->send($self->msg('page', $tot));
282                 } else {
283                         $self->state('prompt');
284                 }
285         } elsif ($self->{state} eq 'sysop') {
286                 my $passwd = $self->{user}->passwd;
287                 if ($passwd) {
288                         my @pw = grep {$_ !~ /\s/} split //, $passwd;
289                         my @l = @{$self->{passwd}};
290                         my $str = "$pw[$l[0]].*$pw[$l[1]].*$pw[$l[2]].*$pw[$l[3]].*$pw[$l[4]]";
291                         if ($cmdline =~ /$str/) {
292                                 $self->{priv} = $self->{user}->priv;
293                         } else {
294                                 $self->send($self->msg('sorry'));
295                         }
296                 } else {
297                         $self->send($self->msg('sorry'));
298                 }
299                 $self->state('prompt');
300         } elsif ($self->{state} eq 'passwd') {
301                 my $passwd = $self->{user}->passwd;
302                 if ($passwd && $cmdline eq $passwd) {
303                         $self->send($self->msg('pw1'));
304                         $self->state('passwd1');
305                 } else {
306                         $self->conn->{echo} = $self->conn->{decho};
307                         delete $self->conn->{decho};
308                         $self->send($self->msg('sorry'));
309                         $self->state('prompt');
310                 }
311         } elsif ($self->{state} eq 'passwd1') {
312                 $self->{passwd} = $cmdline;
313                 $self->send($self->msg('pw2'));
314                 $self->state('passwd2');
315         } elsif ($self->{state} eq 'passwd2') {
316                 if ($cmdline eq $self->{passwd}) {
317                         $self->{user}->passwd($cmdline);
318                         $self->send($self->msg('pw3'));
319                 } else {
320                         $self->send($self->msg('pw4'));
321                 }
322                 $self->conn->{echo} = $self->conn->{decho};
323                 delete $self->conn->{decho};
324                 $self->state('prompt');
325         } elsif ($self->{state} eq 'talk' || $self->{state} eq 'chat') {
326                 if ($cmdline =~ m{^(?:/EX|/ABORT)}i) {
327                         for (@{$self->{talklist}}) {
328                                 if ($self->{state} eq 'talk') {
329                                         $self->send_talks($_,  $self->msg('talkend'));
330                                 } else {
331                                         $self->local_send('C', $self->msg('chatend', $_));
332                                 }
333                         }
334                         $self->state('prompt');
335                         delete $self->{talklist};
336                 } elsif ($cmdline =~ m|^/+\w+|) {
337                         $cmdline =~ s|^/||;
338                         my $sendit = $cmdline =~ s|^/+||;
339                         my @in = $self->run_cmd($cmdline);
340                         $self->send_ans(@in);
341                         if ($sendit && $self->{talklist} && @{$self->{talklist}}) {
342                                 foreach my $l (@in) {
343                                         my @bad;
344                                         if (@bad = BadWords::check($l)) {
345                                                 $self->badcount(($self->badcount||0) + @bad);
346                                                 LogDbg('DXCommand', "$self->{call} swore: $l with words:" . join(',', @bad) . ")");
347                                         } else {
348                                                 for (@{$self->{talklist}}) {
349                                                         if ($self->{state} eq 'talk') {
350                                                                 $self->send_talks($_, $l);
351                                                         } else {
352                                                                 send_chats($self, $_, $l)
353                                                         }
354                                                 }
355                                         }
356                                 }
357                         }
358                         $self->send($self->{state} eq 'talk' ? $self->talk_prompt : $self->chat_prompt);
359                 } elsif ($self->{talklist} && @{$self->{talklist}}) {
360                         # send what has been said to whoever is in this person's talk list
361                         my @bad;
362                         if (@bad = BadWords::check($cmdline)) {
363                                 $self->badcount(($self->badcount||0) + @bad);
364                                 LogDbg('DXCommand', "$self->{call} swore: $cmdline with words:" . join(',', @bad) . ")");
365                         } else {
366                                 for (@{$self->{talklist}}) {
367                                         if ($self->{state} eq 'talk') {
368                                                 $self->send_talks($_, $rawline);
369                                         } else {
370                                                 send_chats($self, $_, $rawline);
371                                         }
372                                 }
373                         }
374                         $self->send($self->talk_prompt) if $self->{state} eq 'talk';
375                         $self->send($self->chat_prompt) if $self->{state} eq 'chat';
376                 } else {
377                         # for safety
378                         $self->state('prompt');
379                 }
380         } elsif (my $func = $self->{func}) {
381                 no strict 'refs';
382                 my @ans;
383                 if (ref $self->{edit}) {
384                         eval { @ans = $self->{edit}->$func($self, $rawline)};
385                 } else {
386                         eval {  @ans = &{$self->{func}}($self, $rawline) };
387                 }
388                 if ($@) {
389                         $self->send_ans("Syserr: on stored func $self->{func}", $@);
390                         delete $self->{func};
391                         $self->state('prompt');
392                         undef $@;
393                 }
394                 $self->send_ans(@ans);
395         } else {
396                 $self->send_ans(run_cmd($self, $cmdline));
397         } 
398
399         # check for excessive swearing
400         if ($self->{badcount} && $self->{badcount} >= $maxbadcount) {
401                 LogDbg('DXCommand', "$self->{call} logged out for excessive swearing");
402                 $self->disconnect;
403                 return;
404         }
405
406         # send a prompt only if we are in a prompt state
407         $self->prompt() if $self->{state} =~ /^prompt/o;
408 }
409
410 # send out the talk messages taking into account vias and connectivity
411 sub send_talks
412 {
413         my ($self, $ent, $line) = @_;
414         
415         my ($to, $via) = $ent =~ /(\S+)>(\S+)/;
416         $to = $ent unless $to;
417         my $call = $via && $via ne '*' ? $via : $to;
418         my $clref = Route::get($call);
419         my $dxchan = $clref->dxchan if $clref;
420         if ($dxchan) {
421                 $dxchan->talk($self->{call}, $to, undef, $line);
422         } else {
423                 $self->send($self->msg('disc2', $via ? $via : $to));
424                 my @l = grep { $_ ne $ent } @{$self->{talklist}};
425                 if (@l) {
426                         $self->{talklist} = \@l;
427                 } else {
428                         delete $self->{talklist};
429                         $self->state('prompt');
430                 }
431         }
432 }
433
434 sub send_chats
435 {
436         my $self = shift;
437         my $target = shift;
438         my $text = shift;
439
440         my $msgid = DXProt::nextchatmsgid();
441         $text = "#$msgid $text";
442         $main::me->normal(DXProt::pc93($target, $self->{call}, undef, $text));
443 }
444
445 sub special_prompt
446 {
447         my $self = shift;
448         my $prompt = shift;
449         my @call;
450         for (@{$self->{talklist}}) {
451                 my ($to, $via) = /(\S+)>(\S+)/;
452                 $to = $_ unless $to;
453                 push @call, $to;
454         }
455         return $self->msg($prompt, join(',', @call));
456 }
457
458 sub talk_prompt
459 {
460         my $self = shift;
461         return $self->special_prompt('talkprompt');
462 }
463
464 sub chat_prompt
465 {
466         my $self = shift;
467         return $self->special_prompt('chatprompt');
468 }
469
470 #
471 # send a load of stuff to a command user with page prompting
472 # and stuff
473 #
474
475 sub send_ans
476 {
477         my $self = shift;
478         
479         if ($self->{pagelth} && @_ > $self->{pagelth}) {
480                 my $i;
481                 for ($i = $self->{pagelth}; $i-- > 0; ) {
482                         my $line = shift @_;
483                         $line =~ s/\s+$//o;     # why am having to do this? 
484                         $self->send($line);
485                 }
486                 $self->{pagedata} =  [ @_ ];
487                 $self->state('page');
488                 $self->send($self->msg('page', scalar @_));
489         } else {
490                 for (@_) {
491                         if (defined $_) {
492                                 $self->send($_);
493                         } else {
494                                 $self->send('');
495                         }
496                 }
497         } 
498 }
499
500
501 # this is the thing that preps for running the command, it is done like this for the 
502 # benefit of remote command execution
503 #
504
505 sub run_cmd
506 {
507         my $self = shift;
508         my $user = $self->{user};
509         my $call = $self->{call};
510         my $cmdline = shift;
511         my @ans;
512         
513         return () if length $cmdline == 0;
514         
515         # split the command line up into parts, the first part is the command
516         my ($cmd, $args) = split /\s+/, $cmdline, 2;
517         $args = "" unless defined $args;
518                 
519         if ($cmd) {
520
521                 # check cmd
522                 if ($cmd =~ m|^/| || $cmd =~ m|[^-?\w/]|) {
523                         LogDbg('DXCommand', "cmd: $self->{call} - invalid characters in '$cmd'");
524                         return $self->_error_out('e1');
525                 }
526
527                 # strip out // on command only
528                 $cmd =~ s|//|/|g;
529                                         
530                 my ($path, $fcmd);
531                         
532                 dbg("cmd: $cmd") if isdbg('command');
533                         
534                 # alias it if possible
535                 my $acmd = CmdAlias::get_cmd($cmd);
536                 if ($acmd) {
537                         ($cmd, $args) = split /\s+/, "$acmd $args", 2;
538                         $args = "" unless defined $args;
539                         dbg("cmd: aliased $cmd $args") if isdbg('command');
540                 }
541                         
542                 # first expand out the entry to a command
543                 ($path, $fcmd) = search($main::localcmd, $cmd, "pl");
544                 ($path, $fcmd) = search($main::cmd, $cmd, "pl") unless $path && $fcmd;
545
546                 if ($path && $cmd) {
547                         dbg("cmd: path $cmd cmd: $fcmd") if isdbg('command');
548                         
549                         my $package = find_cmd_name($path, $fcmd);
550                         return ($@) if $@;
551                                 
552                         if ($package && $self->can("${package}::handle")) {
553                                 no strict 'refs';
554                                 dbg("cmd: package $package") if isdbg('command');
555                                 my $t0 = [gettimeofday];
556                                 eval { @ans = &{"${package}::handle"}($self, $args) };
557                                 if ($@) {
558                                         DXDebug::dbgprintring(25);
559                                         return (DXDebug::shortmess($@));
560                                 }
561                                 if (isdbg('progress')) {
562                                         my $msecs = _diffms($t0);
563                                         my $s = "CMD: '$cmd $args' by $call ip: $self->{hostname} ${msecs}mS";
564                                         dbg($s) if $cmd !~ /^(?:echo|blank)/ || isdbg('echo');     # cut down a bit on HRD and other clients' noise
565                                 }
566                         } else {
567                                 dbg("cmd: $package not present") if isdbg('command');
568                                 return $self->_error_out('e1');
569                         }
570                 } else {
571                         dbg("cmd: $cmd not found") if isdbg('command');
572                         return $self->_error_out('e1');
573                 }
574         }
575         
576         my $ok = shift @ans;
577         if ($ok) {
578                 delete $self->{errors};
579         } else {
580                 if (++$self->{errors} > $DXChannel::maxerrors) {
581                         $self->send($self->msg('e26'));
582                         $self->disconnect;
583                         return ();
584                 }
585         }
586         return map {s/([^\s])\s+$/$1/; $_} @ans;
587 }
588
589 #
590 # This is called from inside the main cluster processing loop and is used
591 # for despatching commands that are doing some long processing job
592 #
593 sub process
594 {
595         my $t = time;
596         my @dxchan = DXChannel::get_all();
597         my $dxchan;
598
599         $users = 0;
600         foreach $dxchan (@dxchan) {
601                 next unless $dxchan->is_user;  
602         
603                 # send a outstanding message prompt if required
604                 if ($t >= $dxchan->lastmsgpoll + $msgpolltime) {
605                         $dxchan->send($dxchan->msg('m9')) if DXMsg::for_me($dxchan->call);
606                         $dxchan->lastmsgpoll($t);
607                 }
608                 
609                 # send a prompt if no activity out on this channel
610                 if ($t >= $dxchan->t + $main::user_interval) {
611                         $dxchan->prompt() if $dxchan->{state} =~ /^prompt/o;
612                         $dxchan->t($t);
613                 }
614                 ++$users;
615                 $maxusers = $users if $users > $maxusers;
616         }
617
618         while (my ($k, $v) = each %nothereslug) {
619                 if ($main::systime >= $v + 300) {
620                         delete $nothereslug{$k};
621                 }
622         }
623
624         import_cmd();
625 }
626
627 #
628 # finish up a user context
629 #
630 sub disconnect
631 {
632         my $self = shift;
633         my $call = $self->call;
634
635         return if $self->{disconnecting}++;
636
637         delete $self->{senddbg};
638
639         my $uref = Route::User::get($call);
640         my @rout;
641         if ($uref) {
642 #               @rout = $main::routeroot->del_user($uref);
643                 @rout = DXProt::_del_thingy($main::routeroot, [$call, 0]);
644
645                 dbg("B/C PC17 on $main::mycall for: $call") if isdbg('route');
646
647                 # issue a pc17 to everybody interested
648                 $main::me->route_pc17($main::mycall, undef, $main::routeroot, $uref);
649                 $main::me->route_pc92d($main::mycall, undef, $main::routeroot, $uref) unless $DXProt::pc92_slug_changes;
650         } else {
651                 confess "trying to disconnect a non existant user $call";
652         }
653
654         # I was the last node visited
655     $self->user->node($main::mycall);
656                 
657         # send info to all logged in thingies
658         $self->tell_login('logoutu');
659         $self->tell_buddies('logoutb');
660
661         LogDbg('DXCommand', "$call disconnected");
662
663         $self->SUPER::disconnect;
664 }
665
666 #
667 # short cut to output a prompt
668 #
669
670 sub prompt
671 {
672         my $self = shift;
673
674         return if $self->{gtk};         # 'cos prompts are not a concept that applies here
675         
676         my $call = $self->call;
677         my $date = cldate($main::systime);
678         my $time = ztime($main::systime);
679         my $prompt = $self->{prompt} || $self->msg('pr');
680
681         $call = "($call)" unless $self->here;
682         $prompt =~ s/\%C/$call/g;
683         $prompt =~ s/\%D/$date/g;
684         $prompt =~ s/\%T/$time/g;
685         $prompt =~ s/\%M/$main::mycall/g;
686         
687         $self->send($prompt);
688 }
689
690 # broadcast a message to all users [except those mentioned after buffer]
691 sub broadcast
692 {
693         my $pkg = shift;                        # ignored
694         my $s = shift;                          # the line to be rebroadcast
695         
696     foreach my $dxchan (DXChannel::get_all()) {
697                 next unless $dxchan->is_user; # only interested in user channels  
698                 next if grep $dxchan == $_, @_;
699                 $dxchan->send($s);                      # send it
700         }
701 }
702
703 # gimme all the users
704 sub get_all
705 {
706         goto &DXChannel::get_all_users;
707 }
708
709 # run a script for this user
710 sub run_script
711 {
712         my $self = shift;
713         my $silent = shift || 0;
714         
715 }
716
717 #
718 # search for the command in the cache of short->long form commands
719 #
720
721 sub search
722 {
723         my ($path, $short_cmd, $suffix) = @_;
724         my ($apath, $acmd);
725         
726         # commands are lower case
727         $short_cmd = lc $short_cmd;
728         dbg("command: $path $short_cmd\n") if isdbg('command');
729
730         # do some checking for funny characters
731         return () if $short_cmd =~ /\/$/;
732
733         # return immediately if we have it
734         ($apath, $acmd) = split ',', $cmd_cache{$short_cmd} if $cmd_cache{$short_cmd};
735         if ($apath && $acmd) {
736                 dbg("cached $short_cmd = ($apath, $acmd)\n") if isdbg('command');
737                 return ($apath, $acmd);
738         }
739         
740         # if not guess
741         my @parts = split '/', $short_cmd;
742         my $dirfn;
743         my $curdir = $path;
744         
745         while (my $p = shift @parts) {
746                 opendir(D, $curdir) or confess "can't open $curdir $!";
747                 my @ls = readdir D;
748                 closedir D;
749
750                 # if this isn't the last part
751                 if (@parts) {
752                         my $found;
753                         foreach my $l (sort @ls) {
754                                 next if $l =~ /^\./;
755                                 if ((-d "$curdir/$l") && $p eq substr($l, 0, length $p)) {
756                                         dbg("got dir: $curdir/$l\n") if isdbg('command');
757                                         $dirfn .= "$l/";
758                                         $curdir .= "/$l";
759                                         $found++;
760                                         last;
761                                 }
762                         }
763                         # only proceed if we find the directory asked for
764                         return () unless $found;
765                 } else {
766                         foreach my $l (sort @ls) {
767                                 next if $l =~ /^\./;
768                                 next unless $l =~ /\.$suffix$/;
769                                 if ($p eq substr($l, 0, length $p)) {
770                                         $l =~ s/\.$suffix$//;
771                                         $dirfn = "" unless $dirfn;
772                                         $cmd_cache{$short_cmd} = join(',', ($path, "$dirfn$l")); # cache it
773                                         dbg("got path: $path cmd: $dirfn$l\n") if isdbg('command');
774                                         return ($path, "$dirfn$l");
775                                 }
776                         }
777                 }
778         }
779
780         return ();  
781 }  
782
783 # clear the command name cache
784 sub clear_cmd_cache
785 {
786         no strict 'refs';
787         
788         for my $k (keys %Cache) {
789                 unless ($k =~ /cmd_cache/) {
790                         dbg("Undefining cmd $k") if isdbg('command');
791                         undef $DXCommandmode::{"${k}::"};
792                 }
793         }
794         %cmd_cache = ();
795         %Cache = ( cmd_clear_cmd_cache  => $Cache{cmd_clear_cmd_cache} );
796 }
797
798 #
799 # the persistant execution of things from the command directories
800 #
801 #
802 # This allows perl programs to call functions dynamically
803
804 # This has been nicked directly from the perlembed pages
805 #
806 #require Devel::Symdump;  
807
808 sub valid_package_name {
809         my $string = shift;
810         $string =~ s|([^A-Za-z0-9_/])|sprintf("_%2x",unpack("C",$1))|eg;
811         
812         $string =~ s|/|_|g;
813         return "cmd_$string";
814 }
815
816
817 # this bit of magic finds a command in the offered directory
818 sub find_cmd_name {
819         my $path = shift;
820         my $cmdname = shift;
821         my $package = valid_package_name($cmdname);
822         my $filename = "$path/$cmdname.pl";
823         my $mtime = -M $filename;
824         
825         # return if we can't find it
826         $errstr = undef;
827         unless (defined $mtime) {
828                 $errstr = DXM::msg('e1');
829                 return undef;
830         }
831         
832         if(exists $Cache{$package} && exists $Cache{$package}->{mtime} && $Cache{$package}->{mtime} <= $mtime) {
833                 #we have compiled this subroutine already,
834                 #it has not been updated on disk, nothing left to do
835                 #print STDERR "already compiled $package->handler\n";
836                 dbg("find_cmd_name: $package cached") if isdbg('command');
837         } else {
838
839                 my $sub = readfilestr($filename);
840                 unless ($sub) {
841                         $errstr = "Syserr: can't open '$filename' $!";
842                         return undef;
843                 };
844                 
845                 #wrap the code into a subroutine inside our unique package
846                 my $eval = qq(package DXCommandmode::$package; use 5.10.1; use POSIX qw{:math_h}; use DXLog; use DXDebug; use DXUser; use DXUtil; our \@ISA = qw{DXCommandmode}; );
847
848
849                 if ($sub =~ m|\s*sub\s+handle\n|) {
850                         $eval .= $sub;
851                 } else {
852                         $eval .= qq(sub handle { $sub });
853                 }
854                 
855                 if (isdbg('eval')) {
856                         my @list = split /\n/, $eval;
857                         my $line;
858                         for (@list) {
859                                 dbg($_ . "\n") if isdbg('eval');
860                         }
861                 }
862                 
863                 # get rid of any existing sub and try to compile the new one
864                 no strict 'refs';
865
866                 if (exists $Cache{$package}) {
867                         dbg("find_cmd_name: Redefining $package") if isdbg('command');
868                         undef $DXCommandmode::{"${package}::"};
869                         delete $Cache{$package};
870                 } else {
871                         dbg("find_cmd_name: Defining $package") if isdbg('command');
872                 }
873
874                 eval $eval;
875
876                 $Cache{$package} = {mtime => $mtime } unless $@;
877         }
878
879         return "DXCommandmode::$package";
880 }
881
882 sub send
883 {
884         my $self = shift;
885         if ($self->{gtk}) {
886                 for (@_) {
887                         $self->SUPER::send(dd(['cmd',$_]));
888                 }
889         } else {
890                 $self->SUPER::send(@_);
891         }
892 }
893
894 sub local_send
895 {
896         my ($self, $let, $buf) = @_;
897         if ($self->{state} eq 'prompt' || $self->{state} eq 'talk' || $self->{state} eq 'chat') {
898                 if ($self->{enhanced}) {
899                         $self->send_later($let, $buf);
900                 } else {
901                         $self->send($buf);
902                 }
903         } else {
904                 $self->delay($buf);
905         }
906 }
907
908 # send a talk message here
909 sub talk
910 {
911         my ($self, $from, $to, $via, $line, $onode) = @_;
912         $line =~ s/\\5E/\^/g;
913         if ($self->{talk}) {
914                 if ($self->{gtk}) {
915                         $self->local_send('T', dd(['talk',$to,$from,$via,$line]));
916                 } else {
917                         $self->local_send('T', "$to de $from: $line");
918                 }
919         }
920         Log('talk', $to, $from, '<' . ($onode || '*'), $line);
921         # send a 'not here' message if required
922         unless ($self->{here} && $from ne $to) {
923                 my $key = "$to$from";
924                 unless (exists $nothereslug{$key}) {
925                         my ($ref, $dxchan);
926                         if (($ref = Route::get($from)) && ($dxchan = $ref->dxchan)) {
927                                 my $name = $self->user->name || $to;
928                                 my $s = $self->user->nothere || $dxchan->msg('nothere', $name);
929                                 $nothereslug{$key} = $main::systime;
930                                 $dxchan->talk($to, $from, undef, $s);
931                         }
932                 }
933         }
934 }
935
936 # send an announce
937 sub announce
938 {
939         my $self = shift;
940         my $line = shift;
941         my $isolate = shift;
942         my $to = shift;
943         my $target = shift;
944         my $text = shift;
945         my ($filter, $hops);
946
947         if (!$self->{ann_talk} && $to ne $self->{call}) {
948                 my $call = AnnTalk::is_talk_candidate($_[0], $text);
949                 return if $call;
950         }
951
952         if ($self->{annfilter}) {
953                 ($filter, $hops) = $self->{annfilter}->it(@_ );
954                 return unless $filter;
955         }
956
957         unless ($self->{ann}) {
958                 return if $_[0] ne $main::myalias && $_[0] ne $main::mycall;
959         }
960         return if $target eq 'SYSOP' && $self->{priv} < 5;
961         my $buf;
962         if ($self->{gtk}) {
963                 $buf = dd(['ann', $to, $target, $text, @_])
964         } else {
965                 $buf = "$to$target de $_[0]: $text";
966                 #$buf =~ s/\%5E/^/g;
967                 $buf .= "\a\a" if $self->{beep};
968         }
969         $self->local_send($target eq 'WX' ? 'W' : 'N', $buf);
970 }
971
972 # send a chat
973 sub chat
974 {
975         my $self = shift;
976         my $line = shift;
977         my $isolate = shift;
978         my $target = shift;
979         my $to = shift;
980         my $text = shift;
981         my ($filter, $hops);
982
983         return unless grep uc $_ eq $target, @{$self->{user}->{group}};
984         
985         $text =~ s/^\#\d+ //;
986         my $buf;
987         if ($self->{gtk}) {
988                 $buf = dd(['chat', $to, $target, $text, @_])
989         } else {
990                 $buf = "$target de $_[0]: $text";
991                 #$buf =~ s/\%5E/^/g;
992                 $buf .= "\a\a" if $self->{beep};
993         }
994         $self->local_send('C', $buf);
995 }
996
997 sub format_dx_spot
998 {
999         my $self = shift;
1000
1001         my $t = ztime($_[2]);
1002         my $loc = '';
1003         my $clth = 31 + $self->{width} - 80;    # allow comment to grow according the screen width 
1004         #       --$clth if $self->{consort} eq 'local';
1005         
1006         my $comment = substr (($_[3] || ''), 0, $clth);
1007         $comment =~ s/\t/ /g;
1008         
1009         $comment .= ' ' x ($clth - (length($comment)));
1010         
1011     if ($self->{user}->wantgrid) {
1012                 my $ref = DXUser::get_current($_[1]);
1013                 if ($ref && $ref->qra) {
1014                         my $cloc = ' ' . substr($ref->qra, 0, 4);
1015                         $comment = substr $comment, 0,  ($clth - (length($comment)+length($cloc)));
1016                         $comment .= $cloc;
1017                 }
1018                 my $origin = $_[4];
1019                 $origin =~ s/-#$//;                     # sigh......
1020                 $ref = DXUser::get_current($origin);
1021                 if ($ref && $ref->qra) {
1022                         $loc = ' ' . substr($ref->qra, 0, 4);
1023                 }
1024         } elsif ($self->{user}->wantdxitu) {
1025                 $loc = ' ' . sprintf("%2d", $_[10]) if defined $_[10];
1026                 $comment = substr($comment, 0,  $clth-3) . ' ' . sprintf("%2d", $_[8]) if defined $_[8]; 
1027         } elsif ($self->{user}->wantdxcq) {
1028                 $loc = ' ' . sprintf("%2d", $_[11]) if defined $_[11];
1029                 $comment = substr($comment, 0, $clth-3) . ' ' . sprintf("%2d", $_[9]) if defined $_[9]; 
1030         } elsif ($self->{user}->wantusstate) {
1031                 $loc = ' ' . $_[13] if $_[13];
1032                 $comment = substr($comment, 0,  $clth-3) . ' ' . $_[12] if $_[12]; 
1033         }
1034
1035         return sprintf "DX de %-9.9s%10.1f %-12.12s %-s $t$loc", "$_[4]:", $_[0], $_[1], $comment;
1036 }
1037
1038 # send a dx spot
1039 sub dx_spot
1040 {
1041         my $self = shift;
1042         my $line = shift;
1043         my $isolate = shift;
1044         return unless $self->{dx};
1045
1046         my ($filter, $hops);
1047
1048         if ($self->{spotsfilter}) {
1049                 ($filter, $hops) = $self->{spotsfilter}->it(@_ );
1050                 return unless $filter;
1051         }
1052
1053         dbg('spot: "' . join('","', @_) . '"') if isdbg('dxspot');
1054
1055         my $buf;
1056         if ($self->{ve7cc}) {
1057                 $buf = VE7CC::dx_spot($self, @_);
1058         } elsif ($self->{gtk}) {
1059                 my ($dxloc, $byloc);
1060
1061                 my $ref = DXUser::get_current($_[4]);
1062                 if ($ref) {
1063                         $byloc = $ref->qra;
1064                         $byloc = substr($byloc, 0, 4) if $byloc;
1065                 }
1066
1067                 my $spot = $_[1];
1068                 $spot =~ s|/\w{1,4}$||;
1069                 $ref = DXUser::get_current($spot);
1070                 if ($ref) {
1071                         $dxloc = $ref->qra;
1072                         $dxloc = substr($dxloc, 0, 4) if $dxloc;
1073                 }
1074                 $buf = dd(['dx', @_, ($dxloc||''), ($byloc||'')]);
1075                 
1076         } else {
1077                 $buf = $self->format_dx_spot(@_);
1078                 $buf .= "\a\a" if $self->{beep};
1079                 #$buf =~ s/\%5E/^/g;
1080         }
1081
1082         $self->local_send('X', $buf);
1083 }
1084
1085 sub wwv
1086 {
1087         my $self = shift;
1088         my $line = shift;
1089         my $isolate = shift;
1090         my ($filter, $hops);
1091
1092         return unless $self->{wwv};
1093         
1094         if ($self->{wwvfilter}) {
1095                 ($filter, $hops) = $self->{wwvfilter}->it(@_[7..$#_] );
1096                 return unless $filter;
1097         }
1098
1099         my $buf;
1100         if ($self->{gtk}) {
1101                 $buf = dd(['wwv', @_])
1102         } else {
1103                 $buf = "WWV de $_[6] <$_[1]>:   SFI=$_[2], A=$_[3], K=$_[4], $_[5]";
1104                 $buf .= "\a\a" if $self->{beep};
1105         }
1106         
1107         $self->local_send('V', $buf);
1108 }
1109
1110 sub wcy
1111 {
1112         my $self = shift;
1113         my $line = shift;
1114         my $isolate = shift;
1115         my ($filter, $hops);
1116
1117         return unless $self->{wcy};
1118         
1119         if ($self->{wcyfilter}) {
1120                 ($filter, $hops) = $self->{wcyfilter}->it(@_ );
1121                 return unless $filter;
1122         }
1123
1124         my $buf;
1125         if ($self->{gtk}) {
1126                 $buf = dd(['wcy', @_])
1127         } else {
1128                 $buf = "WCY de $_[10] <$_[1]> : K=$_[4] expK=$_[5] A=$_[3] R=$_[6] SFI=$_[2] SA=$_[7] GMF=$_[8] Au=$_[9]";
1129                 $buf .= "\a\a" if $self->{beep};
1130         }
1131         $self->local_send('Y', $buf);
1132 }
1133
1134 # broadcast debug stuff to all interested parties
1135 sub broadcast_debug
1136 {
1137         my $s = shift;                          # the line to be rebroadcast
1138         
1139         foreach my $dxchan (DXChannel::get_all_users) {
1140                 next unless $dxchan->{enhanced} && $dxchan->{senddbg};
1141                 if ($dxchan->{gtk}) {
1142                         $dxchan->send_later('L', dd(['db', $s]));
1143                 } else {
1144                         $dxchan->send_later('L', $s);
1145                 }
1146         }
1147 }
1148
1149 sub do_entry_stuff
1150 {
1151         my $self = shift;
1152         my $line = shift;
1153         my @out;
1154         
1155         if ($self->state eq 'enterbody') {
1156                 my $loc = $self->{loc} || confess "local var gone missing" ;
1157                 if ($line eq "\032" || $line eq '%1A' || uc $line eq "/EX") {
1158                         no strict 'refs';
1159                         push @out, &{$loc->{endaction}}($self);          # like this for < 5.8.0
1160                         $self->func(undef);
1161                         $self->state('prompt');
1162                 } elsif ($line eq "\031" || uc $line eq "/ABORT" || uc $line eq "/QUIT") {
1163                         push @out, $self->msg('m10');
1164                         delete $loc->{lines};
1165                         delete $self->{loc};
1166                         $self->func(undef);
1167                         $self->state('prompt');
1168                 } else {
1169                         push @{$loc->{lines}}, length($line) > 0 ? $line : " ";
1170                         # i.e. it ain't and end or abort, therefore store the line
1171                 }
1172         } else {
1173                 confess "Invalid state $self->{state}";
1174         }
1175         return @out;
1176 }
1177
1178 sub store_startup_script
1179 {
1180         my $self = shift;
1181         my $loc = $self->{loc} || confess "local var gone missing" ;
1182         my @out;
1183         my $call = $loc->{call} || confess "callsign gone missing";
1184         confess "lines array gone missing" unless ref $loc->{lines};
1185         my $r = Script::store($call, $loc->{lines});
1186         if (defined $r) {
1187                 if ($r) {
1188                         push @out, $self->msg('m19', $call, $r);
1189                 } else {
1190                         push @out, $self->msg('m20', $call);
1191                 }
1192         } else {
1193                 push @out, "error opening startup script $call $!";
1194         } 
1195         return @out;
1196 }
1197
1198 # Import any commands contained in any files in import_cmd directory
1199 #
1200 # If the filename has a recogisable callsign as some delimited part
1201 # of it, then this is the user the command will be run as. 
1202 #
1203 sub import_cmd
1204 {
1205         # are there any to do in this directory?
1206         return unless -d $cmdimportdir;
1207         unless (opendir(DIR, $cmdimportdir)) {
1208                 LogDbg('err', "can\'t open $cmdimportdir $!");
1209                 return;
1210         } 
1211
1212         my @names = readdir(DIR);
1213         closedir(DIR);
1214         my $name;
1215
1216         return unless @names;
1217         
1218         foreach $name (@names) {
1219                 next if $name =~ /^\./;
1220
1221                 my $s = Script->new($name, $cmdimportdir);
1222                 if ($s) {
1223                         LogDbg('DXCommand', "Run import cmd file $name");
1224                         my @cat = split /[^A-Za-z0-9]+/, $name;
1225                         my ($call) = grep {is_callsign(uc $_)} @cat;
1226                         $call ||= $main::mycall;
1227                         $call = uc $call;
1228                         my @out;
1229                         
1230                         
1231                         $s->inscript(0);        # switch off script checks
1232                         
1233                         if ($call eq $main::mycall) {
1234                                 @out = $s->run($main::me, 1);
1235                         } else {
1236                                 my $dxchan = DXChannel::get($call);
1237                             if ($dxchan) {
1238                                         @out = $s->run($dxchan, 1);
1239                                 } else {
1240                                         my $u = DXUser::get($call);
1241                                         if ($u) {
1242                                                 $dxchan = $main::me;
1243                                                 my $old = $dxchan->{call};
1244                                                 my $priv = $dxchan->{priv};
1245                                                 my $user = $dxchan->{user};
1246                                                 $dxchan->{call} = $call;
1247                                                 $dxchan->{priv} = $u->priv;
1248                                                 $dxchan->{user} = $u;
1249                                                 @out = $s->run($dxchan, 1);
1250                                                 $dxchan->{call} = $old;
1251                                                 $dxchan->{priv} = $priv;
1252                                                 $dxchan->{user} = $user;
1253                                         } else {
1254                                                 LogDbg('err', "Trying to run import cmd for non-existant user $call");
1255                                         }
1256                                 }
1257                         }
1258                         $s->erase;
1259                         for (@out) {
1260                                 LogDbg('DXCommand', "Import cmd $name/$call: $_");
1261                         }
1262                 } else {
1263                         LogDbg('err', "Failed to open $cmdimportdir/$name $!");
1264                         unlink "$cmdimportdir/$name";
1265                 }
1266         }
1267 }
1268
1269 sub print_find_reply
1270 {
1271         my ($self, $node, $target, $flag, $ms) = @_;
1272         my $sort = $flag == 2 ? "External" : "Local";
1273         $self->send("$sort $target found at $node in $ms ms" );
1274 }
1275
1276 # send the most relevant motd
1277 sub send_motd
1278 {
1279         my $self = shift;
1280         my $motd;
1281
1282         unless ($self->{registered}) {
1283                 $motd = "${main::motd}_nor_$self->{lang}";
1284                 $motd = "${main::motd}_nor" unless -e $motd;
1285         }
1286         $motd = "${main::motd}_$self->{lang}" unless $motd && -e $motd;
1287         $motd = $main::motd unless $motd && -e $motd;
1288         if ($self->conn->ax25) {
1289                 if ($motd) {
1290                         $motd = "${motd}_ax25" if -e "${motd}_ax25";
1291                 } else {
1292                         $motd = "${main::motd}_ax25" if -e "${main::motd}_ax25";
1293                 }
1294         }
1295         $self->send_file($motd) if -e $motd;
1296 }
1297
1298
1299 # Punt off a long running command into a separate process
1300 #
1301 # This is called from commands to run some potentially long running
1302 # function. The process forks and then runs the function and returns
1303 # the result back to the cmd. 
1304 #
1305 # NOTE: this merely forks the current process and then runs the cmd in that (current) context.
1306 #       IT DOES NOT START UP SOME NEW PROGRAM AND RELIES ON THE FACT THAT IT IS RUNNING DXSPIDER 
1307 #       THE CURRENT CONTEXT!!
1308
1309 # call: $self->spawn_cmd($original_cmd_line, \<function>, [cb => sub{...}], [prefix => "cmd> "], [progress => 0|1], [args => [...]]);
1310 sub spawn_cmd
1311 {
1312         my $self = shift;
1313         my $line = shift;
1314         my $cmdref = shift;
1315         my $call = $self->{call};
1316         my %args = @_;
1317         my @out;
1318         
1319         my $cb = delete $args{cb};
1320         my $prefix = delete $args{prefix};
1321         my $progress = delete $args{progress};
1322         my $args = delete $args{args} || [];
1323         my $t0 = [gettimeofday];
1324
1325         no strict 'refs';
1326
1327         # just behave normally if something has set the "one-shot" _nospawn in the channel
1328         if ($self->{_nospawn}) {
1329                 eval { @out = $cmdref->(@$args); };
1330                 if ($@) {
1331                         DXDebug::dbgprintring(25);
1332                         push @out, DXDebug::shortmess($@);
1333                 }
1334                 return @out;
1335         }
1336         
1337         my $fc = DXSubprocess->new;
1338 #       $fc->serializer(\&encode_json);
1339 #       $fc->deserializer(\&decode_json);
1340         $fc->run(
1341                          sub {
1342                                  my $subpro = shift;
1343                                  if (isdbg('progress')) {
1344                                          my $s = qq{$call line: "$line"};
1345                                          $s .= ", args: " . join(', ', map { defined $_ ? qq{'$_'} : q{'undef'} } @$args) if $args && @$args;
1346                                          dbg($s);
1347                                  }
1348                                  eval {
1349                                          ++$self->{_in_sub_process};
1350                                          dbg "\$self->{_in_sub_process} = $self->{_in_sub_process}";
1351                                          @out = $cmdref->(@$args);
1352                                          --$self->{_in_sub_process} if $self->{_in_sub_process} > 0;
1353                                  };
1354                                  if ($@) {
1355                                          DXDebug::dbgprintring(25);
1356                                          push @out, DXDebug::shortmess($@);
1357                                  }
1358                                  return @out;
1359                          },
1360 #                        $args,
1361                          sub {
1362                                  my ($fc, $err, @res) = @_; 
1363                                  my $dxchan = DXChannel::get($call);
1364                                  return unless $dxchan;
1365
1366                                  if ($err) {
1367                                          my $s = "DXProt::spawn_cmd: call $call error $err";
1368                                          dbg($s) if isdbg('chan');
1369                                          $dxchan->send($s);
1370                                          return;
1371                                  }
1372                                  if ($cb) {
1373                                          # transform output if required
1374                                          @res = $cb->($dxchan, @res);
1375                                  }
1376                                  if (@res) {
1377                                          if (defined $prefix) {
1378                                                  $dxchan->send(map {"$prefix$_"} @res);
1379                                          } else {
1380                                                  $dxchan->send(@res);
1381                                          }
1382                                  }
1383                                  diffms("by $call", $line, $t0, scalar @res) if isdbg('progress');
1384                          });
1385         
1386         return @out;
1387 }
1388
1389 sub user_count
1390 {
1391         return ($users, $maxusers);
1392 }
1393 1;
1394 __END__