perl/Filter.pm

   1 #
   2 # The User/Sysop Filter module
   3 #
   4 # The way this works is that the filter routine is actually
   5 # a predefined function that returns 0 if it is OK and 1 if it
   6 # is not when presented with a list of things.
   7 #
   8 # This set of routines provide a means of maintaining the filter
   9 # scripts which are compiled in when an entity connects.
  10 #
  11 # Copyright (c) 1999 Dirk Koopman G1TLH
  12 #
  13 # $Id$
  14 #
  15 # The NEW INSTRUCTIONS
  16 #
  17 # use the commands accept/spot|ann|wwv|wcy and reject/spot|ann|wwv|wcy
  18 # also show/filter spot|ann|wwv|wcy
  19 #
  20 # The filters live in a directory tree of their own in $main::root/filter
  21 #
  22 # Each type of filter (e.g. spot, wwv) live in a tree of their own so you
  23 # can have different filters for different things for the same callsign.
  24 #
  25
  26
  27 package Filter;
  28
  29 use DXVars;
  30 use DXUtil;
  31 use DXDebug;
  32 use Data::Dumper;
  33 use Prefix;
  34
  35 use strict;
  36
  37 use vars qw($VERSION $BRANCH);
  38 $VERSION = sprintf( "%d.%03d", q$Revision$ =~ /(\d+)\.(\d+)/ );
  39 $BRANCH = sprintf( "%d.%03d", q$Revision$ =~ /\d+\.\d+\.(\d+)\.(\d+)/ ) || 0;
  40 $main::build += $VERSION;
  41 $main::branch += $BRANCH;
  42
  43 use vars qw ($filterbasefn $in);
  44
  45 $filterbasefn = "$main::root/filter";
  46 $in = undef;
  47
  48 # initial filter system
  49 sub init
  50 {
  51
  52 }
  53
  54 sub new
  55 {
  56         my ($class, $sort, $call, $flag) = @_;
  57         $flag = ($flag) ? "in_" : "";
  58         return bless {sort => $sort, name => "$flag$call.pl" }, $class;
  59 }
  60
  61 # standard filename generator
  62 sub getfn
  63 {
  64         my ($sort, $call, $flag) = @_;
  65
  66     # first uppercase
  67         $flag = ($flag) ? "in_" : "";
  68         $call = uc $call;
  69         my $fn = "$filterbasefn/$sort/$flag$call.pl";
  70
  71         # otherwise lowercase
  72         unless (-e $fn) {
  73                 $call = lc $call;
  74                 $fn = "$filterbasefn/$sort/$flag$call.pl";
  75         }
  76         $fn = undef unless -e $fn;
  77         return $fn;
  78 }
  79
  80 # this reads in a filter statement and returns it as a list
  81 #
  82 # The filter is stored in straight perl so that it can be parsed and read
  83 # in with a 'do' statement. The 'do' statement reads the filter into
  84 # @in which is a list of references
  85 #
  86 sub compile
  87 {
  88         my $self = shift;
  89         my $fname = shift;
  90         my $ar = shift;
  91         my $ref = $self->{$fname};
  92         my $rr;
  93
  94         if ($ref->{$ar} && exists $ref->{$ar}->{asc}) {
  95                 $ref->{$ar}->{code} = eval "sub { my \$r=shift; return $ref->{$ar}->{asc}; }" ;
  96                 if ($@) {
  97                         my $sort = $ref->{sort};
  98                         my $name = $ref->{name};
  99                         dbg("Error compiling $ar $sort $name: $@");
 100                         Log('err', "Error compiling $ar $sort $name: $@");
 101                 }
 102                 $rr = $@;
 103         }
 104         return $rr;
 105 }
 106
 107 sub read_in
 108 {
 109         my ($sort, $call, $flag) = @_;
 110         my $fn;
 111
 112         # load it
 113         if ($fn = getfn($sort, $call, $flag)) {
 114                 $in = undef;
 115                 my $s = readfilestr($fn);
 116                 my $newin = eval $s;
 117                 dbg($@) if $@;
 118                 if ($in) {
 119                         $newin = new('Filter::Old', $sort, $call, $flag);
 120                         $newin->{filter} = $in;
 121                 } else {
 122                         my $filter;
 123                         my $key;
 124                         foreach $key ($newin->getfilkeys) {
 125                                 $newin->compile($key, 'reject');
 126                                 $newin->compile($key, 'accept');
 127                         }
 128                 }
 129                 return $newin;
 130         }
 131         return undef;
 132 }
 133
 134 sub getfilters
 135 {
 136         my $self = shift;
 137         my @out;
 138         my $key;
 139         foreach $key (grep {/^filter/ } keys %$self) {
 140                 push @out, $self->{$key};
 141         }
 142         return @out;
 143 }
 144
 145 sub getfilkeys
 146 {
 147         my $self = shift;
 148         return grep {/^filter/ } keys %$self;
 149 }
 150
 151 #
 152 # This routine accepts a composite filter with a reject rule and then an accept rule.
 153 #
 154 # The filter returns 0 if an entry is matched by any reject rule and also if any
 155 # accept rule fails otherwise it returns 1
 156 #
 157 # Either set of rules may be missing meaning an implicit 'opposite' ie if it
 158 # a reject then ok else if an accept then not ok.
 159 #
 160 # you can set a default with either an accept/xxxx all or reject/xxxx all
 161 #
 162 # Unlike the old system, this is kept as a hash of hashes so that you can
 163 # easily change them by program.
 164 #
 165 # You can have 10 filter lines (0->9), they are tried in order until
 166 # one matches
 167 #
 168 # There is a parser that takes a Filter::Cmd object which describes all the possible
 169 # things you can filter on and then converts that to a bit of perl which is compiled
 170 # and stored as a function.
 171 #
 172 # The result of this is that in theory you can put together an arbritrarily complex
 173 # expression involving the things you can filter on including 'and' 'or' 'not' and
 174 # 'brackets'.
 175 #
 176 # eg:-
 177 #
 178 # accept/spots hf and by_zone 14,15,16 and not by pa,on
 179 #
 180 # accept/spots freq 0/30000 and by_zone 4,5
 181 #
 182 # accept/spots 2 vhf and (by_zone 14,15,16 or call_dxcc 61)
 183 #
 184 # no filter no implies filter 1
 185 #
 186 # The field nos are the same as for the 'Old' filters
 187 #
 188 #
 189
 190 sub it
 191 {
 192         my $self = shift;
 193
 194         my $filter;
 195         my @keys = sort $self->getfilkeys;
 196         my $key;
 197         my $type = 'Dunno';
 198         my $asc = '?';
 199
 200         my $r = @keys > 0 ? 0 : 1;
 201         foreach $key (@keys) {
 202                 $filter = $self->{$key};
 203                 if ($filter->{reject} && exists $filter->{reject}->{code}) {
 204                         $type = 'reject';
 205                         $asc = $filter->{reject}->{user};
 206                         if (&{$filter->{reject}->{code}}(\@_)) {
 207                                 $r = 0;
 208                                 last;
 209                         } else {
 210                                 $r = 1;
 211                         }
 212                 }
 213                 if ($filter->{accept} && exists $filter->{accept}->{code}) {
 214                         $type = 'accept';
 215                         $asc = $filter->{accept}->{user};
 216                         if (&{$filter->{accept}->{code}}(\@_)) {
 217                                 $r = 1;
 218                                 last;
 219                         } else {
 220                                 $r = 0;
 221                         }
 222                 }
 223         }
 224
 225         # hops are done differently (simply)
 226         my $hops = $self->{hops} if exists $self->{hops};
 227
 228         if (isdbg('filter')) {
 229                 my $args = join '\',\'', @_;
 230                 my $true = $r ? "OK " : "REJ";
 231                 my $sort = $self->{sort};
 232                 my $dir = $self->{name} =~ /^in_/i ? "IN " : "OUT";
 233
 234                 my $h = $hops || '';
 235                 dbg("$true $dir: $type/$sort with $asc on '$args' $h") if isdbg('filter');
 236         }
 237         return ($r, $hops);
 238 }
 239
 240 # this writes out the filter in a form suitable to be read in by 'read_in'
 241 # It expects a list of references to filter lines
 242 sub write
 243 {
 244         my $self = shift;
 245         my $sort = $self->{sort};
 246         my $name = $self->{name};
 247         my $dir = "$filterbasefn/$sort";
 248         my $fn = "$dir/$name";
 249
 250         mkdir $dir, 0775 unless -e $dir;
 251     rename $fn, "$fn.o" if -e $fn;
 252         my $fh = new IO::File ">$fn";
 253         if ($fh) {
 254                 my $dd = new Data::Dumper([ $self ]);
 255                 $dd->Indent(1);
 256                 $dd->Terse(1);
 257                 $dd->Quotekeys($] < 5.005 ? 1 : 0);
 258                 $fh->print($dd->Dumpxs);
 259                 $fh->close;
 260         } else {
 261                 rename "$fn.o", $fn if -e "$fn.o";
 262                 return "$fn $!";
 263         }
 264         return undef;
 265 }
 266
 267 sub print
 268 {
 269         my $self = shift;
 270         my $name = shift || $self->{name};
 271         my $sort = shift || $self->{sort};
 272         my $flag = shift || "";
 273         my @out;
 274         $name =~ s/.pl$//;
 275
 276         push @out, join(' ',  $name , ':', $sort, $flag);
 277         my $filter;
 278         my $key;
 279         foreach $key (sort $self->getfilkeys) {
 280                 my $filter = $self->{$key};
 281                 if (exists $filter->{reject} && exists $filter->{reject}->{user}) {
 282                         push @out, ' ' . join(' ', $key, 'reject', $filter->{reject}->{user});
 283                 }
 284                 if (exists $filter->{accept} && exists $filter->{accept}->{user}) {
 285                         push @out, ' ' . join(' ', $key, 'accept', $filter->{accept}->{user});
 286                 }
 287         }
 288         return @out;
 289 }
 290
 291 sub install
 292 {
 293         my $self = shift;
 294         my $remove = shift;
 295         my $name = uc $self->{name};
 296         my $sort = $self->{sort};
 297         my $in = "";
 298         $in = "in" if $name =~ s/^IN_//;
 299         $name =~ s/.PL$//;
 300
 301         my $dxchan;
 302         my @dxchan;
 303         if ($name eq 'NODE_DEFAULT') {
 304                 @dxchan = DXChannel::get_all_nodes();
 305         } elsif ($name eq 'USER_DEFAULT') {
 306                 @dxchan = DXChannel::get_all_users();
 307         } else {
 308                 $dxchan = DXChannel->get($name);
 309                 push @dxchan, $dxchan if $dxchan;
 310         }
 311         foreach $dxchan (@dxchan) {
 312                 my $n = "$in$sort" . "filter";
 313                 my $ref = $dxchan->$n();
 314                 if (!$ref || ($ref && uc $ref->{name} eq "$name.PL")) {
 315                         $dxchan->$n($remove ? undef : $self);
 316                 }
 317         }
 318 }
 319
 320 sub delete
 321 {
 322         my ($sort, $call, $flag, $fno) = @_;
 323
 324         # look for the file
 325         my $fn = getfn($sort, $call, $flag);
 326         my $filter = read_in($sort, $call, $flag);
 327         if ($filter) {
 328                 if ($fno eq 'all') {
 329                         my $key;
 330                         foreach $key ($filter->getfilkeys) {
 331                                 delete $filter->{$key};
 332                         }
 333                 } elsif (exists $filter->{"filter$fno"}) {
 334                         delete $filter->{"filter$fno"};
 335                 }
 336
 337                 # get rid
 338                 if ($filter->{hops} || $filter->getfilkeys) {
 339                         $filter->install;
 340                         $filter->write;
 341                 } else {
 342                         $filter->install(1);
 343                         unlink $fn;
 344                 }
 345         }
 346 }
 347
 348 package Filter::Cmd;
 349
 350 use strict;
 351 use DXVars;
 352 use DXUtil;
 353 use DXDebug;
 354 use vars qw(@ISA);
 355 @ISA = qw(Filter);
 356
 357 # the general purpose command processor
 358 # this is called as a subroutine not as a method
 359 sub parse
 360 {
 361         my ($self, $dxchan, $sort, $line) = @_;
 362         my $ntoken = 0;
 363         my $fno = 1;
 364         my $filter;
 365         my ($flag, $call);
 366         my $s;
 367         my $user;
 368
 369         # check the line for non legal characters
 370         return ('ill', $dxchan->msg('e19')) if $line =~ /[^\s\w,_\-\*\/\(\)]/;
 371
 372         # add some spaces for ease of parsing
 373         $line =~ s/([\(\)])/ $1 /g;
 374         $line = lc $line;
 375
 376         my @f = split /\s+/, $line;
 377         my $conj = ' && ';
 378         my $not = "";
 379         while (@f) {
 380                 if ($ntoken == 0) {
 381
 382                         if (@f && $dxchan->priv >= 8 && ((is_callsign(uc $f[0]) && DXUser->get(uc $f[0])) || $f[0] =~ /(?:node|user)_default/)) {
 383                                 $call = shift @f;
 384                                 if ($f[0] eq 'input') {
 385                                         shift @f;
 386                                         $flag++;
 387                                 }
 388                         } else {
 389                                 $call = $dxchan->call;
 390                         }
 391
 392                         if (@f && $f[0] =~ /^\d$/) {
 393                                 $fno = shift @f;
 394                         }
 395
 396                         $filter = Filter::read_in($sort, $call, $flag);
 397                         $filter = Filter->new($sort, $call, $flag) if !$filter || $filter->isa('Filter::Old');
 398
 399                         $ntoken++;
 400                         next;
 401                 }
 402
 403                 # do the rest of the filter tokens
 404                 if (@f) {
 405                         my $tok = shift @f;
 406                         if ($tok eq '(') {
 407                                 if ($s) {
 408                                         $s .= $conj;
 409                                         $user .= $conj;
 410                                         $conj = "";
 411                                 }
 412                                 if ($not) {
 413                                         $s .= $not;
 414                                         $user .= $not;
 415                                         $not = "";
 416                                 }
 417                                 $s .= $tok;
 418                                 $user .= $tok;
 419                                 next;
 420                         } elsif ($tok eq ')') {
 421                                 $conj = ' && ';
 422                                 $not ="";
 423                                 $s .= $tok;
 424                                 $user .= $tok;
 425                                 next;
 426                         } elsif ($tok eq 'all') {
 427                                 $s .= '1';
 428                                 $user .= $tok;
 429                                 last;
 430                         } elsif ($tok eq 'or') {
 431                                 $conj = ' || ' if $conj ne ' || ';
 432                                 next;
 433                         } elsif ($tok eq 'and') {
 434                                 $conj = ' && ' if $conj ne ' && ';
 435                                 next;
 436                         } elsif ($tok eq 'not' || $tok eq '!') {
 437                                 $not = '!';
 438                                 next;
 439                         }
 440                         if (@f) {
 441                                 my $val = shift @f;
 442                                 my @val = split /,/, $val;
 443
 444                                 if ($s) {
 445                                         $s .= $conj ;
 446                                         $s .= $not;
 447                                         $user .= $conj;
 448                                         $user .= $not;
 449                                         $conj = ' && ';
 450                                         $not = "";
 451                                 }
 452                                 $user .= "$tok $val";
 453
 454                                 my $fref;
 455                                 my $found;
 456                                 foreach $fref (@$self) {
 457
 458                                         if ($fref->[0] eq $tok) {
 459                                                 if ($fref->[4]) {
 460                                                         my @nval;
 461                                                         for (@val) {
 462                                                                 push @nval, split(',', &{$fref->[4]}($dxchan, $_));
 463                                                         }
 464                                                         @val = @nval;
 465                                                 }
 466                                                 if ($fref->[1] eq 'a') {
 467                                                         my @t;
 468                                                         for (@val) {
 469                                                                 s/\*//g;
 470                                                                 push @t, "\$r->[$fref->[2]]=~/$_/i";
 471                                                         }
 472                                                         $s .= "(" . join(' || ', @t) . ")";
 473                                                 } elsif ($fref->[1] eq 'c') {
 474                                                         my @t;
 475                                                         for (@val) {
 476                                                                 s/\*//g;
 477                                                                 push @t, "\$r->[$fref->[2]]=~/^\U$_/";
 478                                                         }
 479                                                         $s .= "(" . join(' || ', @t) . ")";
 480                                                 } elsif ($fref->[1] eq 'n') {
 481                                                         my @t;
 482                                                         for (@val) {
 483                                                                 return ('num', $dxchan->msg('e21', $_)) unless /^\d+$/;
 484                                                                 push @t, "\$r->[$fref->[2]]==$_";
 485                                                         }
 486                                                         $s .= "(" . join(' || ', @t) . ")";
 487                                                 } elsif ($fref->[1] =~ /^n[ciz]$/ ) {    # for DXCC, ITU, CQ Zone
 488                                                         my @n;
 489                                                         my $cmd = $fref->[1];
 490                                                         foreach my $v (@val) {
 491                                                                 if ($v =~ /^\d+$/) {
 492                                                                         push @n, $v unless grep $_ eq $v, @n;
 493                                                                 } else {
 494                                                                         my @pre = Prefix::extract($v);
 495                                                                         return ('numpre', $dxchan->msg('e27', $_)) unless @pre;
 496                                                                         shift @pre;
 497                                                                         foreach my $p (@pre) {
 498                                                                                 my $n = $p->dxcc if $cmd eq 'nc' ;
 499                                                                                 $n = $p->itu if $cmd eq 'ni' ;
 500                                                                                 $n = $p->cq if $cmd eq 'nz' ;
 501                                                                                 push @n, $n unless grep $_ eq $n, @n;
 502                                                                         }
 503                                                                 }
 504                                                         }
 505                                                         $s .= "(" . join(' || ', map {"\$r->[$fref->[2]]==$_"} @n) . ")";
 506                                                 } elsif ($fref->[1] eq 'r') {
 507                                                         my @t;
 508                                                         for (@val) {
 509                                                                 return ('range', $dxchan->msg('e23', $_)) unless /^(\d+)\/(\d+)$/;
 510                                                                 push @t, "(\$r->[$fref->[2]]>=$1 && \$r->[$fref->[2]]<=$2)";
 511                                                         }
 512                                                         $s .= "(" . join(' || ', @t) . ")";
 513                                                 } elsif ($fref->[1] eq 't') {
 514                                                         my @t;
 515                                                         for (@val) {
 516                                                                 s/\*//g;
 517                                                                 push @t, "\$r->[$fref->[2]]=~/$_/i";
 518                                                         }
 519                                                         $s .= "(" . join(' || ', @t) . ")";
 520                                                 } else {
 521                                                         confess("invalid letter $fref->[1]");
 522                                                 }
 523                                                 ++$found;
 524                                                 last;
 525                                         }
 526                                 }
 527                                 return ('unknown', $dxchan->msg('e20', $tok)) unless $found;
 528                         } else {
 529                                 return ('no', $dxchan->msg('filter2', $tok));
 530                         }
 531                 }
 532
 533         }
 534
 535         # tidy up the user string
 536         $user =~ s/\&\&/ and /g;
 537         $user =~ s/\|\|/ or /g;
 538         $user =~ s/\!/ not /g;
 539         $user =~ s/\s+/ /g;
 540
 541         return (0, $filter, $fno, $user, "$s");
 542 }
 543
 544 # a filter accept/reject command
 545 sub cmd
 546 {
 547         my ($self, $dxchan, $sort, $type, $line) = @_;
 548
 549         return $dxchan->msg('filter5') unless $line;
 550
 551         my ($r, $filter, $fno, $user, $s) = $self->parse($dxchan, $sort, $line);
 552         my $u = DXUser->get_current($user);
 553         return (1, $dxchan->msg('isow', $user)) if $u && $u->isolate;
 554         return (1, $filter) if $r;
 555
 556         my $fn = "filter$fno";
 557
 558         $filter->{$fn} = {} unless exists $filter->{$fn};
 559         $filter->{$fn}->{$type} = {} unless exists $filter->{$fn}->{$type};
 560
 561         $filter->{$fn}->{$type}->{user} = $user;
 562         $filter->{$fn}->{$type}->{asc} = $s;
 563         $r = $filter->compile($fn, $type);
 564         return (1,$r) if $r;
 565
 566         $r = $filter->write;
 567         return (1,$r) if $r;
 568
 569         $filter->install;
 570
 571     return (0, $filter, $fno);
 572 }
 573
 574 package Filter::Old;
 575
 576 use strict;
 577 use DXVars;
 578 use DXUtil;
 579 use DXDebug;
 580 use vars qw(@ISA);
 581 @ISA = qw(Filter);
 582
 583 # the OLD instructions!
 584 #
 585 # Each filter file has the same structure:-
 586 #
 587 # <some comment>
 588 # @in = (
 589 #      [ action, fieldno, fieldsort, comparison, action data ],
 590 #      ...
 591 # );
 592 #
 593 # The action is usually 1 or 0 but could be any numeric value
 594 #
 595 # The fieldno is the field no in the list of fields that is presented
 596 # to 'Filter::it'
 597 #
 598 # The fieldsort is the type of field that we are dealing with which
 599 # currently can be 'a', 'n', 'r' or 'd'. 'a' is alphanumeric, 'n' is
 600 # numeric, 'r' is ranges of pairs of numeric values and 'd' is default.
 601 #
 602 # Filter::it basically goes thru the list of comparisons from top to
 603 # bottom and when one matches it will return the action and the action data as a list.
 604 # The fields
 605 # are the element nos of the list that is presented to Filter::it. Element
 606 # 0 is the first field of the list.
 607 #
 608
 609 #
 610 # takes the reference to the filter (the first argument) and applies
 611 # it to the subsequent arguments and returns the action specified.
 612 #
 613 sub it
 614 {
 615         my $self = shift;
 616         my $filter = $self->{filter};            # this is now a bless ref of course but so what
 617
 618         my ($action, $field, $fieldsort, $comp, $actiondata);
 619         my $ref;
 620
 621         # default action is 1
 622         $action = 1;
 623         $actiondata = "";
 624         return ($action, $actiondata) if !$filter;
 625
 626         for $ref (@{$filter}) {
 627                 ($action, $field, $fieldsort, $comp, $actiondata) = @{$ref};
 628                 if ($fieldsort eq 'n') {
 629                         my $val = $_[$field];
 630                         return ($action, $actiondata)  if grep $_ == $val, @{$comp};
 631                 } elsif ($fieldsort eq 'r') {
 632                         my $val = $_[$field];
 633                         my $i;
 634                         my @range = @{$comp};
 635                         for ($i = 0; $i < @range; $i += 2) {
 636                                 return ($action, $actiondata)  if $val >= $range[$i] && $val <= $range[$i+1];
 637                         }
 638                 } elsif ($fieldsort eq 'a') {
 639                         return ($action, $actiondata)  if $_[$field] =~ m{$comp};
 640                 } else {
 641                         return ($action, $actiondata);      # the default action
 642                 }
 643         }
 644 }
 645
 646 sub print
 647 {
 648         my $self = shift;
 649         my $call = shift;
 650         my $sort = shift;
 651         my $flag = shift || "";
 652         return "$call: Old Style Filter $flag $sort";
 653 }
 654
 655 1;
 656 __END__