fixed sh/node
[spider.git] / perl / DXUser.pm
1 #
2 # DX cluster user routines
3 #
4 # Copyright (c) 1998 - Dirk Koopman G1TLH
5 #
6 # $Id$
7 #
8
9 package DXUser;
10
11 use DXLog;
12 use DB_File;
13 use Data::Dumper;
14 use Fcntl;
15 use IO::File;
16 use DXDebug;
17
18 use strict;
19 use vars qw(%u $dbm $filename %valid $lastoperinterval $lasttime);
20
21 %u = ();
22 $dbm = undef;
23 $filename = undef;
24 $lastoperinterval = 30*24*60*60;
25 $lasttime = 0;
26
27 # hash of valid elements and a simple prompt
28 %valid = (
29                   call => '0,Callsign',
30                   alias => '0,Real Callsign',
31                   name => '0,Name',
32                   qth => '0,Home QTH',
33                   lat => '0,Latitude,slat',
34                   long => '0,Longitude,slong',
35                   qra => '0,Locator',
36                   email => '0,E-mail Address',
37                   priv => '9,Privilege Level',
38                   lastin => '0,Last Time in,cldatetime',
39                   passwd => '9,Password',
40                   addr => '0,Full Address',
41                   'sort' => '0,Type of User', # A - ak1a, U - User, S - spider cluster, B - BBS
42                   xpert => '0,Expert Status,yesno',
43                   bbs => '0,Home BBS',
44                   node => '0,Last Node',
45                   homenode => '0,Home Node',
46                   lockout => '9,Locked out?,yesno',     # won't let them in at all
47                   dxok => '9,Accept DX Spots?,yesno', # accept his dx spots?
48                   annok => '9,Accept Announces?,yesno', # accept his announces?
49                   reg => '0,Registered?,yesno', # is this user registered?
50                   lang => '0,Language',
51                   hmsgno => '0,Highest Msgno',
52                   group => '0,Access Group,parray',     # used to create a group of users/nodes for some purpose or other
53                   isolate => '9,Isolate network,yesno',
54                   wantbeep => '0,Rec Beep,yesno',
55                   wantann => '0,Rec Announce,yesno',
56                   wantwwv => '0,Rec WWV,yesno',
57                   wantwcy => '0,Rec WCY,yesno',
58                   wantecho => '0,Rec Echo,yesno',
59                   wanttalk => '0,Rec Talk,yesno',
60                   wantwx => '0,Rec WX,yesno',
61                   wantdx => '0,Rec DX Spots,yesno',
62                   pagelth => '0,Current Pagelth',
63                   pingint => '9,Node Ping interval',
64                   nopings => '9,Ping Obs Count',
65                   wantlogininfo => '9,Login info req,yesno',
66                   wantgrid => '0,DX Grid Info,yesno',
67                   lastoper => '9,Last for/oper,cldatetime',
68                  );
69
70 no strict;
71 sub AUTOLOAD
72 {
73         my $self = shift;
74         my $name = $AUTOLOAD;
75   
76         return if $name =~ /::DESTROY$/;
77         $name =~ s/.*:://o;
78   
79         confess "Non-existant field '$AUTOLOAD'" if !$valid{$name};
80         if (@_) {
81                 $self->{$name} = shift;
82         }
83         return $self->{$name};
84 }
85
86 #
87 # initialise the system
88 #
89 sub init
90 {
91         my ($pkg, $fn, $mode) = @_;
92   
93         confess "need a filename in User" if !$fn;
94         $fn .= ".v2";
95         if ($mode) {
96                 $dbm = tie (%u, 'DB_File', $fn, O_CREAT|O_RDWR, 0666, $DB_BTREE) or confess "can't open user file: $fn ($!)";
97         } else {
98                 $dbm = tie (%u, 'DB_File', $fn, O_RDONLY, 0666, $DB_BTREE) or confess "can't open user file: $fn ($!)";
99         }
100         
101         $filename = $fn;
102 }
103
104 sub del_file
105 {
106         my ($pkg, $fn, $mode) = @_;
107   
108         confess "need a filename in User" if !$fn;
109         $fn .= ".v2";
110         unlink $fn;
111 }
112
113 use strict;
114
115 #
116 # periodic processing
117 #
118 sub process
119 {
120         if ($main::systime > $lasttime + 15) {
121                 $dbm->sync;
122                 $lasttime = $main::systime;
123         }
124 }
125
126 #
127 # close the system
128 #
129
130 sub finish
131 {
132         undef $dbm;
133         untie %u;
134 }
135
136 #
137 # new - create a new user
138 #
139
140 sub new
141 {
142         my $pkg = shift;
143         my $call = uc shift;
144         #  $call =~ s/-\d+$//o;
145   
146 #       confess "can't create existing call $call in User\n!" if $u{$call};
147
148         my $self = bless {}, $pkg;
149         $self->{call} = $call;
150         $self->{'sort'} = 'U';
151         $self->put;
152         return $self;
153 }
154
155 #
156 # get - get an existing user - this seems to return a different reference everytime it is
157 #       called - see below
158 #
159
160 sub get
161 {
162         my $pkg = shift;
163         my $call = uc shift;
164         my $data;
165         unless ($dbm->get($call, $data)) {
166                 return decode($data);
167         }
168         return undef;
169 }
170
171 #
172 # get an existing either from the channel (if there is one) or from the database
173 #
174 # It is important to note that if you have done a get (for the channel say) and you
175 # want access or modify that you must use this call (and you must NOT use get's all
176 # over the place willy nilly!)
177 #
178
179 sub get_current
180 {
181         my $pkg = shift;
182         my $call = uc shift;
183   
184         my $dxchan = DXChannel->get($call);
185         return $dxchan->user if $dxchan;
186         my $data;
187         unless ($dbm->get($call, $data)) {
188                 return decode($data);
189         }
190         return undef;
191 }
192
193 #
194 # get all callsigns in the database 
195 #
196
197 sub get_all_calls
198 {
199         return (sort keys %u);
200 }
201
202 #
203 # put - put a user
204 #
205
206 sub put
207 {
208         my $self = shift;
209         confess "Trying to put nothing!" unless $self && ref $self;
210         my $call = $self->{call};
211         # delete all instances of this 
212         for ($dbm->get_dup($call)) {
213                 $dbm->del_dup($call, $_);
214         }
215         delete $self->{annok} if $self->{annok};
216         delete $self->{dxok} if $self->{dxok};
217         $dbm->put($call, $self->encode);
218 }
219
220
221 # create a string from a user reference
222 #
223 sub encode
224 {
225         my $self = shift;
226         my $dd = new Data::Dumper([$self]);
227         $dd->Indent(0);
228         $dd->Terse(1);
229     $dd->Quotekeys($] < 5.005 ? 1 : 0);
230         return $dd->Dumpxs;
231 }
232
233 #
234 # create a hash from a string
235 #
236 sub decode
237 {
238         my $s = shift;
239         my $ref;
240         eval '$ref = ' . $s;
241         if ($@) {
242                 dbg('err', $@) if $@;
243                 Log('err', $@) if $@;
244                 $ref = undef;
245         }
246         return $ref;
247 }
248
249 #
250 # del - delete a user
251 #
252
253 sub del
254 {
255         my $self = shift;
256         my $call = $self->{call};
257         # delete all instances of this 
258         for ($dbm->get_dup($call)) {
259                 $dbm->del_dup($call, $_);
260         }
261 }
262
263 #
264 # close - close down a user
265 #
266
267 sub close
268 {
269         my $self = shift;
270         $self->{lastin} = time;
271         $self->put();
272 }
273
274 #
275 # sync the database
276 #
277
278 sub sync
279 {
280         $dbm->sync;
281 }
282
283 #
284 # return a list of valid elements 
285
286
287 sub fields
288 {
289         return keys(%valid);
290 }
291
292
293 #
294 # export the database to an ascii file
295 #
296
297 sub export
298 {
299         my $fn = shift;
300         
301         # save old ones
302         rename "$fn.oooo", "$fn.ooooo" if -e "$fn.oooo";
303         rename "$fn.ooo", "$fn.oooo" if -e "$fn.ooo";
304         rename "$fn.oo", "$fn.ooo" if -e "$fn.oo";
305         rename "$fn.o", "$fn.oo" if -e "$fn.o";
306         rename "$fn", "$fn.o" if -e "$fn";
307
308         my $count = 0;
309         my $fh = new IO::File ">$fn" or return "cannot open $fn ($!)";
310         if ($fh) {
311                 my $ref;
312                 my $key;
313                 my $action;
314                 my $t = scalar localtime;
315                 print $fh "#!/usr/bin/perl
316 #
317 # The exported userfile for a DXSpider System
318 #
319 # Input file: $filename
320 #       Time: $t
321 #
322
323 package DXUser;
324
325 %u = (
326 ";
327
328                 for ($action = R_FIRST; !$dbm->seq($key, $ref, $action); $action = R_NEXT) {
329                         print $fh "'$key' => $ref,\n";
330                         ++$count;
331                 } 
332                 print $fh ");\n#\n# there were $count records\n#\n";
333                 $fh->close;
334         } 
335         return $count;
336 }
337
338 #
339 # group handling
340 #
341
342 # add one or more groups
343 sub add_group
344 {
345         my $self = shift;
346         my $ref = $self->{group} || [ 'local' ];
347         $self->{group} = $ref if !$self->{group};
348         push @$ref, @_ if @_;
349 }
350
351 # remove one or more groups
352 sub del_group
353 {
354         my $self = shift;
355         my $ref = $self->{group} || [ 'local' ];
356         my @in = @_;
357         
358         $self->{group} = $ref if !$self->{group};
359         
360         @$ref = map { my $a = $_; return (grep { $_ eq $a } @in) ? () : $a } @$ref;
361 }
362
363 # does this thing contain all the groups listed?
364 sub union
365 {
366         my $self = shift;
367         my $ref = $self->{group};
368         my $n;
369         
370         return 0 if !$ref || @_ == 0;
371         return 1 if @$ref == 0 && @_ == 0;
372         for ($n = 0; $n < @_; ) {
373                 for (@$ref) {
374                         my $a = $_;
375                         $n++ if grep $_ eq $a, @_; 
376                 }
377         }
378         return $n >= @_;
379 }
380
381 # simplified group test just for one group
382 sub in_group
383 {
384         my $self = shift;
385         my $s = shift;
386         my $ref = $self->{group};
387         
388         return 0 if !$ref;
389         return grep $_ eq $s, $ref;
390 }
391
392 # set up a default group (only happens for them's that connect direct)
393 sub new_group
394 {
395         my $self = shift;
396         $self->{group} = [ 'local' ];
397 }
398
399 #
400 # return a prompt for a field
401 #
402
403 sub field_prompt
404
405         my ($self, $ele) = @_;
406         return $valid{$ele};
407 }
408
409 # some variable accessors
410 sub sort
411 {
412         my $self = shift;
413         @_ ? $self->{'sort'} = shift : $self->{'sort'} ;
414 }
415
416 # some accessors
417 sub _want
418 {
419         my $n = shift;
420         my $self = shift;
421         my $val = shift;
422         my $s = "want$n";
423         $self->{$s} = $val if defined $val;
424         return exists $self->{$s} ? $self->{$s} : 1;
425 }
426
427 sub wantbeep
428 {
429         return _want('beep', @_);
430 }
431
432 sub wantann
433 {
434         return _want('ann', @_);
435 }
436
437 sub wantwwv
438 {
439         return _want('wwv', @_);
440 }
441
442 sub wantwcy
443 {
444         return _want('wcy', @_);
445 }
446
447 sub wantecho
448 {
449         return _want('echo', @_);
450 }
451
452 sub wantwx
453 {
454         return _want('wx', @_);
455 }
456
457 sub wantdx
458 {
459         return _want('dx', @_);
460 }
461
462 sub wanttalk
463 {
464         return _want('talk', @_);
465 }
466
467 sub wantgrid
468 {
469         return _want('grid', @_);
470 }
471
472 sub wantlogininfo
473 {
474         my $self = shift;
475         my $n = shift;
476         $self->{wantlogininfo} = $n if $n;
477         return exists $self->{wantlogininfo} ? $self->{wantlogininfo} : 0;
478 }
479
480 sub is_node
481 {
482         my $self = shift;
483         return $self->{sort} =~ /[ACRSX]/;
484 }
485
486 sub is_user
487 {
488         my $self = shift;
489         return $self->{sort} eq 'U';
490 }
491
492 sub is_bbs
493 {
494         my $self = shift;
495         return $self->{sort} eq 'B';
496 }
497
498 sub is_spider
499 {
500         my $self = shift;
501         return $self->{sort} eq 'S';
502 }
503
504 sub is_clx
505 {
506         my $self = shift;
507         return $self->{sort} eq 'C';
508 }
509
510 sub is_dxnet
511 {
512         my $self = shift;
513         return $self->{sort} eq 'X';
514 }
515
516 sub is_arcluster
517 {
518         my $self = shift;
519         return $self->{sort} eq 'R';
520 }
521
522 sub is_ak1a
523 {
524         my $self = shift;
525         return $self->{sort} eq 'A';
526 }
527 1;
528 __END__
529
530
531
532
533