add thicker belt & braces to pc92 field checking
[spider.git] / perl / DXProtHandle.pm
1 #
2 #
3 # This module impliments the handlers for the protocal mode for a dx cluster
4 #
5 # Copyright (c) 1998-2007 Dirk Koopman G1TLH
6 #
7 #
8 #
9
10 package DXProt;
11
12 @ISA = qw(DXChannel);
13
14 use DXUtil;
15 use DXChannel;
16 use DXUser;
17 use DXM;
18 use DXProtVars;
19 use DXCommandmode;
20 use DXLog;
21 use Spot;
22 use DXProtout;
23 use DXDebug;
24 use Filter;
25 use Local;
26 use DXDb;
27 use AnnTalk;
28 use Geomag;
29 use WCY;
30 use BadWords;
31 use DXHash;
32 use Route;
33 use Route::Node;
34 use Script;
35 use DXCIDR;
36
37 use strict;
38 use warnings qw(all);
39 no warnings qw(uninitialized);
40
41
42
43 use vars qw($pc11_max_age $pc23_max_age $last_pc50 $eph_restime $eph_info_restime $eph_pc34_restime
44                         $last_hour $last10 %eph  %pings %rcmds $ann_to_talk
45                         $pingint $obscount %pc19list $chatdupeage $chatimportfn
46                         $investigation_int $pc19_version $myprot_version
47                         %nodehops $baddx $badspotter $badnode $censorpc
48                         $allowzero $decode_dk0wcy $send_opernam @checklist
49                         $eph_pc15_restime $pc9x_past_age $pc9x_dupe_age
50                         $pc10_dupe_age $pc92_slug_changes $last_pc92_slug
51                         $pc92Ain $pc92Cin $pc92Din $pc92Kin $pc9x_time_tolerance
52                         $pc92filterdef $senderverify $pc11_dwell_time $pc11_extract_route $pc92_ad_enabled $pc92c_ipaddr_enable
53                    );
54
55 $pc9x_dupe_age = 60;                    # catch loops of circular (usually) D records
56 $pc10_dupe_age = 45;                    # just something to catch duplicate PC10->PC93 conversions
57 $pc92_slug_changes = 60*1;              # slug any changes going outward for this long
58 $last_pc92_slug = 0;                    # the last time we sent out any delayed add or del PC92s
59 $pc9x_time_tolerance = 15*60;   # the time on a pc9x is allowed to be out by this amount
60 $pc9x_past_age = (122*60)+              # maximum age in the past of a px9x (a config record might be the only
61 $pc9x_time_tolerance;           # thing a node might send - once an hour and we allow an extra hour for luck)
62                                 # this is actually the partition between "yesterday" and "today" but old.
63 $senderverify = 0;                              # 1 - check for forged PC11 or PC61.
64                                 # 2 - if forged, dump them.
65 $pc11_dwell_time = 2;                   # number of seconds to wait for a PC61 to come to substitute the PC11
66 $pc11_extract_route = 1;                # generate missing  user route entry and IP address from passing PC61s
67
68
69 $pc92filterdef = bless ([
70                           # tag, sort, field, priv, special parser
71                           ['call', 'c', 0],
72                           ['by', 'c', 0],
73                           ['dxcc', 'nc', 1],
74                           ['itu', 'ni', 2],
75                           ['zone', 'nz', 3],
76                          ], 'Filter::Cmd');
77
78 our %pc11q;
79 # this is a place to park an incoming PC11 in the sure and certain hope that
80 # a PC61 will be along soon. This has the side benefit that it will delay a
81 # a PC11 for one second - assuming that it is not removed by a PC61 version
82
83 # incoming talk commands
84 sub handle_10
85 {
86         my $self = shift;
87         my $pcno = shift;
88         my $line = shift;
89         my $origin = shift;
90         my $pc = shift;
91
92         # this is to catch loops caused by bad software ...
93         if (eph_dup($line, $pc10_dupe_age)) {
94                 return;
95         }
96
97
98         # is it for me or one of mine?
99         my ($from, $to, $via, $call, $dxchan);
100         $from = $pc->[1];
101         if ($pc->[5] gt ' ') {
102                 $via = $pc->[2];
103                 $to = $pc->[5];
104         } else {
105                 $to = $pc->[2];
106         }
107
108         # if this is a 'nodx' node then ignore it
109         if ($badnode->in($pc->[6]) || ($via && $badnode->in($via))) {
110                 dbg($line) if isdbg('nologchan');
111                 dbg("PCPROT: Bad Node, dropped");
112                 return;
113         }
114
115
116         my $nossid = $from;
117         $nossid =~ s/-\d+$//;
118         if ($badspotter->in($nossid)) {
119                 dbg($line) if isdbg('nologchan');
120                 dbg("PCPROT: Bad Spotter, dropped");
121                 return;
122         }
123
124         # if we are converting announces to talk is it a dup?
125         if ($ann_to_talk) {
126                 if (AnnTalk::is_talk_candidate($from, $pc->[3]) && AnnTalk::dup($from, $to, $pc->[3])) {
127                         dbg("PCPROT: Dupe talk from announce, dropped") if isdbg('chanerr');
128                         return;
129                 }
130         }
131         
132         # will we allow it at all?
133         if ($censorpc) {
134                 my @bad;
135                 if (@bad = BadWords::check($pc->[3])) {
136                         my $bw = join ', ', @bad; 
137                         dbg($line) if isdbg('nologchan');
138                         dbg("PCPROT: Badwords: '$bw', dropped");
139                         return;
140                 }
141         }
142
143         # convert this to a PC93, coming from mycall with origin set and process it as such
144         my $ref = Route::get($pc->[6]);
145         my $ip = $ref->ip;
146         $main::me->normal(pc93($to, $from, $via, $pc->[3], $pc->[6]), $ip);
147 }
148
149 my %pc11_saved;                                 # delayed PC11s
150 my $pc11_rx;                                    # no of pc11 rxed
151 my $pc61_rx;                                    # no of pc61 rxed
152 my $pc11_to_61;                                 # no of 'better' pc61, that replaced stored waiting pc11
153 my $rpc11_to_61;                                # no of pc11s 'promoted' to pc61 by IP captured in routing table
154
155 # DX Spot handling
156 sub handle_11
157 {
158         my $self = shift;
159         my $pcno = shift;
160         my $line = shift;
161         my $origin = shift;
162         my $pc = shift;
163         my $recurse = shift || 0;
164
165         # route 'foreign' pc26s
166         if ($pcno == 26) {
167                 if ($pc->[7] ne $main::mycall) {
168                         $self->route($pc->[7], $line);
169                         return;
170                 }
171         }
172
173         dbg("---") if isdbg("pc11") || isdbg("pc61"); 
174         dbg("INPUT $self->{call}: $line via: $origin recurse: $recurse") if isdbg("pc11") || isdbg("pc61"); 
175
176 #       my ($hops) = $pc->[8] =~ /^H(\d+)/;
177
178         # is the spotted callsign blank? This should really be trapped earlier but it
179         # could break other protocol sentences. Also check for lower case characters.
180         if ($pc->[2] =~ /^\s*$/) {
181                 dbg($line) if isdbg('nologchan');
182                 dbg("PCPROT: blank callsign, dropped");
183                 return;
184         }
185         if ($pc->[2] =~ /[a-z]/) {
186                 dbg($line) if isdbg('nologchan');
187                 dbg("PCPROT: lowercase characters, dropped");
188                 return;
189         }
190
191
192         # if this is a 'nodx' node then ignore it
193         if ($badnode->in($pc->[7])) {
194                 dbg($line) if isdbg('nologchan');
195                 dbg("PCPROT: Bad Node $pc->[7], dropped");
196                 return;
197         }
198
199         # convert the date to a unix date
200         my $d = cltounix($pc->[3], $pc->[4]);
201         # bang out (and don't pass on) if date is invalid or the spot is too old (or too young)
202         if (!$d || (($pcno == 11 || $pcno == 61) && ($d < $main::systime - $pc11_max_age || $d > $main::systime + 900))) {
203                 dbg($line) if isdbg('nologchan');
204                 dbg("PCPROT: Spot ignored, invalid date or out of range ($pc->[3] $pc->[4])\n");
205                 return;
206         }
207
208         # is it 'baddx'
209         if ($baddx->in($pc->[2])) {
210                 dbg("PCPROT: Bad DX spot '$pc->[2]', ignored");
211                 dbg($line) if isdbg('nologchan');
212                 return;
213         }
214
215         # is it claiming to be BUST(ed)
216         $pc->[5] =~ s/^\s+//;                   # take any leading blanks off
217         $pc->[2] = unpad($pc->[2]);             # take off leading and trailing blanks from spotted callsign
218         if ($pc->[2] =~ /BUST\w*$/) {
219                 dbg($line) if isdbg('nologchan');
220                 dbg("PCPROT: useless 'BUSTED' spot") if isdbg('chanerr');
221                 return;
222         }
223         
224         my $nossid = $pc->[6];
225     $nossid =~ s/-\d+$//;
226
227         my @spot = Spot::prepare($pc->[1], $pc->[2], $d, $pc->[5], $nossid, $pc->[7], $pc->[8]);
228
229         #   $f0 = frequency
230         #   $f1 = call
231         #   $f2 = date in unix format
232         #   $f3 = comment
233         #   $f4 = spotter
234         #   $f5 = spotted dxcc country
235         #   $f6 = spotter dxcc country
236         #   $f7 = origin
237         #   $f8 = spotted itu
238         #   $f9 = spotted cq zone
239         #   $f10 = spotter itu
240         #   $f11 = spotter cq zone
241         #   $f12 = spotted us state
242         #   $f13 = spotter us state
243         #   $f14 = ip address
244
245
246         # is this is a 'bad spotter' or an unknown user then ignore it. 
247         if ($badspotter->in($nossid)) {
248                 dbg($line) if isdbg('nologchan');
249                 dbg("PCPROT: Bad Spotter $pc->[6], dropped");
250                 return;
251         }
252
253         # global spot filtering on INPUT
254         if ($self->{inspotsfilter}) {
255                 my ($filter, $hops) = $self->{inspotsfilter}->it(@spot);
256                 unless ($filter) {
257                         dbg("PCPROT: Rejected by input spot filter") if isdbg('chanerr');
258                         return;
259                 }
260         }
261
262         # Populate the routing table
263         $self->populate_routing_table($pc->[7], $pc->[6], $pc->[8]);
264         my $r = Route::User::get($pc->[6]);
265         if ($pcno == 61) {
266                 unless ($pc->[8] && is_ipaddr($pc->[8])) {
267                         dbg("PCPROT: ROUTE $self->{call} NO IP ADDRESS in '$line'!");   
268                 }
269         }
270
271         # this is where we decide to delay PC11s in the hope that a PC61 will be along soon.
272         my $key = join '|', @spot[0..2,4,7]; # not including text
273
274         unless ($recurse) {
275
276                 if ($pcno == 61) {
277
278                         if ($pc11_saved{$key}) {
279                                 # before we promote  because it's a better pc61, check that it's not a dupe (but don't insert it).
280                                 if (Spot::dup_find(@spot[0..4,7])) {
281                                         dbg("PCPROT: Duplicate Spot  $self->{call}: $pc->[0] $key ignored\n") if isdbg('chanerr') || isdbg('dupespot') || isdbg('pc11');
282                                         delete $pc11_saved{$key};
283                                         return;
284                                 }
285
286                                 ++$pc11_to_61;
287
288                                 my $percent = $pc11_rx ? $pc11_to_61 * 100 / $pc11_rx : 0;
289                                 dbg(sprintf("PROMOTED $self->{call}: BETTER $pc->[0] $key, using pc61, WAITING pc11 DUMPED: $pc61_rx pc11: $pc11_rx better pc61: $pc11_to_61 (%0.1f%%)", $percent)) if isdbg("pc11");
290
291                                 delete $pc11_saved{$key}; # because we have promoted it, no longer needed.
292
293                                 # so unlike the promotion by route, there is a stored, but uncounted PC11
294                                 # which have discarded. But we have chosen to use better PC61 that's just come in
295                                 # so we allow the PC61 to be counted later, but count the now discarded PC11
296                                 # because it *did* come in.
297                                 ++$pc11_rx;
298                         } 
299                 }
300
301                 if ($pcno == 11) {
302
303                         # if this fires then we have already had one or more PC11s but no PC61 for this spot
304                         if ($pc11_saved{$key}) {
305                                 dbg("DUPE $self->{call} $pc->[0] key: $key is saved, ignored") if isdbg("pc11");
306                                 return;         # because it's a dup
307                         }
308
309                         # before we promote by route, check that it's not been preceded by a previous PC61
310                         if (Spot::dup_find(@spot[0..4,7])) {
311                                 my $s = exists $pc11_saved{$key} ? " stored $key removed" : "";
312                                 dbg("PCPROT: Duplicate Spot $self->{call}: PC11$s, recurse: $recurse, ignored\n") if isdbg('chanerr') || isdbg('dupespot') || isdbg('pc11');
313                                 delete $pc11_saved{$key};
314                                 return;
315                         }
316
317
318                         # If we have an ip address we can promote by route
319                         if ($r && $r->ip) {
320                                 $pcno = 61;
321                                 $pc->[0] = 'PC61';
322                                 my $hops = $pc->[8];
323                                 $pc->[8] = $spot[14] = $r->ip;
324                                 ++$rpc11_to_61;
325                                 my $percent = $pc11_rx ? $rpc11_to_61 * 100 / $pc11_rx : 0;
326                                 dbg(sprintf("PROMOTED $self->{call}: ROUTE pc11 $key PROMOTED to pc61 with IP $spot[14] pc61: $pc61_rx pc11: $pc11_rx route->pc61 $rpc11_to_61 (%0.1f%%)", $percent)) if isdbg("pc11");
327                                 $line = join '^', @$pc, $hops, '~';
328
329                                 # update the stats (NOTE, thie record was a PC11, it has now become a PC61
330                                 # this is NOT the same choosing a better PC61, that is a separate record. 
331                                 ++$pc11_rx;             # 'cos we received as a PC11 it and it won't be a pc11 anymore 
332                                 --$pc61_rx;             # 'cos we'll increment it later as it's now a pc61, no double counting
333                                 
334 #                               dbg("CHANGED saved key: $key PC11 line to $line") if isdbg('pc11');
335                                 delete $pc11_saved{$key};
336                         }
337
338                         # if it is STILL (despite all efforts to change it) a PC11
339                         # save it and wait - it will be called from pc11_process
340                         if ($pcno == 11) {
341                                 $pc11_saved{$key} = [$main::systime, $self, $pcno, $line, $origin, $pc];
342                                 dbg("WAITING $self->{call}: NEW $pc->[0] spot $key waiting for a better offer") if isdbg("pc11");
343                                 return;
344                         }
345                 }
346         }
347         
348         # this goes after the input filtering, but before the add
349         # so that if it is input filtered, it isn't added to the dup
350         # list. This allows it to come in from a "legitimate" source
351         #
352         ## NOTE: this is where we insert the spot into the DXDupe cache
353         #
354         if (Spot::dup(@spot[0..4,7])) {
355                 dbg("PCPROT: Duplicate Spot  $self->{call}: $pc->[0] $key ignored\n") if isdbg('chanerr') || isdbg('dupespot') || isdbg('pc11');
356                 return;
357         }
358
359         dbg("PROCESSING $self->{call}: $pc->[0] key: $key") if isdbg('pc11');
360         
361         if ($pcno == 11) {
362                 ++$pc11_rx;
363         } else {
364                 ++$pc61_rx;
365         }
366
367         # we check IP addresses for PC61 - this will also dedupe PC11 promotions
368         if (@$pc > 8 && is_ipaddr($pc->[8])) {
369                 my $ip = $pc->[8];
370                 $ip =~ s/,/:/g;
371                 $ip =~ s/^::ffff://;
372                 if (DXCIDR::find($ip)) {
373                         dbg($line) if isdbg('nologchan');
374                         dbg("PCPROT: PC61 $ip in badip list, dropped");
375                         return;
376                 }
377         }
378         
379         # here we verify the spotter is currently connected to the node it says it is one. AKA email sender verify
380         # but without the explicit probe to the node. We are relying on "historical" information, but it very likely
381         # to be current once we have seen the first PC92C from that node.
382         #
383         # As for spots generated from non-PC92 nodes, we'll see after about  do_pc9x3h20m...
384         #
385         if ($senderverify) {
386                 my $nroute = Route::Node::get($pc->[7]);
387                 my $uroute = Route::Node::get($pc->[6]);
388                 my $local = DXChannel::get($pc->[7]);
389                 
390                 if ($nroute && ($nroute->last_PC92C || ($local && !$local->do_pc9x))) {
391                         my $s = '';
392                         my $ip = $pcno == 61 ?  $pc->[8] : '';
393 #                       $s .= "User $pc->[6] not logged in, " unless $uroute;
394                         $s .= "User $pc->[6] not on node $pc->[7], " unless $nroute->is_user($pc->[6]);
395 #                       $s .= "Node $pc->[7] at '$ip' not on Node's IP " . $nroute->ip if $ip && $nroute && $nroute->ip && $nroute->ip ne $ip;
396                         if ($s) {
397                                 my $action = $senderverify > 1 ? ", DUMPED" : '';
398                                 $s =~ s/, $//;
399                                 dbg("PCPROT: Suspicious Spot $pc->[2] on $pc->[1] by $pc->[6]($ip)\@$pc->[7] $s$action");
400                                 return unless $senderverify < 2;
401                         }
402                 }
403         }
404
405         # we until here to do any censorship to try and reduce the amount of noise that repeated copies
406         # from other connected nodes cause
407         if ($censorpc) {
408                 my @bad;
409                 if (@bad = BadWords::check($pc->[5])) {
410                         my $bw = join ', ', @bad;
411                         dbg($line) if isdbg('nologchan');
412                         dbg("PCPROT: Badwords: '$bw', dropped");
413                         return;
414                 }
415         }
416
417         
418         # add it
419         Spot::add(@spot);
420
421         my $ip = '';
422         $ip ||= $spot[14] if exists $spot[14];
423         if (isdbg('progress')) {
424                 my $sip = $ip ? sprintf "($ip)" : '' unless $ip =~ m|[\(\)\*]|;
425                 $sip ||= '';
426                 my $d = ztime($spot[2]);
427                 my $s = "SPOT: $spot[1] on $spot[0] \@ $d by $spot[4]$sip\@$spot[7]";
428                 $s .= $spot[3] ? " '$spot[3]'" : q{ ''};
429                 $s .=  " route: $origin";
430                 dbg($s);
431         }
432         
433         #
434         # @spot at this point contains:-
435         # freq, spotted call, time, text, spotter, spotted cc, spotters cc, orig node
436         # then  spotted itu, spotted cq, spotters itu, spotters cq
437         # you should be able to route on any of these
438         #
439
440         # fix up qra locators of known users
441         my $user = DXUser::get_current($spot[4]);
442         if ($user) {
443                 my $qra = $user->qra;
444                 unless ($qra && is_qra($qra)) {
445                         my $lat = $user->lat;
446                         my $long = $user->long;
447                         if (defined $lat && defined $long) {
448                                 $user->qra(DXBearing::lltoqra($lat, $long));
449                                 $user->put;
450                         }
451                 }
452
453                 # send a remote command to a distant cluster if it is visible and there is no
454                 # qra locator and we havn't done it for a month.
455
456                 unless ($user->qra) {
457                         my $node;
458                         my $to = $user->homenode;
459                         my $last = $user->lastoper || 0;
460                         if ($send_opernam && $to && $to ne $main::mycall && $main::systime > $last + $DXUser::lastoperinterval && ($node = Route::Node::get($to)) ) {
461                                 my $cmd = "forward/opernam $spot[4]";
462                                 # send the rcmd but we aren't interested in the replies...
463                                 my $dxchan = $node->dxchan;
464                                 if ($dxchan && $dxchan->is_clx) {
465                                         route(undef, $to, pc84($main::mycall, $to, $main::mycall, $cmd));
466                                 } else {
467                                         route(undef, $to, pc34($main::mycall, $to, $cmd));
468                                 }
469                                 if ($to ne $origin) {
470                                         $to = $origin;
471                                         $node = Route::Node::get($to);
472                                         if ($node) {
473                                                 $dxchan = $node->dxchan;
474                                                 if ($dxchan && $dxchan->is_clx) {
475                                                         route(undef, $to, pc84($main::mycall, $to, $main::mycall, $cmd));
476                                                 } else {
477                                                         route(undef, $to, pc34($main::mycall, $to, $cmd));
478                                                 }
479                                         }
480                                 }
481                                 $user->lastoper($main::systime);
482                                 $user->put;
483                         }
484                 }
485         }
486
487         # local processing
488         if (defined &Local::spot) {
489                 my $r;
490                 eval {
491                         $r = Local::spot($self, @spot);
492                 };
493                 return if $r;
494         }
495
496         # DON'T be silly and send on PC26s!
497         return if $pcno == 26;
498
499         # send out the filtered spots
500         send_dx_spot($self, $line, @spot) if @spot;
501
502         # cancel any recursion as we have now processed it
503         my $count =  $pc11_to_61+$rpc11_to_61;
504         my $percent = ($pc11_rx + $pc61_rx) ? ($pc11_rx * 100) / ($pc11_rx + $pc61_rx) : 0;
505         my $pc11_61 = $pc11_rx ? ($count * 100) / $pc11_rx : 0;
506         my $data = "$pc->[0] key: $key";
507         my $stats = sprintf "pc11: $pc11_rx pc61: $pc61_rx pc11%%: %0.1f%% pc11->pc61: $count(%0.1f%%)", $percent, $pc11_61;
508         if ($recurse) {
509                 if ($pc11_saved{$key}) {
510                         dbg("END $self->{call}: RECURSED $data removed and finished $stats") if isdbg('pc11');
511                         delete $pc11_saved{$key};
512                 } else {
513                         dbg("END $self->{call}: RECURSED NO KEY finished $stats") if isdbg('pc11'); 
514                 }
515                 $recurse = 0;
516         } else {
517                 dbg("END $self->{call}: NORMAL $data finished $stats") if isdbg('pc11');
518         }
519 }
520
521 # used to kick outstanding PC11 if required
522 sub pc11_process
523 {
524         foreach my $key (keys %pc11_saved) {
525                 my $r = $pc11_saved{$key};
526                 if ($main::systime > $r->[0] + $pc11_dwell_time) {
527                         dbg("---") if isdbg("pc11");
528                         dbg("RECURSE $r->[1]->{call}: PC11 spot $key timed out waiting, resend") if isdbg("pc11");
529                         my $self = $r->[1];
530                         delete $pc11_saved{$key};
531                         $self->handle_11(@$r[2..5], 1);
532                 }
533         }
534 }
535
536 # return the pc11 / pc61 / promotions data
537 sub get_pc11_61_stats
538 {
539         my $promotions =  $pc11_to_61+$rpc11_to_61;
540         my $percent = ($pc11_rx + $pc61_rx) ? ($pc11_rx * 100) / ($pc11_rx + $pc61_rx) : 0;
541         my $pc11_61p = $pc11_rx ? ($promotions * 100) / $pc11_rx : 0;
542         return {
543                         pc11_rx => $pc11_rx+0,
544                         pc61_rx => $pc61_rx+0,
545                         pc11_to_61 => $pc11_to_61+0,
546                         rpc11_to_61 => $rpc11_to_61+0,
547                         promotions => $promotions+0,
548                         pc11_percent => $percent+0,
549                         promotions_percent => $pc11_61p+0,
550                    };
551 }
552
553 # announces
554 sub handle_12
555 {
556         my $self = shift;
557         my $pcno = shift;
558         my $line = shift;
559         my $origin = shift;
560         my $pc = shift;
561
562         # announce duplicate checking
563         $pc->[3] =~ s/^\s+//;                   # remove leading blanks
564
565         # if this is a 'nodx' node then ignore it
566         if ($badnode->in($pc->[5])) {
567                 dbg($line) if isdbg('nologchan');
568                 dbg("PCPROT: Bad Node, dropped");
569                 return;
570         }
571
572         # if this is a 'bad spotter' user then ignore it
573         my $nossid = $pc->[1];
574         $nossid =~ s/-\d+$//;
575         if ($badspotter->in($nossid)) {
576                 dbg($line) if isdbg('nologchan');
577                 dbg("PCPROT: Bad Spotter, dropped");
578                 return;
579         }
580
581         # ignore PC12s from origins that use PCxx protocol
582         my $oref = Route::get($origin);
583         if ($oref->do_pc9x) {
584                 dbg("PCPROT: PC12 rxed from PC9x node, ignored") if isdbg('chanerr');
585                 return;
586         }
587
588         if ($censorpc) {
589                 my @bad;
590                 if (@bad = BadWords::check($pc->[3])) {
591                         my $bw = join ', ', @bad;
592                         dbg($line) if isdbg('nologchan');
593                         dbg("PCPROT: Badwords: '$bw', dropped");
594                         return;
595                 }
596         }
597
598
599         my $dxchan;
600
601         if ((($dxchan = DXChannel::get($pc->[2])) && $dxchan->is_user) || $pc->[4] =~ /^[\#\w.]+$/){
602                 $self->send_chat(0, $line, @$pc[1..6]);
603         } elsif ($pc->[2] eq '*' || $pc->[2] eq $main::mycall) {
604
605                 # ignore something that looks like a chat line coming in with sysop
606                 # flag - this is a kludge...
607                 if ($pc->[3] =~ /^\#\d+ / && $pc->[4] eq '*') {
608                         dbg('PCPROT: Probable chat rewrite, dropped') if isdbg('chanerr');
609                         return;
610                 }
611
612                 # here's a bit of fun, convert incoming ann with a callsign in the first word
613                 # or one saying 'to <call>' to a talk if we can route to the recipient
614                 if ($ann_to_talk) {
615                         my $call = AnnTalk::is_talk_candidate($pc->[1], $pc->[3]);
616                         if ($call) {
617                                 my $ref = Route::get($call);
618                                 if ($ref) {
619                                         $dxchan = $ref->dxchan;
620                                         $dxchan->talk($pc->[1], $call, undef, $pc->[3], $pc->[5]) if $dxchan != $self;
621                                         return;
622                                 }
623                         }
624                 }
625
626                 # send it
627                 $self->send_announce(0, $line, @$pc[1..6]);
628         } else {
629                 $self->route($pc->[2], $line);
630         }
631
632         # local processing
633         if (defined &Local::ann) {
634                 my $r;
635                 eval {
636                         $r = Local::ann($self, $line, @$pc[1..6]);
637                 };
638                 return if $r;
639         }
640 }
641
642 sub handle_15
643 {
644         my $self = shift;
645         my $pcno = shift;
646         my $line = shift;
647         my $origin = shift;
648         my $pc = shift;
649
650         if (eph_dup($line, $eph_pc15_restime)) {
651                 return;
652         } else {
653                 unless ($self->{isolate}) {
654                         DXChannel::broadcast_nodes($line, $self) if $line =~ /\^H\d+\^?~?$/; # send it to everyone but me
655                 }
656         }
657 }
658
659 # incoming user
660 sub handle_16
661 {
662         my $self = shift;
663         my $pcno = shift;
664         my $line = shift;
665         my $origin = shift;
666         my $pc = shift;
667
668         # general checks
669         my $dxchan;
670         my $ncall = $pc->[1];
671         my $newline = "PC16^";
672
673         # dos I want users from this channel?
674         unless ($self->user->wantpc16) {
675                 dbg("PCPROT: don't send users to $self->{call}") if isdbg('chanerr');
676                 return;
677         }
678
679         # is it me?
680         if ($ncall eq $main::mycall) {
681                 dbg("PCPROT: trying to alter config on this node from outside!") if isdbg('chanerr');
682                 return;
683         }
684
685         my $h;
686         $h = 1 if DXChannel::get($ncall);
687         if ($h && $self->{call} ne $ncall) {
688                 dbg("PCPROT: trying to update a local node, ignored") if isdbg('chanerr');
689                 return;
690         }
691
692         if (eph_dup($line)) {
693                 return;
694         }
695
696         # isolate now means only accept stuff from this call only
697         if ($self->{isolate} && $ncall ne $self->{call}) {
698                 dbg("PCPROT: $self->{call} isolated, $ncall ignored") if isdbg('chanerr');
699                 return;
700         }
701
702         my $parent = Route::Node::get($ncall);
703
704         if ($parent) {
705                 $dxchan = $parent->dxchan;
706                 if ($dxchan && $dxchan ne $self) {
707                         dbg("PCPROT: PC16 from $self->{call} trying to alter locally connected $ncall, ignored!") if isdbg('chanerr');
708                         return;
709                 }
710
711                 # input filter if required
712                 return unless $self->in_filter_route($parent);
713         } else {
714                 $parent = Route::Node->new($ncall);
715         }
716
717         unless ($h) {
718                 if ($parent->via_pc92) {
719                         dbg("PCPROT: non-local node controlled by PC92, ignored") if isdbg('chanerr');
720                         return;
721                 }
722         }
723
724         my $i;
725         my @rout;
726         for ($i = 2; $i < $#$pc; $i++) {
727                 my ($call, $conf, $here) = $pc->[$i] =~ /^(\S+) (\S) (\d)/o;
728                 next unless $call && $conf && defined $here && is_callsign($call);
729                 next if $call eq $main::mycall;
730
731                 eph_del_regex("^PC17\\^$call\\^$ncall");
732
733                 $conf = $conf eq '*';
734
735                 # reject this if we think it is a node already
736                 my $r = Route::Node::get($call);
737                 my $u = DXUser::get_current($call) unless $r;
738                 if ($r || ($u && $u->is_node)) {
739                         dbg("PCPROT: $call is a node") if isdbg('chanerr');
740                         next;
741                 }
742
743                 $r = Route::User::get($call);
744                 my $flags = Route::here($here)|Route::conf($conf);
745
746                 if ($r) {
747                         my $au = $r->addparent($parent);
748                         if ($r->flags != $flags) {
749                                 $r->flags($flags);
750                                 $au = $r;
751                         }
752                         push @rout, $r if $h && $au;
753                 } else {
754                         my @ans = $parent->add_user($call, $flags);
755                         push @rout, @ans if $h && @ans;
756                 }
757
758                 # add this station to the user database, if required
759                 my $user = DXUser::get_current($ncall);
760                 $user = DXUser->new($call) unless $user;
761                 $user->homenode($parent->call) if !$user->homenode;
762                 $user->node($parent->call);
763                 $user->lastin($main::systime) unless DXChannel::get($call);
764                 $user->put;
765
766                 # send info to all logged in thingies
767                 $self->tell_login('loginu', "$ncall: $call") if $user->is_local_node;
768                 $self->tell_buddies('loginb', $call, $ncall);
769         }
770         if (@rout) {
771                 $self->route_pc16($origin, $line, $parent, @rout) if @rout;
772 #               $self->route_pc92a($main::mycall, undef, $parent, @rout) if $h && $self->{state} eq 'normal';
773         }
774 }
775
776 # remove a user
777 sub handle_17
778 {
779         my $self = shift;
780         my $pcno = shift;
781         my $line = shift;
782         my $origin = shift;
783         my $pc = shift;
784
785         my $dxchan;
786         my $ncall = $pc->[2];
787         my $ucall = $pc->[1];
788
789         eph_del_regex("^PC16\\^$ncall.*$ucall");
790
791         # do I want users from this channel?
792         unless ($self->user->wantpc16) {
793                 dbg("PCPROT: don't send users to $self->{call}") if isdbg('chanerr');
794                 return;
795         }
796
797         if ($ncall eq $main::mycall) {
798                 dbg("PCPROT: trying to alter config on this node from outside!") if isdbg('chanerr');
799                 return;
800         }
801
802         # isolate now means only accept stuff from this call only
803         if ($self->{isolate} && $ncall ne $self->{call}) {
804                 dbg("PCPROT: $self->{call} isolated, $ncall ignored") if isdbg('chanerr');
805                 return;
806         }
807
808         my $uref = Route::User::get($ucall);
809         unless ($uref) {
810                 dbg("PCPROT: Route::User $ucall not in config") if isdbg('chanerr');
811                 return;
812         }
813         my $parent = Route::Node::get($ncall);
814         unless ($parent) {
815                 dbg("PCPROT: Route::Node $ncall not in config") if isdbg('chanerr');
816                 return;
817         }
818
819         $dxchan = DXChannel::get($ncall);
820         if ($dxchan && $dxchan ne $self) {
821                 dbg("PCPROT: PC17 from $self->{call} trying to alter locally connected $ncall, ignored!") if isdbg('chanerr');
822                 return;
823         }
824
825         unless ($dxchan) {
826                 if ($parent->via_pc92) {
827                         dbg("PCPROT: non-local node controlled by PC92, ignored") if isdbg('chanerr');
828                         return;
829                 }
830         }
831
832         if (DXChannel::get($ucall)) {
833                 dbg("PCPROT: trying do disconnect local user, ignored") if isdbg('chanerr');
834                 return;
835         }
836
837         # input filter if required and then remove user if present
838 #               return unless $self->in_filter_route($parent);
839         $parent->del_user($uref);
840
841         # send info to all logged in thingies
842         my $user = DXUser::get_current($ncall);
843         $self->tell_login('logoutu', "$ncall: $ucall") if $user && $user->is_local_node;
844         $self->tell_buddies('logoutb', $ucall, $ncall);
845
846         if (eph_dup($line)) {
847                 return;
848         }
849
850         $self->route_pc17($origin, $line, $parent, $uref);
851 #       $self->route_pc92d($main::mycall, undef, $parent, $uref) if $dxchan;
852 }
853
854 # link request
855 sub handle_18
856 {
857         my $self = shift;
858         my $pcno = shift;
859         my $line = shift;
860         my $origin = shift;
861         my $pc = shift;
862
863         $self->state('init');
864
865         my $parent = Route::Node::get($self->{call});
866         
867         # record the type and version offered
868         if (my ($software, $version) = $pc->[1] =~ /(DXSpider|CC\s*Cluster)\s+Version: (\d+(?:\.\d+)?)/i) {
869                 $version += 0;
870                 $version += 53 if $version < 6;
871                 $self->{version} = $version;
872                 $self->user->version($version);
873                 $parent->version($version);
874                 my ($build) = $pc->[1] =~ /Build: (\d+(?:\.\d+)?)/;
875                 $build += 0;
876                 $build = 0 unless $build > 1;
877                 $self->{build} = $build;
878                 $self->user->build($build);
879                 $parent->build($build);
880                 dbg("$self->{call} = $software version $version build $build");
881                 unless ($self->is_spider) {
882                         dbg("Change U " . $self->user->sort . " C $self->{sort} -> S");
883                         $self->user->sort('S');
884                         $self->user->put;
885                         $self->sort('S');
886                 }
887 #               $self->{handle_xml}++ if DXXml::available() && $pc->[1] =~ /\bxml/;
888         } elsif (my ($software, $version, $build) = $pc->[1] =~ /(AR-Cluster)\s+Version:\s+(\d+\.\d+).?(\d+\.\d+)?/) {
889                 dbg("$self->{call} = $software version $version build $build");
890                 $self->{version} = $version;
891                 $self->user->version($version);
892                 $parent->version($version);
893                 $self->{build} = $build;
894                 $self->user->build($build);
895                 $parent->build($build);
896                 unless ($self->is_arcluster) {
897                         dbg("Change U " . $self->user->sort . " C $self->{sort} -> R");
898                         $self->user->sort('R');
899                         $self->user->put;
900                         $self->sort('R');
901                 }
902         } else {
903                 dbg("$self->{call} = Unknown software ($pc->[1] $pc->[2])");
904                 $self->version(50.0);
905                 $self->version($pc->[2] / 100) if $pc->[2] && $pc->[2] =~ /^\d+$/;
906                 $self->user->version($self->version);
907         }
908
909         if ($pc->[1] =~ /CC\s*Cluster/i || $pc->[1] =~ /\bpc9x/i) {
910                 if ($self->{isolate}) {
911                         dbg("$self->{call} pc9x recognised, but node is isolated, using old protocol");
912                 } elsif (!$self->user->wantpc9x) {
913                         dbg("$self->{call} pc9x explicitly switched off, using old protocol");
914                 } else {
915                         $self->{do_pc9x} = 1;
916                         dbg("$self->{call} Set do PC9x");
917                 }
918         }
919
920         # first clear out any nodes on this dxchannel
921         my @rout = $parent->del_nodes;
922         $self->route_pc21($origin, $line, @rout, $parent) if @rout;
923         $self->send_local_config();
924         $self->send(pc20());
925 }
926
927 sub check_add_user
928 {
929         my $call = shift;
930         my $type = shift;
931         my $homenode = shift;
932
933         # add this station to the user database, if required (don't remove SSID from nodes)
934         my $user = DXUser::get_current($call);
935         unless ($user) {
936                 $user = DXUser->new($call);
937                 $user->sort($type || 'U');
938                 if ($user->is_node) {
939                         $user->priv(1);         # I have relented and defaulted nodes
940                         $user->lockout(1) if $user->is_node;
941                 } else {
942                         $user->homenode($homenode) if $homenode;
943                         $user->node($homenode);
944                         $user->priv(0);
945                 }
946                 $user->lastin($main::systime); # this make it last longer than just this invocation
947                 $user->put;                             # just to make sure it gets written away!!!
948                 dbg("DXProt: PC92 new user record for $call created");
949         }
950
951         # this is to fix a problem I introduced some build ago by using this function for users
952         # whereas it was only being used for nodes.
953         if ($user->is_user && $user->lockout && ($user->priv // 0) == 1) {
954                 $user->priv(0);
955                 $user->lockout(0);
956                 dbg("DXProt: PC92 user record for $call depriv'd and unlocked");
957                 $user->put;
958         }
959         return $user;
960 }
961
962 # incoming cluster list
963 sub handle_19
964 {
965         my $self = shift;
966         my $pcno = shift;
967         my $line = shift;
968         my $origin = shift;
969         my $pc = shift;
970
971         my $i;
972         my $newline = "PC19^";
973
974         # new routing list
975         my (@rout, @pc92out);
976
977         # first get the INTERFACE node
978         my $parent = Route::Node::get($self->{call});
979         unless ($parent) {
980                 dbg("PCPROT: my parent $self->{call} has disappeared");
981                 $self->disconnect;
982                 return;
983         }
984
985         my $h;
986
987         # parse the PC19
988         #
989         # We are making a major change from now on. We are only going to accept
990         # PC19s from directly connected nodes.  This means that we are probably
991         # going to throw away most of the data that we are being sent.
992         #
993         # The justification for this is that most of it is wrong or out of date
994         # anyway.
995         #
996         # From now on we are only going to believe PC92 data and locally connected
997         # non-pc92 nodes.
998         #
999         for ($i = 1; $i < $#$pc-1; $i += 4) {
1000                 my $here = $pc->[$i];
1001                 my $call = uc $pc->[$i+1];
1002                 my $conf = $pc->[$i+2];
1003                 my $ver = $pc->[$i+3];
1004                 next unless defined $here && defined $conf && is_callsign($call);
1005
1006                 eph_del_regex("^PC(?:21\\^$call|17\\^[^\\^]+\\^$call)");
1007
1008                 # check for sane parameters
1009                 #                               $ver = 5000 if $ver eq '0000';
1010                 next unless $ver && $ver =~ /^\d+$/;
1011                 next if $ver < 5000;    # only works with version 5 software
1012                 next if length $call < 3; # min 3 letter callsigns
1013                 next if $call eq $main::mycall || $call eq $main::myalias;
1014
1015                 # check that this PC19 isn't trying to alter the wrong dxchan
1016                 $h = 0;
1017                 my $dxchan = DXChannel::get($call);
1018                 if ($dxchan) {
1019                         if ($dxchan == $self) {
1020                                 $h = 1;
1021                         } else {
1022                                 dbg("PCPROT: PC19 from $self->{call} trying to alter wrong locally connected $call, ignored!") if isdbg('chanerr');
1023                                 next;
1024                         }
1025                 }
1026
1027                 # isolate now means only accept stuff from this call only
1028                 if ($self->{isolate} && $call ne $self->{call}) {
1029                         dbg("PCPROT: $self->{call} isolated, $call ignored") if isdbg('chanerr');
1030                         next;
1031                 }
1032
1033                 my $user = check_add_user($call, 'A');
1034
1035 #               if (eph_dup($genline)) {
1036 #                       dbg("PCPROT: dup PC19 for $call detected") if isdbg('chanerr');
1037 #                       next;
1038 #               }
1039
1040
1041                 unless ($h) {
1042                         if ($parent->via_pc92) {
1043                                 dbg("PCPROT: non-local node controlled by PC92, ignored") if isdbg('chanerr');
1044                                 next;
1045                         }
1046                 }
1047
1048                 my $r = Route::Node::get($call);
1049                 my $flags = Route::here($here)|Route::conf($conf);
1050
1051                 # modify the routing table if it is in it, otherwise store it in the pc19list for now
1052                 if ($r) {
1053                         my $ar;
1054                         if ($call ne $parent->call) {
1055                                 if ($self->in_filter_route($r)) {
1056                                         $ar = $parent->add($call, $ver, $flags);
1057 #                                       push @rout, $ar if $ar;
1058                                 } else {
1059                                         next;
1060                                 }
1061                         }
1062                         if ($r->version ne $ver || $r->flags != $flags) {
1063                                 $r->version($ver);
1064                                 $r->flags($flags);
1065                         }
1066                         push @rout, $r;
1067                 } else {
1068                         if ($call eq $self->{call} || $user->wantroutepc19) {
1069                                 my $new = Route->new($call); # throw away
1070                                 if ($self->in_filter_route($new)) {
1071                                         my $ar = $parent->add($call, $ver, $flags);
1072                                         $user->wantroutepc19(1) unless defined $user->wantroutepc19;
1073                                         push @rout, $ar if $ar;
1074                                         push @pc92out, $r if $h;
1075                                 } else {
1076                                         next;
1077                                 }
1078                         }
1079                 }
1080
1081                 # unbusy and stop and outgoing mail (ie if somehow we receive another PC19 without a disconnect)
1082                 my $mref = DXMsg::get_busy($call);
1083                 $mref->stop_msg($call) if $mref;
1084
1085                 $user->lastin($main::systime) unless DXChannel::get($call);
1086                 $user->put;
1087         }
1088
1089         # we are not automatically sending out PC19s, we send out a composite PC21,PC19 instead
1090         # but remember there will only be one (pair) these because any extras will be
1091         # thrown away.
1092         if (@rout) {
1093 #               $self->route_pc21($self->{call}, $line, @rout);
1094                 $self->route_pc19($self->{call}, $line, @rout);
1095         }
1096         if (@pc92out && !$pc92_slug_changes) {
1097                 $self->route_pc92a($main::mycall, $line, $main::routeroot, @pc92out) if $self->{state} eq 'normal';
1098         }
1099 }
1100
1101 # send local configuration
1102 sub handle_20
1103 {
1104         my $self = shift;
1105         my $pcno = shift;
1106         my $line = shift;
1107         my $origin = shift;
1108         my $pc = shift;
1109
1110         if ($self->{do_pc9x} && $self->{state} ne 'init92' && $self->{state} ne 'normal') {
1111                 $self->send("Reseting to oldstyle routing because login call not sent in any pc92");
1112                 $self->{do_pc9x} = 0;
1113         }
1114         $self->send_local_config;
1115         $self->send(pc22());
1116         $self->state('normal');
1117         $self->{lastping} = 0;
1118         $self->route_pc92a($main::mycall, undef, $main::routeroot, Route::Node::get($self->{call}));
1119 }
1120
1121 # delete a cluster from the list
1122 #
1123 # This should never occur for directly connected nodes.
1124 #
1125 sub handle_21
1126 {
1127         my $self = shift;
1128         my $pcno = shift;
1129         my $line = shift;
1130         my $origin = shift;
1131         my $pc = shift;
1132
1133         my $call = uc $pc->[1];
1134
1135         eph_del_regex("^PC1[679].*$call");
1136
1137         # if I get a PC21 from the same callsign as self then ignore it
1138         if ($call eq $self->{call}) {
1139                 dbg("PCPROT: self referencing PC21 from $self->{call}");
1140                 return;
1141         }
1142
1143         # for the above reason and also because of the check for PC21s coming
1144         # in for self->call from outside being ignored further down
1145         # we don't need any isolation code here, because we will never
1146         # act on a PC21 with self->call in it.
1147
1148         my $parent = Route::Node::get($self->{call});
1149         unless ($parent) {
1150                 dbg("PCPROT: my parent $self->{call} has disappeared");
1151                 $self->disconnect;
1152                 return;
1153         }
1154
1155         my @rout;
1156
1157         if ($call ne $main::mycall && $call ne $main::myalias) { # don't allow malicious buggers to disconnect me!
1158                 my $node = Route::Node::get($call);
1159                 if ($node) {
1160
1161                         if ($node->via_pc92) {
1162                                 dbg("PCPROT: controlled by PC92, ignored") if isdbg('chanerr');
1163                                 return;
1164                         }
1165
1166                         my $dxchan = DXChannel::get($call);
1167                         if ($dxchan && $dxchan != $self) {
1168                                 dbg("PCPROT: PC21 from $self->{call} trying to alter locally connected $call, ignored!") if isdbg('chan');
1169                                 return;
1170                         }
1171
1172                         # input filter it
1173                         return unless $self->in_filter_route($node);
1174
1175                         # routing objects, force a PC21 if it is local
1176                         push @rout, $node->del($parent);
1177                         push @rout, $call if $dxchan && @rout == 0;
1178                 }
1179         } else {
1180                 dbg("PCPROT: I WILL _NOT_ be disconnected!") if isdbg('chan');
1181                 return;
1182         }
1183
1184         if (eph_dup($line)) {
1185                 return;
1186         }
1187
1188         if (@rout) {
1189                 $self->route_pc21($origin, $line, @rout);
1190 #               $self->route_pc92d($main::mycall, $line, $main::routeroot, @rout);
1191         }
1192 }
1193
1194
1195 sub handle_22
1196 {
1197         my $self = shift;
1198         my $pcno = shift;
1199         my $line = shift;
1200         my $origin = shift;
1201         my $pc = shift;
1202
1203         if ($self->{do_pc9x}) {
1204                 if ($self->{state} ne 'init92' && $self->{state} ne 'normal') {
1205                         $self->send("Reseting to oldstyle routing because login call not sent in any pc92");
1206                         $self->{do_pc9x} = 0;
1207                 }
1208         }
1209         $self->{lastping} = 0;
1210         $self->state('normal');
1211         $self->route_pc92a($main::mycall, undef, $main::routeroot, Route::Node::get($self->{call}));
1212 }
1213
1214 # WWV info
1215 sub handle_23
1216 {
1217         my $self = shift;
1218         my $pcno = shift;
1219         my $line = shift;
1220         my $origin = shift;
1221         my $pc = shift;
1222
1223         # route foreign' pc27s
1224         if ($pcno == 27) {
1225                 if ($pc->[8] ne $main::mycall) {
1226                         $self->route($pc->[8], $line);
1227                         return;
1228                 }
1229         }
1230
1231
1232         # do some de-duping
1233         my $d = cltounix($pc->[1], sprintf("%02d18Z", $pc->[2]));
1234         my $sfi = unpad($pc->[3]);
1235         my $k = unpad($pc->[4]);
1236         my $i = unpad($pc->[5]);
1237         my ($r) = $pc->[6] =~ /R=(\d+)/;
1238         $r = 0 unless $r;
1239         if (($pcno == 23 && $d < $main::systime - $pc23_max_age) || $d > $main::systime + 1500 || $pc->[2] < 0 || $pc->[2] > 23) {
1240                 dbg("PCPROT: WWV Date ($pc->[1] $pc->[2]) out of range") if isdbg('chanerr');
1241                 return;
1242         }
1243
1244         # global wwv filtering on INPUT
1245         my @dxcc = ((Prefix::cty_data($pc->[7]))[0..2], (Prefix::cty_data($pc->[8]))[0..2]);
1246         if ($self->{inwwvfilter}) {
1247                 my ($filter, $hops) = $self->{inwwvfilter}->it(@$pc[7,8], $origin, @dxcc);
1248                 unless ($filter) {
1249                         dbg("PCPROT: Rejected by input wwv filter") if isdbg('chanerr');
1250                         return;
1251                 }
1252         }
1253         $pc->[7] =~ s/-\d+$//o;         # remove spotter's ssid
1254         if (Geomag::dup($d,$sfi,$k,$i,$pc->[6],$pc->[7])) {
1255                 dbg("PCPROT: Dup WWV Spot ignored\n") if isdbg('chanerr');
1256                 return;
1257         }
1258
1259         # note this only takes the first one it gets
1260         Geomag::update($d, $pc->[2], $sfi, $k, $i, @$pc[6..8], $r);
1261         dbg("WWV: <$pc->[2]>, sfi=$sfi k=$k info=$i '$pc->[6]' $pc->[7]\@$pc->[8] $r route: $origin") if isdbg('progress');
1262
1263         if (defined &Local::wwv) {
1264                 my $rep;
1265                 eval {
1266                         $rep = Local::wwv($self, $pc->[1], $pc->[2], $sfi, $k, $i, @$pc[6..8], $r);
1267                 };
1268                 return if $rep;
1269         }
1270
1271         # DON'T be silly and send on PC27s!
1272         return if $pcno == 27;
1273
1274         # broadcast to the eager world
1275         send_wwv_spot($self, $line, $d, $pc->[2], $sfi, $k, $i, @$pc[6..8]);
1276 }
1277
1278 # set here status
1279 sub handle_24
1280 {
1281         my $self = shift;
1282         my $pcno = shift;
1283         my $line = shift;
1284         my $origin = shift;
1285         my $pc = shift;
1286
1287         my $call = uc $pc->[1];
1288         my ($nref, $uref);
1289         $nref = Route::Node::get($call);
1290         $uref = Route::User::get($call);
1291         return unless $nref || $uref; # if we don't know where they are, it's pointless sending it on
1292
1293         if (eph_dup($line)) {
1294                 return;
1295         }
1296
1297         $nref->here($pc->[2]) if $nref;
1298         $uref->here($pc->[2]) if $uref;
1299         my $ref = $nref || $uref;
1300         return unless $self->in_filter_route($ref);
1301
1302         $self->route_pc24($origin, $line, $ref, $pc->[3]);
1303 }
1304
1305 # merge request
1306 sub handle_25
1307 {
1308         my $self = shift;
1309         my $pcno = shift;
1310         my $line = shift;
1311         my $origin = shift;
1312         my $pc = shift;
1313
1314         if ($pc->[1] ne $main::mycall) {
1315                 $self->route($pc->[1], $line);
1316                 return;
1317         }
1318         if ($pc->[2] eq $main::mycall) {
1319                 dbg("PCPROT: Trying to merge to myself, ignored") if isdbg('chan');
1320                 return;
1321         }
1322
1323         Log('DXProt', "Merge request for $pc->[3] spots and $pc->[4] WWV from $pc->[2]");
1324
1325         # spots
1326         if ($pc->[3] > 0) {
1327                 my @in = reverse Spot::search(1, undef, undef, 0, $pc->[3]);
1328                 my $in;
1329                 foreach $in (@in) {
1330                         $self->send(pc26(@{$in}[0..4], $pc->[2]));
1331                 }
1332         }
1333
1334         # wwv
1335         if ($pc->[4] > 0) {
1336                 my @in = reverse Geomag::search(0, $pc->[4], time, 1);
1337                 my $in;
1338                 foreach $in (@in) {
1339                         $self->send(pc27(@{$in}[0..5], $pc->[2]));
1340                 }
1341         }
1342 }
1343
1344 sub handle_26 {goto &handle_11}
1345 sub handle_27 {goto &handle_23}
1346
1347 # mail/file handling
1348 sub handle_28
1349 {
1350         my $self = shift;
1351         my $pcno = shift;
1352         my $line = shift;
1353         my $origin = shift;
1354         my $pc = shift;
1355
1356         if ($pc->[1] eq $main::mycall) {
1357                 no strict 'refs';
1358                 my $sub = "DXMsg::handle_$pcno";
1359                 &$sub($self, @$pc);
1360         } else {
1361                 $self->route($pc->[1], $line) unless $self->is_clx;
1362         }
1363 }
1364
1365 sub handle_29 {goto &handle_28}
1366 sub handle_30 {goto &handle_28}
1367 sub handle_31 {goto &handle_28}
1368 sub handle_32 {goto &handle_28}
1369 sub handle_33 {goto &handle_28}
1370
1371 sub handle_34
1372 {
1373         my $self = shift;
1374         my $pcno = shift;
1375         my $line = shift;
1376         my $origin = shift;
1377         my $pc = shift;
1378
1379         if (eph_dup($line, $eph_pc34_restime)) {
1380                 return;
1381         } else {
1382                 $self->process_rcmd($pc->[1], $pc->[2], $pc->[2], $pc->[3]);
1383         }
1384 }
1385
1386 # remote command replies
1387 sub handle_35
1388 {
1389         my $self = shift;
1390         my $pcno = shift;
1391         my $line = shift;
1392         my $origin = shift;
1393         my $pc = shift;
1394
1395         eph_del_regex("^PC35\\^$pc->[2]\\^$pc->[1]\\^");
1396         $self->process_rcmd_reply($pc->[1], $pc->[2], $pc->[1], $pc->[3]);
1397 }
1398
1399 sub handle_36 {goto &handle_34}
1400
1401 # database stuff
1402 sub handle_37
1403 {
1404         my $self = shift;
1405         my $pcno = shift;
1406         my $line = shift;
1407         my $origin = shift;
1408         my $pc = shift;
1409
1410         if ($pc->[1] eq $main::mycall) {
1411                 no strict 'refs';
1412                 my $sub = "DXDb::handle_$pcno";
1413                 &$sub($self, @$pc);
1414         } else {
1415                 $self->route($pc->[1], $line) unless $self->is_clx;
1416         }
1417 }
1418
1419 # node connected list from neighbour
1420 sub handle_38
1421 {
1422         my $self = shift;
1423         my $pcno = shift;
1424         my $line = shift;
1425         my $origin = shift;
1426         my $pc = shift;
1427 }
1428
1429 # incoming disconnect
1430 sub handle_39
1431 {
1432         my $self = shift;
1433         my $pcno = shift;
1434         my $line = shift;
1435         my $origin = shift;
1436         my $pc = shift;
1437
1438         if ($pc->[1] eq $self->{call}) {
1439                 $self->disconnect(1);
1440         } else {
1441                 dbg("PCPROT: came in on wrong channel") if isdbg('chanerr');
1442         }
1443 }
1444
1445 sub handle_40 {goto &handle_28}
1446
1447 # user info
1448 sub handle_41
1449 {
1450         my $self = shift;
1451         my $pcno = shift;
1452         my $line = shift;
1453         my $origin = shift;
1454         my $pc = shift;
1455
1456         my $call = $pc->[1];
1457         my $sort = $pc->[2];
1458         my $val = $pc->[3];
1459
1460         my $l = "PC41^$call^$sort";
1461         if (eph_dup($l, $eph_info_restime)) {
1462                 return;
1463         }
1464
1465         # input filter if required
1466         #                       my $ref = Route::get($call) || Route->new($call);
1467         #                       return unless $self->in_filter_route($ref);
1468
1469         if ($val eq $sort || $val =~ /^\s*$/) {
1470                 dbg('PCPROT: invalid value') if isdbg('chanerr');
1471                 return;
1472         }
1473
1474         if ($call eq $main::mycall || $call eq $main::myalias) {
1475                 dbg "DXPROT: PC41 trying to update $call from outside via $origin, ignored";
1476                 return;
1477         }
1478         my $chan = DXChannel::get($call);
1479         if ($chan) {
1480                 dbg "DXPROT: PC41 trying to update online $call from outside via $origin, ignored";
1481                 return;
1482         }
1483
1484         # add this station to the user database, if required
1485         my $user = DXUser::get_current($call);
1486         $user = DXUser->new($call) unless $user;
1487
1488         if ($sort == 1) {
1489                 if (($val =~ /spotter/i || $val =~ /self/i) && $user->name && $user->name ne $val) {
1490                         dbg("PCPROT: invalid name") if isdbg('chanerr');
1491                         return;
1492                 }
1493                 $user->name($val);
1494         } elsif ($sort == 2) {
1495                 $user->qth($val);
1496         } elsif ($sort == 3) {
1497                 if (is_latlong($val)) {
1498                         my ($lat, $long) = DXBearing::stoll($val);
1499                         $user->lat($lat) if $lat;
1500                         $user->long($long) if $long;
1501                         $user->qra(DXBearing::lltoqra($lat, $long)) unless $user->qra;
1502                 } else {
1503                         dbg('PCPROT: not a valid lat/long') if isdbg('chanerr');
1504                         return;
1505                 }
1506         } elsif ($sort == 4) {
1507                 $user->homenode($val);
1508         } elsif ($sort == 5) {
1509                 if (is_qra(uc $val)) {
1510                         my ($lat, $long) = DXBearing::qratoll(uc $val);
1511                         $user->lat($lat) if $lat && !$user->lat;
1512                         $user->long($long) if $long && !$user->long;
1513                         $user->qra(uc $val);
1514                 } else {
1515                         dbg('PCPROT: not a valid QRA locator') if isdbg('chanerr');
1516                         return;
1517                 }
1518         }
1519         $user->lastoper($main::systime); # to cut down on excessive for/opers being generated
1520         $user->put;
1521
1522         unless ($self->{isolate}) {
1523                 DXChannel::broadcast_nodes($line, $self); # send it to everyone but me
1524         }
1525
1526         #  perhaps this IS what we want after all
1527         #                       $self->route_pc41($ref, $call, $sort, $val, $pc->[4]);
1528 }
1529
1530 sub handle_42 {goto &handle_28}
1531
1532
1533 # database
1534 sub handle_44 {goto &handle_37}
1535 sub handle_45 {goto &handle_37}
1536 sub handle_46 {goto &handle_37}
1537 sub handle_47 {goto &handle_37}
1538 sub handle_48 {goto &handle_37}
1539
1540 # message and database
1541 sub handle_49
1542 {
1543         my $self = shift;
1544         my $pcno = shift;
1545         my $line = shift;
1546         my $origin = shift;
1547         my $pc = shift;
1548
1549         if (eph_dup($line)) {
1550                 return;
1551         }
1552
1553         if ($pc->[1] eq $main::mycall) {
1554                 DXMsg::handle_49($self, @$pc);
1555         } else {
1556                 $self->route($pc->[1], $line) unless $self->is_clx;
1557         }
1558 }
1559
1560 # keep alive/user list
1561 sub handle_50
1562 {
1563         my $self = shift;
1564         my $pcno = shift;
1565         my $line = shift;
1566         my $origin = shift;
1567         my $pc = shift;
1568
1569         return if (eph_dup($line));
1570
1571         my $call = $pc->[1];
1572
1573         my $node = Route::Node::get($call);
1574         if ($node) {
1575                 return unless $node->call eq $self->{call};
1576                 $node->usercount($pc->[2]) unless $node->users;
1577                 $node->reset_obs;
1578                 $node->PC92C_dxchan($self->call, $pc->[-1]);
1579
1580                 # input filter if required
1581 #               return unless $self->in_filter_route($node);
1582
1583                 unless ($self->{isolate}) {
1584                         DXChannel::broadcast_nodes($line, $self); # send it to everyone but me
1585                 }
1586 #               $self->route_pc50($origin, $line, $node, $pc->[2], $pc->[3]) unless eph_dup($line);
1587         }
1588 }
1589
1590 # incoming ping requests/answers
1591 sub handle_51
1592 {
1593         my $self = shift;
1594         my $pcno = shift;
1595         my $line = shift;
1596         my $origin = shift;
1597         my $pc = shift;
1598
1599         my $to = $pc->[1];
1600         my $from = $pc->[2];
1601         my $flag = $pc->[3];
1602
1603         if ($to eq $main::myalias) {
1604                 dbg("DXPROT: Ping addressed to \$myalias ($main::myalias), ignored") if isdbg('chan');
1605                 return;
1606         }
1607
1608         # is it for us?
1609         if ($to eq $main::mycall) {
1610                 if ($flag == 1) {
1611                         $self->send(pc51($from, $to, '0'));
1612                 } else {
1613                         DXXml::Ping::handle_ping_reply($self, $from);
1614                 }
1615         } else {
1616                 if (eph_dup($line)) {
1617                         return;
1618                 }
1619                 # route down an appropriate thingy
1620                 $self->route($to, $line);
1621         }
1622 }
1623
1624 sub handle_61 { goto &handle_11; }
1625
1626 # dunno but route it
1627 sub handle_75
1628 {
1629         my $self = shift;
1630         my $pcno = shift;
1631         my $line = shift;
1632         my $origin = shift;
1633         my $pc = shift;
1634
1635         my $call = $pc->[1];
1636         if ($call ne $main::mycall) {
1637                 $self->route($call, $line);
1638         }
1639 }
1640
1641 # WCY broadcasts
1642 sub handle_73
1643 {
1644         my $self = shift;
1645         my $pcno = shift;
1646         my $line = shift;
1647         my $origin = shift;
1648         my $pc = shift;
1649
1650         my $call = $pc->[1];
1651
1652         # do some de-duping
1653         my $d = cltounix($call, sprintf("%02d18Z", $pc->[2]));
1654         if (($pcno == 23 && $d < $main::systime - $pc23_max_age) || $d > $main::systime + 1500 || $pc->[2] < 0 || $pc->[2] > 23) {
1655                 dbg("PCPROT: WCY Date ($call $pc->[2]) out of range") if isdbg('chanerr');
1656                 return;
1657         }
1658         $pc = [ map { unpad($_) } @$pc ];
1659         if (WCY::dup($d)) {
1660                 dbg("PCPROT: Dup WCY Spot ignored\n") if isdbg('chanerr');
1661                 return;
1662         }
1663
1664         my $wcy = WCY::update($d, @$pc[2..12]);
1665         dbg("WCY: <$pc->[2]> K=$pc->[5] expK=$pc->[6] A=$pc->[4] R=$pc->[7] SFI=$pc->[3] SA=$pc->[8] GMF=$pc->[9] Au=$pc->[10] $pc->[11]\@$pc->[12] route: $origin") if isdbg('progress');
1666
1667         if (defined &Local::wcy) {
1668                 my $rep;
1669                 eval {
1670                         $rep = Local::wcy($self, @$pc[1..12]);
1671                 };
1672                 return if $rep;
1673         }
1674
1675         # broadcast to the eager world
1676         send_wcy_spot($self, $line, $d, @$pc[2..12]);
1677 }
1678
1679 # remote commands (incoming)
1680 sub handle_84
1681 {
1682         my $self = shift;
1683         my $pcno = shift;
1684         my $line = shift;
1685         my $origin = shift;
1686         my $pc = shift;
1687
1688         $self->process_rcmd($pc->[1], $pc->[2], $pc->[3], $pc->[4]);
1689 }
1690
1691 # remote command replies
1692 sub handle_85
1693 {
1694         my $self = shift;
1695         my $pcno = shift;
1696         my $line = shift;
1697         my $origin = shift;
1698         my $pc = shift;
1699
1700         $self->process_rcmd_reply($pc->[1], $pc->[2], $pc->[3], $pc->[4]);
1701 }
1702
1703 # decode a pc92 call: flag call : version : build
1704 sub _decode_pc92_call
1705 {
1706         my $icall = shift;
1707         my @part = split /:/, $icall;
1708         my ($flag, $call) = unpack "A A*", $part[0];
1709         unless (defined $flag && $flag ge '0' && $flag le '7') {
1710                 dbg("PCPROT: $icall no flag byte (0-7) at front of call, ignored") if isdbg('chanerr');
1711                 return ();
1712         }
1713         unless ($call && is_callsign($call)) {
1714                 dbg("PCPROT: $icall no recognisable callsign, ignored") if isdbg('chanerr');
1715                 return ();
1716         }
1717         my $is_node = $flag & 4;
1718         my $is_extnode = $flag & 2;
1719         my $here = $flag & 1;
1720         my $version = $part[1] || 0;
1721         my $build = $part[2] || 0;
1722         my $ip = $part[3] || '';
1723
1724         # remember that, at this stage, IPV6 addresses have : replaced by ,
1725         if (length $version > 4 && $version =~ /[,\.][\da-f]{1,4}/i) {
1726                 $ip = $version;
1727                 $version = 0;
1728         }
1729         $version =~ s/\D//g;
1730         $version = 0 unless $version && $version =~ /^[0-9]+$/;
1731         $build =~ s/^0\.//;
1732         $build =~ s/\D//g;
1733         $build = 0 unless $build &&  $build =~ /^[0-9]+$/;
1734         if ($ip) {
1735         $ip =~ s/,/:/g;
1736         $ip =~ s/^::ffff://i;
1737                 $ip = '' unless is_ipaddr($ip);
1738     }
1739         dbg("'$icall' = '" . join("', '", $call, $is_node, $is_extnode, $here, $version, $build, $ip) . "'") if isdbg('pc92');
1740         return ($call, $is_node, $is_extnode, $here, $version+0, $build+0, $ip);
1741 }
1742
1743 # decode a pc92 call: flag call : version : build
1744 sub _encode_pc92_call
1745 {
1746         my $ref = shift;
1747
1748         # plain call or value
1749         return $ref unless ref $ref;
1750
1751         my $ext = shift || 0;
1752         my $flag = 0;
1753         my $call = $ref->call;
1754         my $extra = '';
1755         $flag |= $ref->here ? 1 : 0;
1756         if ($ref->isa('Route::Node') || $ref->isa('DXProt')) {
1757                 $flag |= 4;
1758                 my $dxchan = DXChannel::get($call);
1759                 $flag |= 2 if $call ne $main::mycall && $dxchan && !$dxchan->{do_pc9x};
1760                 if (($ext & 1) && $ref->version) {
1761                         my $version = $ref->version || 1.0;
1762                         $version =  $version * 100 + 5300 if $version < 50;
1763                         $extra .= ":" . $version;
1764                 }
1765         }
1766         if (($ext & 2) && $ref->ip) {
1767                 my $ip = $ref->ip;
1768                 $ip =~ s/:/,/g;
1769                 $extra .= ':' . $ip;
1770         }
1771
1772         return "$flag$call$extra";
1773 }
1774
1775 my %things_add;
1776 my %things_del;
1777
1778 sub _add_thingy
1779 {
1780         my $parent = shift;
1781         my $s = shift;
1782         my $dxchan = shift;
1783         my $hops = shift;
1784
1785         my ($call, $is_node, $is_extnode, $here, $version, $build, $ip) = @$s;
1786         my @rout;
1787
1788         # remove spurious IPV6 prefix on IPV4 addresses
1789         $build ||= 0;
1790         $version ||= 0;
1791
1792         if ($call) {
1793                 my $ncall = $parent->call;
1794                 if ($ncall ne $call) {
1795                         my $user;
1796                         my $r;
1797
1798                         # normalise call, delete any unnormalised calls in the users file.
1799                         # then ignore this thingy
1800                         my $normcall = normalise_call($call);
1801                         if ($normcall ne $call) {
1802                                 next if DXChannel::get($call);
1803                                 $user = DXUser::get($call);
1804                                 dbg("DXProt::_add_thingy call $call normalised to $normcall, deleting spurious user $call");
1805                                 $user->del if $user;
1806                             $call = $normcall; # this is safe because a route add will ignore duplicates
1807                         }
1808                         
1809                         if ($is_node) {
1810                                 dbg("ROUTE: added node $call to $ncall") if isdbg('routelow');
1811                                 $user = check_add_user($call, 'A');
1812                                 @rout = $parent->add($call, $version, Route::here($here), $ip);
1813                                 $r = Route::Node::get($call);
1814                                 $r->PC92C_dxchan($dxchan->call, $hops) if $r;
1815                                 if ($version && is_numeric($version) && !$r->K && !$user->K) {
1816                                         my $old = $user->sort;
1817                                         if ($user->is_ak1a && (($version >= 5455 &&  $build > 0) || ($version >= 3000 && $version <= 3500)) ) {
1818                                                 $user->sort('S');
1819                                                 dbg("PCPROT::_add_thingy node $call v: $version b: $build sort ($old) updated to " . $user->sort);
1820                                         } elsif ($user->is_spider && ($version < 3000 || ($version > 4000 && $version < 5455))) {
1821                                                 unless ($version > 0  && $build == 0) {
1822                                                         $user->sort('A');
1823                                                         $build ||= 0;
1824                                                         dbg("PCPROT::_add_thingy node $call v: $version b: $build sort ($old) downgraded to " . $user->sort);
1825                                                 }
1826                                         }
1827                                 }
1828                                 $r->version($user->version) if $user->version;
1829                                 $r->build($user->build) if $user->build;
1830                                 $r->K(1) if $user->K;
1831                         } else {
1832                                 dbg("ROUTE: added user $call to $ncall") if isdbg('routelow');
1833                                 $user = check_add_user($call, 'U', $parent->call);
1834                                 @rout = $parent->add_user($call, Route::here($here), $ip);
1835                                 $dxchan->tell_buddies('loginb', $call, $ncall) if $dxchan;
1836                                 $r = Route::User::get($call);
1837                         }
1838                         if ($ip) {
1839                                 $r->ip($ip);
1840                                 Log('DXProt', "PC92A $call -> $ip on $ncall");
1841                         }
1842                         if ($pc92_slug_changes && $parent == $main::routeroot) {
1843                                 $things_add{$call} = Route::get($call);
1844                                 delete $things_del{$call};
1845                         }
1846                         $user->close($main::systime, $ip) if $user;             # this just updates lastseen and the connlist list containing the IP address
1847                 } else {                                
1848                         dbgprintring(10) if isdbg('nologchan');
1849                         dbg("DXProt::add_thingy: Trying to add parent $call to itself $ncall, ignored");
1850                 }
1851         }
1852         
1853         return @rout;
1854 }
1855
1856 sub _del_thingy
1857 {
1858         my $parent = shift;
1859         my $s = shift;
1860         my $dxchan = shift;
1861         my ($call, $is_node, $is_extnode, $here, $version, $build) = @$s;
1862         my @rout;
1863         if ($call) {
1864                 my $ref;
1865                 if ($is_node) {
1866                         $ref = Route::Node::get($call);
1867                         dbg("ROUTE: deleting node $call from " . $parent->call) if isdbg('routelow');
1868                         @rout = $ref->del($parent) if $ref;
1869                 } else {
1870                         dbg("ROUTE: deleting user $call from " . $parent->call) if isdbg('routelow');
1871                         $ref = Route::User::get($call);
1872                         if ($ref) {
1873                                 $dxchan->tell_buddies('logoutb', $call, $parent->call) if $dxchan;
1874                                 @rout = $parent->del_user($ref);
1875                         }
1876                 }
1877                 if ($pc92_slug_changes && $parent == $main::routeroot) {
1878                         $things_del{$call} = $ref unless exists $things_add{$call};
1879                         delete $things_add{$call};
1880                 }
1881         }
1882         return @rout;
1883 }
1884
1885 # this will only happen if we are slugging changes and
1886 # there are some changes to be sent, it will create an add or a delete
1887 # or both
1888 sub gen_pc92_changes
1889 {
1890         my @add = values %things_add;
1891         my @del = values %things_del;
1892         return (\@add, \@del);
1893 }
1894
1895 sub clear_pc92_changes
1896 {
1897         %things_add = %things_del = ();
1898         $last_pc92_slug = $main::systime;
1899 }
1900
1901 my $_last_time;
1902 my $_last_occurs;
1903 my $_last_pc9x_id;
1904
1905 sub last_pc9x_id
1906 {
1907         return $_last_pc9x_id;
1908 }
1909
1910 sub gen_pc9x_t
1911 {
1912         if (!$_last_time || $_last_time != $main::systime) {
1913                 $_last_time = $main::systime;
1914                 $_last_occurs = 0;
1915                 return $_last_pc9x_id = $_last_time - $main::systime_daystart;
1916         } else {
1917                 $_last_occurs++;
1918                 return $_last_pc9x_id = sprintf "%d.%02d", $_last_time - $main::systime_daystart, $_last_occurs;
1919         }
1920 }
1921
1922 sub check_pc9x_t
1923 {
1924         my $call = shift;
1925         my $t = shift;
1926         my $pc = shift;
1927         my $create = shift;
1928
1929         # check that the time is between 0 >= $t < 86400
1930         unless ($t >= 0 && $t < 86400) {
1931                 dbg("PCPROT: time invalid t: $t, ignored") if isdbg('chanerr');
1932                 return undef;
1933         }
1934
1935         # check that the time of this pc9x is within tolerance (default 15 mins either way)
1936         my $now = $main::systime - $main::systime_daystart ;
1937         my $diff = abs($now - $t);
1938         unless ($diff < $pc9x_time_tolerance || 86400 - $diff < $pc9x_time_tolerance) {
1939                 my $c = ref $call ? $call->call : $call;
1940                 dbg("PC9XERR: $c time out of range t: $t now: $now diff: $diff > $pc9x_time_tolerance, ignored") if isdbg('chan');
1941                 return undef;
1942         }
1943
1944         my $parent = ref $call ? $call : Route::Node::get($call);
1945         if ($parent) {
1946                 # we only do this for external calls whose routing table
1947                 # record come and go. The reference for mycall is permanent
1948                 # and not that frequently used, it also never times out, so
1949                 # the id on it is completely unreliable. Besides, only commands
1950                 # originating on this box will go through this code...
1951                 if ($parent->call ne $main::mycall) {
1952                         my $lastid = $parent->lastid;
1953                         if (defined $lastid) {
1954                                 if ($t < $lastid) {
1955                                         # note that this is where we determine whether this pc9x has come in yesterday
1956                                         # but is still greater (modulo 86400) than the lastid or is simply an old
1957                                         # duplicate sentence. To determine this we need to do some module 86400
1958                                         # arithmetic. High numbers mean that this is an old duplicate sentence,
1959                                         # low numbers that it is a new sentence.
1960                                         #
1961                                         # Typically you will see yesterday being taken on $t = 84, $lastid = 86235
1962                                         # and old dupes with $t = 234, $lastid = 256 (which give answers 249 and
1963                                         # 86378 respectively in the calculation below).
1964                                         #
1965                                         if ($t+86400-$lastid > $pc9x_past_age) {
1966                                                 dbg("PCPROT: dup id on $t <= lastid $lastid, ignored") if isdbg('chanerr') || isdbg('pc92dedupe');
1967                                                 return undef;
1968                                         }
1969                                 } elsif ($t == $lastid) {
1970                                         dbg("PCPROT: dup id on $t == lastid $lastid, ignored") if isdbg('chanerr') || isdbg('pc92dedupe');
1971                                         return undef;
1972                                 } else {
1973                                         # check that if we have a low number in lastid that yesterday's numbers
1974                                         # (likely in the 85000+ area) don't override them, thus causing flip flopping
1975                                         if ($lastid+86400-$t < $pc9x_past_age) {
1976                                                 dbg("PCPROT: dup id on $t in yesterday, lastid $lastid, ignored") if isdbg('chanerr') || isdbg('pc92dedupe');
1977                                                 return undef;
1978                                         }
1979                                 }
1980                         }
1981                 }
1982         } elsif ($create) {
1983                 $parent = Route::Node->new($call);
1984         } else {
1985                 dbg("PCPROT: $call does not exist, ignored") if isdbg('pc92dedupe');
1986                 return undef;
1987         }
1988         if (isdbg('pc92dedupe')) {
1989                 my $exists = exists $parent->{lastid}; # naughty, naughty :-)
1990                 my $val = $parent->{lastid};
1991                 my $s = $exists ? (defined $val ? $val : 'exists/undef') : 'undef';
1992                 dbg("PCPROT: $call pc92 id lastid $s -> $t");
1993         }
1994         $parent->lastid($t);
1995
1996         return $parent;
1997 }
1998
1999 sub pc92_handle_first_slot
2000 {
2001         my $self = shift;
2002         my $slot = shift;
2003         my $parent = shift;
2004         my $t = shift;
2005         my $hops = shift;
2006         my $oparent = $parent;
2007
2008         my @radd;
2009
2010         my ($call, $is_node, $is_extnode, $here, $version, $build) = @$slot;
2011         if ($call && $is_node) {
2012                 if ($call eq $main::mycall) {
2013                         LogDbg('err', "PCPROT: $self->{call} : $call looped back onto \$main::mycall ($main::mycall), ignored");
2014                         return;
2015                 }
2016                 if ($call eq $main::myalias) {
2017                         LogDbg('err', "PCPROT: $self->{call} : $call looped back onto \$main::myalias ($main::myalias), ignored");
2018                         return;
2019                 }
2020                 # this is only accepted from my "self".
2021                 # this also kills configs from PC92 nodes with external PC19 nodes that are also
2022                 # locally connected. Local nodes always take precedence. But we remember the lastid
2023                 # to try to reduce the number of dupe PC92s for this external node.
2024                 if (DXChannel::get($call) && $call ne $self->{call}) {
2025                         $parent = check_pc9x_t($call, $t, 92); # this will update the lastid time
2026                         dbg("PCPROT: locally connected node $call from other another node $self->{call}, ignored") if isdbg('chanerr');
2027                         return;
2028                 }
2029                 if ($is_extnode) {
2030                         # reparent to external node (note that we must have received a 'C' or 'A' record
2031                         # from the true parent node for this external before we get one for the this node
2032                         unless ($parent = Route::Node::get($call)) {
2033                                 if ($is_extnode && $oparent) {
2034                                         @radd = _add_thingy($oparent, $slot, $self, $hops);
2035                                         $parent = $radd[0];
2036                                 } else {
2037                                         dbg("PCPROT: no previous C or A for this external node received, ignored") if isdbg('chanerr');
2038                                         return;
2039                                 }
2040                         }
2041                         $parent = check_pc9x_t($call, $t, 92) || return;
2042                         $parent->via_pc92(1);
2043                         $parent->PC92C_dxchan($self->{call}, $hops);
2044                 }
2045         } else {
2046                 dbg("PCPROT: must be \$mycall or external node as first entry, ignored") if isdbg('chanerr');
2047                 return;
2048         }
2049         $parent->here(Route::here($here));
2050         $parent->version($version || $pc19_version) if $version;
2051     $parent->build($build) if $build;
2052         $parent->PC92C_dxchan($self->{call}, $hops) unless $self->{call} eq $parent->call;
2053         return ($parent, @radd);
2054 }
2055
2056 # DXSpider routing entries
2057 sub handle_92
2058 {
2059         my $self = shift;
2060         my $pcno = shift;
2061         my $line = shift;
2062         my $origin = shift;
2063         my $pc = shift;
2064
2065         my (@radd, @rdel);
2066
2067         my $pcall = $pc->[1];
2068         my $t = $pc->[2];
2069         my $sort = $pc->[3];
2070         my $hops = $pc->[-1];
2071
2072         # this catches loops of A/Ds
2073 #       if (eph_dup($line, $pc9x_dupe_age)) {
2074 #               return;
2075 #       }
2076
2077         if ($pcall eq $main::mycall) {
2078                 LogDbg('err', "PCPROT: looped back, ignored");
2079                 return;
2080         }
2081
2082         if ($pcall eq $main::myalias) {
2083                 LogDbg('err', "PCPROT: looped back to \$myalias ($main::myalias), misconfiguration ignored");
2084                 return;
2085         }
2086
2087         if ($pcall eq $self->{call} && $self->{state} eq 'init') {
2088                 if ($self->{isolate}) {
2089                         dbg("DXPROT: PC9x received, but $pcall is isolated, ignored");
2090                         return;
2091                 } elsif (!$self->user->wantpc9x) {
2092                         dbg("DXPROT: PC9x explicitly switched off on $pcall, ignored");
2093                         return;
2094                 } else {
2095                         $self->state('init92');
2096                         $self->{do_pc9x} = 1;
2097                         dbg("DXPROT: Do pc9x set on $pcall");
2098                 }
2099         }
2100         unless ($self->{do_pc9x}) {
2101                 dbg("PCPROT: PC9x come in from non-PC9x node, ignored") if isdbg('chanerr');
2102                 return;
2103         }
2104
2105         # don't create routing entries for D records that don't already exist
2106         # this is what causes all those PC92 loops!
2107         my $parent = check_pc9x_t($pcall, $t, 92, $sort ne 'D') || return;
2108         my $oparent = $parent;
2109
2110         $parent->do_pc9x(1);
2111         $parent->via_pc92(1);
2112
2113         if ($sort eq 'F' || $sort eq 'R') {
2114
2115                 # this is the route finding section
2116                 # here is where the consequences of the 'find' command
2117                 # are dealt with
2118
2119                 my $from = $pc->[4];
2120                 my $target = $pc->[5];
2121
2122                 if ($sort eq 'F') {
2123                         my $flag;
2124                         my $ref;
2125                         my $dxchan;
2126                         if ($ref = DXChannel::get($target)) {
2127                                 $flag = 1;              # we are directly connected
2128                         } else {
2129                                 $ref = Route::get($target);
2130                                 $dxchan = $ref->dxchan;
2131                                 $flag = 2;
2132                         }
2133                         if ($ref && $flag && $dxchan) {
2134                                 $self->send(pc92r($from, $target, $flag, int($dxchan->{pingave}*1000)));
2135                                 return;
2136                         }
2137                 } elsif ($sort eq 'R') {
2138                         if (my $dxchan = DXChannel::get($from)) {
2139                                 handle_pc92_find_reply($dxchan, $pcall, $from, $target, @$pc[6,7]);
2140                         } else {
2141                                 my $ref = Route::get($from);
2142                                 if ($ref) {
2143                                         my @dxchan = grep {$_->do_pc9x} $ref->alldxchan;
2144                                         if (@dxchan) {
2145                                                 $_->send($line) for @dxchan;
2146                                         } else {
2147                                                 dbg("PCPROT: $self->{call} : type R no return route, ignored") if isdbg('chanerr') || isdbg('route');
2148                                         }
2149                                 } else {
2150                                         dbg("PCPROT: $self->{call} : type R no return route, ignored") if isdbg('chanerr') || isdbg('route');
2151                                 }
2152                         }
2153                         return;
2154                 }
2155
2156         } elsif ($sort eq 'K') {
2157                 $pc92Kin += length $line;
2158
2159                 # remember the last channel we arrived on
2160                 $parent->PC92C_dxchan($self->{call}, $hops) unless $self->{call} eq $parent->call;
2161
2162                 my @ent = _decode_pc92_call($pc->[4]);
2163
2164                 if (@ent) {
2165                         my $add;
2166
2167                         ($parent, $add) = $self->pc92_handle_first_slot(\@ent, $parent, $t, $hops);
2168                         return unless $parent; # dupe
2169                         
2170                         push @radd, $add if $add;
2171                         $parent->reset_obs;
2172                         my $call = $parent->call;
2173                         my $version = $ent[4] || 0;
2174                         my $build = $ent[5] ||  0;
2175                         $build =~ s/^0\.//;
2176                         my $oldbuild = $parent->build || 0;
2177                         my $oldversion = $parent->version || 0;
2178                         my $user = check_add_user($parent->call, 'S');
2179                         my $oldsort = $user->sort // '';
2180
2181                         dbg("PCPROT: PC92 K v: $version ov: $oldversion b: $build ob: $oldbuild pk: " . ($parent->K || '0') . " uk: " . ($user->K || 0)) if isdbg('pc92k');
2182                                 
2183                         if (is_numeric($version) || is_numeric($build)) {
2184                                 my $changed = 0;
2185                                 if (($oldversion ne $version || $build ne $oldbuild)) {
2186                                         dbg("PCPROT: PC92 K node $call updated version: $version (was $oldversion) build: $build (was $oldbuild)");
2187                                         $user->version($parent->version($version));
2188                                         $user->build($parent->build($build));
2189                                         ++$changed;
2190                                 }
2191                                 if ($oldsort ne 'S') {
2192                                         dbg("PCPROT: PC92 K node $call updated sort: $sort (was $oldsort)");
2193                                         $user->sort('S');
2194                                         ++$changed;
2195                                 }
2196                                 unless ($user->K) {
2197                                         dbg("PCPROT: PC92 K node $call updated - marked as PC92 K user");
2198                                         $user->K(1);
2199                                         ++$changed;
2200                                 }
2201                                 $user->put if $changed;
2202                                 $parent->K(1); # mark this as come in on a K
2203                         } else {
2204                                 dbg("DXProt PC92 K version call $call: invalid version: '$version' or build: '$version', ignored");
2205                         }
2206                         dbg("ROUTE: reset obscount on $call now " . $parent->obscount) if isdbg('obscount');
2207                 }
2208         } elsif ($sort eq 'A' || $sort eq 'D' || $sort eq 'C') {
2209
2210                 $pc92Ain += length $line if $sort eq 'A';
2211                 $pc92Cin += length $line if $sort eq 'C';
2212                 $pc92Din += length $line if $sort eq 'D';
2213
2214                 # remember the last channel we arrived on
2215                 $parent->PC92C_dxchan($self->{call}, $hops) unless $self->{call} eq $parent->call;
2216
2217                 # this is the main route section
2218                 # here is where all the routes are created and destroyed
2219
2220                 # cope with missing duplicate node calls in the first slot
2221                 my $me = $pc->[4] || '';
2222                 $me ||= _encode_pc92_call($parent) unless $me ;
2223
2224                 my @ent = map {my @a = _decode_pc92_call($_); @a ? \@a : ()} grep {$_ && /^[0-7]/} $me, @$pc[5 .. $#$pc];
2225
2226                 if (@ent) {
2227
2228                         # look at the first one which will always be a node of some sort
2229                         # except in the case of 'A' or 'D' in which the $pcall is used
2230                         # otherwise use the node call and update any information
2231                         # that needs to be done.
2232                         my $add;
2233
2234                         ($parent, $add) = $self->pc92_handle_first_slot($ent[0], $parent, $t, $hops);
2235                         return unless $parent; # dupe
2236
2237                         shift @ent;
2238                         push @radd, $add if $add;
2239                 }
2240
2241                 # do a pass through removing any references to either mycall
2242                 my @nent;
2243                 for (@ent) {
2244                         my $dxc;
2245                         next unless $_ && @$_;
2246                         if ($_->[0] eq $main::mycall) {
2247                                 dbg("PCPROT: $self->{call} : type $sort $_->[0] refers to me, ignored") if isdbg('route');
2248                                 next;
2249                         }
2250                         if ($_->[0] eq $main::myalias && $_->[1] || $_->[0] eq $main::mycall && $_->[1] == 0) {
2251                                 LogDbg('err',"PCPROT: $self->{call} : type $sort $_->[0] trying to change type to " . $_->[1]?"Node":"User" . ", ignored");
2252                                 next;
2253                         }
2254                         
2255                         push @nent, $_;
2256                 }
2257
2258                 if ($sort eq 'A') {
2259                         for (@nent) {
2260                                 push @radd, _add_thingy($parent, $_, $self, $hops);
2261                         }
2262                 } elsif ($sort eq 'D') {
2263                         for (@nent) {
2264                                 push @rdel, _del_thingy($parent, $_, $self);
2265                         }
2266                 } elsif ($sort eq 'C') {
2267                         my (@nodes, @users);
2268
2269                         # we reset obscounts on config records as well as K records
2270                         $parent->reset_obs;
2271                         dbg("ROUTE: reset obscount on $parent->{call} now " . $parent->obscount) if isdbg('obscount');
2272
2273                         #
2274                         foreach my $r (@nent) {
2275                                 #                       my ($call, $is_node, $is_extnode, $here, $version, $build) = _decode_pc92_call($_);
2276                                 if ($r->[0]) {
2277                                         if ($r->[1]) {
2278                                                 push @nodes, $r->[0];
2279                                         } else {
2280                                                 push @users, $r->[0];
2281                                         }
2282                                 } else {
2283                                         dbg("PCPROT: $self->{call} :  pc92 call entry '$_' not decoded, ignored") if isdbg('chanerr') || isdbg('route');
2284                                 }
2285                         }
2286
2287                         my ($dnodes, $dusers, $nnodes, $nusers) = $parent->calc_config_changes(\@nodes, \@users);
2288
2289                         # add users here
2290                         foreach my $r (@nent) {
2291                                 my $call = $r->[0];
2292                                 if ($call) {
2293                                         push @radd,_add_thingy($parent, $r, $self, $hops) if grep $call eq $_, (@$nnodes, @$nusers);
2294                                 }
2295                         }
2296                         # del users here
2297                         foreach my $r (@$dnodes) {
2298                                 push @rdel,_del_thingy($parent, [$r, 1], $self);
2299                         }
2300                         foreach my $r (@$dusers) {
2301                                 push @rdel,_del_thingy($parent, [$r, 0], $self);
2302                         }
2303
2304                         # remember this last PC92C for rebroadcast on demand
2305                         $parent->last_PC92C($line);
2306                 } else {
2307                         dbg("PCPROT: unknown action '$sort', ignored") if isdbg('chanerr');
2308                         return;
2309                 }
2310
2311                 foreach my $r (@rdel) {
2312                         next unless $r;
2313
2314                         $self->route_pc21($pcall, undef, $r) if $r->isa('Route::Node');
2315                         $self->route_pc17($pcall, undef, $parent, $r) if $r->isa('Route::User');
2316                 }
2317                 my @pc19 = grep { $_ && $_->isa('Route::Node') } @radd;
2318                 my @pc16 = grep { $_ && $_->isa('Route::User') } @radd;
2319                 unshift @pc19, $parent if $self->{state} eq 'init92' && $oparent == $parent;
2320                 $self->route_pc19($pcall, undef, @pc19) if @pc19;
2321                 $self->route_pc16($pcall, undef, $parent, @pc16) if @pc16;
2322         }
2323
2324         # broadcast it if we get here
2325         $self->broadcast_route_pc9x($pcall, undef, $line, 0) unless !$pc92_ad_enabled && ($sort eq 'A' || $sort eq 'D');
2326 }
2327
2328 # get all the routes for a thing, bearing in mind that the thing (e.g. a user)
2329 # might be on two or more nodes at the same time or that there may be more than
2330 # one equal distance neighbour to a node.
2331 #
2332 # What this means that if sh/route g1tlh shows that he is on (say) two nodes, then
2333 # a Route::findroutes is done on each of those two nodes, the best route(s) taken from
2334 # each and then combined to give a set of dxchans to send the PC9x record down
2335 #
2336 sub find_pc9x_routes
2337 {
2338         my $to = shift;
2339         my $ref = Route::get($to);
2340         my @parent;
2341         my %cand;
2342
2343         if ($ref->isa('Route::User')) {
2344                 my $dxchan = DXChannel::get($to);
2345                 push @parent, $to if $dxchan;
2346                 push @parent, $ref->parents;
2347         } else {
2348                 @parent = $to;
2349         }
2350         foreach my $p (@parent) {
2351                 my $lasthops;
2352                 my @routes = Route::findroutes($p);
2353                 foreach my $r (@routes) {
2354                         $lasthops = $r->[0] unless defined $lasthops;
2355                         if ($r->[0] == $lasthops) {
2356                                 $cand{$r->[1]->call} = $r->[1];
2357                         } else {
2358                                 last;
2359                         }
2360                 }
2361         }
2362         return values %cand;
2363 }
2364
2365 sub handle_93
2366 {
2367         my $self = shift;
2368         my $pcno = shift;
2369         my $line = shift;
2370         my $origin = shift;
2371         my $pc = shift;
2372
2373 #       $self->{do_pc9x} ||= 1;
2374
2375         my $pcall = $pc->[1];                   # this is now checked earlier
2376
2377         # remember that we are converting PC10->PC93 and self will be $main::me if it
2378         # comes from us
2379         unless ($self->{do_pc9x}) {
2380                 dbg("PCPROT: PC9x come in from non-PC9x node, ignored") if isdbg('chanerr');
2381                 return;
2382         }
2383
2384         my $t = $pc->[2];
2385         my $parent = check_pc9x_t($pcall, $t, 93, 1) || return;
2386
2387         my $to = uc $pc->[3];
2388         my $from = uc $pc->[4];
2389         my $via = uc $pc->[5];
2390         my $text = $pc->[6];
2391         my $onode = uc $pc->[7];
2392         my $ipaddr = $pc->[8];
2393
2394         $onode = undef unless $onode && is_callsign($onode);
2395         $onode //= $pcall;
2396         $ipaddr = undef unless $ipaddr && is_ipaddr($ipaddr);
2397
2398         # this is catch loops caused by bad software ...
2399         if (eph_dup("PC93|$from|$text|$onode", $pc10_dupe_age)) {
2400                 return;
2401         }
2402
2403         if (isdbg('progress')) {
2404                 my $vs = $via ne '*' ? " via $via" : ''; 
2405                 my $s = "ANNTALK: $from\@$onode$vs -> $to '$text' route: $origin";
2406                 dbg($s);
2407         }
2408
2409         # if this is a 'bad spotter' user then ignore it
2410         my $nossid = $from;
2411         $nossid =~ s/-\d+$//;
2412         if ($badspotter->in($nossid)) {
2413                 dbg($line) if isdbg('nologchan');
2414                 dbg("PCPROT: Bad Spotter, dropped");
2415                 return;
2416         }
2417
2418         # ignore PC93 coming in from outside this node with a target of local
2419         if ($to eq 'LOCAL' && $self != $main::me) {
2420                 dbg("PCPROT: incoming LOCAL chat not from local node, ignored") if isdbg('chanerr');
2421                 return;
2422         }
2423
2424         # will we allow it at all?
2425         if ($censorpc) {
2426                 my @bad;
2427                 if (@bad = BadWords::check($text)) {
2428                         my $bw = join ', ', @bad;
2429                         dbg($line) if isdbg('nologchan');
2430                         dbg("PCPROT: Badwords: '$bw', dropped");
2431                         return;
2432                 }
2433         }
2434
2435         $self->populate_routing_table($onode, $from, $ipaddr);
2436
2437         # if it is routeable then then treat it like a talk
2438         my $ref = Route::get($to);
2439         if ($ref) {
2440                 my $dxchan;
2441
2442                 # convert to PC10 or local talks where appropriate
2443                 # PC93 capable nodes of the same hop count all get a copy
2444                 # if there is a PC10 node then it will get a copy and that
2445                 # will be it. Hopefully such a node will not figure highly
2446                 # in the route list, unless it is local, 'cos it don't issue PC92s!
2447                 # note that both local and PC93s at the same time are possible if the
2448                 # user on more than one node.
2449                 my @routes = find_pc9x_routes($to);
2450                 my $lasthops;
2451                 foreach $dxchan (@routes) {
2452                         if (ref $dxchan && $dxchan->isa('DXChannel')) {
2453                                 if ($dxchan->{do_pc9x}) {
2454                                         $dxchan->send($line);
2455                                 } else {
2456                                         $dxchan->talk($from, $to, $via, $text, $onode);
2457                                 }
2458                         } else {
2459                                 dbg("ERROR: $to -> $dxchan is not a DXChannel! (convert to pc10)");
2460                         }
2461                 }
2462                 return;
2463
2464         } elsif ($to eq '*' || $to eq 'SYSOP' || $to eq 'WX') {
2465                 # announces
2466                 my $sysop = $to eq 'SYSOP' ? '*' : ' ';
2467                 my $wx = $to eq 'WX' ? '1' : '0';
2468                 my $local = $via eq 'LOCAL' ? '*' : $via;
2469
2470                 $self->send_announce(1, pc12($from, $text, $local, $sysop, $wx, $pcall), $from, $local, $text, $sysop, $pcall, $wx, $via eq 'LOCAL' ? $via : undef);
2471                 return if $via eq 'LOCAL';
2472         } elsif (!is_callsign($to) && $text =~ /^#\d+ /) {
2473                 # chat messages really only locally connected users
2474                 $self->send_chat(1, $line, $from, '*', $text, $to, $pcall, '0');
2475         }
2476
2477         # broadcast this chat sentence everywhere unless it is targetted to 'LOCAL'
2478         $self->broadcast_route_pc9x($pcall, undef, $line, 0) unless $to eq 'LOCAL' || $via eq 'LOCAL';
2479 }
2480
2481 # if get here then rebroadcast the thing with its Hop count decremented (if
2482 # there is one). If it has a hop count and it decrements to zero then don't
2483 # rebroadcast it.
2484 #
2485 # NOTE - don't arrive here UNLESS YOU WANT this lump of protocol to be
2486 #        REBROADCAST!!!!
2487 #
2488
2489 sub handle_default
2490 {
2491         my $self = shift;
2492         my $pcno = shift;
2493         my $line = shift;
2494         my $origin = shift;
2495         my $pc = shift;
2496
2497         unless (eph_dup($line)) {
2498                 if ($pcno >= 90) {
2499                         my $pcall = $pc->[1];
2500                         unless (is_callsign($pcall)) {
2501                                 dbg("PCPROT: invalid callsign string '$pc->[1]', ignored") if isdbg('chanerr');
2502                                 return;
2503                         }
2504                         my $t = $pc->[2];
2505                         my $parent = check_pc9x_t($pcall, $t, $pcno, 1) || return;
2506                         $self->broadcast_route_pc9x($pcall, undef, $line, 0);
2507                 } else {
2508                         unless ($self->{isolate}) {
2509                                 DXChannel::broadcast_nodes($line, $self) if $line =~ /\^H\d+\^?~?$/; # send it to everyone but me
2510                         }
2511                 }
2512         }
2513 }
2514
2515 sub populate_routing_table
2516 {
2517         my ($self, $node, $user, $ip) = @_;
2518         
2519         my $rn = Route::Node::get($node);
2520         unless ($rn) {
2521                 $rn = Route::Node->new($node);
2522                 dbg("ROUTE $self->{call}: ADD NEW node: $node") if isdbg('pc11');
2523         }
2524
2525         my $ru;
2526         if ($user ne $node) {
2527                 $ru = Route::User::get($user);
2528                 unless ($ru) {
2529                         $rn->add_user($user, 0, undef);
2530                         dbg("ROUTE $self->{call}: ADD NEW user: $user -> $node") if isdbg('pc11');
2531                 }
2532                 $ru = Route::User::get($user);
2533         }
2534         
2535         # Add/Change any IP address info
2536
2537         # as we have a route to a user, if it (or the node) does not exist then create them
2538         # link the user to the node if not already done.
2539         # then add or alter the IP address
2540         if ($ip && is_ipaddr($ip)) {
2541                 my $new = $ip;
2542                 if ($ru) {
2543                         if ($ru->ip ne $new) {
2544                                 if ($ru->ip) {
2545                                         my $old = $ru->ip;
2546                                         $ru->ip($new);
2547                                         dbg("ROUTE $self->{call}: ALTER IP node: $node user: $user old IP: '$old'-> new IP: '$new'") if isdbg('pc11');
2548                                 } else{
2549                                         $ru->ip($new);
2550                                         dbg("ROUTE $self->{call}: NEW IP node: $node user: $user IP: '$new'") if isdbg('pc11');
2551                                 }
2552                         }
2553                 } else {
2554                         dbg("ROUTE $self->{call}: ADD Failed for node $node user $user") if isdbg('pc11');
2555                 }
2556         }
2557 }
2558
2559 1;