make set/badnode and badspotter apply to announces and talks as well
[spider.git] / perl / DXProt.pm
1 #!/usr/bin/perl
2 #
3 # This module impliments the protocal mode for a dx cluster
4 #
5 # Copyright (c) 1998 Dirk Koopman G1TLH
6 #
7 # $Id$
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 Time::HiRes qw(gettimeofday tv_interval);
31 use BadWords;
32 use DXHash;
33 use Route;
34 use Route::Node;
35 use Script;
36
37 use strict;
38
39 use vars qw($VERSION $BRANCH);
40 $VERSION = sprintf( "%d.%03d", q$Revision$ =~ /(\d+)\.(\d+)/ );
41 $BRANCH = sprintf( "%d.%03d", q$Revision$ =~ /\d+\.\d+\.(\d+)\.(\d+)/ ) || 0;
42 $main::build += $VERSION;
43 $main::branch += $BRANCH;
44
45 use vars qw($pc11_max_age $pc23_max_age $last_pc50 $eph_restime $eph_info_restime $eph_pc34_restime
46                         $last_hour $last10 %eph  %pings %rcmds $ann_to_talk
47                         %nodehops $baddx $badspotter $badnode $censorpc $rspfcheck
48                         $allowzero $decode_dk0wcy $send_opernam @checklist);
49
50 $pc11_max_age = 1*3600;                 # the maximum age for an incoming 'real-time' pc11
51 $pc23_max_age = 1*3600;                 # the maximum age for an incoming 'real-time' pc23
52
53 $last_hour = time;                              # last time I did an hourly periodic update
54 %pings = ();                    # outstanding ping requests outbound
55 %rcmds = ();                    # outstanding rcmd requests outbound
56 %nodehops = ();                 # node specific hop control
57 $censorpc = 1;                                  # Do a BadWords::check on text fields and reject things
58                                                                 # loads of 'bad things'
59 $baddx = new DXHash "baddx";
60 $badspotter = new DXHash "badspotter";
61 $badnode = new DXHash "badnode";
62 $last10 = $last_pc50 = time;
63 $ann_to_talk = 1;
64 $rspfcheck = 1;
65 $eph_restime = 180;
66 $eph_info_restime = 60*60;
67 $eph_pc34_restime = 30;
68
69 @checklist = 
70 (
71  [ qw(c c m bp bc c) ],                 # pc10
72  [ qw(f m d t m c c h) ],               # pc11
73  [ qw(c bc m bp bm p h) ],              # pc12
74  [ qw(c h) ],                                   # 
75  [ qw(c h) ],                                   # 
76  [ qw(c m h) ],                                 # 
77  undef ,                                                # pc16 has to be validated manually
78  [ qw(c c h) ],                                 # pc17
79  [ qw(m n) ],                                   # pc18
80  undef ,                                                # pc19 has to be validated manually
81  undef ,                                                # pc20 no validation
82  [ qw(c m h) ],                                 # pc21
83  undef ,                                                # pc22 no validation
84  [ qw(d n n n n m c c h) ],             # pc23
85  [ qw(c p h) ],                                 # pc24
86  [ qw(c c n n) ],                               # pc25
87  [ qw(f m d t m c c bc) ],              # pc26
88  [ qw(d n n n n m c c bc) ],    # pc27
89  [ qw(c c m c d t p m bp n p bp bc) ], # pc28
90  [ qw(c c n m) ],                               # pc29
91  [ qw(c c n) ],                                 # pc30
92  [ qw(c c n) ],                                 # pc31
93  [ qw(c c n) ],                                 # pc32
94  [ qw(c c n) ],                                 # pc33
95  [ qw(c c m) ],                                 # pc34
96  [ qw(c c m) ],                                 # pc35
97  [ qw(c c m) ],                                 # pc36
98  [ qw(c c n m) ],                               # pc37
99  undef,                                                 # pc38 not interested
100  [ qw(c m) ],                                   # pc39
101  [ qw(c c m p n) ],                             # pc40
102  [ qw(c n m h) ],                               # pc41
103  [ qw(c c n) ],                                 # pc42
104  undef,                                                 # pc43 don't handle it
105  [ qw(c c n m m c) ],                   # pc44
106  [ qw(c c n m) ],                               # pc45
107  [ qw(c c n) ],                                 # pc46
108  undef,                                                 # pc47
109  undef,                                                 # pc48
110  [ qw(c m h) ],                                 # pc49
111  [ qw(c n h) ],                                 # pc50
112  [ qw(c c n) ],                                 # pc51
113  undef,
114  undef,
115  undef,
116  undef,
117  undef,
118  undef,
119  undef,
120  undef,
121  undef,                                                 # pc60
122  undef,
123  undef,
124  undef,
125  undef,
126  undef,
127  undef,
128  undef,
129  undef,
130  undef,
131  undef,                                                 # pc70
132  undef,
133  undef,
134  [ qw(d n n n n n n m m m c c h) ],     # pc73
135  undef,
136  undef,
137  undef,
138  undef,
139  undef,
140  undef,
141  undef,                                                 # pc80
142  undef,
143  undef,
144  undef,
145  [ qw(c c c m) ],                               # pc84
146  [ qw(c c c m) ],                               # pc85
147 );
148
149 # use the entry in the check list to check the field list presented
150 # return OK if line NOT in check list (for now)
151 sub check
152 {
153         my $n = shift;
154         $n -= 10;
155         return 0 if $n < 0 || $n > @checklist; 
156         my $ref = $checklist[$n];
157         return 0 unless ref $ref;
158         
159         my $i;
160         shift;    # not interested in the first field
161         for ($i = 0; $i < @$ref; $i++) {
162                 my ($blank, $act) = $$ref[$i] =~ /^(b?)(\w)$/;
163                 return 0 unless $act;
164                 next if $blank && $_[$i] =~ /^[ \*]$/;
165                 if ($act eq 'c') {
166                         return $i+1 unless is_callsign($_[$i]);
167                 } elsif ($act eq 'm') {
168                         return $i+1 unless is_pctext($_[$i]);
169                 } elsif ($act eq 'p') {
170                         return $i+1 unless is_pcflag($_[$i]);
171                 } elsif ($act eq 'f') {
172                         return $i+1 unless is_freq($_[$i]);
173                 } elsif ($act eq 'n') {
174                         return $i+1 unless $_[$i] =~ /^[\d ]+$/;
175                 } elsif ($act eq 'h') {
176                         return $i+1 unless $_[$i] =~ /^H\d\d?$/;
177                 } elsif ($act eq 'd') {
178                         return $i+1 unless $_[$i] =~ /^\s*\d+-\w\w\w-[12][90]\d\d$/;
179                 } elsif ($act eq 't') {
180                         return $i+1 unless $_[$i] =~ /^[012]\d[012345]\dZ$/;
181                 }
182         }
183         return 0;
184 }
185
186 sub init
187 {
188         my $user = DXUser->get($main::mycall);
189         $DXProt::myprot_version += $main::version*100;
190         $main::me = DXProt->new($main::mycall, 0, $user); 
191         $main::me->{here} = 1;
192         $main::me->{state} = "indifferent";
193         do "$main::data/hop_table.pl" if -e "$main::data/hop_table.pl";
194         confess $@ if $@;
195         $main::me->{sort} = 'S';    # S for spider
196         $main::me->{priv} = 9;
197         $main::me->{metric} = 0;
198         $main::me->{pingave} = 0;
199         
200 #       $Route::Node::me->adddxchan($main::me);
201 }
202
203 #
204 # obtain a new connection this is derived from dxchannel
205 #
206
207 sub new 
208 {
209         my $self = DXChannel::alloc(@_);
210
211         # add this node to the table, the values get filled in later
212         my $pkg = shift;
213         my $call = shift;
214         $main::routeroot->add($call, '5000', Route::here(1)) if $call ne $main::mycall;
215
216         return $self;
217 }
218
219 # this is how a pc connection starts (for an incoming connection)
220 # issue a PC38 followed by a PC18, then wait for a PC20 (remembering
221 # all the crap that comes between).
222 sub start
223 {
224         my ($self, $line, $sort) = @_;
225         my $call = $self->{call};
226         my $user = $self->{user};
227
228         # log it
229         my $host = $self->{conn}->{peerhost} || "unknown";
230         Log('DXProt', "$call connected from $host");
231         
232         # remember type of connection
233         $self->{consort} = $line;
234         $self->{outbound} = $sort eq 'O';
235         my $priv = $user->priv;
236         $priv = $user->priv(1) unless $priv;
237         $self->{priv} = $priv;     # other clusters can always be 'normal' users
238         $self->{lang} = $user->lang || 'en';
239         $self->{isolate} = $user->{isolate};
240         $self->{consort} = $line;       # save the connection type
241         $self->{here} = 1;
242         $self->{width} = 80;
243
244         # sort out registration
245         $self->{registered} = 1;
246
247         # get the output filters
248         $self->{spotsfilter} = Filter::read_in('spots', $call, 0) || Filter::read_in('spots', 'node_default', 0);
249         $self->{wwvfilter} = Filter::read_in('wwv', $call, 0) || Filter::read_in('wwv', 'node_default', 0);
250         $self->{wcyfilter} = Filter::read_in('wcy', $call, 0) || Filter::read_in('wcy', 'node_default', 0);
251         $self->{annfilter} = Filter::read_in('ann', $call, 0) || Filter::read_in('ann', 'node_default', 0) ;
252         $self->{routefilter} = Filter::read_in('route', $call, 0) || Filter::read_in('route', 'node_default', 0) unless $self->{isolate} ;
253
254
255         # get the INPUT filters (these only pertain to Clusters)
256         $self->{inspotsfilter} = Filter::read_in('spots', $call, 1) || Filter::read_in('spots', 'node_default', 1);
257         $self->{inwwvfilter} = Filter::read_in('wwv', $call, 1) || Filter::read_in('wwv', 'node_default', 1);
258         $self->{inwcyfilter} = Filter::read_in('wcy', $call, 1) || Filter::read_in('wcy', 'node_default', 1);
259         $self->{inannfilter} = Filter::read_in('ann', $call, 1) || Filter::read_in('ann', 'node_default', 1);
260         $self->{inroutefilter} = Filter::read_in('route', $call, 1) || Filter::read_in('route', 'node_default', 1) unless $self->{isolate};
261         
262         # set unbuffered and no echo
263         $self->send_now('B',"0");
264         $self->send_now('E',"0");
265         $self->conn->echo(0) if $self->conn->can('echo');
266         
267         # ping neighbour node stuff
268         my $ping = $user->pingint;
269         $ping = 5*60 unless defined $ping;
270         $self->{pingint} = $ping;
271         $self->{nopings} = $user->nopings || 2;
272         $self->{pingtime} = [ ];
273         $self->{pingave} = 999;
274         $self->{metric} ||= 100;
275         $self->{lastping} = $main::systime;
276
277         # send initialisation string
278         unless ($self->{outbound}) {
279                 $self->send(pc18());
280         }
281         
282         $self->state('init');
283         $self->{pc50_t} = $main::systime;
284
285         # send info to all logged in thingies
286         $self->tell_login('loginn');
287
288         # run a script send the output to the debug file
289         my $script = new Script(lc $call) || new Script('node_default');
290         $script->run($self) if $script;
291 }
292
293 #
294 # This is the normal pcxx despatcher
295 #
296 sub normal
297 {
298         my ($self, $line) = @_;
299         my @field = split /\^/, $line;
300         return unless @field;
301         
302         pop @field if $field[-1] eq '~';
303         
304 #       print join(',', @field), "\n";
305                                                 
306         
307         # process PC frames, this will fail unless the frame starts PCnn
308         my ($pcno) = $field[0] =~ /^PC(\d\d)/; # just get the number
309         return unless $pcno;
310         return if $pcno < 10 || $pcno > 99;
311
312         # check for and dump bad protocol messages
313         my $n = check($pcno, @field);
314         if ($n) {
315                 dbg("PCPROT: bad field $n, dumped (" . parray($checklist[$pcno-10]) . ")") if isdbg('chanerr');
316                 return;
317         }
318
319         # local processing 1
320         my $pcr;
321         eval {
322                 $pcr = Local::pcprot($self, $pcno, @field);
323         };
324 #       dbg("Local::pcprot error $@") if isdbg('local') if $@;
325         return if $pcr;
326         
327  SWITCH: {
328                 if ($pcno == 10) {              # incoming talk
329
330                         # rsfp check
331                         return if $rspfcheck and !$self->rspfcheck(0, $field[6], $field[1]);
332                         
333                         # will we allow it at all?
334                         if ($censorpc) {
335                                 my @bad;
336                                 if (@bad = BadWords::check($field[3])) {
337                                         dbg("PCPROT: Bad words: @bad, dropped") if isdbg('chanerr');
338                                         return;
339                                 }
340                         }
341
342                         # is it for me or one of mine?
343                         my ($from, $to, $via, $call, $dxchan);
344                         $from = $field[1];
345                         if ($field[5] gt ' ') {
346                                 $via = $field[2];
347                                 $to = $field[5];
348                         } else {
349                                 $to = $field[2];
350                         }
351
352                         # if this is a 'nodx' node then ignore it
353                         if ($badnode->in($field[6]) || ($via && $badnode->in($via))) {
354                                 dbg("PCPROT: Bad Node, dropped") if isdbg('chanerr');
355                                 return;
356                         }
357
358                         # if this is a 'bad spotter' user then ignore it
359                         if ($badspotter->in($from)) {
360                                 dbg("PCPROT: Bad Spotter, dropped") if isdbg('chanerr');
361                                 return;
362                         }
363
364                         # if we are converting announces to talk is it a dup?
365                         if ($ann_to_talk) {
366                                 if (AnnTalk::is_talk_candidate($from, $field[3]) && AnnTalk::dup($from, $to, $field[3])) {
367                                         dbg("DXPROT: Dupe talk from announce, dropped") if isdbg('chanerr');
368                                         return;
369                                 }
370                         }
371
372                         # it is here and logged on
373                         $dxchan = DXChannel->get($main::myalias) if $to eq $main::mycall;
374                         $dxchan = DXChannel->get($to) unless $dxchan;
375                         if ($dxchan && $dxchan->is_user) {
376                                 $field[3] =~ s/\%5E/^/g;
377                                 $dxchan->talk($from, $to, $via, $field[3]);
378                                 return;
379                         }
380
381                         # is it elsewhere, visible on the cluster via the to address?
382                         # note: this discards the via unless the to address is on
383                         # the via address
384                         my ($ref, $vref);
385                         if ($ref = Route::get($to)) {
386                                 $vref = Route::Node::get($via) if $via;
387                                 $vref = undef unless $vref && grep $to eq $_, $vref->users;
388                                 $ref->dxchan->talk($from, $to, $vref ? $via : undef, $field[3], $field[6]);
389                                 return;
390                         }
391
392                         # not visible here, send a message of condolence
393                         $vref = undef;
394                         $ref = Route::get($from);
395                         $vref = $ref = Route::Node::get($field[6]) unless $ref; 
396                         if ($ref) {
397                                 $dxchan = $ref->dxchan;
398                                 $dxchan->talk($main::mycall, $from, $vref ? $vref->call : undef, $dxchan->msg('talknh', $to) );
399                         }
400                         return;
401                 }
402                 
403                 if ($pcno == 11 || $pcno == 26) { # dx spot
404
405                         # route 'foreign' pc26s 
406                         if ($pcno == 26) {
407                                 if ($field[7] ne $main::mycall) {
408                                         $self->route($field[7], $line);
409                                         return;
410                                 }
411                         }
412                         
413                         # rsfp check
414 #                       return if $rspfcheck and !$self->rspfcheck(1, $field[7], $field[6]);
415
416                         # if this is a 'nodx' node then ignore it
417                         if ($badnode->in($field[7])) {
418                                 dbg("PCPROT: Bad Node, dropped") if isdbg('chanerr');
419                                 return;
420                         }
421                         
422                         # if this is a 'bad spotter' user then ignore it
423                         if ($badspotter->in($field[6])) {
424                                 dbg("PCPROT: Bad Spotter, dropped") if isdbg('chanerr');
425                                 return;
426                         }
427                         
428                         # convert the date to a unix date
429                         my $d = cltounix($field[3], $field[4]);
430                         # bang out (and don't pass on) if date is invalid or the spot is too old (or too young)
431                         if (!$d || ($pcno == 11 && ($d < $main::systime - $pc11_max_age || $d > $main::systime + 900))) {
432                                 dbg("PCPROT: Spot ignored, invalid date or out of range ($field[3] $field[4])\n") if isdbg('chanerr');
433                                 return;
434                         }
435
436                         # is it 'baddx'
437                         if ($baddx->in($field[2]) || BadWords::check($field[2]) || $field[2] =~ /COCK/) {
438                                 dbg("PCPROT: Bad DX spot, ignored") if isdbg('chanerr');
439                                 return;
440                         }
441                         
442                         # do some de-duping
443                         $field[5] =~ s/^\s+//;      # take any leading blanks off
444                         $field[2] = unpad($field[2]);   # take off leading and trailing blanks from spotted callsign
445                         if ($field[2] =~ /BUST\w*$/) {
446                                 dbg("PCPROT: useless 'BUSTED' spot") if isdbg('chanerr');
447                                 return;
448                         }
449                         if ($censorpc) {
450                                 my @bad;
451                                 if (@bad = BadWords::check($field[5])) {
452                                         dbg("PCPROT: Bad words: @bad, dropped") if isdbg('chanerr');
453                                         return;
454                                 }
455                         }
456
457
458                         my @spot = Spot::prepare($field[1], $field[2], $d, $field[5], $field[6], $field[7]);
459                         # global spot filtering on INPUT
460                         if ($self->{inspotsfilter}) {
461                                 my ($filter, $hops) = $self->{inspotsfilter}->it(@spot);
462                                 unless ($filter) {
463                                         dbg("PCPROT: Rejected by input spot filter") if isdbg('chanerr');
464                                         return;
465                                 }
466                         }
467
468                         # this goes after the input filtering, but before the add
469                         # so that if it is input filtered, it isn't added to the dup
470                         # list. This allows it to come in from a "legitimate" source
471                         if (Spot::dup($field[1], $field[2], $d, $field[5])) {
472                                 dbg("PCPROT: Duplicate Spot ignored\n") if isdbg('chanerr');
473                                 return;
474                         }
475
476                         # add it 
477                         Spot::add(@spot);
478
479             #
480                         # @spot at this point contains:-
481             # freq, spotted call, time, text, spotter, spotted cc, spotters cc, orig node
482                         # then  spotted itu, spotted cq, spotters itu, spotters cq
483                         # you should be able to route on any of these
484             #
485                         
486                         # fix up qra locators of known users 
487                         my $user = DXUser->get_current($spot[4]);
488                         if ($user) {
489                                 my $qra = $user->qra;
490                                 unless ($qra && is_qra($qra)) {
491                                         my $lat = $user->lat;
492                                         my $long = $user->long;
493                                         if (defined $lat && defined $long) {
494                                                 $user->qra(DXBearing::lltoqra($lat, $long)); 
495                                                 $user->put;
496                                         }
497                                 }
498
499                                 # send a remote command to a distant cluster if it is visible and there is no
500                                 # qra locator and we havn't done it for a month.
501
502                                 unless ($user->qra) {
503                                         my $node;
504                                         my $to = $user->homenode;
505                                         my $last = $user->lastoper || 0;
506                                         if ($send_opernam && $to && $to ne $main::mycall && $main::systime > $last + $DXUser::lastoperinterval && ($node = Route::Node::get($to)) ) {
507                                                 my $cmd = "forward/opernam $spot[4]";
508                                                 # send the rcmd but we aren't interested in the replies...
509                                                 my $dxchan = $node->dxchan;
510                                                 if ($dxchan && $dxchan->is_clx) {
511                                                         route(undef, $to, pc84($main::mycall, $to, $main::mycall, $cmd));
512                                                 } else {
513                                                         route(undef, $to, pc34($main::mycall, $to, $cmd));
514                                                 }
515                                                 if ($to ne $field[7]) {
516                                                         $to = $field[7];
517                                                         $node = Route::Node::get($to);
518                                                         if ($node) {
519                                                                 $dxchan = $node->dxchan;
520                                                                 if ($dxchan && $dxchan->is_clx) {
521                                                                         route(undef, $to, pc84($main::mycall, $to, $main::mycall, $cmd));
522                                                                 } else {
523                                                                         route(undef, $to, pc34($main::mycall, $to, $cmd));
524                                                                 }
525                                                         }
526                                                 }
527                                                 $user->lastoper($main::systime);
528                                                 $user->put;
529                                         }
530                                 }
531                         }
532                                 
533                         # local processing 
534                         my $r;
535                         eval {
536                                 $r = Local::spot($self, @spot);
537                         };
538 #                       dbg("Local::spot1 error $@") if isdbg('local') if $@;
539                         return if $r;
540
541                         # DON'T be silly and send on PC26s!
542                         return if $pcno == 26;
543
544                         # send out the filtered spots
545                         send_dx_spot($self, $line, @spot) if @spot;
546                         return;
547                 }
548                 
549                 if ($pcno == 12) {              # announces
550
551 #                       return if $rspfcheck and !$self->rspfcheck(1, $field[5], $field[1]);
552
553                         # announce duplicate checking
554                         $field[3] =~ s/^\s+//;  # remove leading blanks
555
556                         if ($censorpc) {
557                                 my @bad;
558                                 if (@bad = BadWords::check($field[3])) {
559                                         dbg("PCPROT: Bad words: @bad, dropped") if isdbg('chanerr');
560                                         return;
561                                 }
562                         }
563
564                         # if this is a 'nodx' node then ignore it
565                         if ($badnode->in($field[5])) {
566                                 dbg("PCPROT: Bad Node, dropped") if isdbg('chanerr');
567                                 return;
568                         }
569
570                         # if this is a 'bad spotter' user then ignore it
571                         if ($badspotter->in($field[1])) {
572                                 dbg("PCPROT: Bad Spotter, dropped") if isdbg('chanerr');
573                                 return;
574                         }
575
576                         if ($field[2] eq '*' || $field[2] eq $main::mycall) {
577
578
579                                 # here's a bit of fun, convert incoming ann with a callsign in the first word
580                                 # or one saying 'to <call>' to a talk if we can route to the recipient
581                                 if ($ann_to_talk) {
582                                         my $call = AnnTalk::is_talk_candidate($field[1], $field[3]);
583                                         if ($call) {
584                                                 my $ref = Route::get($call);
585                                                 if ($ref) {
586                                                         my $dxchan = $ref->dxchan;
587                                                         $dxchan->talk($field[1], $call, undef, $field[3], $field[5]) if $dxchan != $self;
588                                                         return;
589                                                 }
590                                         }
591                                 }
592         
593                                 # send it
594                                 $self->send_announce($line, @field[1..6]);
595                         } else {
596                                 $self->route($field[2], $line);
597                         }
598                         return;
599                 }
600                 
601                 if ($pcno == 13) {
602                         last SWITCH;
603                 }
604                 if ($pcno == 14) {
605                         last SWITCH;
606                 }
607                 if ($pcno == 15) {
608                         last SWITCH;
609                 }
610                 
611                 if ($pcno == 16) {              # add a user
612
613                         if (eph_dup($line)) {
614                                 dbg("PCPROT: dup PC16 detected") if isdbg('chanerr');
615                                 return;
616                         }
617
618                         # general checks
619                         my $dxchan;
620                         my $ncall = $field[1];
621                         my $newline = "PC16^";
622                         
623                         if ($ncall eq $main::mycall) {
624                                 dbg("PCPROT: trying to alter config on this node from outside!") if isdbg('chanerr');
625                                 return;
626                         }
627                         my $parent = Route::Node::get($ncall); 
628                         unless ($parent) {
629                                 dbg("PCPROT: Node $ncall not in config") if isdbg('chanerr');
630                                 return;
631                         }
632                         $dxchan = $parent->dxchan;
633                         if ($dxchan && $dxchan ne $self) {
634                                 dbg("PCPROT: PC16 from $self->{call} trying to alter locally connected $ncall, ignored!") if isdbg('chanerr');
635                                 return;
636                         }
637
638                         # input filter if required
639                         return unless $self->in_filter_route($parent);
640                         
641                         my $i;
642                         my @rout;
643                         for ($i = 2; $i < $#field; $i++) {
644                                 my ($call, $conf, $here) = $field[$i] =~ /^(\S+) (\S) (\d)/o;
645                                 next unless $call && $conf && defined $here && is_callsign($call);
646                                 next if $call eq $main::mycall;
647
648                                 eph_del_regex("^PC17\\^$call\\^$ncall");
649                                 
650                                 $conf = $conf eq '*';
651
652                                 # reject this if we think it is a node already
653                                 my $r = Route::Node::get($call);
654                                 my $u = DXUser->get_current($call) unless $r;
655                                 if ($r || ($u && $u->is_node)) {
656                                         dbg("PCPROT: $call is a node") if isdbg('chanerr');
657                                         next;
658                                 }
659                                 
660                                 $r = Route::User::get($call);
661                                 my $flags = Route::here($here)|Route::conf($conf);
662                                 
663                                 if ($r) {
664                                         if ($r->flags != $flags) {
665                                                 $r->flags($flags);
666                                                 push @rout, $r;
667                                         }
668                                         $r->addparent($parent);
669                                 } else {
670                                         push @rout, $parent->add_user($call, $flags);
671                                 }
672                                 
673                                 # add this station to the user database, if required
674                                 $call =~ s/-\d+$//o;        # remove ssid for users
675                                 my $user = DXUser->get_current($call);
676                                 $user = DXUser->new($call) if !$user;
677                                 $user->homenode($parent->call) if !$user->homenode;
678                                 $user->node($parent->call);
679                                 $user->lastin($main::systime) unless DXChannel->get($call);
680                                 $user->put;
681                         }
682                         
683                         # queue up any messages (look for privates only)
684                         DXMsg::queue_msg(1) if $self->state eq 'normal';     
685
686                         $self->route_pc16($parent, @rout) if @rout;
687                         return;
688                 }
689                 
690                 if ($pcno == 17) {              # remove a user
691                         my $dxchan;
692                         my $ncall = $field[2];
693                         my $ucall = $field[1];
694
695                         eph_del_regex("^PC16\\^$ncall.*$ucall");
696                         
697                         if ($ncall eq $main::mycall) {
698                                 dbg("PCPROT: trying to alter config on this node from outside!") if isdbg('chanerr');
699                                 return;
700                         }
701
702                         my $uref = Route::User::get($ucall);
703                         unless ($uref) {
704                                 dbg("PCPROT: Route::User $ucall not in config") if isdbg('chanerr');
705                                 return;
706                         }
707                         my $parent = Route::Node::get($ncall);
708                         unless ($parent) {
709                                 dbg("PCPROT: Route::Node $ncall not in config") if isdbg('chanerr');
710                                 return;
711                         }                       
712
713                         $dxchan = $parent->dxchan;
714                         if ($dxchan && $dxchan ne $self) {
715                                 dbg("PCPROT: PC17 from $self->{call} trying to alter locally connected $ncall, ignored!") if isdbg('chanerr');
716                                 return;
717                         }
718
719                         # input filter if required
720                         return unless $self->in_filter_route($parent);
721                         
722                         $parent->del_user($uref);
723
724                         if (eph_dup($line)) {
725                                 dbg("PCPROT: dup PC17 detected") if isdbg('chanerr');
726                                 return;
727                         }
728
729                         $self->route_pc17($parent, $uref);
730                         return;
731                 }
732                 
733                 if ($pcno == 18) {              # link request
734                         $self->state('init');   
735
736                         # first clear out any nodes on this dxchannel
737                         my $parent = Route::Node::get($self->{call});
738                         my @rout = $parent->del_nodes;
739                         $self->route_pc21(@rout, $parent) if @rout;
740                         $self->send_local_config();
741                         $self->send(pc20());
742                         return;             # we don't pass these on
743                 }
744                 
745                 if ($pcno == 19) {              # incoming cluster list
746                         my $i;
747                         my $newline = "PC19^";
748
749                         if (eph_dup($line)) {
750                                 dbg("PCPROT: dup PC19 detected") if isdbg('chanerr');
751                                 return;
752                         }
753
754                         # new routing list
755                         my @rout;
756                         my $parent = Route::Node::get($self->{call});
757                         unless ($parent) {
758                                 dbg("DXPROT: my parent $self->{call} has disappeared");
759                                 $self->disconnect;
760                                 return;
761                         }
762
763                         # parse the PC19
764                         for ($i = 1; $i < $#field-1; $i += 4) {
765                                 my $here = $field[$i];
766                                 my $call = uc $field[$i+1];
767                                 my $conf = $field[$i+2];
768                                 my $ver = $field[$i+3];
769                                 next unless defined $here && defined $conf && is_callsign($call);
770
771                                 eph_del_regex("^PC(?:21\\^$call|17\\^[^\\^]+\\^$call)");
772                                 
773                                 # check for sane parameters
774 #                               $ver = 5000 if $ver eq '0000';
775                                 next if $ver < 5000; # only works with version 5 software
776                                 next if length $call < 3; # min 3 letter callsigns
777                                 next if $call eq $main::mycall;
778
779                                 # check that this PC19 isn't trying to alter the wrong dxchan
780                                 my $dxchan = DXChannel->get($call);
781                                 if ($dxchan && $dxchan != $self) {
782                                         dbg("PCPROT: PC19 from $self->{call} trying to alter wrong locally connected $call, ignored!") if isdbg('chanerr');
783                                         next;
784                                 }
785
786                                 # update it if required
787                                 my $r = Route::Node::get($call);
788                                 my $flags = Route::here($here)|Route::conf($conf);
789                                 if ($r) {
790                                         my $ar;
791                                         if ($call ne $parent->call) {
792                                                 if ($self->in_filter_route($r)) {
793                                                         $ar = $parent->add($call, $ver, $flags);
794                                                         push @rout, $ar if $ar;
795                                                 } else {
796                                                         next;
797                                                 }
798                                         }
799                                         if ($r->version ne $ver || $r->flags != $flags) {
800                                                 $r->version($ver);
801                                                 $r->flags($flags);
802                                                 push @rout, $r unless $ar;
803                                         }
804                                 } else {
805                                         if ($call eq $self->{call}) {
806                                                 dbg("DXPROT: my channel route for $call has disappeared");
807                                                 next;
808                                         };
809                                         
810                                         my $new = Route->new($call);          # throw away
811                                     if ($self->in_filter_route($new)) {
812                                                 my $r = $parent->add($call, $ver, $flags);
813                                                 push @rout, $r;
814                                         } else {
815                                                 next;
816                                         }
817                                 }
818
819                                 # unbusy and stop and outgoing mail (ie if somehow we receive another PC19 without a disconnect)
820                                 my $mref = DXMsg::get_busy($call);
821                                 $mref->stop_msg($call) if $mref;
822                                 
823                                 # add this station to the user database, if required (don't remove SSID from nodes)
824                                 my $user = DXUser->get_current($call);
825                                 if (!$user) {
826                                         $user = DXUser->new($call);
827                                         $user->sort('A');
828                                         $user->priv(1);                   # I have relented and defaulted nodes
829                                         $user->lockout(1);
830                                         $user->homenode($call);
831                                         $user->node($call);
832                                 }
833                                 $user->lastin($main::systime) unless DXChannel->get($call);
834                                 $user->put;
835                         }
836
837
838                         $self->route_pc19(@rout) if @rout;
839                         return;
840                 }
841                 
842                 if ($pcno == 20) {              # send local configuration
843                         $self->send_local_config();
844                         $self->send(pc22());
845                         $self->state('normal');
846                         $self->{lastping} = 0;
847                         return;
848                 }
849                 
850                 if ($pcno == 21) {              # delete a cluster from the list
851                         my $call = uc $field[1];
852
853                         eph_del_regex("^PC1[79].*$call");
854                         
855                         # if I get a PC21 from the same callsign as self then treat it
856                         # as a PC39: I have gone away
857                         if ($call eq $self->call) {
858                                 $self->disconnect(1);
859                                 return;
860                         }
861
862                         my @rout;
863                         my $parent = Route::Node::get($self->{call});
864                         unless ($parent) {
865                                 dbg("DXPROT: my parent $self->{call} has disappeared");
866                                 $self->disconnect;
867                                 return;
868                         }
869                         if ($call ne $main::mycall) { # don't allow malicious buggers to disconnect me!
870                                 my $node = Route::Node::get($call);
871                                 if ($node) {
872
873                                         my $dxchan = DXChannel->get($call);
874                                         if ($dxchan && $dxchan != $self) {
875                                                 dbg("PCPROT: PC21 from $self->{call} trying to alter locally connected $call, ignored!") if isdbg('chanerr');
876                                                 return;
877                                         }
878
879                                         # input filter it
880                                         return unless $self->in_filter_route($node);
881
882                                         # routing objects
883                                         push @rout, $node->del($parent);
884                                 }
885                         } else {
886                                 dbg("PCPROT: I WILL _NOT_ be disconnected!") if isdbg('chanerr');
887                                 return;
888                         }
889
890 #                       if (eph_dup($line)) {
891 #                               dbg("PCPROT: dup PC21 detected") if isdbg('chanerr');
892 #                               return;
893 #                       }
894
895                         $self->route_pc21(@rout) if @rout;
896                         return;
897                 }
898                 
899                 if ($pcno == 22) {
900                         $self->state('normal');
901                         $self->{lastping} = 0;
902                         return;
903                 }
904                                 
905                 if ($pcno == 23 || $pcno == 27) { # WWV info
906                         
907                         # route 'foreign' pc27s 
908                         if ($pcno == 27) {
909                                 if ($field[8] ne $main::mycall) {
910                                         $self->route($field[8], $line);
911                                         return;
912                                 }
913                         }
914
915                         return if $rspfcheck and !$self->rspfcheck(1, $field[8], $field[7]);
916
917                         # do some de-duping
918                         my $d = cltounix($field[1], sprintf("%02d18Z", $field[2]));
919                         my $sfi = unpad($field[3]);
920                         my $k = unpad($field[4]);
921                         my $i = unpad($field[5]);
922                         my ($r) = $field[6] =~ /R=(\d+)/;
923                         $r = 0 unless $r;
924                         if (($pcno == 23 && $d < $main::systime - $pc23_max_age) || $d > $main::systime + 1500 || $field[2] < 0 || $field[2] > 23) {
925                                 dbg("PCPROT: WWV Date ($field[1] $field[2]) out of range") if isdbg('chanerr');
926                                 return;
927                         }
928                         if (Geomag::dup($d,$sfi,$k,$i,$field[6])) {
929                                 dbg("PCPROT: Dup WWV Spot ignored\n") if isdbg('chanerr');
930                                 return;
931                         }
932                         $field[7] =~ s/-\d+$//o;            # remove spotter's ssid
933                 
934                         my $wwv = Geomag::update($d, $field[2], $sfi, $k, $i, @field[6..8], $r);
935
936                         my $rep;
937                         eval {
938                                 $rep = Local::wwv($self, $field[1], $field[2], $sfi, $k, $i, @field[6..8], $r);
939                         };
940 #                       dbg("Local::wwv2 error $@") if isdbg('local') if $@;
941                         return if $rep;
942
943                         # DON'T be silly and send on PC27s!
944                         return if $pcno == 27;
945
946                         # broadcast to the eager world
947                         send_wwv_spot($self, $line, $d, $field[2], $sfi, $k, $i, @field[6..8]);
948                         return;
949                 }
950                 
951                 if ($pcno == 24) {              # set here status
952                         my $call = uc $field[1];
953                         my ($nref, $uref);
954                         $nref = Route::Node::get($call);
955                         $uref = Route::User::get($call);
956                         return unless $nref || $uref;   # if we don't know where they are, it's pointless sending it on
957                         
958                         unless (eph_dup($line)) {
959                                 $nref->here($field[2]) if $nref;
960                                 $uref->here($field[2]) if $uref;
961                                 my $ref = $nref || $uref;
962                                 return unless $self->in_filter_route($ref);
963                                 $self->route_pc24($ref, $field[3]);
964                         }
965                         return;
966                 }
967                 
968                 if ($pcno == 25) {      # merge request
969                         if ($field[1] ne $main::mycall) {
970                                 $self->route($field[1], $line);
971                                 return;
972                         }
973                         if ($field[2] eq $main::mycall) {
974                                 dbg("PCPROT: Trying to merge to myself, ignored") if isdbg('chanerr');
975                                 return;
976                         }
977
978                         Log('DXProt', "Merge request for $field[3] spots and $field[4] WWV from $field[2]");
979                         
980                         # spots
981                         if ($field[3] > 0) {
982                                 my @in = reverse Spot::search(1, undef, undef, 0, $field[3]);
983                                 my $in;
984                                 foreach $in (@in) {
985                                         $self->send(pc26(@{$in}[0..4], $field[2]));
986                                 }
987                         }
988
989                         # wwv
990                         if ($field[4] > 0) {
991                                 my @in = reverse Geomag::search(0, $field[4], time, 1);
992                                 my $in;
993                                 foreach $in (@in) {
994                                         $self->send(pc27(@{$in}[0..5], $field[2]));
995                                 }
996                         }
997                         return;
998                 }
999
1000                 if (($pcno >= 28 && $pcno <= 33) || $pcno == 40 || $pcno == 42 || $pcno == 49) { # mail/file handling
1001                         return if $pcno == 49 && eph_dup($line);
1002                         if ($pcno == 49 || $field[1] eq $main::mycall) {
1003                                 DXMsg::process($self, $line);
1004                         } else {
1005                                 $self->route($field[1], $line) unless $self->is_clx;
1006                         }
1007                         return;
1008                 }
1009                 
1010                 if ($pcno == 34 || $pcno == 36) { # remote commands (incoming)
1011                         if (eph_dup($line, $eph_pc34_restime)) {
1012                                 dbg("PCPROT: dupe") if isdbg('chanerr');
1013                         } else {
1014                                 $self->process_rcmd($field[1], $field[2], $field[2], $field[3]);
1015                         }
1016                         return;
1017                 }
1018                 
1019                 if ($pcno == 35) {              # remote command replies
1020                         eph_del_regex("^PC35\\^$field[2]\\^$field[1]\\^");
1021                         $self->process_rcmd_reply($field[1], $field[2], $field[1], $field[3]);
1022                         return;
1023                 }
1024                 
1025                 # for pc 37 see 44 onwards
1026
1027                 if ($pcno == 38) {              # node connected list from neighbour
1028                         return;
1029                 }
1030                 
1031                 if ($pcno == 39) {              # incoming disconnect
1032                         if ($field[1] eq $self->{call}) {
1033                                 $self->disconnect(1);
1034                         } else {
1035                                 dbg("PCPROT: came in on wrong channel") if isdbg('chanerr');
1036                         }
1037                         return;
1038                 }
1039                 
1040                 if ($pcno == 41) {              # user info
1041                         my $call = $field[1];
1042
1043                         if (eph_dup($line, $eph_info_restime)) {
1044                                 dbg("PCPROT: dupe") if isdbg('chanerr');
1045                                 return;
1046                         }
1047                         
1048                         # input filter if required
1049 #                       my $ref = Route::get($call) || Route->new($call);
1050 #                       return unless $self->in_filter_route($ref);
1051
1052                         if ($field[3] eq $field[2] || $field[3] =~ /^\s*$/) {
1053                                 dbg('PCPROT: invalid value') if isdbg('chanerr');
1054                                 return;
1055                         }
1056
1057                         # add this station to the user database, if required
1058                         my $user = DXUser->get_current($call);
1059                         $user = DXUser->new($call) if !$user;
1060                         
1061                         if ($field[2] == 1) {
1062                                 $user->name($field[3]);
1063                         } elsif ($field[2] == 2) {
1064                                 $user->qth($field[3]);
1065                         } elsif ($field[2] == 3) {
1066                                 if (is_latlong($field[3])) {
1067                                         my ($lat, $long) = DXBearing::stoll($field[3]);
1068                                         $user->lat($lat);
1069                                         $user->long($long);
1070                                         $user->qra(DXBearing::lltoqra($lat, $long));
1071                                 } else {
1072                                         dbg('PCPROT: not a valid lat/long') if isdbg('chanerr');
1073                                         return;
1074                                 }
1075                         } elsif ($field[2] == 4) {
1076                                 $user->homenode($field[3]);
1077                         } elsif ($field[2] == 5) {
1078                                 if (is_qra(uc $field[3])) {
1079                                         my ($lat, $long) = DXBearing::qratoll(uc $field[3]);
1080                                         $user->lat($lat);
1081                                         $user->long($long);
1082                                         $user->qra(uc $field[3]);
1083                                 } else {
1084                                         dbg('PCPROT: not a valid QRA locator') if isdbg('chanerr');
1085                                         return;
1086                                 }
1087                         }
1088                         $user->lastoper($main::systime);   # to cut down on excessive for/opers being generated
1089                         $user->put;
1090
1091                         unless ($self->{isolate}) {
1092                                 DXChannel::broadcast_nodes($line, $self); # send it to everyone but me
1093                         }
1094
1095 #  perhaps this IS what we want after all
1096 #                       $self->route_pc41($ref, $call, $field[2], $field[3], $field[4]);
1097                         return;
1098                 }
1099
1100                 if ($pcno == 43) {
1101                         last SWITCH;
1102                 }
1103
1104                 if ($pcno == 37 || $pcno == 44 || $pcno == 45 || $pcno == 46 || $pcno == 47 || $pcno == 48) {
1105                         DXDb::process($self, $line);
1106                         return;
1107                 }
1108                 
1109                 if ($pcno == 50) {              # keep alive/user list
1110                         my $call = $field[1];
1111                         my $node = Route::Node::get($call);
1112                         if ($node) {
1113                                 return unless $node->call eq $self->{call};
1114                                 $node->usercount($field[2]);
1115
1116                                 # input filter if required
1117                                 return unless $self->in_filter_route($node);
1118
1119                                 $self->route_pc50($node, $field[2], $field[3]) unless eph_dup($line);
1120                         }
1121                         return;
1122                 }
1123                 
1124                 if ($pcno == 51) {              # incoming ping requests/answers
1125                         my $to = $field[1];
1126                         my $from = $field[2];
1127                         my $flag = $field[3];
1128
1129                         
1130                         # is it for us?
1131                         if ($to eq $main::mycall) {
1132                                 if ($flag == 1) {
1133                                         $self->send(pc51($from, $to, '0'));
1134                                 } else {
1135                                         # it's a reply, look in the ping list for this one
1136                                         my $ref = $pings{$from};
1137                                         if ($ref) {
1138                                                 my $tochan =  DXChannel->get($from);
1139                                                 while (@$ref) {
1140                                                         my $r = shift @$ref;
1141                                                         my $dxchan = DXChannel->get($r->{call});
1142                                                         next unless $dxchan;
1143                                                         my $t = tv_interval($r->{t}, [ gettimeofday ]);
1144                                                         if ($dxchan->is_user) {
1145                                                                 my $s = sprintf "%.2f", $t; 
1146                                                                 my $ave = sprintf "%.2f", $tochan ? ($tochan->{pingave} || $t) : $t;
1147                                                                 $dxchan->send($dxchan->msg('pingi', $from, $s, $ave))
1148                                                         } elsif ($dxchan->is_node) {
1149                                                                 if ($tochan) {
1150                                                                         my $nopings = $tochan->user->nopings || 2;
1151                                                                         push @{$tochan->{pingtime}}, $t;
1152                                                                         shift @{$tochan->{pingtime}} if @{$tochan->{pingtime}} > 6;
1153
1154                                                                         # cope with a missed ping, this means you must set the pingint large enough
1155                                                                         if ($t > $tochan->{pingint}  && $t < 2 * $tochan->{pingint} ) {
1156                                                                                 $t -= $tochan->{pingint};
1157                                                                         }
1158
1159                                                                         # calc smoothed RTT a la TCP
1160                                                                         if (@{$tochan->{pingtime}} == 1) {
1161                                                                                 $tochan->{pingave} = $t;
1162                                                                         } else {
1163                                                                                 $tochan->{pingave} = $tochan->{pingave} + (($t - $tochan->{pingave}) / 6);
1164                                                                         }
1165 #                                                                       my $st;
1166 #                                                                       for (@{$tochan->{pingtime}}) {
1167 #                                                                               $st += $_;
1168 #                                                                       }
1169 #                                                                       $tochan->{pingave} = $st / @{$tochan->{pingtime}};
1170                                                                         $tochan->{nopings} = $nopings; # pump up the timer
1171                                                                 }
1172                                                         } 
1173                                                 }
1174                                         }
1175                                 }
1176                         } else {
1177                                 if (eph_dup($line)) {
1178                                         dbg("PCPROT: dup PC51 detected") if isdbg('chanerr');
1179                                         return;
1180                                 }
1181                                 # route down an appropriate thingy
1182                                 $self->route($to, $line);
1183                         }
1184                         return;
1185                 }
1186
1187                 if ($pcno == 75) {              # dunno but route it
1188                         my $call = $field[1];
1189                         if ($call ne $main::mycall) {
1190                                 $self->route($call, $line);
1191                         }
1192                         return;
1193                 }
1194
1195                 if ($pcno == 73) {  # WCY broadcasts
1196                         my $call = $field[1];
1197                         
1198                         # do some de-duping
1199                         my $d = cltounix($call, sprintf("%02d18Z", $field[2]));
1200                         if (($pcno == 23 && $d < $main::systime - $pc23_max_age) || $d > $main::systime + 1500 || $field[2] < 0 || $field[2] > 23) {
1201                                 dbg("PCPROT: WCY Date ($call $field[2]) out of range") if isdbg('chanerr');
1202                                 return;
1203                         }
1204                         @field = map { unpad($_) } @field;
1205                         if (WCY::dup($d)) {
1206                                 dbg("PCPROT: Dup WCY Spot ignored\n") if isdbg('chanerr');
1207                                 return;
1208                         }
1209                 
1210                         my $wcy = WCY::update($d, @field[2..12]);
1211
1212                         my $rep;
1213                         eval {
1214                                 $rep = Local::wcy($self, @field[1..12]);
1215                         };
1216                         # dbg("Local::wcy error $@") if isdbg('local') if $@;
1217                         return if $rep;
1218
1219                         # broadcast to the eager world
1220                         send_wcy_spot($self, $line, $d, @field[2..12]);
1221                         return;
1222                 }
1223
1224                 if ($pcno == 84) { # remote commands (incoming)
1225                         $self->process_rcmd($field[1], $field[2], $field[3], $field[4]);
1226                         return;
1227                 }
1228
1229                 if ($pcno == 85) {              # remote command replies
1230                         $self->process_rcmd_reply($field[1], $field[2], $field[3], $field[4]);
1231                         
1232                         return;
1233                 }
1234         }
1235          
1236         # if get here then rebroadcast the thing with its Hop count decremented (if
1237         # there is one). If it has a hop count and it decrements to zero then don't
1238         # rebroadcast it.
1239         #
1240         # NOTE - don't arrive here UNLESS YOU WANT this lump of protocol to be
1241         #        REBROADCAST!!!!
1242         #
1243
1244         if (eph_dup($line)) {
1245                 dbg("PCPROT: Ephemeral dup, dropped") if isdbg('chanerr');
1246         } else {
1247                 unless ($self->{isolate}) {
1248                         DXChannel::broadcast_nodes($line, $self); # send it to everyone but me
1249                 }
1250         }
1251 }
1252
1253 #
1254 # This is called from inside the main cluster processing loop and is used
1255 # for despatching commands that are doing some long processing job
1256 #
1257 sub process
1258 {
1259         my $t = time;
1260         my @dxchan = DXChannel->get_all();
1261         my $dxchan;
1262         my $pc50s;
1263         
1264         # send out a pc50 on EVERY channel all at once
1265         if ($t >= $last_pc50 + $DXProt::pc50_interval) {
1266                 $pc50s = pc50($main::me, scalar DXChannel::get_all_users);
1267                 eph_dup($pc50s);
1268                 $last_pc50 = $t;
1269         }
1270
1271         foreach $dxchan (@dxchan) {
1272                 next unless $dxchan->is_node();
1273                 next if $dxchan == $main::me;
1274
1275                 # send the pc50
1276                 $dxchan->send($pc50s) if $pc50s;
1277                 
1278                 # send a ping out on this channel
1279                 if ($dxchan->{pingint} && $t >= $dxchan->{pingint} + $dxchan->{lastping}) {
1280                         if ($dxchan->{nopings} <= 0) {
1281                                 $dxchan->disconnect;
1282                         } else {
1283                                 addping($main::mycall, $dxchan->call);
1284                                 $dxchan->{nopings} -= 1;
1285                                 $dxchan->{lastping} = $t;
1286                         }
1287                 }
1288         }
1289
1290         # every ten seconds
1291         if ($t - $last10 >= 10) {       
1292                 # clean out ephemera 
1293
1294                 eph_clean();
1295
1296                 $last10 = $t;
1297         }
1298         
1299         if ($main::systime - 3600 > $last_hour) {
1300                 $last_hour = $main::systime;
1301         }
1302 }
1303
1304 #
1305 # finish up a pc context
1306 #
1307
1308 #
1309 # some active measures
1310 #
1311
1312 sub send_dx_spot
1313 {
1314         my $self = shift;
1315         my $line = shift;
1316         my @dxchan = DXChannel->get_all();
1317         my $dxchan;
1318         
1319         # send it if it isn't the except list and isn't isolated and still has a hop count
1320         # taking into account filtering and so on
1321         foreach $dxchan (@dxchan) {
1322                 next if $dxchan == $main::me;
1323                 next if $dxchan == $self && $self->is_node;
1324                 $dxchan->dx_spot($line, $self->{isolate}, @_, $self->{call});
1325         }
1326 }
1327
1328 sub dx_spot
1329 {
1330         my $self = shift;
1331         my $line = shift;
1332         my $isolate = shift;
1333         my ($filter, $hops);
1334
1335         if ($self->{spotsfilter}) {
1336                 ($filter, $hops) = $self->{spotsfilter}->it(@_);
1337                 return unless $filter;
1338         }
1339         send_prot_line($self, $filter, $hops, $isolate, $line);
1340 }
1341
1342 sub send_prot_line
1343 {
1344         my ($self, $filter, $hops, $isolate, $line) = @_;
1345         my $routeit;
1346         
1347         if ($hops) {
1348                 $routeit = $line;
1349                 $routeit =~ s/\^H\d+\^\~$/\^H$hops\^\~/;
1350         } else {
1351                 $routeit = adjust_hops($self, $line);  # adjust its hop count by node name
1352                 return unless $routeit;
1353         }
1354         if ($filter) {
1355                 $self->send($routeit);
1356         } else {
1357                 $self->send($routeit) unless $self->{isolate} || $isolate;
1358         }
1359 }
1360
1361
1362 sub send_wwv_spot
1363 {
1364         my $self = shift;
1365         my $line = shift;
1366         my @dxchan = DXChannel->get_all();
1367         my $dxchan;
1368         my ($wwv_dxcc, $wwv_itu, $wwv_cq, $org_dxcc, $org_itu, $org_cq) = (0..0);
1369         my @dxcc = Prefix::extract($_[6]);
1370         if (@dxcc > 0) {
1371                 $wwv_dxcc = $dxcc[1]->dxcc;
1372                 $wwv_itu = $dxcc[1]->itu;
1373                 $wwv_cq = $dxcc[1]->cq;                                         
1374         }
1375         @dxcc = Prefix::extract($_[7]);
1376         if (@dxcc > 0) {
1377                 $org_dxcc = $dxcc[1]->dxcc;
1378                 $org_itu = $dxcc[1]->itu;
1379                 $org_cq = $dxcc[1]->cq;                                         
1380         }
1381         
1382         # send it if it isn't the except list and isn't isolated and still has a hop count
1383         # taking into account filtering and so on
1384         foreach $dxchan (@dxchan) {
1385                 next if $dxchan == $main::me;
1386                 next if $dxchan == $self && $self->is_node;
1387                 my $routeit;
1388                 my ($filter, $hops);
1389
1390                 $dxchan->wwv($line, $self->{isolate}, @_, $self->{call}, $wwv_dxcc, $wwv_itu, $wwv_cq, $org_dxcc, $org_itu, $org_cq);
1391         }
1392         
1393 }
1394
1395 sub wwv
1396 {
1397         my $self = shift;
1398         my $line = shift;
1399         my $isolate = shift;
1400         my ($filter, $hops);
1401         
1402         if ($self->{wwvfilter}) {
1403                 ($filter, $hops) = $self->{wwvfilter}->it(@_);
1404                 return unless $filter;
1405         }
1406         send_prot_line($self, $filter, $hops, $isolate, $line)
1407 }
1408
1409 sub send_wcy_spot
1410 {
1411         my $self = shift;
1412         my $line = shift;
1413         my @dxchan = DXChannel->get_all();
1414         my $dxchan;
1415         my ($wcy_dxcc, $wcy_itu, $wcy_cq, $org_dxcc, $org_itu, $org_cq) = (0..0);
1416         my @dxcc = Prefix::extract($_[10]);
1417         if (@dxcc > 0) {
1418                 $wcy_dxcc = $dxcc[1]->dxcc;
1419                 $wcy_itu = $dxcc[1]->itu;
1420                 $wcy_cq = $dxcc[1]->cq;                                         
1421         }
1422         @dxcc = Prefix::extract($_[11]);
1423         if (@dxcc > 0) {
1424                 $org_dxcc = $dxcc[1]->dxcc;
1425                 $org_itu = $dxcc[1]->itu;
1426                 $org_cq = $dxcc[1]->cq;                                         
1427         }
1428         
1429         # send it if it isn't the except list and isn't isolated and still has a hop count
1430         # taking into account filtering and so on
1431         foreach $dxchan (@dxchan) {
1432                 next if $dxchan == $main::me;
1433                 next if $dxchan == $self;
1434
1435                 $dxchan->wcy($line, $self->{isolate}, @_, $self->{call}, $wcy_dxcc, $wcy_itu, $wcy_cq, $org_dxcc, $org_itu, $org_cq);
1436         }
1437 }
1438
1439 sub wcy
1440 {
1441         my $self = shift;
1442         my $line = shift;
1443         my $isolate = shift;
1444         my ($filter, $hops);
1445
1446         if ($self->{wcyfilter}) {
1447                 ($filter, $hops) = $self->{wcyfilter}->it(@_);
1448                 return unless $filter;
1449         }
1450         send_prot_line($self, $filter, $hops, $isolate, $line) if $self->is_clx || $self->is_spider || $self->is_dxnet;
1451 }
1452
1453 # send an announce
1454 sub send_announce
1455 {
1456         my $self = shift;
1457         my $line = shift;
1458         my @dxchan = DXChannel->get_all();
1459         my $dxchan;
1460         my $target;
1461         my $to = 'To ';
1462         my $text = unpad($_[2]);
1463                                 
1464         if ($_[3] eq '*') {     # sysops
1465                 $target = "SYSOP";
1466         } elsif ($_[3] gt ' ') { # speciality list handling
1467                 my ($name) = split /\./, $_[3]; 
1468                 $target = "$name"; # put the rest in later (if bothered) 
1469         } 
1470         
1471         if ($_[5] eq '1') {
1472                 $target = "WX"; 
1473                 $to = '';
1474         }
1475         $target = "ALL" if !$target;
1476
1477
1478         # obtain country codes etc 
1479         my ($ann_dxcc, $ann_itu, $ann_cq, $org_dxcc, $org_itu, $org_cq) = (0..0);
1480         my @dxcc = Prefix::extract($_[0]);
1481         if (@dxcc > 0) {
1482                 $ann_dxcc = $dxcc[1]->dxcc;
1483                 $ann_itu = $dxcc[1]->itu;
1484                 $ann_cq = $dxcc[1]->cq;                                         
1485         }
1486         @dxcc = Prefix::extract($_[4]);
1487         if (@dxcc > 0) {
1488                 $org_dxcc = $dxcc[1]->dxcc;
1489                 $org_itu = $dxcc[1]->itu;
1490                 $org_cq = $dxcc[1]->cq;                                         
1491         }
1492
1493         if ($self->{inannfilter}) {
1494                 my ($filter, $hops) = 
1495                         $self->{inannfilter}->it(@_, $self->{call}, 
1496                                                                          $ann_dxcc, $ann_itu, $ann_cq,
1497                                                                          $org_dxcc, $org_itu, $org_cq);
1498                 unless ($filter) {
1499                         dbg("PCPROT: Rejected by input announce filter") if isdbg('chanerr');
1500                         return;
1501                 }
1502         }
1503
1504         if (AnnTalk::dup($_[0], $_[1], $_[2])) {
1505                 dbg("PCPROT: Duplicate Announce ignored") if isdbg('chanerr');
1506                 return;
1507         }
1508
1509         Log('ann', $target, $_[0], $text);
1510
1511         # send it if it isn't the except list and isn't isolated and still has a hop count
1512         # taking into account filtering and so on
1513         foreach $dxchan (@dxchan) {
1514                 next if $dxchan == $main::me;
1515                 next if $dxchan == $self && $self->is_node;
1516                 $dxchan->announce($line, $self->{isolate}, $to, $target, $text, @_, $self->{call}, $ann_dxcc, $ann_itu, $ann_cq, $org_dxcc, $org_itu, $org_cq);
1517         }
1518 }
1519
1520 sub announce
1521 {
1522         my $self = shift;
1523         my $line = shift;
1524         my $isolate = shift;
1525         my $to = shift;
1526         my $target = shift;
1527         my $text = shift;
1528         my ($filter, $hops);
1529
1530         if ($self->{annfilter}) {
1531                 ($filter, $hops) = $self->{annfilter}->it(@_);
1532                 return unless $filter;
1533         }
1534         send_prot_line($self, $filter, $hops, $isolate, $line) unless $_[1] eq $main::mycall;
1535 }
1536
1537
1538 sub send_local_config
1539 {
1540         my $self = shift;
1541         my $n;
1542         my @nodes;
1543         my @localnodes;
1544         my @remotenodes;
1545
1546         dbg('DXProt::send_local_config') if isdbg('trace');
1547         
1548         # send our nodes
1549         if ($self->{isolate}) {
1550                 @localnodes = ( $main::routeroot );
1551         } else {
1552                 # create a list of all the nodes that are not connected to this connection
1553                 # and are not themselves isolated, this to make sure that isolated nodes
1554         # don't appear outside of this node
1555                 my @dxchan = grep { $_->call ne $main::mycall && $_ != $self && !$_->{isolate} } DXChannel::get_all_nodes();
1556                 @localnodes = map { my $r = Route::Node::get($_->{call}); $r ? $r : () } @dxchan if @dxchan;
1557                 my @intcalls = map { $_->nodes } @localnodes if @localnodes;
1558                 my $ref = Route::Node::get($self->{call});
1559                 my @rnodes = $ref->nodes;
1560                 for my $n (@intcalls) {
1561                         push @remotenodes, Route::Node::get($n) unless grep $n eq $_, @rnodes;
1562                 }
1563                 unshift @localnodes, $main::routeroot;
1564         }
1565         
1566         send_route($self, \&pc19, scalar(@localnodes)+scalar(@remotenodes), @localnodes, @remotenodes);
1567         
1568         # get all the users connected on the above nodes and send them out
1569         foreach $n (@localnodes, @remotenodes) {
1570                 if ($n) {
1571                         send_route($self, \&pc16, 1, $n, map {my $r = Route::User::get($_); $r ? ($r) : ()} $n->users);
1572                 } else {
1573                         dbg("sent a null value") if isdbg('chanerr');
1574                 }
1575         }
1576 }
1577
1578 #
1579 # route a message down an appropriate interface for a callsign
1580 #
1581 # is called route(to, pcline);
1582 #
1583 sub route
1584 {
1585         my ($self, $call, $line) = @_;
1586
1587         if (ref $self && $call eq $self->{call}) {
1588                 dbg("PCPROT: Trying to route back to source, dropped") if isdbg('chanerr');
1589                 return;
1590         }
1591
1592         # always send it down the local interface if available
1593         my $dxchan = DXChannel->get($call);
1594         unless ($dxchan) {
1595                 my $cl = Route::get($call);
1596                 $dxchan = $cl->dxchan if $cl;
1597                 if (ref $dxchan) {
1598                         if (ref $self && $dxchan eq $self) {
1599                                 dbg("PCPROT: Trying to route back to source, dropped") if isdbg('chanerr');
1600                                 return;
1601                         }
1602                 }
1603         }
1604         if ($dxchan) {
1605                 my $routeit = adjust_hops($dxchan, $line);   # adjust its hop count by node name
1606                 if ($routeit) {
1607                         $dxchan->send($routeit) unless $dxchan == $main::me;
1608                 }
1609         } else {
1610                 dbg("PCPROT: No route available, dropped") if isdbg('chanerr');
1611         }
1612 }
1613
1614 #
1615 # obtain the hops from the list for this callsign and pc no 
1616 #
1617
1618 sub get_hops
1619 {
1620         my $pcno = shift;
1621         my $hops = $DXProt::hopcount{$pcno};
1622         $hops = $DXProt::def_hopcount if !$hops;
1623         return "H$hops";       
1624 }
1625
1626
1627 # adjust the hop count on a per node basis using the user loadable 
1628 # hop table if available or else decrement an existing one
1629 #
1630
1631 sub adjust_hops
1632 {
1633         my $self = shift;
1634         my $s = shift;
1635         my $call = $self->{call};
1636         my $hops;
1637         
1638         if (($hops) = $s =~ /\^H(\d+)\^~?$/o) {
1639                 my ($pcno) = $s =~ /^PC(\d\d)/o;
1640                 confess "$call called adjust_hops with '$s'" unless $pcno;
1641                 my $ref = $nodehops{$call} if %nodehops;
1642                 if ($ref) {
1643                         my $newhops = $ref->{$pcno};
1644                         return "" if defined $newhops && $newhops == 0;
1645                         $newhops = $ref->{default} unless $newhops;
1646                         return "" if defined $newhops && $newhops == 0;
1647                         $newhops = $hops if !$newhops;
1648                         $s =~ s/\^H(\d+)(\^~?)$/\^H$newhops$2/ if $newhops;
1649                 } else {
1650                         # simply decrement it
1651                         $hops--;
1652                         return "" if !$hops;
1653                         $s =~ s/\^H(\d+)(\^~?)$/\^H$hops$2/ if $hops;
1654                 }
1655         }
1656         return $s;
1657 }
1658
1659
1660 # load hop tables
1661 #
1662 sub load_hops
1663 {
1664         my $self = shift;
1665         return $self->msg('lh1') unless -e "$main::data/hop_table.pl";
1666         do "$main::data/hop_table.pl";
1667         return $@ if $@;
1668         return 0;
1669 }
1670
1671
1672 # add a ping request to the ping queues
1673 sub addping
1674 {
1675         my ($from, $to) = @_;
1676         my $ref = $pings{$to} || [];
1677         my $r = {};
1678         $r->{call} = $from;
1679         $r->{t} = [ gettimeofday ];
1680         route(undef, $to, pc51($to, $main::mycall, 1));
1681         push @$ref, $r;
1682         $pings{$to} = $ref;
1683 }
1684
1685 sub process_rcmd
1686 {
1687         my ($self, $tonode, $fromnode, $user, $cmd) = @_;
1688         if ($tonode eq $main::mycall) {
1689                 my $ref = DXUser->get_current($fromnode);
1690                 my $cref = Route::Node::get($fromnode);
1691                 Log('rcmd', 'in', $ref->{priv}, $fromnode, $cmd);
1692                 if ($cmd !~ /^\s*rcmd/i && $cref && $ref && $cref->call eq $ref->homenode) { # not allowed to relay RCMDS!
1693                         if ($ref->{priv}) {             # you have to have SOME privilege, the commands have further filtering
1694                                 $self->{remotecmd} = 1; # for the benefit of any command that needs to know
1695                                 my $oldpriv = $self->{priv};
1696                                 $self->{priv} = $ref->{priv}; # assume the user's privilege level
1697                                 my @in = (DXCommandmode::run_cmd($self, $cmd));
1698                                 $self->{priv} = $oldpriv;
1699                                 $self->send_rcmd_reply($main::mycall, $fromnode, $user, @in);
1700                                 delete $self->{remotecmd};
1701                         } else {
1702                                 $self->send_rcmd_reply($main::mycall, $fromnode, $user, "sorry...!");
1703                         }
1704                 } else {
1705                         $self->send_rcmd_reply($main::mycall, $fromnode, $user, "your attempt is logged, Tut tut tut...!");
1706                 }
1707         } else {
1708                 my $ref = DXUser->get_current($tonode);
1709                 if ($ref && $ref->is_clx) {
1710                         $self->route($tonode, pc84($fromnode, $tonode, $user, $cmd));
1711                 } else {
1712                         $self->route($tonode, pc34($fromnode, $tonode, $cmd));
1713                 }
1714         }
1715 }
1716
1717 sub process_rcmd_reply
1718 {
1719         my ($self, $tonode, $fromnode, $user, $line) = @_;
1720         if ($tonode eq $main::mycall) {
1721                 my $s = $rcmds{$fromnode};
1722                 if ($s) {
1723                         my $dxchan = DXChannel->get($s->{call});
1724                         my $ref = $user eq $tonode ? $dxchan : (DXChannel->get($user) || $dxchan);
1725                         $ref->send($line) if $ref;
1726                         delete $rcmds{$fromnode} if !$dxchan;
1727                 } else {
1728                         # send unsolicited ones to the sysop
1729                         my $dxchan = DXChannel->get($main::myalias);
1730                         $dxchan->send($line) if $dxchan;
1731                 }
1732         } else {
1733                 my $ref = DXUser->get_current($tonode);
1734                 if ($ref && $ref->is_clx) {
1735                         $self->route($tonode, pc85($fromnode, $tonode, $user, $line));
1736                 } else {
1737                         $self->route($tonode, pc35($fromnode, $tonode, $line));
1738                 }
1739         }
1740 }
1741
1742 sub send_rcmd_reply
1743 {
1744         my $self = shift;
1745         my $tonode = shift;
1746         my $fromnode = shift;
1747         my $user = shift;
1748         while (@_) {
1749                 my $line = shift;
1750                 $line =~ s/\s*$//;
1751                 Log('rcmd', 'out', $fromnode, $line);
1752                 if ($self->is_clx) {
1753                         $self->send(pc85($main::mycall, $fromnode, $user, "$main::mycall:$line"));
1754                 } else {
1755                         $self->send(pc35($main::mycall, $fromnode, "$main::mycall:$line"));
1756                 }
1757         }
1758 }
1759
1760 # add a rcmd request to the rcmd queues
1761 sub addrcmd
1762 {
1763         my ($self, $to, $cmd) = @_;
1764
1765         my $r = {};
1766         $r->{call} = $self->{call};
1767         $r->{t} = $main::systime;
1768         $r->{cmd} = $cmd;
1769         $rcmds{$to} = $r;
1770         
1771         my $ref = Route::Node::get($to);
1772         my $dxchan = $ref->dxchan;
1773         if ($dxchan && $dxchan->is_clx) {
1774                 route(undef, $to, pc84($main::mycall, $to, $self->{call}, $cmd));
1775         } else {
1776                 route(undef, $to, pc34($main::mycall, $to, $cmd));
1777         }
1778 }
1779
1780 sub disconnect
1781 {
1782         my $self = shift;
1783         my $pc39flag = shift;
1784         my $call = $self->call;
1785
1786         return if $self->{disconnecting}++;
1787         
1788         unless ($pc39flag && $pc39flag == 1) {
1789                 $self->send_now("D", DXProt::pc39($main::mycall, $self->msg('disc1', "System Op")));
1790         }
1791
1792         # get rid of any PC16 and 19s
1793         eph_del_regex("^PC16\\^$call");
1794         eph_del_regex("^PC19\\^.*$call");
1795
1796         # do routing stuff
1797         my $node = Route::Node::get($call);
1798         my @rout;
1799         if ($node) {
1800                 @rout = $node->del($main::routeroot);
1801         }
1802         
1803         # unbusy and stop and outgoing mail
1804         my $mref = DXMsg::get_busy($call);
1805         $mref->stop_msg($call) if $mref;
1806         
1807         # broadcast to all other nodes that all the nodes connected to via me are gone
1808         unless ($pc39flag && $pc39flag == 2) {
1809                 $self->route_pc21(@rout) if @rout;
1810         }
1811
1812         # remove outstanding pings
1813         delete $pings{$call};
1814         
1815         # I was the last node visited
1816     $self->user->node($main::mycall);
1817
1818         # send info to all logged in thingies
1819         $self->tell_login('logoutn');
1820
1821         Log('DXProt', $call . " Disconnected");
1822
1823         $self->SUPER::disconnect;
1824 }
1825
1826
1827
1828 # send a talk message to this thingy
1829 #
1830 sub talk
1831 {
1832         my ($self, $from, $to, $via, $line, $origin) = @_;
1833         
1834         $line =~ s/\^/\\5E/g;                   # remove any ^ characters
1835         $self->send(DXProt::pc10($from, $to, $via, $line, $origin));
1836         Log('talk', $to, $from, $via?$via:$self->call, $line) unless $origin && $origin ne $main::mycall;
1837 }
1838
1839 # send it if it isn't the except list and isn't isolated and still has a hop count
1840 # taking into account filtering and so on
1841 sub send_route
1842 {
1843         my $self = shift;
1844         my $generate = shift;
1845         my $no = shift;     # the no of things to filter on 
1846         my $routeit;
1847         my ($filter, $hops);
1848         my @rin;
1849         
1850         for (; @_ && $no; $no--) {
1851                 my $r = shift;
1852                 
1853                 if (!$self->{isolate} && $self->{routefilter}) {
1854                         $filter = undef;
1855                         if ($r) {
1856                                 ($filter, $hops) = $self->{routefilter}->it($self->{call}, $self->{dxcc}, $self->{itu}, $self->{cq}, $r->call, $r->dxcc, $r->itu, $r->cq);
1857                                 if ($filter) {
1858                                         push @rin, $r;
1859                                 } else {
1860                                         dbg("DXPROT: $self->{call}/" . $r->call . " rejected by output filter") if isdbg('chanerr');
1861                                 }
1862                         } else {
1863                                 dbg("was sent a null value") if isdbg('chanerr');
1864                         }
1865                 } else {
1866                         push @rin, $r unless $self->{isolate} && $r->call ne $main::mycall;
1867                 }
1868         }
1869         if (@rin) {
1870                 foreach my $line (&$generate(@rin, @_)) {
1871                         if ($hops) {
1872                                 $routeit = $line;
1873                                 $routeit =~ s/\^H\d+\^\~$/\^H$hops\^\~/;
1874                         } else {
1875                                 $routeit = adjust_hops($self, $line);  # adjust its hop count by node name
1876                                 next unless $routeit;
1877                         }
1878                         $self->send($routeit);
1879                 }
1880         }
1881 }
1882
1883 sub broadcast_route
1884 {
1885         my $self = shift;
1886         my $generate = shift;
1887         my @dxchan = DXChannel::get_all_nodes();
1888         my $dxchan;
1889         my $line;
1890         
1891         unless ($self->{isolate}) {
1892                 foreach $dxchan (@dxchan) {
1893                         next if $dxchan == $self;
1894                         next if $dxchan == $main::me;
1895                         $dxchan->send_route($generate, @_);
1896                 }
1897         }
1898 }
1899
1900 sub route_pc16
1901 {
1902         my $self = shift;
1903         broadcast_route($self, \&pc16, 1, @_);
1904 }
1905
1906 sub route_pc17
1907 {
1908         my $self = shift;
1909         broadcast_route($self, \&pc17, 1, @_);
1910 }
1911
1912 sub route_pc19
1913 {
1914         my $self = shift;
1915         broadcast_route($self, \&pc19, scalar @_, @_);
1916 }
1917
1918 sub route_pc21
1919 {
1920         my $self = shift;
1921         broadcast_route($self, \&pc21, scalar @_, @_);
1922 }
1923
1924 sub route_pc24
1925 {
1926         my $self = shift;
1927         broadcast_route($self, \&pc24, 1, @_);
1928 }
1929
1930 sub route_pc41
1931 {
1932         my $self = shift;
1933         broadcast_route($self, \&pc41, 1, @_);
1934 }
1935
1936 sub route_pc50
1937 {
1938         my $self = shift;
1939         broadcast_route($self, \&pc50, 1, @_);
1940 }
1941
1942 sub in_filter_route
1943 {
1944         my $self = shift;
1945         my $r = shift;
1946         my ($filter, $hops) = (1, 1);
1947         
1948         if ($self->{inroutefilter}) {
1949                 ($filter, $hops) = $self->{inroutefilter}->it($self->{call}, $self->{dxcc}, $self->{itu}, $self->{cq}, $r->call, $r->dxcc, $r->itu, $r->cq);
1950                 dbg("PCPROT: $self->{call}/" . $r->call . ' rejected by in_filter_route') if !$filter && isdbg('chanerr');
1951         }
1952         return $filter;
1953 }
1954
1955 sub eph_dup
1956 {
1957         my $s = shift;
1958         my $t = shift || $eph_restime;
1959         my $r;
1960
1961         # chop the end off
1962         $s =~ s/\^H\d\d?\^?\~?$//;
1963         $r = 1 if exists $eph{$s};    # pump up the dup if it keeps circulating
1964         $eph{$s} = $main::systime + $t;
1965         return $r;
1966 }
1967
1968 sub eph_del_regex
1969 {
1970         my $regex = shift;
1971         my ($key, $val);
1972         while (($key, $val) = each %eph) {
1973                 if ($key =~ m{$regex}) {
1974                         delete $eph{$key};
1975                 }
1976         }
1977 }
1978
1979 sub eph_clean
1980 {
1981         my ($key, $val);
1982         
1983         while (($key, $val) = each %eph) {
1984                 if ($main::systime >= $val) {
1985                         delete $eph{$key};
1986                 }
1987         }
1988 }
1989
1990 sub eph_list
1991 {
1992         my ($key, $val);
1993         my @out;
1994
1995         while (($key, $val) = each %eph) {
1996                 push @out, $key, $val;
1997         }
1998         return @out;
1999 }
2000
2001 sub run_cmd
2002 {
2003         goto &DXCommandmode::run_cmd;
2004 }
2005 1;
2006 __END__