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 $pc12_dup_age
36 $me = undef; # the channel id for this cluster
37 $pc11_max_age = 1*3600; # the maximum age for an incoming 'real-time' pc11
38 $pc11_dup_age = 24*3600; # the maximum time to keep the spot dup list for
39 $pc23_dup_age = 24*3600; # the maximum time to keep the wwv dup list for
40 $pc12_dup_age = 24*3600; # the maximum time to keep the ann dup list for
41 %spotdup = (); # the pc11 and 26 dup hash
42 %wwvdup = (); # the pc23 and 27 dup hash
43 %anndup = (); # the PC12 dup hash
44 $last_hour = time; # last time I did an hourly periodic update
45 %pings = (); # outstanding ping requests outbound
46 %rcmds = (); # outstanding rcmd requests outbound
47 %nodehops = (); # node specific hop control
48 @baddx = (); # list of illegal spotted callsigns
50 $baddxfn = "$main::data/baddx.pl";
54 my $user = DXUser->get($main::mycall);
55 $DXProt::myprot_version += $main::version*100;
56 $me = DXProt->new($main::mycall, 0, $user);
58 $me->{state} = "indifferent";
59 do "$main::data/hop_table.pl" if -e "$main::data/hop_table.pl";
61 # $me->{sort} = 'M'; # M for me
63 # now prime the spot duplicates file with today's and yesterday's data
64 my @today = Julian::unixtoj(time);
65 my @spots = Spot::readfile(@today);
66 @today = Julian::sub(@today, 1);
67 push @spots, Spot::readfile(@today);
69 my $dupkey = "$_->[0]$_->[1]$_->[2]$_->[3]$_->[4]";
70 $spotdup{$dupkey} = $_->[2];
73 # now prime the wwv duplicates file with just this month's data
74 my @wwv = Geomag::readfile(time);
76 my $dupkey = "$_->[1].$_->[2]$_->[3]$_->[4]";
77 $wwvdup{$dupkey} = $_->[1];
81 do "$baddxfn" if -e "$baddxfn";
86 # obtain a new connection this is derived from dxchannel
91 my $self = DXChannel::alloc(@_);
92 $self->{'sort'} = 'A'; # in absence of how to find out what sort of an object I am
96 # this is how a pc connection starts (for an incoming connection)
97 # issue a PC38 followed by a PC18, then wait for a PC20 (remembering
98 # all the crap that comes between).
101 my ($self, $line, $sort) = @_;
102 my $call = $self->{call};
103 my $user = $self->{user};
105 # remember type of connection
106 $self->{consort} = $line;
107 $self->{outbound} = $sort eq 'O';
108 $self->{priv} = $user->priv;
109 $self->{lang} = $user->lang;
110 $self->{isolate} = $user->{isolate};
111 $self->{consort} = $line; # save the connection type
115 $self->{spotfilter} = Filter::read_in('spots', $call);
116 $self->{wwvfilter} = Filter::read_in('wwv', $call);
117 $self->{annfilter} = Filter::read_in('ann', $call);
119 # set unbuffered and no echo
120 $self->send_now('B',"0");
121 $self->send_now('E',"0");
123 # send initialisation string
124 if (!$self->{outbound}) {
125 $self->send(pc38()) if DXNode->get_all();
128 $self->state('init');
131 Log('DXProt', "$call connected");
135 # This is the normal pcxx despatcher
139 my ($self, $line) = @_;
140 my @field = split /\^/, $line;
141 pop @field if $field[-1] eq '~';
143 # print join(',', @field), "\n";
145 # ignore any lines that don't start with PC
146 return if !$field[0] =~ /^PC/;
149 my ($pcno) = $field[0] =~ /^PC(\d\d)/; # just get the number
151 return if $pcno < 10 || $pcno > 51;
153 # dump bad protocol messages unless it is a PC29
154 if ($line =~ /\%[0-9A-F][0-9A-F]/o && $pcno != 29) {
155 dbg('chan', "CORRUPT protocol message - dumped");
162 $pcr = Local::pcprot($self, $pcno, @field);
164 # dbg('local', "Local::pcprot error $@") if $@;
168 if ($pcno == 10) { # incoming talk
170 # is it for me or one of mine?
171 my $call = ($field[5] gt ' ') ? $field[5] : $field[2];
172 if ($call eq $main::mycall || grep $_ eq $call, get_all_user_calls()) {
175 my $text = unpad($field[3]);
176 Log('talk', $call, $field[1], $field[6], $text);
177 $call = $main::myalias if $call eq $main::mycall;
178 my $ref = DXChannel->get($call);
179 $ref->send("$call de $field[1]: $text") if $ref && $ref->{talk};
181 route($field[2], $line); # relay it on its way
186 if ($pcno == 11 || $pcno == 26) { # dx spot
188 # route 'foreign' pc26s
190 if ($field[7] ne $main::mycall) {
191 route($field[7], $line);
196 # if this is a 'nodx' node then ignore it
197 last SWITCH if grep $field[7] =~ /^$_/, @DXProt::nodx_node;
199 # convert the date to a unix date
200 my $d = cltounix($field[3], $field[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 && ($d < $main::systime - $pc11_max_age || $d > $main::systime + 900))) {
203 dbg('chan', "Spot ignored, invalid date or out of range ($field[3] $field[4])\n");
207 # strip off the leading & trailing spaces from the comment
208 my $text = unpad($field[5]);
211 my $spotter = $field[6];
212 $spotter =~ s/-\d+$//o; # strip off the ssid from the spotter
215 my $freq = $field[1] - 0;
216 my $dupkey = "$freq$field[2]$d$text$spotter";
217 if ($spotdup{$dupkey}) {
218 dbg('chan', "Duplicate Spot ignored\n");
222 $spotdup{$dupkey} = $d;
225 if (grep $field[2] eq $_, @baddx) {
226 dbg('chan', "Bad DX spot, ignored");
230 # are any of the crucial fields invalid?
231 if ($field[2] =~ /[a-z]/ || $field[6] =~ /[a-z]/ || $field[7] =~ /[a-z]/) {
232 dbg('chan', "Spot contains lower case callsigns, rejected");
236 my @spot = Spot::add($freq, $field[2], $d, $text, $spotter, $field[7]);
239 # @spot at this point contains:-
240 # freq, spotted call, time, text, spotter, spotted cc, spotters cc, orig node
241 # then spotted itu, spotted cq, spotters itu, spotters cq
242 # you should be able to route on any of these
248 $r = Local::spot($self, @spot);
250 # dbg('local', "Local::spot1 error $@") if $@;
253 # DON'T be silly and send on PC26s!
254 return if $pcno == 26;
256 # send out the filtered spots
257 send_dx_spot($self, $line, @spot) if @spot;
261 if ($pcno == 12) { # announces
262 # announce duplicate checking
263 my $text = uc unpad($field[3]);
264 my $dupkey = $field[1].$field[2].$text.$field[4].$field[6];
265 if ($anndup{$dupkey}) {
266 dbg('chan', "Duplicate Announce ignored\n");
269 $anndup{$dupkey} = $main::systime;
271 # global ann filtering
272 my ($filter, $hops) = Filter::it($self->{annfilter}, @field[1..6], $self->{call} ) if $self->{annfilter};
273 if ($self->{annfilter} && !$filter) {
274 dbg('chan', "Rejected by filter");
278 if ($field[2] eq '*' || $field[2] eq $main::mycall) {
280 # strip leading and trailing stuff
281 my $text = unpad($field[3]);
286 if ($field[4] eq '*') { # sysops
288 @list = map { $_->priv >= 5 ? $_ : () } get_all_users();
289 } elsif ($field[4] gt ' ') { # speciality list handling
290 my ($name) = split /\./, $field[4];
291 $target = "$name"; # put the rest in later (if bothered)
294 if ($field[6] eq '1') {
298 $target = "All" if !$target;
301 broadcast_list("$to$target de $field[1]: $text", 'ann', undef, @list);
303 broadcast_users("$target de $field[1]: $text", 'ann', undef);
305 Log('ann', $target, $field[1], $text);
307 return if $field[2] eq $main::mycall; # it's routed to me
309 route($field[2], $line);
310 return; # only on a routed one
326 if ($pcno == 16) { # add a user
327 my $node = DXCluster->get_exact($field[1]);
328 return unless $node; # ignore if havn't seen a PC19 for this one yet
329 return unless $node->isa('DXNode');
330 if ($node->dxchan != $self) {
331 dbg('chan', "LOOP: $field[1] came in on wrong channel");
335 if (($dxchan = DXChannel->get($field[1])) && $dxchan != $self) {
336 dbg('chan', "LOOP: $field[1] connected locally");
342 for ($i = 2; $i < $#field; $i++) {
343 my ($call, $confmode, $here) = $field[$i] =~ /^(\S+) (\S) (\d)/o;
344 next if !$call || length $call < 3 || length $call > 8;
347 next if DXCluster->get_exact($call); # we already have this (loop?)
349 $confmode = $confmode eq '*';
350 DXNodeuser->new($self, $node, $call, $confmode, $here);
352 # add this station to the user database, if required
353 $call =~ s/-\d+$//o; # remove ssid for users
354 my $user = DXUser->get_current($call);
355 $user = DXUser->new($call) if !$user;
356 $user->homenode($node->call) if !$user->homenode;
357 $user->node($node->call);
358 $user->lastin($main::systime) unless DXChannel->get($call);
362 # queue up any messages (look for privates only)
363 DXMsg::queue_msg(1) if $self->state eq 'normal';
367 if ($pcno == 17) { # remove a user
368 my $node = DXCluster->get_exact($field[2]);
370 return unless $node->isa('DXNode');
371 if ($node->dxchan != $self) {
372 dbg('chan', "LOOP: $field[2] came in on wrong channel");
376 if (($dxchan = DXChannel->get($field[2])) && $dxchan != $self) {
377 dbg('chan', "LOOP: $field[2] connected locally");
380 my $ref = DXCluster->get_exact($field[1]);
385 if ($pcno == 18) { # link request
386 $self->state('init');
388 # first clear out any nodes on this dxchannel
389 my @gonenodes = map { $_->dxchan == $self ? $_ : () } DXNode::get_all();
390 foreach my $node (@gonenodes) {
391 next if $node->dxchan == $DXProt::me;
392 broadcast_ak1a(pc21($node->call, 'Gone, re-init') , $self) unless $self->{isolate};
395 $self->send_local_config();
397 return; # we don't pass these on
400 if ($pcno == 19) { # incoming cluster list
402 my $newline = "PC19^";
403 for ($i = 1; $i < $#field-1; $i += 4) {
404 my $here = $field[$i];
405 my $call = uc $field[$i+1];
406 my $confmode = $field[$i+2];
407 my $ver = $field[$i+3];
409 $ver = 5400 if !$ver && $allowzero;
411 # now check the call over
412 my $node = DXCluster->get_exact($call);
415 if (($dxchan = DXChannel->get($call)) && $dxchan != $self) {
416 dbg('chan', "LOOP: $call connected locally");
418 if ($node->dxchan != $self) {
419 dbg('chan', "LOOP: $call come in on wrong channel");
422 dbg('chan', "already have $call");
426 # check for sane parameters
427 next if $ver < 5000; # only works with version 5 software
428 next if length $call < 3; # min 3 letter callsigns
430 # add it to the nodes table and outgoing line
431 $newline .= "$here^$call^$confmode^$ver^";
432 DXNode->new($self, $call, $confmode, $here, $ver);
434 # unbusy and stop and outgoing mail (ie if somehow we receive another PC19 without a disconnect)
435 my $mref = DXMsg::get_busy($call);
436 $mref->stop_msg($call) if $mref;
438 # add this station to the user database, if required (don't remove SSID from nodes)
439 my $user = DXUser->get_current($call);
441 $user = DXUser->new($call);
443 $user->priv(1); # I have relented and defaulted nodes
444 $self->{priv} = 1; # to user RCMDs allowed
445 $user->homenode($call);
448 $user->lastin($main::systime) unless DXChannel->get($call);
452 return if $newline eq "PC19^";
455 $newline .= get_hops(19) . "^";
460 if ($pcno == 20) { # send local configuration
461 $self->send_local_config();
463 $self->state('normal');
467 if ($pcno == 21) { # delete a cluster from the list
468 my $call = uc $field[1];
469 if ($call ne $main::mycall) { # don't allow malicious buggers to disconnect me!
470 my $node = DXCluster->get_exact($call);
472 if ($node->dxchan != $self) {
473 dbg('chan', "LOOP: $call come in on wrong channel");
477 if (($dxchan = DXChannel->get($call)) && $dxchan != $self) {
478 dbg('chan', "LOOP: $call connected locally");
483 dbg('chan', "$call not in table, dropped");
491 $self->state('normal');
495 if ($pcno == 23 || $pcno == 27) { # WWV info
497 # route 'foreign' pc27s
499 if ($field[8] ne $main::mycall) {
500 route($field[8], $line);
506 my $d = cltounix($field[1], sprintf("%02d18Z", $field[2]));
507 my $sfi = unpad($field[3]);
508 my $k = unpad($field[4]);
509 my $i = unpad($field[5]);
510 my $dupkey = "$d.$sfi$k$i";
511 if ($wwvdup{$dupkey}) {
512 dbg('chan', "Dup WWV Spot ignored\n");
515 if ($d > $main::systime + 900 || $field[2] < 0 || $field[2] > 23) {
516 dbg('chan', "WWV Date ($field[1] $field[2]) out of range");
519 $wwvdup{$dupkey} = $d;
520 $field[6] =~ s/-\d+$//o; # remove spotter's ssid
522 my $wwv = Geomag::update($d, $field[2], $sfi, $k, $i, @field[6..8]);
526 $r = Local::wwv($self, $field[1], $field[2], $sfi, $k, $i, @field[6..8]);
528 # dbg('local', "Local::wwv2 error $@") if $@;
531 # DON'T be silly and send on PC27s!
532 return if $pcno == 27;
534 # broadcast to the eager world
535 send_wwv_spot($self, $line, $d, $field[2], $sfi, $k, $i, @field[6..8]);
539 if ($pcno == 24) { # set here status
540 my $call = uc $field[1];
541 my $ref = DXCluster->get_exact($call);
542 $ref->here($field[2]) if $ref;
546 if ($pcno == 25) { # merge request
547 if ($field[1] ne $main::mycall) {
548 route($field[1], $line);
551 if ($field[2] eq $main::mycall) {
552 dbg('chan', "Trying to merge to myself, ignored");
556 Log('DXProt', "Merge request for $field[3] spots and $field[4] WWV from $field[1]");
560 my @in = reverse Spot::search(1, undef, undef, 0, $field[3]-1);
563 $self->send(pc26(@{$in}[0..4], $field[2]));
569 my @in = reverse Geomag::search(0, $field[4], time, 1);
572 $self->send(pc27(@{$in}[0..5], $field[2]));
578 if (($pcno >= 28 && $pcno <= 33) || $pcno == 40 || $pcno == 42 || $pcno == 49) { # mail/file handling
579 if ($pcno == 49 || $field[1] eq $main::mycall) {
580 DXMsg::process($self, $line);
582 route($field[1], $line);
587 if ($pcno == 34 || $pcno == 36) { # remote commands (incoming)
588 if ($field[1] eq $main::mycall) {
589 my $ref = DXUser->get_current($field[2]);
590 my $cref = DXCluster->get($field[2]);
591 Log('rcmd', 'in', $ref->{priv}, $field[2], $field[3]);
592 unless ($field[3] =~ /rcmd/i || !$cref || !$ref || $cref->mynode->call ne $ref->homenode) { # not allowed to relay RCMDS!
593 if ($ref->{priv}) { # you have to have SOME privilege, the commands have further filtering
594 $self->{remotecmd} = 1; # for the benefit of any command that needs to know
595 my $oldpriv = $self->{priv};
596 $self->{priv} = $ref->{priv}; # assume the user's privilege level
597 my @in = (DXCommandmode::run_cmd($self, $field[3]));
598 $self->{priv} = $oldpriv;
601 $self->send(pc35($main::mycall, $field[2], "$main::mycall:$_"));
602 Log('rcmd', 'out', $field[2], $_);
604 delete $self->{remotecmd};
606 $self->send(pc35($main::mycall, $field[2], "$main::mycall:sorry...!"));
609 $self->send(pc35($main::mycall, $field[2], "$main::mycall:your attempt is logged, Tut tut tut...!"));
612 route($field[1], $line);
617 if ($pcno == 35) { # remote command replies
618 if ($field[1] eq $main::mycall) {
619 my $s = $rcmds{$field[2]};
621 my $dxchan = DXChannel->get($s->{call});
622 $dxchan->send($field[3]) if $dxchan;
623 delete $rcmds{$field[2]} if !$dxchan;
626 route($field[1], $line);
631 # for pc 37 see 44 onwards
633 if ($pcno == 38) { # node connected list from neighbour
637 if ($pcno == 39) { # incoming disconnect
642 if ($pcno == 41) { # user info
643 # add this station to the user database, if required
644 my $user = DXUser->get_current($field[1]);
646 # then try without an SSID
647 $field[1] =~ s/-\d+$//o;
648 $user = DXUser->get_current($field[1]);
650 $user = DXUser->new($field[1]) if !$user;
652 if ($field[2] == 1) {
653 $user->name($field[3]);
654 } elsif ($field[2] == 2) {
655 $user->qth($field[3]);
656 } elsif ($field[2] == 3) {
657 my ($lat, $long) = DXBearing::stoll($field[3]);
660 } elsif ($field[2] == 4) {
661 $user->homenode($field[3]);
669 if ($pcno == 37 || $pcno == 44 || $pcno == 45 || $pcno == 46 || $pcno == 47) {
670 if ($field[1] eq $main::mycall) {
673 route($field[1], $line);
678 if ($pcno == 50) { # keep alive/user list
679 my $node = DXCluster->get_exact($field[1]);
681 return unless $node->isa('DXNode');
682 return unless $node->dxchan == $self;
683 $node->update_users($field[2]);
688 if ($pcno == 51) { # incoming ping requests/answers
691 if ($field[1] eq $main::mycall) {
692 my $flag = $field[3];
694 $self->send(pc51($field[2], $field[1], '0'));
696 # it's a reply, look in the ping list for this one
697 my $ref = $pings{$field[2]};
700 my $dxchan = DXChannel->get($r->{call});
701 $dxchan->send($dxchan->msg('pingi', $field[2], atime($main::systime), $main::systime - $r->{t})) if $dxchan;
706 # route down an appropriate thingy
707 route($field[1], $line);
713 # if get here then rebroadcast the thing with its Hop count decremented (if
714 # there is one). If it has a hop count and it decrements to zero then don't
717 # NOTE - don't arrive here UNLESS YOU WANT this lump of protocol to be
721 if (!$self->{isolate}) {
722 broadcast_ak1a($line, $self); # send it to everyone but me
727 # This is called from inside the main cluster processing loop and is used
728 # for despatching commands that are doing some long processing job
733 my @dxchan = DXChannel->get_all();
736 foreach $dxchan (@dxchan) {
737 next unless $dxchan->is_ak1a();
738 next if $dxchan == $me;
740 # send a pc50 out on this channel
741 if ($t >= $dxchan->pc50_t + $DXProt::pc50_interval) {
742 $dxchan->send(pc50());
750 if ($main::systime - 3600 > $last_hour) {
751 $cutoff = $main::systime - $pc11_dup_age;
752 while (($key, $val) = each %spotdup) {
753 delete $spotdup{$key} if $val < $cutoff;
755 $cutoff = $main::systime - $pc23_dup_age;
756 while (($key, $val) = each %wwvdup) {
757 delete $wwvdup{$key} if $val < $cutoff;
759 $cutoff = $main::systime - $pc12_dup_age;
760 while (($key, $val) = each %anndup) {
761 delete $anndup{$key} if $val < $cutoff;
763 $last_hour = $main::systime;
768 # finish up a pc context
773 my $call = $self->call;
774 my $ref = DXCluster->get_exact($call);
776 # unbusy and stop and outgoing mail
777 my $mref = DXMsg::get_busy($call);
778 $mref->stop_msg($call) if $mref;
780 # broadcast to all other nodes that all the nodes connected to via me are gone
781 my @gonenodes = map { $_->dxchan == $self ? $_ : () } DXNode::get_all();
784 foreach $node (@gonenodes) {
785 next if $node->call eq $call;
786 broadcast_ak1a(pc21($node->call, 'Gone') , $self) unless $self->{isolate};
790 # remove outstanding pings
791 delete $pings{$call};
793 # now broadcast to all other ak1a nodes that I have gone
794 broadcast_ak1a(pc21($call, 'Gone.'), $self) unless $self->{isolate};
796 Log('DXProt', $call . " Disconnected");
801 # some active measures
807 my @dxchan = DXChannel->get_all();
810 # send it if it isn't the except list and isn't isolated and still has a hop count
811 # taking into account filtering and so on
812 foreach $dxchan (@dxchan) {
814 my ($filter, $hops) = Filter::it($dxchan->{spotfilter}, @_, $self->{call} ) if $dxchan->{spotfilter};
815 if ($dxchan->is_ak1a) {
816 next if $dxchan == $self;
819 $routeit =~ s/\^H\d+\^\~$/\^H$hops\^\~/;
821 $routeit = adjust_hops($dxchan, $line); # adjust its hop count by node name
822 next unless $routeit;
825 $dxchan->send($routeit) if $routeit;
827 $dxchan->send($routeit) unless $dxchan->{isolate} || $self->{isolate};
830 } elsif ($dxchan->is_user && $dxchan->{dx}) {
831 my $buf = Spot::formatb($_[0], $_[1], $_[2], $_[3], $_[4]);
832 $buf .= "\a\a" if $dxchan->{beep};
833 if ($dxchan->{state} eq 'prompt' || $dxchan->{state} eq 'convers') {
834 $dxchan->send($buf) if !$hops || ($hops && $filter);
836 $dxchan->delay($buf) if !$hops || ($hops && $filter);
846 my @dxchan = DXChannel->get_all();
849 # send it if it isn't the except list and isn't isolated and still has a hop count
850 # taking into account filtering and so on
851 foreach $dxchan (@dxchan) {
853 my ($filter, $hops) = Filter::it($dxchan->{wwvfilter}, @_, $self->{call} ) if $dxchan->{wwvfilter};
854 if ($dxchan->is_ak1a) {
855 next if $dxchan == $self;
858 $routeit =~ s/\^H\d+\^\~$/\^H$hops\^\~/;
860 $routeit = adjust_hops($dxchan, $line); # adjust its hop count by node name
861 next unless $routeit;
864 $dxchan->send($routeit) if $routeit;
866 $dxchan->send($routeit) unless $dxchan->{isolate} || $self->{isolate};
869 } elsif ($dxchan->is_user && $dxchan->{wwv}) {
870 my $buf = "WWV de $_[6] <$_[1]>: SFI=$_[2], A=$_[3], K=$_[4], $_[5]";
871 $buf .= "\a\a" if $dxchan->{beep};
872 if ($dxchan->{state} eq 'prompt' || $dxchan->{state} eq 'convers') {
873 $dxchan->send($buf) if !$hops || ($hops && $filter);
875 $dxchan->delay($buf) if !$hops || ($hops && $filter);
881 sub send_local_config
890 if ($self->{isolate}) {
891 @localnodes = (DXCluster->get_exact($main::mycall));
893 # create a list of all the nodes that are not connected to this connection
894 # and are not themselves isolated, this to make sure that isolated nodes
895 # don't appear outside of this node
896 @nodes = DXNode::get_all();
897 @nodes = grep { $_->{call} ne $main::mycall } @nodes;
898 @nodes = grep { $_->dxchan != $self } @nodes if @nodes;
899 @nodes = grep { !$_->dxchan->{isolate} } @nodes if @nodes;
900 @localnodes = grep { $_->dxchan->{call} eq $_->{call} } @nodes if @nodes;
901 unshift @localnodes, DXCluster->get_exact($main::mycall);
902 @remotenodes = grep { $_->dxchan->{call} ne $_->{call} } @nodes if @nodes;
905 my @s = $me->pc19(@localnodes, @remotenodes);
907 my $routeit = adjust_hops($self, $_);
908 $self->send($routeit) if $routeit;
911 # get all the users connected on the above nodes and send them out
912 foreach $n (@localnodes, @remotenodes) {
913 my @users = values %{$n->list};
914 my @s = pc16($n, @users);
916 my $routeit = adjust_hops($self, $_);
917 $self->send($routeit) if $routeit;
923 # route a message down an appropriate interface for a callsign
925 # is called route(to, pcline);
929 my ($call, $line) = @_;
930 my $cl = DXCluster->get_exact($call);
933 my $dxchan = $cl->{dxchan};
935 my $routeit = adjust_hops($dxchan, $line); # adjust its hop count by node name
937 $dxchan->send($routeit) if $dxchan;
943 # broadcast a message to all clusters taking into account isolation
944 # [except those mentioned after buffer]
947 my $s = shift; # the line to be rebroadcast
948 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
949 my @dxchan = get_all_ak1a();
952 # send it if it isn't the except list and isn't isolated and still has a hop count
953 foreach $dxchan (@dxchan) {
954 next if grep $dxchan == $_, @except;
955 my $routeit = adjust_hops($dxchan, $s); # adjust its hop count by node name
956 $dxchan->send($routeit) unless $dxchan->{isolate} || !$routeit;
960 # broadcast a message to all clusters ignoring isolation
961 # [except those mentioned after buffer]
962 sub broadcast_all_ak1a
964 my $s = shift; # the line to be rebroadcast
965 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
966 my @dxchan = get_all_ak1a();
969 # send it if it isn't the except list and isn't isolated and still has a hop count
970 foreach $dxchan (@dxchan) {
971 next if grep $dxchan == $_, @except;
972 my $routeit = adjust_hops($dxchan, $s); # adjust its hop count by node name
973 $dxchan->send($routeit);
977 # broadcast to all users
978 # storing the spot or whatever until it is in a state to receive it
981 my $s = shift; # the line to be rebroadcast
982 my $sort = shift; # the type of transmission
983 my $fref = shift; # a reference to an object to filter on
984 my @except = @_; # to all channels EXCEPT these (dxchannel refs)
985 my @dxchan = get_all_users();
989 foreach $dxchan (@dxchan) {
990 next if grep $dxchan == $_, @except;
993 broadcast_list($s, $sort, $fref, @out);
996 # broadcast to a list of users
1004 foreach $dxchan (@_) {
1007 if ($sort eq 'dx') {
1008 next unless $dxchan->{dx};
1009 ($filter) = Filter::it($dxchan->{spotfilter}, @{$fref}) if ref $fref;
1010 next unless $filter;
1012 next if $sort eq 'ann' && !$dxchan->{ann};
1013 next if $sort eq 'wwv' && !$dxchan->{wwv};
1014 next if $sort eq 'wx' && !$dxchan->{wx};
1016 $s =~ s/\a//og unless $dxchan->{beep};
1018 if ($dxchan->{state} eq 'prompt' || $dxchan->{state} eq 'convers') {
1027 # gimme all the ak1a nodes
1031 my @list = DXChannel->get_all();
1034 foreach $ref (@list) {
1035 push @out, $ref if $ref->is_ak1a;
1040 # return a list of all users
1043 my @list = DXChannel->get_all();
1046 foreach $ref (@list) {
1047 push @out, $ref if $ref->is_user;
1052 # return a list of all user callsigns
1053 sub get_all_user_calls
1055 my @list = DXChannel->get_all();
1058 foreach $ref (@list) {
1059 push @out, $ref->call if $ref->is_user;
1065 # obtain the hops from the list for this callsign and pc no
1071 my $hops = $DXProt::hopcount{$pcno};
1072 $hops = $DXProt::def_hopcount if !$hops;
1077 # adjust the hop count on a per node basis using the user loadable
1078 # hop table if available or else decrement an existing one
1085 my $call = $self->{call};
1088 if (($hops) = $s =~ /\^H(\d+)\^~?$/o) {
1089 my ($pcno) = $s =~ /^PC(\d\d)/o;
1090 confess "$call called adjust_hops with '$s'" unless $pcno;
1091 my $ref = $nodehops{$call} if %nodehops;
1093 my $newhops = $ref->{$pcno};
1094 return "" if defined $newhops && $newhops == 0;
1095 $newhops = $ref->{default} unless $newhops;
1096 return "" if defined $newhops && $newhops == 0;
1097 $newhops = $hops if !$newhops;
1098 $s =~ s/\^H(\d+)(\^~?)$/\^H$newhops$2/ if $newhops;
1100 # simply decrement it
1102 return "" if !$hops;
1103 $s =~ s/\^H(\d+)(\^~?)$/\^H$hops$2/ if $hops;
1115 return $self->msg('lh1') unless -e "$main::data/hop_table.pl";
1116 do "$main::data/hop_table.pl";
1121 # remove leading and trailing spaces from an input string
1125 $s =~ s/^\s+|\s+$//;
1129 # add a ping request to the ping queues
1132 my ($from, $to) = @_;
1133 my $ref = $pings{$to};
1134 $ref = $pings{$to} = [] if !$ref;
1137 $r->{t} = $main::systime;
1138 route($to, pc51($to, $main::mycall, 1));
1142 # add a rcmd request to the rcmd queues
1145 my ($from, $to, $cmd) = @_;
1148 $r->{t} = $main::systime;
1150 route($to, pc34($main::mycall, $to, $cmd));