3 # This module impliments the protocal mode for a dx cluster
5 # Copyright (c) 1998 Dirk Koopman G1TLH
31 use vars qw($me $pc11_max_age $pc11_dup_age $pc23_dup_age
32 %spotdup %wwvdup $last_hour %pings %rcmds
33 %nodehops @baddx $baddxfn);
35 $me = undef; # the channel id for this cluster
36 $pc11_max_age = 1*3600; # the maximum age for an incoming 'real-time' pc11
37 $pc11_dup_age = 24*3600; # the maximum time to keep the spot dup list for
38 $pc23_dup_age = 24*3600; # the maximum time to keep the wwv dup list for
39 %spotdup = (); # the pc11 and 26 dup hash
40 %wwvdup = (); # the pc23 and 27 dup hash
41 $last_hour = time; # last time I did an hourly periodic update
42 %pings = (); # outstanding ping requests outbound
43 %rcmds = (); # outstanding rcmd requests outbound
44 %nodehops = (); # node specific hop control
45 @baddx = (); # list of illegal spotted callsigns
47 $baddxfn = "$main::data/baddx.pl";
51 my $user = DXUser->get($main::mycall);
52 $DXProt::myprot_version += $main::version*100;
53 $me = DXProt->new($main::mycall, 0, $user);
55 $me->{state} = "indifferent";
56 do "$main::data/hop_table.pl" if -e "$main::data/hop_table.pl";
58 # $me->{sort} = 'M'; # M for me
60 # now prime the spot duplicates file with today's and yesterday's data
61 my @today = Julian::unixtoj(time);
62 my @spots = Spot::readfile(@today);
63 @today = Julian::sub(@today, 1);
64 push @spots, Spot::readfile(@today);
66 my $dupkey = "$_->[0]$_->[1]$_->[2]$_->[3]$_->[4]";
67 $spotdup{$dupkey} = $_->[2];
70 # now prime the wwv duplicates file with just this month's data
71 my @wwv = Geomag::readfile(time);
73 my $dupkey = "$_->[1].$_->[2]$_->[3]$_->[4]";
74 $wwvdup{$dupkey} = $_->[1];
78 do "$baddxfn" if -e "$baddxfn";
83 # obtain a new connection this is derived from dxchannel
88 my $self = DXChannel::alloc(@_);
89 $self->{'sort'} = 'A'; # in absence of how to find out what sort of an object I am
93 # this is how a pc connection starts (for an incoming connection)
94 # issue a PC38 followed by a PC18, then wait for a PC20 (remembering
95 # all the crap that comes between).
98 my ($self, $line, $sort) = @_;
99 my $call = $self->{call};
100 my $user = $self->{user};
102 # remember type of connection
103 $self->{consort} = $line;
104 $self->{outbound} = $sort eq 'O';
105 $self->{priv} = $user->priv;
106 $self->{lang} = $user->lang;
107 $self->{isolate} = $user->{isolate};
108 $self->{consort} = $line; # save the connection type
112 $self->{spotfilter} = Filter::read_in('spots', $call);
113 $self->{wwvfilter} = Filter::read_in('wwv', $call);
114 $self->{annfilter} = Filter::read_in('ann', $call);
117 $self->send_now('B',"0");
119 # send initialisation string
120 if (!$self->{outbound}) {
121 $self->send(pc38()) if DXNode->get_all();
124 $self->state('init');
127 Log('DXProt', "$call connected");
131 # This is the normal pcxx despatcher
135 my ($self, $line) = @_;
136 my @field = split /\^/, $line;
137 pop @field if $field[-1] eq '~';
139 # print join(',', @field), "\n";
141 # ignore any lines that don't start with PC
142 return if !$field[0] =~ /^PC/;
145 my ($pcno) = $field[0] =~ /^PC(\d\d)/; # just get the number
147 return if $pcno < 10 || $pcno > 51;
152 $pcr = Local::pcprot($self, $pcno, @field);
154 # dbg('local', "Local::pcprot error $@") if $@;
158 if ($pcno == 10) { # incoming talk
160 # is it for me or one of mine?
161 my $call = ($field[5] gt ' ') ? $field[5] : $field[2];
162 if ($call eq $main::mycall || grep $_ eq $call, get_all_user_calls()) {
165 my $text = unpad($field[3]);
166 Log('talk', $call, $field[1], $field[6], $text);
167 $call = $main::myalias if $call eq $main::mycall;
168 my $ref = DXChannel->get($call);
169 $ref->send("$call de $field[1]: $text") if $ref && $ref->{talk};
171 route($field[2], $line); # relay it on its way
176 if ($pcno == 11 || $pcno == 26) { # dx spot
178 # if this is a 'nodx' node then ignore it
179 last SWITCH if grep $field[7] =~ /^$_/, @DXProt::nodx_node;
181 # convert the date to a unix date
182 my $d = cltounix($field[3], $field[4]);
183 # bang out (and don't pass on) if date is invalid or the spot is too old (or too young)
184 if (!$d || ($pcno == 11 && ($d < $main::systime - $pc11_max_age || $d > $main::systime + 900))) {
185 dbg('chan', "Spot ignored, invalid date or out of range ($field[3] $field[4])\n");
189 # strip off the leading & trailing spaces from the comment
190 my $text = unpad($field[5]);
193 my $spotter = $field[6];
194 $spotter =~ s/-\d+$//o; # strip off the ssid from the spotter
197 my $freq = $field[1] - 0;
198 my $dupkey = "$freq$field[2]$d$text$spotter";
199 if ($spotdup{$dupkey}) {
200 dbg('chan', "Duplicate Spot ignored\n");
204 $spotdup{$dupkey} = $d;
207 if (grep $field[2] eq $_, @baddx) {
208 dbg('chan', "Bad DX spot, ignored");
212 my @spot = Spot::add($freq, $field[2], $d, $text, $spotter, $field[7]);
215 # @spot at this point contains:-
216 # freq, spotted call, time, text, spotter, spotted cc, spotters cc, orig node
217 # then spotted itu, spotted cq, spotters itu, spotters cq
218 # you should be able to route on any of these
224 $r = Local::spot($self, @spot);
226 # dbg('local', "Local::spot1 error $@") if $@;
229 # DON'T be silly and send on PC26s!
230 return if $pcno == 26;
232 # send out the filtered spots
233 my @dxchan = get_all_ak1a();
236 # send it if it isn't the except list and isn't isolated and still has a hop count
237 # taking into account filtering and so on
238 foreach $dxchan (@dxchan) {
239 next if $dxchan == $self;
241 my ($filter, $hops) = Filter::it($dxchan->{spotfilter}, @spot, $self->{call} ) if $dxchan->{spotfilter};
244 $routeit =~ s/\^H\d+\^\~$/\^H$hops\^\~/;
246 $routeit = adjust_hops($dxchan, $line); # adjust its hop count by node name
247 next unless $routeit;
250 $dxchan->send($routeit) if $routeit;
252 $dxchan->send($routeit) unless $dxchan->{isolate} || $self->{isolate};
256 # send orf to the users
258 my $buf = Spot::formatb($field[1], $field[2], $d, $text, $spotter);
259 broadcast_users("$buf\a\a", 'dx', $spot[0]);
265 if ($pcno == 12) { # announces
267 if ($field[2] eq '*' || $field[2] eq $main::mycall) {
269 # strip leading and trailing stuff
270 my $text = unpad($field[3]);
275 if ($field[4] eq '*') { # sysops
277 @list = map { $_->priv >= 5 ? $_ : () } get_all_users();
278 } elsif ($field[4] gt ' ') { # speciality list handling
279 my ($name) = split /\./, $field[4];
280 $target = "$name"; # put the rest in later (if bothered)
283 if ($field[6] eq '1') {
287 $target = "All" if !$target;
290 broadcast_list("$to$target de $field[1]: $text", 'ann', undef, @list);
292 broadcast_users("$target de $field[1]: $text", 'ann', undef);
294 Log('ann', $target, $field[1], $text);
296 return if $field[2] eq $main::mycall; # it's routed to me
298 route($field[2], $line);
299 return; # only on a routed one
315 if ($pcno == 16) { # add a user
316 my $node = DXCluster->get_exact($field[1]);
317 last SWITCH if !$node; # ignore if havn't seen a PC19 for this one yet
318 last SWITCH unless $node->isa('DXNode');
322 for ($i = 2; $i < $#field; $i++) {
323 my ($call, $confmode, $here) = $field[$i] =~ /^(\S+) (\S) (\d)/o;
324 next if !$call || length $call < 3 || length $call > 8;
327 next if DXCluster->get_exact($call); # we already have this (loop?)
329 $confmode = $confmode eq '*';
330 DXNodeuser->new($self, $node, $call, $confmode, $here);
332 # add this station to the user database, if required
333 $call =~ s/-\d+$//o; # remove ssid for users
334 my $user = DXUser->get_current($call);
335 $user = DXUser->new($call) if !$user;
336 $user->homenode($node->call) if !$user->homenode;
337 $user->node($node->call);
338 $user->lastin($main::systime);
342 # queue up any messages (look for privates only)
343 DXMsg::queue_msg(1) if $self->state eq 'normal';
347 if ($pcno == 17) { # remove a user
349 my $ref = DXCluster->get_exact($field[1]);
354 if ($pcno == 18) { # link request
355 $self->send_local_config();
357 $self->state('init');
358 return; # we don't pass these on
361 if ($pcno == 19) { # incoming cluster list
363 for ($i = 1; $i < $#field-1; $i += 4) {
364 my $here = $field[$i];
365 my $call = uc $field[$i+1];
366 my $confmode = $field[$i+2] eq '*';
367 my $ver = $field[$i+3];
369 # now check the call over
370 next if DXCluster->get_exact($call); # we already have this
372 # check for sane parameters
373 next if $ver < 5000; # only works with version 5 software
374 next if length $call < 3; # min 3 letter callsigns
375 DXNode->new($self, $call, $confmode, $here, $ver);
377 # unbusy and stop and outgoing mail (ie if somehow we receive another PC19 without a disconnect)
378 my $mref = DXMsg::get_busy($call);
379 $mref->stop_msg($self) if $mref;
381 # add this station to the user database, if required (don't remove SSID from nodes)
382 my $user = DXUser->get_current($call);
384 $user = DXUser->new($call);
386 $user->priv(1); # I have relented and defaulted nodes
387 $self->{priv} = 1; # to user RCMDs allowed
388 $user->homenode($call);
391 $user->lastin($main::systime);
395 # queue up any messages
396 DXMsg::queue_msg(0) if $self->state eq 'normal';
400 if ($pcno == 20) { # send local configuration
401 $self->send_local_config();
403 $self->state('normal');
411 if ($pcno == 21) { # delete a cluster from the list
412 my $call = uc $field[1];
413 if ($call ne $main::mycall) { # don't allow malicious buggers to disconnect me!
414 my $ref = DXCluster->get_exact($call);
421 $self->state('normal');
428 if ($pcno == 23 || $pcno == 27) { # WWV info
430 my $d = cltounix($field[1], sprintf("%02d18Z", $field[2]));
431 my $sfi = unpad($field[3]);
432 my $k = unpad($field[4]);
433 my $i = unpad($field[5]);
434 my $dupkey = "$d.$sfi$k$i";
435 if ($wwvdup{$dupkey}) {
436 dbg('chan', "Dup WWV Spot ignored\n");
439 if ($d > $main::systime + 900 || $field[2] < 0 || $field[2] > 23) {
440 dbg('chan', "WWV Date ($field[1] $field[2]) out of range");
443 $wwvdup{$dupkey} = $d;
444 $field[6] =~ s/-\d+$//o; # remove spotter's ssid
446 my $wwv = Geomag::update($d, $field[2], $sfi, $k, $i, @field[6..$#field]);
450 $r = Local::wwv($self, $field[1], $field[2], $sfi, $k, $i, @field[6..$#field]);
452 # dbg('local', "Local::wwv2 error $@") if $@;
455 # DON'T be silly and send on PC27s!
456 return if $pcno == 27;
458 # broadcast to the eager users
459 broadcast_users("WWV de $field[7] <$field[2]>: SFI=$sfi, A=$k, K=$i, $field[6]", 'wwv', $wwv );
463 if ($pcno == 24) { # set here status
464 my $call = uc $field[1];
465 my $ref = DXCluster->get_exact($call);
466 $ref->here($field[2]) if $ref;
470 if ($pcno == 25) { # merge request
471 unless ($field[1] eq $main::mycall) {
472 dbg('chan', "merge request to $field[1] from $field[2] ignored");
476 Log('DXProt', "Merge request for $field[3] spots and $field[4] WWV from $field[1]");
480 my @in = reverse Spot::search(1, undef, undef, 0, $field[3]-1);
483 $self->send(pc26(@{$in}[0..4], $in->[7]));
489 my @in = reverse Geomag::search(0, $field[4], time, 1);
492 $self->send(pc27(@{$in}));
498 if (($pcno >= 28 && $pcno <= 33) || $pcno == 40 || $pcno == 42 || $pcno == 49) { # mail/file handling
499 DXMsg::process($self, $line);
503 if ($pcno == 34 || $pcno == 36) { # remote commands (incoming)
504 if ($field[1] eq $main::mycall) {
505 my $ref = DXUser->get_current($field[2]);
506 Log('rcmd', 'in', $ref->{priv}, $field[2], $field[3]);
507 unless ($field[3] =~ /rcmd/i) { # not allowed to relay RCMDS!
508 if ($ref->{priv}) { # you have to have SOME privilege, the commands have further filtering
509 $self->{remotecmd} = 1; # for the benefit of any command that needs to know
510 my @in = (DXCommandmode::run_cmd($self, $field[3]));
513 $self->send(pc35($main::mycall, $field[2], "$main::mycall:$_"));
514 Log('rcmd', 'out', $field[2], $_);
516 delete $self->{remotecmd};
519 $self->send(pc35($main::mycall, $field[2], "$main::mycall:Tut tut tut...!"));
522 route($field[1], $line);
527 if ($pcno == 35) { # remote command replies
528 if ($field[1] eq $main::mycall) {
529 my $s = $rcmds{$field[2]};
531 my $dxchan = DXChannel->get($s->{call});
532 $dxchan->send($field[3]) if $dxchan;
533 delete $rcmds{$field[2]} if !$dxchan;
536 route($field[1], $line);
545 if ($pcno == 38) { # node connected list from neighbour
549 if ($pcno == 39) { # incoming disconnect
554 if ($pcno == 41) { # user info
555 # add this station to the user database, if required
556 my $user = DXUser->get_current($field[1]);
558 # then try without an SSID
559 $field[1] =~ s/-\d+$//o;
560 $user = DXUser->get_current($field[1]);
562 $user = DXUser->new($field[1]) if !$user;
564 if ($field[2] == 1) {
565 $user->name($field[3]);
566 } elsif ($field[2] == 2) {
567 $user->qth($field[3]);
568 } elsif ($field[2] == 3) {
569 my ($lat, $long) = DXBearing::stoll($field[3]);
572 } elsif ($field[2] == 4) {
573 $user->homenode($field[3]);
597 if ($pcno == 50) { # keep alive/user list
598 my $ref = DXCluster->get_exact($field[1]);
599 $ref->update_users($field[2]) if $ref;
603 if ($pcno == 51) { # incoming ping requests/answers
606 if ($field[1] eq $main::mycall) {
607 my $flag = $field[3];
609 $self->send(pc51($field[2], $field[1], '0'));
611 # it's a reply, look in the ping list for this one
612 my $ref = $pings{$field[2]};
615 my $dxchan = DXChannel->get($r->{call});
616 $dxchan->send($dxchan->msg('pingi', $field[2], atime($main::systime), $main::systime - $r->{t})) if $dxchan;
621 # route down an appropriate thingy
622 route($field[1], $line);
628 # if get here then rebroadcast the thing with its Hop count decremented (if
629 # there is one). If it has a hop count and it decrements to zero then don't
632 # NOTE - don't arrive here UNLESS YOU WANT this lump of protocol to be
636 if (!$self->{isolate}) {
637 broadcast_ak1a($line, $self); # send it to everyone but me
642 # This is called from inside the main cluster processing loop and is used
643 # for despatching commands that are doing some long processing job
648 my @dxchan = DXChannel->get_all();
651 foreach $dxchan (@dxchan) {
652 next unless $dxchan->is_ak1a();
653 next if $dxchan == $me;
655 # send a pc50 out on this channel
656 if ($t >= $dxchan->pc50_t + $DXProt::pc50_interval) {
657 $dxchan->send(pc50());
665 if ($main::systime - 3600 > $last_hour) {
666 $cutoff = $main::systime - $pc11_dup_age;
667 while (($key, $val) = each %spotdup) {
668 delete $spotdup{$key} if $val < $cutoff;
670 $cutoff = $main::systime - $pc23_dup_age;
671 while (($key, $val) = each %wwvdup) {
672 delete $wwvdup{$key} if $val < $cutoff;
674 $last_hour = $main::systime;
679 # finish up a pc context
684 my $call = $self->call;
685 my $ref = DXCluster->get_exact($call);
687 # unbusy and stop and outgoing mail
688 my $mref = DXMsg::get_busy($call);
689 $mref->stop_msg($self) if $mref;
691 # broadcast to all other nodes that all the nodes connected to via me are gone
692 my @gonenodes = map { $_->dxchan == $self ? $_ : () } DXNode::get_all();
695 foreach $node (@gonenodes) {
696 next if $node->call eq $call;
697 broadcast_ak1a(pc21($node->call, 'Gone') , $self) unless $self->{isolate};
701 # remove outstanding pings
702 delete $pings{$call};
704 # now broadcast to all other ak1a nodes that I have gone
705 broadcast_ak1a(pc21($call, 'Gone.'), $self);
707 Log('DXProt', $call . " Disconnected");
712 # some active measures
715 sub send_local_config
724 if ($self->{isolate}) {
725 @localnodes = (DXCluster->get_exact($main::mycall));
727 # create a list of all the nodes that are not connected to this connection
728 # and are not themselves isolated, this to make sure that isolated nodes
729 # don't appear outside of this node
730 @nodes = DXNode::get_all();
731 @nodes = grep { $_->dxchan != $self } @nodes;
732 @nodes = grep { $_->{call} ne $main::mycall } @nodes;
733 @localnodes = grep { $_->dxchan->{call} eq $_->{call} && !$_->dxchan->{isolate} } @nodes if @nodes;
734 unshift @localnodes, DXCluster->get_exact($main::mycall);
735 @remotenodes = grep { $_->dxchan->{call} ne $_->{call} } @nodes if @nodes;
738 my @s = $me->pc19(@localnodes, @remotenodes);
740 my $routeit = adjust_hops($self, $_);
741 $self->send($routeit) if $routeit;
744 # get all the users connected on the above nodes and send them out
745 foreach $n (@localnodes, @remotenodes) {
746 my @users = values %{$n->list};
747 my @s = pc16($n, @users);
749 my $routeit = adjust_hops($self, $_);
750 $self->send($routeit) if $routeit;
756 # route a message down an appropriate interface for a callsign
758 # is called route(to, pcline);
762 my ($call, $line) = @_;
763 my $cl = DXCluster->get_exact($call);
766 my $dxchan = $cl->{dxchan};
768 my $routeit = adjust_hops($dxchan, $line); # adjust its hop count by node name
770 $dxchan->send($routeit) if $dxchan;
776 # broadcast a message to all clusters taking into account isolation
777 # [except those mentioned after buffer]
780 my $s = shift; # the line to be rebroadcast
781 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
782 my @dxchan = get_all_ak1a();
785 # send it if it isn't the except list and isn't isolated and still has a hop count
786 foreach $dxchan (@dxchan) {
787 next if grep $dxchan == $_, @except;
788 my $routeit = adjust_hops($dxchan, $s); # adjust its hop count by node name
789 $dxchan->send($routeit) unless $dxchan->{isolate} || !$routeit;
793 # broadcast a message to all clusters ignoring isolation
794 # [except those mentioned after buffer]
795 sub broadcast_all_ak1a
797 my $s = shift; # the line to be rebroadcast
798 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
799 my @dxchan = get_all_ak1a();
802 # send it if it isn't the except list and isn't isolated and still has a hop count
803 foreach $dxchan (@dxchan) {
804 next if grep $dxchan == $_, @except;
805 my $routeit = adjust_hops($dxchan, $s); # adjust its hop count by node name
806 $dxchan->send($routeit);
810 # broadcast to all users
811 # storing the spot or whatever until it is in a state to receive it
814 my $s = shift; # the line to be rebroadcast
815 my $sort = shift; # the type of transmission
816 my $fref = shift; # a reference to an object to filter on
817 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
818 my @dxchan = get_all_users();
822 foreach $dxchan (@dxchan) {
823 next if grep $dxchan == $_, @except;
826 broadcast_list($s, $sort, $fref, @out);
829 # broadcast to a list of users
837 foreach $dxchan (@_) {
841 next unless $dxchan->{dx};
842 ($filter) = Filter::it($dxchan->{spotfilter}, @{$fref}) if ref $fref;
845 next if $sort eq 'ann' && !$dxchan->{ann};
846 next if $sort eq 'wwv' && !$dxchan->{wwv};
847 next if $sort eq 'wx' && !$dxchan->{wx};
849 $s =~ s/\a//og unless $dxchan->{beep};
851 if ($dxchan->{state} eq 'prompt' || $dxchan->{state} eq 'convers') {
860 # gimme all the ak1a nodes
864 my @list = DXChannel->get_all();
867 foreach $ref (@list) {
868 push @out, $ref if $ref->is_ak1a;
873 # return a list of all users
876 my @list = DXChannel->get_all();
879 foreach $ref (@list) {
880 push @out, $ref if $ref->is_user;
885 # return a list of all user callsigns
886 sub get_all_user_calls
888 my @list = DXChannel->get_all();
891 foreach $ref (@list) {
892 push @out, $ref->call if $ref->is_user;
898 # obtain the hops from the list for this callsign and pc no
904 my $hops = $DXProt::hopcount{$pcno};
905 $hops = $DXProt::def_hopcount if !$hops;
910 # adjust the hop count on a per node basis using the user loadable
911 # hop table if available or else decrement an existing one
918 my $call = $self->{call};
921 if (($hops) = $s =~ /\^H(\d+)\^~?$/o) {
922 my ($pcno) = $s =~ /^PC(\d\d)/o;
923 confess "$call called adjust_hops with '$s'" unless $pcno;
924 my $ref = $nodehops{$call} if %nodehops;
926 my $newhops = $ref->{$pcno};
927 return "" if defined $newhops && $newhops == 0;
928 $newhops = $ref->{default} unless $newhops;
929 return "" if defined $newhops && $newhops == 0;
930 $newhops = $hops if !$newhops;
931 $s =~ s/\^H(\d+)(\^~?)$/\^H$newhops$2/ if $newhops;
933 # simply decrement it
936 $s =~ s/\^H(\d+)(\^~?)$/\^H$hops$2/ if $hops;
948 return $self->msg('lh1') unless -e "$main::data/hop_table.pl";
949 do "$main::data/hop_table.pl";
954 # remove leading and trailing spaces from an input string
962 # add a ping request to the ping queues
965 my ($from, $to) = @_;
966 my $ref = $pings{$to};
967 $ref = $pings{$to} = [] if !$ref;
970 $r->{t} = $main::systime;
971 route($to, pc51($to, $main::mycall, 1));
975 # add a rcmd request to the rcmd queues
978 my ($from, $to, $cmd) = @_;
981 $r->{t} = $main::systime;
983 route($to, pc34($main::mycall, $to, $cmd));