2 # The User/Sysop Filter module
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.
8 # This set of routines provide a means of maintaining the filter
9 # scripts which are compiled in when an entity connects.
11 # Copyright (c) 1999 Dirk Koopman G1TLH
15 # The NEW INSTRUCTIONS
17 # use the commands accept/spot|ann|wwv|wcy and reject/spot|ann|wwv|wcy
18 # also show/filter spot|ann|wwv|wcy
20 # The filters live in a directory tree of their own in $main::root/filter
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.
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,0));
40 $main::build += $VERSION;
41 $main::branch += $BRANCH;
43 use vars qw ($filterbasefn $in);
45 $filterbasefn = "$main::root/filter";
48 # initial filter system
56 my ($class, $sort, $call, $flag) = @_;
57 $flag = ($flag) ? "in_" : "";
58 return bless {sort => $sort, name => "$flag$call.pl" }, $class;
61 # standard filename generator
64 my ($sort, $call, $flag) = @_;
67 $flag = ($flag) ? "in_" : "";
69 my $fn = "$filterbasefn/$sort/$flag$call.pl";
74 $fn = "$filterbasefn/$sort/$flag$call.pl";
76 $fn = undef unless -e $fn;
80 # this reads in a filter statement and returns it as a list
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
91 my $ref = $self->{$fname};
94 if ($ref->{$ar} && exists $ref->{$ar}->{asc}) {
95 my $s = $ref->{$ar}->{asc}; # an optimisation?
97 $ref->{$ar}->{code} = eval "sub { $s }" ;
99 my $sort = $ref->{sort};
100 my $name = $ref->{name};
101 dbg("Error compiling $ar $sort $name: $@");
102 Log('err', "Error compiling $ar $sort $name: $@");
111 my ($sort, $call, $flag) = @_;
115 if ($fn = getfn($sort, $call, $flag)) {
117 my $s = readfilestr($fn);
125 $newin = new('Filter::Old', $sort, $call, $flag);
126 $newin->{filter} = $in;
127 } elsif (ref $newin && $newin->can('getfilkeys')) {
130 foreach $key ($newin->getfilkeys) {
131 $newin->compile($key, 'reject');
132 $newin->compile($key, 'accept');
135 # error on reading file, delete and exit
136 dbg("empty or unreadable filter: $fn, deleted");
150 foreach $key (grep {/^filter/ } keys %$self) {
151 push @out, $self->{$key};
159 return grep {/^filter/ } keys %$self;
163 # This routine accepts a composite filter with a reject rule and then an accept rule.
165 # The filter returns 0 if an entry is matched by any reject rule and also if any
166 # accept rule fails otherwise it returns 1
168 # Either set of rules may be missing meaning an implicit 'opposite' ie if it
169 # a reject then ok else if an accept then not ok.
171 # you can set a default with either an accept/xxxx all or reject/xxxx all
173 # Unlike the old system, this is kept as a hash of hashes so that you can
174 # easily change them by program.
176 # You can have 10 filter lines (0->9), they are tried in order until
179 # There is a parser that takes a Filter::Cmd object which describes all the possible
180 # things you can filter on and then converts that to a bit of perl which is compiled
181 # and stored as a function.
183 # The result of this is that in theory you can put together an arbritrarily complex
184 # expression involving the things you can filter on including 'and' 'or' 'not' and
189 # accept/spots hf and by_zone 14,15,16 and not by pa,on
191 # accept/spots freq 0/30000 and by_zone 4,5
193 # accept/spots 2 vhf and (by_zone 14,15,16 or call_dxcc 61)
195 # no filter no implies filter 1
197 # The field nos are the same as for the 'Old' filters
206 my @keys = sort $self->getfilkeys;
211 my $r = @keys > 0 ? 0 : 1;
212 foreach $key (@keys) {
213 $filter = $self->{$key};
214 if ($filter->{reject} && exists $filter->{reject}->{code}) {
216 $asc = $filter->{reject}->{user};
217 if (&{$filter->{reject}->{code}}(\@_)) {
224 if ($filter->{accept} && exists $filter->{accept}->{code}) {
226 $asc = $filter->{accept}->{user};
227 if (&{$filter->{accept}->{code}}(\@_)) {
236 # hops are done differently (simply)
237 my $hops = $self->{hops} if exists $self->{hops};
239 if (isdbg('filter')) {
240 my $args = join '\',\'', map {defined $_ ? $_ : 'undef'} @_;
241 my $true = $r ? "OK " : "REJ";
242 my $sort = $self->{sort};
243 my $dir = $self->{name} =~ /^in_/i ? "IN " : "OUT";
246 dbg("$true $dir: $type/$sort with $asc on '$args' $h") if isdbg('filter');
251 # this writes out the filter in a form suitable to be read in by 'read_in'
252 # It expects a list of references to filter lines
256 my $sort = $self->{sort};
257 my $name = $self->{name};
258 my $dir = "$filterbasefn/$sort";
259 my $fn = "$dir/$name";
261 mkdir $dir, 0775 unless -e $dir;
262 rename $fn, "$fn.o" if -e $fn;
263 my $fh = new IO::File ">$fn";
265 my $dd = new Data::Dumper([ $self ]);
268 $dd->Quotekeys($] < 5.005 ? 1 : 0);
269 $fh->print($dd->Dumpxs);
272 rename "$fn.o", $fn if -e "$fn.o";
281 my $name = shift || $self->{name};
282 my $sort = shift || $self->{sort};
283 my $flag = shift || "";
287 push @out, join(' ', $name , ':', $sort, $flag);
290 foreach $key (sort $self->getfilkeys) {
291 my $filter = $self->{$key};
292 if (exists $filter->{reject} && exists $filter->{reject}->{user}) {
293 push @out, ' ' . join(' ', $key, 'reject', $filter->{reject}->{user});
295 if (exists $filter->{accept} && exists $filter->{accept}->{user}) {
296 push @out, ' ' . join(' ', $key, 'accept', $filter->{accept}->{user});
306 my $name = uc $self->{name};
307 my $sort = $self->{sort};
309 $in = "in" if $name =~ s/^IN_//;
314 if ($name eq 'NODE_DEFAULT') {
315 @dxchan = DXChannel::get_all_nodes();
316 } elsif ($name eq 'USER_DEFAULT') {
317 @dxchan = DXChannel::get_all_users();
319 $dxchan = DXChannel::get($name);
320 push @dxchan, $dxchan if $dxchan;
322 foreach $dxchan (@dxchan) {
323 my $n = "$in$sort" . "filter";
324 my $i = $in ? 'IN_' : '';
325 my $ref = $dxchan->$n();
326 if (!$ref || ($ref && uc $ref->{name} eq "$i$name.PL")) {
327 $dxchan->$n($remove ? undef : $self);
334 my ($sort, $call, $flag, $fno) = @_;
337 my $fn = getfn($sort, $call, $flag);
338 my $filter = read_in($sort, $call, $flag);
342 foreach $key ($filter->getfilkeys) {
343 delete $filter->{$key};
345 } elsif (exists $filter->{"filter$fno"}) {
346 delete $filter->{"filter$fno"};
350 if ($filter->{hops} || $filter->getfilkeys) {
369 # the general purpose command processor
370 # this is called as a subroutine not as a method
373 my ($self, $dxchan, $sort, $line) = @_;
381 # check the line for non legal characters
382 return ('ill', $dxchan->msg('e19')) if $line =~ /[^\s\w,_\-\*\/\(\)!]/;
384 # add some spaces for ease of parsing
385 $line =~ s/([\(\)])/ $1 /g;
388 my @f = split /\s+/, $line;
394 if (@f && $dxchan->priv >= 8 && ((is_callsign(uc $f[0]) && DXUser->get(uc $f[0])) || $f[0] =~ /(?:node|user)_default/)) {
396 if ($f[0] eq 'input') {
401 $call = $dxchan->call;
404 if (@f && $f[0] =~ /^\d$/) {
408 $filter = Filter::read_in($sort, $call, $flag);
409 $filter = Filter->new($sort, $call, $flag) if !$filter || $filter->isa('Filter::Old');
415 # do the rest of the filter tokens
432 } elsif ($tok eq ')') {
438 } elsif ($tok eq 'all') {
442 } elsif ($tok eq 'or') {
443 $conj = ' || ' if $conj ne ' || ';
445 } elsif ($tok eq 'and') {
446 $conj = ' && ' if $conj ne ' && ';
448 } elsif ($tok eq 'not' || $tok eq '!') {
454 my @val = split /,/, $val;
468 $user .= "$tok $val";
472 foreach $fref (@$self) {
474 if ($fref->[0] eq $tok) {
478 push @nval, split(',', &{$fref->[4]}($dxchan, $_));
482 if ($fref->[1] eq 'a') {
486 push @t, "\$r->[$fref->[2]]=~/$_/i";
488 $s .= "(" . join(' || ', @t) . ")";
489 } elsif ($fref->[1] eq 'c') {
493 push @t, "\$r->[$fref->[2]]=~/^\U$_/";
495 $s .= "(" . join(' || ', @t) . ")";
496 } elsif ($fref->[1] eq 'n') {
499 return ('num', $dxchan->msg('e21', $_)) unless /^\d+$/;
500 push @t, "\$r->[$fref->[2]]==$_";
502 $s .= "(" . join(' || ', @t) . ")";
503 } elsif ($fref->[1] =~ /^n[ciz]$/ ) { # for DXCC, ITU, CQ Zone
504 my $cmd = $fref->[1];
505 my @pre = Prefix::to_ciz($cmd, @val);
506 return ('numpre', $dxchan->msg('e27', $_)) unless @pre;
507 $s .= "(" . join(' || ', map {"\$r->[$fref->[2]]==$_"} @pre) . ")";
508 } elsif ($fref->[1] =~ /^ns$/ ) { # for DXCC, ITU, CQ Zone
509 my $cmd = $fref->[1];
510 my @pre = Prefix::to_ciz($cmd, @val);
511 return ('numpre', $dxchan->msg('e27', $_)) unless @pre;
512 $s .= "(" . "!\$USDB::present || grep \$r->[$fref->[2]] eq \$_, qw(" . join(' ' ,map {uc} @pre) . "))";
513 } elsif ($fref->[1] eq 'r') {
516 return ('range', $dxchan->msg('e23', $_)) unless /^(\d+)\/(\d+)$/;
517 push @t, "(\$r->[$fref->[2]]>=$1 && \$r->[$fref->[2]]<=$2)";
519 $s .= "(" . join(' || ', @t) . ")";
520 } elsif ($fref->[1] eq 't') {
524 push @t, "\$r->[$fref->[2]]=~/$_/i";
526 $s .= "(" . join(' || ', @t) . ")";
528 confess("invalid letter $fref->[1]");
534 return ('unknown', $dxchan->msg('e20', $tok)) unless $found;
536 return ('no', $dxchan->msg('filter2', $tok));
542 # tidy up the user string
543 $user =~ s/\&\&/ and /g;
544 $user =~ s/\|\|/ or /g;
545 $user =~ s/\!/ not /g;
548 return (0, $filter, $fno, $user, "$s");
551 # a filter accept/reject command
554 my ($self, $dxchan, $sort, $type, $line) = @_;
556 return $dxchan->msg('filter5') unless $line;
558 my ($r, $filter, $fno, $user, $s) = $self->parse($dxchan, $sort, $line);
559 my $u = DXUser->get_current($user);
560 return (1, $dxchan->msg('isow', $user)) if $u && $u->isolate;
561 return (1, $filter) if $r;
563 my $fn = "filter$fno";
565 $filter->{$fn} = {} unless exists $filter->{$fn};
566 $filter->{$fn}->{$type} = {} unless exists $filter->{$fn}->{$type};
568 $filter->{$fn}->{$type}->{user} = $user;
569 $filter->{$fn}->{$type}->{asc} = $s;
570 $r = $filter->compile($fn, $type);
578 return (0, $filter, $fno);
590 # the OLD instructions!
592 # Each filter file has the same structure:-
596 # [ action, fieldno, fieldsort, comparison, action data ],
600 # The action is usually 1 or 0 but could be any numeric value
602 # The fieldno is the field no in the list of fields that is presented
605 # The fieldsort is the type of field that we are dealing with which
606 # currently can be 'a', 'n', 'r' or 'd'. 'a' is alphanumeric, 'n' is
607 # numeric, 'r' is ranges of pairs of numeric values and 'd' is default.
609 # Filter::it basically goes thru the list of comparisons from top to
610 # bottom and when one matches it will return the action and the action data as a list.
612 # are the element nos of the list that is presented to Filter::it. Element
613 # 0 is the first field of the list.
617 # takes the reference to the filter (the first argument) and applies
618 # it to the subsequent arguments and returns the action specified.
623 my $filter = $self->{filter}; # this is now a bless ref of course but so what
625 my ($action, $field, $fieldsort, $comp, $actiondata);
628 # default action is 1
631 return ($action, $actiondata) if !$filter;
633 for $ref (@{$filter}) {
634 ($action, $field, $fieldsort, $comp, $actiondata) = @{$ref};
635 if ($fieldsort eq 'n') {
636 my $val = $_[$field];
637 return ($action, $actiondata) if grep $_ == $val, @{$comp};
638 } elsif ($fieldsort eq 'r') {
639 my $val = $_[$field];
641 my @range = @{$comp};
642 for ($i = 0; $i < @range; $i += 2) {
643 return ($action, $actiondata) if $val >= $range[$i] && $val <= $range[$i+1];
645 } elsif ($fieldsort eq 'a') {
646 return ($action, $actiondata) if $_[$field] =~ m{$comp};
648 return ($action, $actiondata); # the default action
658 my $flag = shift || "";
659 return "$call: Old Style Filter $flag $sort";