Annotation of loncom/lonnet/perl/lonnet.pm, revision 1.75
1.1 albertel 1: # The LearningOnline Network
2: # TCP networking package
1.12 www 3: #
4: # Functions for use by content handlers:
5: #
6: # plaintext(short) : plain text explanation of short term
1.25 www 7: # fileembstyle(ext) : embed style in page for file extension
8: # filedescription(ext) : descriptor text for file extension
1.29 www 9: # allowed(short,url) : returns codes for allowed actions
10: # F: full access
11: # U,I,K: authentication modes (cxx only)
12: # '': forbidden
13: # 1: user needs to choose course
14: # 2: browse allowed
1.21 www 15: # definerole(rolename,sys,dom,cou) : define a custom role rolename
16: # set priviledges in format of lonTabs/roles.tab for
17: # system, domain and course level,
18: # assignrole(udom,uname,url,role,end,start) : give a role to a user for the
19: # level given by url. Optional start and end dates
20: # (leave empty string or zero for "no date")
21: # assigncustomrole (udom,uname,url,rdom,rnam,rolename,end,start) : give a
22: # custom role to a user for the level given by url.
23: # Specify name and domain of role author, and role name
24: # revokerole (udom,uname,url,role) : Revoke a role for url
25: # revokecustomrole (udom,uname,url,rdom,rnam,rolename) : Revoke a custom role
1.24 www 26: # appenv(hash) : adds hash to session environment
1.56 www 27: # delenv(varname) : deletes all environment entries starting with varname
1.12 www 28: # store(hash) : stores hash permanently for this url
1.47 www 29: # cstore(hash) : critical store
1.12 www 30: # restore : returns hash for this url
31: # eget(namesp,array) : returns hash with keys from array filled in from namesp
32: # get(namesp,array) : returns hash with keys from array filled in from namesp
1.38 www 33: # del(namesp,array) : deletes keys out of array from namesp
1.12 www 34: # put(namesp,hash) : stores hash in namesp
1.47 www 35: # cput(namesp,hash) : critical put
1.15 www 36: # dump(namesp) : dumps the complete namespace into a hash
1.23 www 37: # ssi(url,hash) : does a complete request cycle on url to localhost, posts
38: # hash
1.34 www 39: # coursedescription(id) : returns and caches course description for id
1.17 www 40: # repcopy(filename) : replicate file
41: # dirlist(url) : gets a directory listing
1.40 www 42: # directcondval(index) : reading condition value of single condition from
43: # state string
1.28 www 44: # condval(index) : value of condition index based on state
1.58 www 45: # EXT(name) : value of a variable
1.31 www 46: # symblist(map,hash) : Updates symbolic storage links
1.44 www 47: # symbread([filename]) : returns the data handle (filename optional)
1.31 www 48: # rndseed() : returns a random seed
1.36 albertel 49: # getfile(filename) : returns the contents of filename, or a -1 if it can't
50: # be found, replicates and subscribes to the file
51: # filelocation(dir,file) : returns a farily clean absolute reference to file
52: # from the directory dir
1.46 www 53: # hreflocation(dir,file) : same as filelocation, but for hrefs
1.47 www 54: # log(domain,user,home,msg) : write to permanent log for user
1.70 www 55: # usection(domain,user,courseid) : output of section name/number or '' for
56: # "not in course" and '-1' for "no section"
57: # userenvironment(domain,user,what) : puts out any environment parameter
58: # for a user
59: # idput(domain,hash) : writes IDs for users from hash (name=>id,name=>id)
60: # idget(domain,array): returns hash with usernames (id=>name,id=>name) for
61: # an array of IDs
62: # idrget(domain,array): returns hash with IDs for usernames (name=>id,...) for
63: # an array of names
1.73 www 64: # metadata(file,entry): returns the metadata entry for a file. entry='keys'
65: # returns a comma separated list of keys
1.12 www 66: #
1.1 albertel 67: # 6/1/99,6/2,6/10,6/11,6/12,6/14,6/26,6/28,6/29,6/30,
1.5 www 68: # 7/1,7/2,7/9,7/10,7/12,7/14,7/15,7/19,
1.8 www 69: # 11/8,11/16,11/18,11/22,11/23,12/22,
1.12 www 70: # 01/06,01/13,02/24,02/28,02/29,
71: # 03/01,03/02,03/06,03/07,03/13,
1.15 www 72: # 04/05,05/29,05/31,06/01,
73: # 06/05,06/26 Gerd Kortemeyer
74: # 06/26 Ben Tyszka
1.22 www 75: # 06/30,07/15,07/17,07/18,07/20,07/21,07/22,07/25 Gerd Kortemeyer
1.23 www 76: # 08/14 Ben Tyszka
1.36 albertel 77: # 08/22,08/28,08/31,09/01,09/02,09/04,09/05,09/25,09/28,09/30 Gerd Kortemeyer
1.35 www 78: # 10/04 Gerd Kortemeyer
1.36 albertel 79: # 10/04 Guy Albertelli
1.54 www 80: # 10/06,10/09,10/10,10/11,10/14,10/20,10/23,10/25,10/26,10/27,10/28,10/29,
1.71 www 81: # 10/30,10/31,
1.75 ! www 82: # 11/2,11/14,11/15,11/16,11/20,11/21,11/22,11/25,11/27,
! 83: # 12/02 Gerd Kortemeyer
1.1 albertel 84:
85: package Apache::lonnet;
86:
87: use strict;
88: use Apache::File;
1.8 www 89: use LWP::UserAgent();
1.15 www 90: use HTTP::Headers;
1.11 www 91: use vars
1.71 www 92: qw(%perlvar %hostname %homecache %spareid %hostdom %libserv %pr %prp %fe %fd $readit %metacache);
1.1 albertel 93: use IO::Socket;
1.31 www 94: use GDBM_File;
1.8 www 95: use Apache::Constants qw(:common :http);
1.71 www 96: use HTML::TokeParser;
1.1 albertel 97:
98: # --------------------------------------------------------------------- Logging
99:
100: sub logthis {
101: my $message=shift;
102: my $execdir=$perlvar{'lonDaemons'};
103: my $now=time;
104: my $local=localtime($now);
105: my $fh=Apache::File->new(">>$execdir/logs/lonnet.log");
106: print $fh "$local ($$): $message\n";
107: return 1;
108: }
109:
110: sub logperm {
111: my $message=shift;
112: my $execdir=$perlvar{'lonDaemons'};
113: my $now=time;
114: my $local=localtime($now);
115: my $fh=Apache::File->new(">>$execdir/logs/lonnet.perm.log");
116: print $fh "$now:$message:$local\n";
117: return 1;
118: }
119:
120: # -------------------------------------------------- Non-critical communication
121: sub subreply {
122: my ($cmd,$server)=@_;
123: my $peerfile="$perlvar{'lonSockDir'}/$server";
124: my $client=IO::Socket::UNIX->new(Peer =>"$peerfile",
125: Type => SOCK_STREAM,
126: Timeout => 10)
127: or return "con_lost";
128: print $client "$cmd\n";
129: my $answer=<$client>;
1.9 www 130: if (!$answer) { $answer="con_lost"; }
1.1 albertel 131: chomp($answer);
132: return $answer;
133: }
134:
135: sub reply {
136: my ($cmd,$server)=@_;
137: my $answer=subreply($cmd,$server);
138: if ($answer eq 'con_lost') { $answer=subreply($cmd,$server); }
1.65 www 139: if (($answer=~/^refused/) || ($answer=~/^rejected/)) {
1.12 www 140: &logthis("<font color=blue>WARNING:".
141: " $cmd to $server returned $answer</font>");
142: }
1.1 albertel 143: return $answer;
144: }
145:
146: # ----------------------------------------------------------- Send USR1 to lonc
147:
148: sub reconlonc {
149: my $peerfile=shift;
150: &logthis("Trying to reconnect for $peerfile");
151: my $loncfile="$perlvar{'lonDaemons'}/logs/lonc.pid";
152: if (my $fh=Apache::File->new("$loncfile")) {
153: my $loncpid=<$fh>;
154: chomp($loncpid);
155: if (kill 0 => $loncpid) {
156: &logthis("lonc at pid $loncpid responding, sending USR1");
157: kill USR1 => $loncpid;
158: sleep 1;
159: if (-e "$peerfile") { return; }
160: &logthis("$peerfile still not there, give it another try");
161: sleep 5;
162: if (-e "$peerfile") { return; }
1.12 www 163: &logthis(
164: "<font color=blue>WARNING: $peerfile still not there, giving up</font>");
1.1 albertel 165: } else {
1.12 www 166: &logthis(
167: "<font color=blue>WARNING:".
168: " lonc at pid $loncpid not responding, giving up</font>");
1.1 albertel 169: }
170: } else {
1.12 www 171: &logthis('<font color=blue>WARNING: lonc not running, giving up</font>');
1.1 albertel 172: }
173: }
174:
175: # ------------------------------------------------------ Critical communication
1.12 www 176:
1.1 albertel 177: sub critical {
178: my ($cmd,$server)=@_;
179: my $answer=reply($cmd,$server);
180: if ($answer eq 'con_lost') {
181: my $pingreply=reply('ping',$server);
182: &reconlonc("$perlvar{'lonSockDir'}/$server");
183: my $pongreply=reply('pong',$server);
184: &logthis("Ping/Pong for $server: $pingreply/$pongreply");
185: $answer=reply($cmd,$server);
186: if ($answer eq 'con_lost') {
187: my $now=time;
188: my $middlename=$cmd;
1.5 www 189: $middlename=substr($middlename,0,16);
1.1 albertel 190: $middlename=~s/\W//g;
191: my $dfilename=
192: "$perlvar{'lonSockDir'}/delayed/$now.$middlename.$server";
193: {
194: my $dfh;
195: if ($dfh=Apache::File->new(">$dfilename")) {
1.7 www 196: print $dfh "$cmd\n";
1.1 albertel 197: }
198: }
199: sleep 2;
200: my $wcmd='';
201: {
202: my $dfh;
203: if ($dfh=Apache::File->new("$dfilename")) {
204: $wcmd=<$dfh>;
205: }
206: }
207: chomp($wcmd);
1.7 www 208: if ($wcmd eq $cmd) {
1.12 www 209: &logthis("<font color=blue>WARNING: ".
210: "Connection buffer $dfilename: $cmd</font>");
1.1 albertel 211: &logperm("D:$server:$cmd");
212: return 'con_delayed';
213: } else {
1.12 www 214: &logthis("<font color=red>CRITICAL:"
215: ." Critical connection failed: $server $cmd</font>");
1.1 albertel 216: &logperm("F:$server:$cmd");
217: return 'con_failed';
218: }
219: }
220: }
221: return $answer;
222: }
223:
1.5 www 224: # ---------------------------------------------------------- Append Environment
225:
226: sub appenv {
1.6 www 227: my %newenv=@_;
1.35 www 228: map {
229: if (($newenv{$_}=~/^user\.role/) || ($newenv{$_}=~/^user\.priv/)) {
230: &logthis("<font color=blue>WARNING: ".
231: "Attempt to modify environment ".$_." to ".$newenv{$_});
232: delete($newenv{$_});
233: } else {
234: $ENV{$_}=$newenv{$_};
235: }
236: } keys %newenv;
1.6 www 237: my @oldenv;
238: {
239: my $fh;
240: unless ($fh=Apache::File->new("$ENV{'user.environment'}")) {
1.5 www 241: return 'error';
1.6 www 242: }
243: @oldenv=<$fh>;
244: }
245: for (my $i=0; $i<=$#oldenv; $i++) {
246: chomp($oldenv[$i]);
1.9 www 247: if ($oldenv[$i] ne '') {
248: my ($name,$value)=split(/=/,$oldenv[$i]);
1.24 www 249: unless (defined($newenv{$name})) {
250: $newenv{$name}=$value;
251: }
1.9 www 252: }
1.6 www 253: }
254: {
255: my $fh;
256: unless ($fh=Apache::File->new(">$ENV{'user.environment'}")) {
257: return 'error';
258: }
259: my $newname;
260: foreach $newname (keys %newenv) {
261: print $fh "$newname=$newenv{$newname}\n";
262: }
1.56 www 263: }
264: return 'ok';
265: }
266: # ----------------------------------------------------- Delete from Environment
267:
268: sub delenv {
269: my $delthis=shift;
270: my %newenv=();
271: if (($delthis=~/user\.role/) || ($delthis=~/user\.priv/)) {
272: &logthis("<font color=blue>WARNING: ".
273: "Attempt to delete from environment ".$delthis);
274: return 'error';
275: }
276: my @oldenv;
277: {
278: my $fh;
279: unless ($fh=Apache::File->new("$ENV{'user.environment'}")) {
280: return 'error';
281: }
282: @oldenv=<$fh>;
283: }
284: {
285: my $fh;
286: unless ($fh=Apache::File->new(">$ENV{'user.environment'}")) {
287: return 'error';
288: }
289: map {
290: unless ($_=~/^$delthis/) { print $fh $_; }
291: } @oldenv;
1.5 www 292: }
293: return 'ok';
294: }
1.1 albertel 295:
296: # ------------------------------ Find server with least workload from spare.tab
1.11 www 297:
1.1 albertel 298: sub spareserver {
299: my $tryserver;
300: my $spareserver='';
301: my $lowestserver=100;
302: foreach $tryserver (keys %spareid) {
303: my $answer=reply('load',$tryserver);
304: if (($answer =~ /\d/) && ($answer<$lowestserver)) {
305: $spareserver="http://$hostname{$tryserver}";
306: $lowestserver=$answer;
307: }
308: }
309: return $spareserver;
310: }
311:
312: # --------- Try to authenticate user from domain's lib servers (first this one)
1.11 www 313:
1.1 albertel 314: sub authenticate {
315: my ($uname,$upass,$udom)=@_;
1.12 www 316: $upass=escape($upass);
1.1 albertel 317: if (($perlvar{'lonRole'} eq 'library') &&
318: ($udom eq $perlvar{'lonDefDomain'})) {
1.3 www 319: my $answer=reply("encrypt:auth:$udom:$uname:$upass",$perlvar{'lonHostID'});
1.2 www 320: if ($answer =~ /authorized/) {
1.9 www 321: if ($answer eq 'authorized') {
322: &logthis("User $uname at $udom authorized by local server");
323: return $perlvar{'lonHostID'};
324: }
325: if ($answer eq 'non_authorized') {
326: &logthis("User $uname at $udom rejected by local server");
327: return 'no_host';
328: }
1.2 www 329: }
1.1 albertel 330: }
331:
332: my $tryserver;
333: foreach $tryserver (keys %libserv) {
334: if ($hostdom{$tryserver} eq $udom) {
1.10 www 335: my $answer=reply("encrypt:auth:$udom:$uname:$upass",$tryserver);
1.1 albertel 336: if ($answer =~ /authorized/) {
1.9 www 337: if ($answer eq 'authorized') {
338: &logthis("User $uname at $udom authorized by $tryserver");
339: return $tryserver;
340: }
341: if ($answer eq 'non_authorized') {
342: &logthis("User $uname at $udom rejected by $tryserver");
343: return 'no_host';
344: }
1.1 albertel 345: }
346: }
1.9 www 347: }
348: &logthis("User $uname at $udom could not be authenticated");
1.1 albertel 349: return 'no_host';
350: }
351:
352: # ---------------------- Find the homebase for a user from domain's lib servers
1.11 www 353:
1.1 albertel 354: sub homeserver {
355: my ($uname,$udom)=@_;
356:
357: my $index="$uname:$udom";
358: if ($homecache{$index}) { return "$homecache{$index}"; }
359:
360: my $tryserver;
361: foreach $tryserver (keys %libserv) {
362: if ($hostdom{$tryserver} eq $udom) {
363: my $answer=reply("home:$udom:$uname",$tryserver);
364: if ($answer eq 'found') {
365: $homecache{$index}=$tryserver;
366: return $tryserver;
367: }
368: }
369: }
370: return 'no_host';
1.70 www 371: }
372:
373: # ------------------------------------- Find the usernames behind a list of IDs
374:
375: sub idget {
376: my ($udom,@ids)=@_;
377: my %returnhash=();
378:
379: my $tryserver;
380: foreach $tryserver (keys %libserv) {
381: if ($hostdom{$tryserver} eq $udom) {
382: my $idlist=join('&',@ids);
383: $idlist=~tr/A-Z/a-z/;
384: my $reply=&reply("idget:$udom:".$idlist,$tryserver);
385: my @answer=();
386: if ($reply ne 'con_lost') {
387: @answer=split(/\&/,$reply);
388: } ;
389: my $i;
390: for ($i=0;$i<=$#ids;$i++) {
391: if ($answer[$i]) {
392: $returnhash{$ids[$i]}=$answer[$i];
393: }
394: }
395: }
396: }
397: return %returnhash;
398: }
399:
400: # ------------------------------------- Find the IDs behind a list of usernames
401:
402: sub idrget {
403: my ($udom,@unames)=@_;
404: my %returnhash=();
405: map {
406: $returnhash{$_}=(&userenvironment($udom,$_,'id'))[1];
407: } @unames;
408: return %returnhash;
409: }
410:
411: # ------------------------------- Store away a list of names and associated IDs
412:
413: sub idput {
414: my ($udom,%ids)=@_;
415: my %servers=();
416: map {
417: my $uhom=&homeserver($_,$udom);
418: if ($uhom ne 'no_host') {
419: my $id=&escape($ids{$_});
420: $id=~tr/A-Z/a-z/;
421: my $unam=&escape($_);
422: if ($servers{$uhom}) {
423: $servers{$uhom}.='&'.$id.'='.$unam;
424: } else {
425: $servers{$uhom}=$id.'='.$unam;
426: }
427: &critical('put:'.$udom.':'.$unam.':environment:id='.$id,$uhom);
428: }
429: } keys %ids;
430: map {
431: &critical('idput:'.$udom.':'.$servers{$_},$_);
432: } keys %servers;
433: }
434:
435: # ------------------------------------- Find the section of student in a course
436:
437: sub usection {
438: my ($udom,$unam,$courseid)=@_;
439: $courseid=~s/\_/\//g;
440: $courseid=~s/^(\w)/\/$1/;
441: map {
442: my ($key,$value)=split(/\=/,$_);
443: $key=&unescape($key);
444: if ($key=~/^$courseid(?:\/)*(\w+)*\_st$/) {
445: my $section=$1;
446: if ($key eq $courseid.'_st') { $section=''; }
447: my ($dummy,$end,$start)=split(/\_/,&unescape($value));
448: my $now=time;
449: my $notactive=0;
450: if ($start) {
451: if ($now<$start) { $notactive=1; }
452: }
453: if ($end) {
454: if ($now>$end) { $notactive=1; }
455: }
456: unless ($notactive) { return $section; }
457: }
458: } split(/\&/,&reply('dump:'.$udom.':'.$unam.':roles',
459: &homeserver($unam,$udom)));
460: return '-1';
461: }
462:
463: # ------------------------------------- Read an entry from a user's environment
464:
465: sub userenvironment {
466: my ($udom,$unam,@what)=@_;
467: my %returnhash=();
468: my @answer=split(/\&/,
469: &reply('get:'.$udom.':'.$unam.':environment:'.join('&',@what),
470: &homeserver($unam,$udom)));
471: my $i;
472: for ($i=0;$i<=$#what;$i++) {
473: $returnhash{$what[$i]}=&unescape($answer[$i]);
474: }
475: return %returnhash;
1.1 albertel 476: }
477:
478: # ----------------------------- Subscribe to a resource, return URL if possible
1.11 www 479:
1.1 albertel 480: sub subscribe {
481: my $fname=shift;
482: my $author=$fname;
483: $author=~s/\/home\/httpd\/html\/res\/([^\/]*)\/([^\/]*).*/$1\/$2/;
484: my ($udom,$uname)=split(/\//,$author);
485: my $home=homeserver($uname,$udom);
486: if (($home eq 'no_host') || ($home eq $perlvar{'lonHostID'})) {
487: return 'not_found';
488: }
489: my $answer=reply("sub:$fname",$home);
1.64 www 490: if (($answer eq 'con_lost') || ($answer eq 'rejected')) {
491: $answer.=' by '.$home;
492: }
1.1 albertel 493: return $answer;
494: }
495:
1.8 www 496: # -------------------------------------------------------------- Replicate file
497:
498: sub repcopy {
499: my $filename=shift;
1.23 www 500: $filename=~s/\/+/\//g;
1.8 www 501: my $transname="$filename.in.transfer";
1.17 www 502: if ((-e $filename) || (-e $transname)) { return OK; }
1.8 www 503: my $remoteurl=subscribe($filename);
1.64 www 504: if ($remoteurl =~ /^con_lost by/) {
505: &logthis("Subscribe returned $remoteurl: $filename");
1.8 www 506: return HTTP_SERVICE_UNAVAILABLE;
507: } elsif ($remoteurl eq 'not_found') {
508: &logthis("Subscribe returned not_found: $filename");
509: return HTTP_NOT_FOUND;
1.64 www 510: } elsif ($remoteurl =~ /^rejected by/) {
511: &logthis("Subscribe returned $remoteurl: $filename");
1.8 www 512: return FORBIDDEN;
1.20 www 513: } elsif ($remoteurl eq 'directory') {
514: return OK;
1.8 www 515: } else {
516: my @parts=split(/\//,$filename);
517: my $path="/$parts[1]/$parts[2]/$parts[3]/$parts[4]";
518: if ($path ne "$perlvar{'lonDocRoot'}/res") {
519: &logthis("Malconfiguration for replication: $filename");
520: return HTTP_BAD_REQUEST;
521: }
522: my $count;
523: for ($count=5;$count<$#parts;$count++) {
524: $path.="/$parts[$count]";
525: if ((-e $path)!=1) {
526: mkdir($path,0777);
527: }
528: }
529: my $ua=new LWP::UserAgent;
530: my $request=new HTTP::Request('GET',"$remoteurl");
531: my $response=$ua->request($request,$transname);
532: if ($response->is_error()) {
533: unlink($transname);
534: my $message=$response->status_line;
1.12 www 535: &logthis("<font color=blue>WARNING:"
536: ." LWP get: $message: $filename</font>");
1.8 www 537: return HTTP_SERVICE_UNAVAILABLE;
538: } else {
1.16 www 539: if ($remoteurl!~/\.meta$/) {
540: my $mrequest=new HTTP::Request('GET',$remoteurl.'.meta');
541: my $mresponse=$ua->request($mrequest,$filename.'.meta');
542: if ($mresponse->is_error()) {
543: unlink($filename.'.meta');
544: &logthis(
545: "<font color=yellow>INFO: No metadata: $filename</font>");
546: }
547: }
1.8 www 548: rename($transname,$filename);
549: return OK;
550: }
551: }
552: }
553:
1.15 www 554: # --------------------------------------------------------- Server Side Include
555:
556: sub ssi {
557:
1.23 www 558: my ($fn,%form)=@_;
1.15 www 559:
560: my $ua=new LWP::UserAgent;
1.23 www 561:
562: my $request;
563:
564: if (%form) {
565: $request=new HTTP::Request('POST',"http://".$ENV{'HTTP_HOST'}.$fn);
566: $request->content(join '&', map { "$_=$form{$_}" } keys %form);
567: } else {
568: $request=new HTTP::Request('GET',"http://".$ENV{'HTTP_HOST'}.$fn);
569: }
570:
1.15 www 571: $request->header(Cookie => $ENV{'HTTP_COOKIE'});
572: my $response=$ua->request($request);
573:
574: return $response->content;
575: }
576:
1.14 www 577: # ------------------------------------------------------------------------- Log
578:
579: sub log {
580: my ($dom,$nam,$hom,$what)=@_;
1.47 www 581: return critical("log:$dom:$nam:$what",$hom);
1.14 www 582: }
583:
1.9 www 584: # ----------------------------------------------------------------------- Store
585:
586: sub store {
1.31 www 587: my %storehash=@_;
588: my $symb;
1.44 www 589: unless ($symb=escape(&symbread())) { return ''; }
1.31 www 590: my $namespace;
1.33 www 591: unless ($namespace=$ENV{'request.course.id'}) { return ''; }
1.12 www 592: my $namevalue='';
593: map {
594: $namevalue.=escape($_).'='.escape($storehash{$_}).'&';
595: } keys %storehash;
596: $namevalue=~s/\&$//;
1.31 www 597: return reply(
598: "store:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb:$namevalue",
1.12 www 599: "$ENV{'user.home'}");
1.9 www 600: }
601:
1.47 www 602: # -------------------------------------------------------------- Critical Store
603:
604: sub cstore {
605: my %storehash=@_;
606: my $symb;
607: unless ($symb=escape(&symbread())) { return ''; }
608: my $namespace;
609: unless ($namespace=$ENV{'request.course.id'}) { return ''; }
610: my $namevalue='';
611: map {
612: $namevalue.=escape($_).'='.escape($storehash{$_}).'&';
613: } keys %storehash;
614: $namevalue=~s/\&$//;
615: return critical(
616: "store:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb:$namevalue",
617: "$ENV{'user.home'}");
618: }
619:
1.9 www 620: # --------------------------------------------------------------------- Restore
621:
622: sub restore {
1.31 www 623: my $symb;
1.44 www 624: unless ($symb=escape(&symbread())) { return ''; }
1.31 www 625: my $namespace;
1.33 www 626: unless ($namespace=$ENV{'request.course.id'}) { return ''; }
1.31 www 627: my $answer=reply(
628: "restore:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb",
629: "$ENV{'user.home'}");
1.12 www 630: my %returnhash=();
631: map {
632: my ($name,$value)=split(/\=/,$_);
633: $returnhash{&unescape($name)}=&unescape($value);
634: } split(/\&/,$answer);
1.75 ! www 635: my $version;
! 636: for ($version=1;$version<=$returnhash{'version'};$version++) {
! 637: map {
! 638: $returnhash{$_}=$returnhash{$version.':'.$_};
! 639: } split(/\:/,$returnhash{$version.':keys'});
! 640: }
1.13 www 641: return %returnhash;
1.34 www 642: }
643:
644: # ---------------------------------------------------------- Course Description
645:
646: sub coursedescription {
647: my $courseid=shift;
648: $courseid=~s/^\///;
1.49 www 649: $courseid=~s/\_/\//g;
1.34 www 650: my ($cdomain,$cnum)=split(/\//,$courseid);
651: my $chome=homeserver($cnum,$cdomain);
652: if ($chome ne 'no_host') {
653: my $rep=reply("dump:$cdomain:$cnum:environment",$chome);
654: if ($rep ne 'con_lost') {
1.54 www 655: my $normalid=$courseid;
656: $normalid=~s/\//\_/g;
1.53 www 657: my %envhash=();
1.34 www 658: my %returnhash=('home' => $chome,
659: 'domain' => $cdomain,
660: 'num' => $cnum);
661: map {
662: my ($name,$value)=split(/\=/,$_);
663: $name=&unescape($name);
664: $value=&unescape($value);
665: $returnhash{$name}=$value;
1.53 www 666: $envhash{'course.'.$normalid.'.'.$name}=$value;
1.34 www 667: } split(/\&/,$rep);
668: $returnhash{'url'}='/res/'.declutter($returnhash{'url'});
669: $returnhash{'fn'}=$perlvar{'lonDaemons'}.'/tmp/'.
1.38 www 670: $ENV{'user.name'}.'_'.$cdomain.'_'.$cnum;
1.54 www 671: $envhash{'course.'.$normalid.'.last_cache'}=time;
1.60 www 672: $envhash{'course.'.$normalid.'.home'}=$chome;
673: $envhash{'course.'.$normalid.'.domain'}=$cdomain;
674: $envhash{'course.'.$normalid.'.num'}=$cnum;
1.53 www 675: &appenv(%envhash);
1.34 www 676: return %returnhash;
677: }
678: }
679: return ();
1.9 www 680: }
1.1 albertel 681:
1.11 www 682: # -------------------------------------------------------- Get user priviledges
683:
684: sub rolesinit {
685: my ($domain,$username,$authhost)=@_;
686: my $rolesdump=reply("dump:$domain:$username:roles",$authhost);
1.12 www 687: if (($rolesdump eq 'con_lost') || ($rolesdump eq '')) { return ''; }
1.11 www 688: my %allroles=();
689: my %thesepriv=();
690: my $now=time;
1.21 www 691: my $userroles="user.login.time=$now\n";
1.11 www 692: my $thesestr;
693:
694: if ($rolesdump ne '') {
695: map {
1.21 www 696: if ($_!~/^rolesdef\&/) {
1.11 www 697: my ($area,$role)=split(/=/,$_);
1.21 www 698: $area=~s/\_\w\w$//;
1.11 www 699: my ($trole,$tend,$tstart)=split(/_/,$role);
1.21 www 700: $userroles.='user.role.'.$trole.'.'.$area.'='.
701: $tstart.'.'.$tend."\n";
1.11 www 702: if ($tend!=0) {
703: if ($tend<$now) {
704: $trole='';
705: }
706: }
707: if ($tstart!=0) {
708: if ($tstart>$now) {
709: $trole='';
710: }
711: }
712: if (($area ne '') && ($trole ne '')) {
1.50 www 713: my $spec=$trole.'.'.$area;
1.12 www 714: my ($tdummy,$tdomain,$trest)=split(/\//,$area);
715: if ($trole =~ /^cr\//) {
716: my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$trole);
717: my $homsvr=homeserver($rauthor,$rdomain);
718: if ($hostname{$homsvr} ne '') {
719: my $roledef=
1.21 www 720: reply("get:$rdomain:$rauthor:roles:rolesdef_$rrole",
1.12 www 721: $homsvr);
722: if (($roledef ne 'con_lost') && ($roledef ne '')) {
723: my ($syspriv,$dompriv,$coursepriv)=
1.21 www 724: split(/\_/,unescape($roledef));
1.50 www 725: $allroles{'cm./'}.=':'.$syspriv;
726: $allroles{$spec.'./'}.=':'.$syspriv;
1.12 www 727: if ($tdomain ne '') {
1.50 www 728: $allroles{'cm./'.$tdomain.'/'}.=':'.$dompriv;
729: $allroles{$spec.'./'.$tdomain.'/'}.=':'.$dompriv;
1.12 www 730: if ($trest ne '') {
1.50 www 731: $allroles{'cm.'.$area}.=':'.$coursepriv;
732: $allroles{$spec.'.'.$area}.=':'.$coursepriv;
1.12 www 733: }
734: }
735: }
1.11 www 736: }
1.12 www 737: } else {
1.50 www 738: $allroles{'cm./'}.=':'.$pr{$trole.':s'};
739: $allroles{$spec.'./'}.=':'.$pr{$trole.':s'};
1.12 www 740: if ($tdomain ne '') {
1.50 www 741: $allroles{'cm./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
742: $allroles{$spec.'./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
1.12 www 743: if ($trest ne '') {
1.50 www 744: $allroles{'cm.'.$area}.=':'.$pr{$trole.':c'};
745: $allroles{$spec.'.'.$area}.=':'.$pr{$trole.':c'};
1.12 www 746: }
747: }
1.11 www 748: }
1.12 www 749: }
750: }
1.11 www 751: } split(/&/,$rolesdump);
752: map {
753: %thesepriv=();
754: map {
755: if ($_ ne '') {
756: my ($priviledge,$restrictions)=split(/&/,$_);
757: if ($restrictions eq '') {
758: $thesepriv{$priviledge}='F';
759: } else {
760: if ($thesepriv{$priviledge} ne 'F') {
761: $thesepriv{$priviledge}.=$restrictions;
762: }
763: }
764: }
765: } split(/:/,$allroles{$_});
766: $thesestr='';
767: map { $thesestr.=':'.$_.'&'.$thesepriv{$_}; } keys %thesepriv;
768: $userroles.='user.priv.'.$_.'='.$thesestr."\n";
769: } keys %allroles;
770: }
771: return $userroles;
772: }
773:
1.12 www 774: # --------------------------------------------------------------- get interface
775:
776: sub get {
777: my ($namespace,@storearr)=@_;
778: my $items='';
779: map {
780: $items.=escape($_).'&';
781: } @storearr;
782: $items=~s/\&$//;
783: my $rep=reply("get:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
784: $ENV{'user.home'});
1.15 www 785: my @pairs=split(/\&/,$rep);
786: my %returnhash=();
1.42 www 787: my $i=0;
1.15 www 788: map {
1.42 www 789: $returnhash{$_}=unescape($pairs[$i]);
790: $i++;
791: } @storearr;
1.15 www 792: return %returnhash;
1.27 www 793: }
794:
795: # --------------------------------------------------------------- del interface
796:
797: sub del {
798: my ($namespace,@storearr)=@_;
799: my $items='';
800: map {
801: $items.=escape($_).'&';
802: } @storearr;
803: $items=~s/\&$//;
804: return reply("del:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
805: $ENV{'user.home'});
1.15 www 806: }
807:
808: # -------------------------------------------------------------- dump interface
809:
810: sub dump {
811: my $namespace=shift;
812: my $rep=reply("dump:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace",
813: $ENV{'user.home'});
1.12 www 814: my @pairs=split(/\&/,$rep);
815: my %returnhash=();
816: map {
817: my ($key,$value)=split(/=/,$_);
1.29 www 818: $returnhash{unescape($key)}=unescape($value);
1.12 www 819: } @pairs;
820: return %returnhash;
821: }
822:
823: # --------------------------------------------------------------- put interface
824:
825: sub put {
826: my ($namespace,%storehash)=@_;
827: my $items='';
828: map {
829: $items.=escape($_).'='.escape($storehash{$_}).'&';
830: } keys %storehash;
831: $items=~s/\&$//;
832: return reply("put:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
1.47 www 833: $ENV{'user.home'});
834: }
835:
836: # ------------------------------------------------------ critical put interface
837:
838: sub cput {
839: my ($namespace,%storehash)=@_;
840: my $items='';
841: map {
842: $items.=escape($_).'='.escape($storehash{$_}).'&';
843: } keys %storehash;
844: $items=~s/\&$//;
845: return critical
846: ("put:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
1.12 www 847: $ENV{'user.home'});
848: }
849:
850: # -------------------------------------------------------------- eget interface
851:
852: sub eget {
853: my ($namespace,@storearr)=@_;
854: my $items='';
855: map {
856: $items.=escape($_).'&';
857: } @storearr;
858: $items=~s/\&$//;
859: my $rep=reply("eget:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
860: $ENV{'user.home'});
861: my @pairs=split(/\&/,$rep);
862: my %returnhash=();
1.42 www 863: my $i=0;
1.12 www 864: map {
1.42 www 865: $returnhash{$_}=unescape($pairs[$i]);
866: $i++;
867: } @storearr;
1.12 www 868: return %returnhash;
869: }
870:
871: # ------------------------------------------------- Check for a user priviledge
872:
873: sub allowed {
874: my ($priv,$uri)=@_;
1.52 www 875: $uri=&declutter($uri);
1.29 www 876:
1.54 www 877: # Free bre access to adm and meta resources
1.29 www 878:
1.54 www 879: if ((($uri=~/^adm\//) || ($uri=~/\.meta$/)) && ($priv eq 'bre')) {
1.14 www 880: return 'F';
881: }
1.29 www 882:
1.52 www 883: my $thisallowed='';
884: my $statecond=0;
885: my $courseprivid='';
886:
887: # Course
888:
889: if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'}=~/$priv\&([^\:]*)/) {
890: $thisallowed.=$1;
891: }
1.29 www 892:
1.52 www 893: # Domain
894:
895: if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.(split(/\//,$uri))[0].'/'}
896: =~/$priv\&([^\:]*)/) {
1.12 www 897: $thisallowed.=$1;
898: }
1.52 www 899:
900: # Course: uri itself is a course
1.66 www 901: my $courseuri=$uri;
902: $courseuri=~s/\_(\d)/\/$1/;
903: if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.$courseuri}
1.52 www 904: =~/$priv\&([^\:]*)/) {
1.12 www 905: $thisallowed.=$1;
906: }
1.29 www 907:
1.52 www 908: # Full access at system, domain or course-wide level? Exit.
1.29 www 909:
910: if ($thisallowed=~/F/) {
911: return 'F';
912: }
913:
1.52 www 914: # If this is generating or modifying users, exit with special codes
1.29 www 915:
1.52 www 916: if (':csu:cdc:ccc:cin:cta:cep:ccr:cst:cad:cli:cau:cdg:'=~/\:$priv\:/) {
917: return $thisallowed;
918: }
919: #
920: # Gathered so far: system, domain and course wide priviledges
921: #
922: # Course: See if uri or referer is an individual resource that is part of
923: # the course
924:
925: if ($ENV{'request.course.id'}) {
926: $courseprivid=$ENV{'request.course.id'};
927: if ($ENV{'request.course.sec'}) {
928: $courseprivid.='/'.$ENV{'request.course.sec'};
929: }
930: $courseprivid=~s/\_/\//;
931: my $checkreferer=1;
932: my @uriparts=split(/\//,$uri);
933: my $filename=$uriparts[$#uriparts];
934: my $pathname=$uri;
935: $pathname=~s/\/$filename$//;
936: if ($ENV{'acc.res.'.$ENV{'request.course.id'}.'.'.$pathname}=~
1.54 www 937: /\&$filename\:([\d\|]+)\&/) {
1.52 www 938: $statecond=$1;
939: if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.$courseprivid}
940: =~/$priv\&([^\:]*)/) {
941: $thisallowed.=$1;
942: $checkreferer=0;
943: }
1.29 www 944: }
1.55 www 945:
1.52 www 946: if (($ENV{'HTTP_REFERER'}) && ($checkreferer)) {
1.55 www 947: my $refuri=$ENV{'HTTP_REFERER'};
948: $refuri=~s/^http\:\/\/$ENV{'request.host'}//i;
949: $refuri=&declutter($refuri);
1.53 www 950: my @uriparts=split(/\//,$refuri);
1.52 www 951: my $filename=$uriparts[$#uriparts];
1.53 www 952: my $pathname=$refuri;
1.52 www 953: $pathname=~s/\/$filename$//;
1.55 www 954: my @filenameparts=split(/\./,$uri);
1.53 www 955: if (&fileembstyle($filenameparts[$#filenameparts]) ne 'ssi') {
956: if ($ENV{'acc.res.'.$ENV{'request.course.id'}.'.'.$pathname}=~
1.54 www 957: /\&$filename\:([\d\|]+)\&/) {
1.53 www 958: my $refstatecond=$1;
1.52 www 959: if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.$courseprivid}
960: =~/$priv\&([^\:]*)/) {
961: $thisallowed.=$1;
1.53 www 962: $uri=$refuri;
963: $statecond=$refstatecond;
1.52 www 964: }
1.53 www 965: }
1.52 www 966: }
1.29 www 967: }
1.52 www 968: }
1.29 www 969:
1.52 www 970: #
971: # Gathered now: all priviledges that could apply, and condition number
972: #
973: #
974: # Full or no access?
975: #
1.29 www 976:
1.52 www 977: if ($thisallowed=~/F/) {
978: return 'F';
979: }
1.29 www 980:
1.52 www 981: unless ($thisallowed) {
982: return '';
983: }
1.29 www 984:
1.52 www 985: # Restrictions exist, deal with them
986: #
987: # C:according to course preferences
988: # R:according to resource settings
989: # L:unless locked
990: # X:according to user session state
991: #
992:
993: # Possibly locked functionality, check all courses
1.54 www 994: # Locks might take effect only after 10 minutes cache expiration for other
995: # courses, and 2 minutes for current course
1.52 www 996:
997: my $envkey;
998: if ($thisallowed=~/L/) {
999: foreach $envkey (keys %ENV) {
1.54 www 1000: if ($envkey=~/^user\.role\.(st|ta)\.([^\.]*)/) {
1001: my $courseid=$2;
1002: my $roleid=$1.'.'.$2;
1003: my $expiretime=600;
1004: if ($ENV{'request.role'} eq $roleid) {
1005: $expiretime=120;
1006: }
1007: my ($cdom,$cnum,$csec)=split(/\//,$courseid);
1008: my $prefix='course.'.$cdom.'_'.$cnum.'.';
1009: if ((time-$ENV{$prefix.'last_cache'})>$expiretime) {
1010: &coursedescription($courseid);
1011: }
1012: if (($ENV{$prefix.'res.'.$uri.'.lock.sections'}=~/\,$csec\,/)
1013: || ($ENV{$prefix.'res.'.$uri.'.lock.sections'} eq 'all')) {
1014: if ($ENV{$prefix.'res.'.$uri.'.lock.expire'}>time) {
1.57 www 1015: &log($ENV{'user.domain'},$ENV{'user.name'},
1016: $ENV{'user.host'},
1017: 'Locked by res: '.$priv.' for '.$uri.' due to '.
1.52 www 1018: $cdom.'/'.$cnum.'/'.$csec.' expire '.
1.54 www 1019: $ENV{$prefix.'priv.'.$priv.'.lock.expire'});
1.52 www 1020: return '';
1021: }
1022: }
1.54 www 1023: if (($ENV{$prefix.'priv.'.$priv.'.lock.sections'}=~/\,$csec\,/)
1024: || ($ENV{$prefix.'priv.'.$priv.'.lock.sections'} eq 'all')) {
1025: if ($ENV{'priv.'.$priv.'.lock.expire'}>time) {
1.57 www 1026: &log($ENV{'user.domain'},$ENV{'user.name'},
1027: $ENV{'user.host'},
1028: 'Locked by priv: '.$priv.' for '.$uri.' due to '.
1.52 www 1029: $cdom.'/'.$cnum.'/'.$csec.' expire '.
1.54 www 1030: $ENV{$prefix.'priv.'.$priv.'.lock.expire'});
1.52 www 1031: return '';
1032: }
1033: }
1034: }
1.29 www 1035: }
1.52 www 1036: }
1037:
1038: #
1039: # Rest of the restrictions depend on selected course
1040: #
1041:
1042: unless ($ENV{'request.course.id'}) {
1043: return '1';
1044: }
1.29 www 1045:
1.52 www 1046: #
1047: # Now user is definitely in a course
1048: #
1.53 www 1049:
1050:
1051: # Course preferences
1052:
1053: if ($thisallowed=~/C/) {
1.54 www 1054: my $rolecode=(split(/\./,$ENV{'request.role'}))[0];
1055: if ($ENV{'course.'.$ENV{'request.course.id'}.'.'.$priv.'.roles.denied'}
1056: =~/\,$rolecode\,/) {
1.57 www 1057: &log($ENV{'user.domain'},$ENV{'user.name'},$ENV{'user.host'},
1058: 'Denied by role: '.$priv.' for '.$uri.' as '.$rolecode.' in '.
1.54 www 1059: $ENV{'request.course.id'});
1060: return '';
1061: }
1.53 www 1062: }
1063:
1064: # Resource preferences
1065:
1066: if ($thisallowed=~/R/) {
1.54 www 1067: my $rolecode=(split(/\./,$ENV{'request.role'}))[0];
1068: my $filename=$perlvar{'lonDocRoot'}.'/res/'.$uri.'.meta';
1069: if (-e $filename) {
1070: my @content;
1071: {
1072: my $fh=Apache::File->new($filename);
1073: @content=<$fh>;
1074: }
1075: if (join('',@content)=~
1076: /\<roledeny[^\>]*\>[^\<]*$rolecode[^\<]*\<\/roledeny\>/) {
1.57 www 1077: &log($ENV{'user.domain'},$ENV{'user.name'},$ENV{'user.host'},
1078: 'Denied by role: '.$priv.' for '.$uri.' as '.$rolecode);
1.54 www 1079: return '';
1080:
1081: }
1082: }
1.53 www 1083: }
1.30 www 1084:
1.52 www 1085: # Restricted by state?
1.30 www 1086:
1.52 www 1087: if ($thisallowed=~/X/) {
1088: if (&condval($statecond)) {
1089: return '2';
1090: } else {
1091: return '';
1092: }
1093: }
1.30 www 1094:
1.52 www 1095: return 'F';
1.12 www 1096: }
1097:
1098: # ----------------------------------------------------------------- Define Role
1099:
1100: sub definerole {
1101: if (allowed('mcr','/')) {
1102: my ($rolename,$sysrole,$domrole,$courole)=@_;
1.21 www 1103: map {
1104: my ($crole,$cqual)=split(/\&/,$_);
1105: if ($pr{'cr:s'}!~/$crole/) { return "refused:s:$crole"; }
1106: if ($pr{'cr:s'}=~/$crole\&/) {
1107: if ($pr{'cr:s'}!~/$crole\&\w*$cqual/) {
1108: return "refused:s:$crole&$cqual";
1109: }
1110: }
1111: } split('/',$sysrole);
1112: map {
1113: my ($crole,$cqual)=split(/\&/,$_);
1114: if ($pr{'cr:d'}!~/$crole/) { return "refused:d:$crole"; }
1115: if ($pr{'cr:d'}=~/$crole\&/) {
1116: if ($pr{'cr:d'}!~/$crole\&\w*$cqual/) {
1117: return "refused:d:$crole&$cqual";
1118: }
1119: }
1120: } split('/',$domrole);
1121: map {
1122: my ($crole,$cqual)=split(/\&/,$_);
1123: if ($pr{'cr:c'}!~/$crole/) { return "refused:c:$crole"; }
1124: if ($pr{'cr:c'}=~/$crole\&/) {
1125: if ($pr{'cr:c'}!~/$crole\&\w*$cqual/) {
1126: return "refused:c:$crole&$cqual";
1127: }
1128: }
1129: } split('/',$courole);
1.12 www 1130: my $command="encrypt:rolesput:$ENV{'user.domain'}:$ENV{'user.name'}:".
1131: "$ENV{'user.domain'}:$ENV{'user.name'}:".
1.21 www 1132: "rolesdef_$rolename=".
1133: escape($sysrole.'_'.$domrole.'_'.$courole);
1.12 www 1134: return reply($command,$ENV{'user.home'});
1135: } else {
1136: return 'refused';
1137: }
1138: }
1139:
1140: # ------------------------------------------------------------------ Plain Text
1141:
1142: sub plaintext {
1.22 www 1143: my $short=shift;
1144: return $prp{$short};
1.12 www 1145: }
1146:
1.25 www 1147: # ------------------------------------------------------------------ Plain Text
1148:
1149: sub fileembstyle {
1150: my $ending=shift;
1151: return $fe{$ending};
1152: }
1153:
1154: # ------------------------------------------------------------ Description Text
1155:
1.74 www 1156: sub filedescription {
1.25 www 1157: my $ending=shift;
1158: return $fd{$ending};
1159: }
1160:
1.12 www 1161: # ----------------------------------------------------------------- Assign Role
1162:
1163: sub assignrole {
1.21 www 1164: my ($udom,$uname,$url,$role,$end,$start)=@_;
1165: my $mrole;
1.31 www 1166: $url=declutter($url);
1.21 www 1167: if ($role =~ /^cr\//) {
1168: unless ($url=~/\.course$/) { return 'invalid'; }
1169: unless (allowed('ccr',$url)) { return 'refused'; }
1170: $mrole='cr';
1171: } else {
1172: unless (($url=~/\.course$/) || ($url=~/\/$/)) { return 'invalid'; }
1173: unless (allowed('c'+$role)) { return 'refused'; }
1174: $mrole=$role;
1175: }
1176: my $command="encrypt:rolesput:$ENV{'user.domain'}:$ENV{'user.name'}:".
1177: "$udom:$uname:$url".'_'."$mrole=$role";
1178: if ($end) { $command.='_$end'; }
1179: if ($start) {
1180: if ($end) {
1181: $command.='_$start';
1182: } else {
1183: $command.='_0_$start';
1184: }
1185: }
1186: return &reply($command,&homeserver($uname,$udom));
1187: }
1188:
1189: # ---------------------------------------------------------- Assign Custom Role
1190:
1191: sub assigncustomrole {
1192: my ($udom,$uname,$url,$rdom,$rnam,$rolename,$end,$start)=@_;
1193: return &assignrole($udom,$uname,$url,'cr/'.$rdom.'/'.$rnam.'/'.$rolename,
1194: $end,$start);
1195: }
1196:
1197: # ----------------------------------------------------------------- Revoke Role
1198:
1199: sub revokerole {
1200: my ($udom,$uname,$url,$role)=@_;
1201: my $now=time;
1202: return &assignrole($udom,$uname,$url,$role,$now);
1203: }
1204:
1205: # ---------------------------------------------------------- Revoke Custom Role
1206:
1207: sub revokecustomrole {
1208: my ($udom,$uname,$url,$rdom,$rnam,$rolename)=@_;
1209: my $now=time;
1210: return &assigncustomrole($udom,$uname,$url,$rdom,$rnam,$rolename,$now);
1.17 www 1211: }
1212:
1213: # ------------------------------------------------------------ Directory lister
1214:
1215: sub dirlist {
1216: my $uri=shift;
1.18 www 1217: $uri=~s/^\///;
1218: $uri=~s/\/$//;
1.19 www 1219: my ($res,$udom,$uname,@rest)=split(/\//,$uri);
1220: if ($udom) {
1221: if ($uname) {
1222: my $listing=reply('ls:'.$perlvar{'lonDocRoot'}.'/'.$uri,
1223: homeserver($uname,$udom));
1224: return split(/:/,$listing);
1225: } else {
1226: my $tryserver;
1227: my %allusers=();
1228: foreach $tryserver (keys %libserv) {
1229: if ($hostdom{$tryserver} eq $udom) {
1230: my $listing=reply('ls:'.$perlvar{'lonDocRoot'}.'/res/'.$udom,
1231: $tryserver);
1232: if (($listing ne 'no_such_dir') && ($listing ne 'empty')
1233: && ($listing ne 'con_lost')) {
1234: map {
1235: my ($entry,@stat)=split(/&/,$_);
1236: $allusers{$entry}=1;
1237: } split(/:/,$listing);
1238: }
1239: }
1240: }
1241: my $alluserstr='';
1242: map {
1243: $alluserstr.=$_.'&user:';
1244: } sort keys %allusers;
1245: $alluserstr=~s/:$//;
1246: return split(/:/,$alluserstr);
1247: }
1248: } else {
1249: my $tryserver;
1250: my %alldom=();
1251: foreach $tryserver (keys %libserv) {
1252: $alldom{$hostdom{$tryserver}}=1;
1253: }
1254: my $alldomstr='';
1255: map {
1256: $alldomstr.=$perlvar{'lonDocRoot'}.'/res/'.$_.'&domain:';
1257: } sort keys %alldom;
1258: $alldomstr=~s/:$//;
1259: return split(/:/,$alldomstr);
1260: }
1.26 www 1261: }
1262:
1263: # -------------------------------------------------------- Value of a Condition
1264:
1.40 www 1265: sub directcondval {
1266: my $number=shift;
1267: if ($ENV{'user.state.'.$ENV{'request.course.id'}}) {
1268: return substr($ENV{'user.state.'.$ENV{'request.course.id'}},$number,1);
1269: } else {
1270: return 2;
1271: }
1272: }
1273:
1.26 www 1274: sub condval {
1275: my $condidx=shift;
1276: my $result=0;
1.54 www 1277: my $allpathcond='';
1278: map {
1279: if (defined($ENV{'acc.cond.'.$ENV{'request.course.id'}.'.'.$_})) {
1280: $allpathcond.=
1281: '('.$ENV{'acc.cond.'.$ENV{'request.course.id'}.'.'.$_}.')|';
1282: }
1283: } split(/\|/,$condidx);
1284: $allpathcond=~s/\|$//;
1.33 www 1285: if ($ENV{'request.course.id'}) {
1.54 www 1286: if ($allpathcond) {
1.26 www 1287: my $operand='|';
1288: my @stack;
1289: map {
1290: if ($_ eq '(') {
1291: push @stack,($operand,$result)
1292: } elsif ($_ eq ')') {
1293: my $before=pop @stack;
1294: if (pop @stack eq '&') {
1295: $result=$result>$before?$before:$result;
1296: } else {
1297: $result=$result>$before?$result:$before;
1298: }
1299: } elsif (($_ eq '&') || ($_ eq '|')) {
1300: $operand=$_;
1301: } else {
1.40 www 1302: my $new=directcondval($_);
1.26 www 1303: if ($operand eq '&') {
1304: $result=$result>$new?$new:$result;
1305: } else {
1306: $result=$result>$new?$result:$new;
1307: }
1308: }
1.54 www 1309: } ($allpathcond=~/(\d+|\(|\)|\&|\|)/g);
1.26 www 1310: }
1311: }
1312: return $result;
1.28 www 1313: }
1314:
1315: # --------------------------------------------------------- Value of a Variable
1316:
1.58 www 1317: sub EXT {
1.48 www 1318: my $varname=shift;
1.68 www 1319: unless ($varname) { return ''; }
1.48 www 1320: my ($realm,$space,$qualifier,@therest)=split(/\./,$varname);
1321: my $rest;
1322: if ($therest[0]) {
1323: $rest=join('.',@therest);
1324: } else {
1325: $rest='';
1326: }
1.57 www 1327: my $qualifierrest=$qualifier;
1328: if ($rest) { $qualifierrest.='.'.$rest; }
1329: my $spacequalifierrest=$space;
1330: if ($qualifierrest) { $spacequalifierrest.='.'.$qualifierrest; }
1.28 www 1331: if ($realm eq 'user') {
1.48 www 1332: # --------------------------------------------------------------- user.resource
1333: if ($space eq 'resource') {
1.57 www 1334: my %restored=&restore;
1335: return $restored{$qualifierrest};
1.48 www 1336: # ----------------------------------------------------------------- user.access
1337: } elsif ($space eq 'access') {
1338: return &allowed($qualifier,$rest);
1339: # ------------------------------------------ user.preferences, user.environment
1340: } elsif (($space eq 'preferences') || ($space eq 'environment')) {
1.57 www 1341: return $ENV{join('.',('environment',$qualifierrest))};
1.48 www 1342: # ----------------------------------------------------------------- user.course
1343: } elsif ($space eq 'course') {
1344: return $ENV{join('.',('request.course',$qualifier))};
1345: # ------------------------------------------------------------------- user.role
1346: } elsif ($space eq 'role') {
1347: my ($role,$where)=split(/\./,$ENV{'request.role'});
1348: if ($qualifier eq 'value') {
1349: return $role;
1350: } elsif ($qualifier eq 'extent') {
1351: return $where;
1352: }
1353: # ----------------------------------------------------------------- user.domain
1354: } elsif ($space eq 'domain') {
1355: return $ENV{'user.domain'};
1356: # ------------------------------------------------------------------- user.name
1357: } elsif ($space eq 'name') {
1358: return $ENV{'user.name'};
1359: # ---------------------------------------------------- Any other user namespace
1.29 www 1360: } else {
1.48 www 1361: my $item=($rest)?$qualifier.'.'.$rest:$qualifier;
1362: my %reply=&get($space,$item);
1363: return $reply{$item};
1364: }
1365: } elsif ($realm eq 'request') {
1366: # ------------------------------------------------------------- request.browser
1367: if ($space eq 'browser') {
1368: return $ENV{'browser.'.$qualifier};
1.57 www 1369: # ------------------------------------------------------------ request.filename
1370: } else {
1371: return $ENV{'request.'.$spacequalifierrest};
1.29 www 1372: }
1.28 www 1373: } elsif ($realm eq 'course') {
1.48 www 1374: # ---------------------------------------------------------- course.description
1.57 www 1375: my $section='';
1376: if ($ENV{'request.course.sec'}) {
1377: $section='_'.$ENV{'request.course.sec'};
1.48 www 1378: }
1.57 www 1379: return $ENV{'course.'.$ENV{'request.course.id'}.$section.'.'.
1380: $spacequalifierrest};
1381: } elsif ($realm eq 'resource') {
1.60 www 1382: if ($ENV{'request.course.id'}) {
1383: # ----------------------------------------------------- Cascading lookup scheme
1.69 www 1384: my $symbp=&symbread();
1385: my $mapp=(split(/\_\_\_/,$symbp))[0];
1386:
1387: my $symbparm=$symbp.'.'.$spacequalifierrest;
1388: my $mapparm=$mapp.'___(all).'.$spacequalifierrest;
1389:
1.60 www 1390: my $seclevel=
1.69 www 1391: $ENV{'request.course.id'}.'.['.
1392: $ENV{'request.course.sec'}.'].'.$spacequalifierrest;
1393: my $seclevelr=
1394: $ENV{'request.course.id'}.'.['.
1395: $ENV{'request.course.sec'}.'].'.$symbparm;
1396: my $seclevelm=
1397: $ENV{'request.course.id'}.'.['.
1398: $ENV{'request.course.sec'}.'].'.$mapparm;
1399:
1.60 www 1400: my $courselevel=
1401: $ENV{'request.course.id'}.'.'.$spacequalifierrest;
1.69 www 1402: my $courselevelr=
1403: $ENV{'request.course.id'}.'.'.$symbparm;
1404: my $courselevelm=
1405: $ENV{'request.course.id'}.'.'.$mapparm;
1406:
1.60 www 1407:
1408: # ----------------------------------------------------------- first, check user
1.69 www 1409: my %resourcedata=get('resourcedata',
1410: ($courselevelr,$courselevelm,$courselevel));
1411: if ($resourcedata{$courselevelr}!~/^error\:/) {
1412:
1413: if ($resourcedata{$courselevelr}) {
1414: return $resourcedata{$courselevelr}; }
1415: if ($resourcedata{$courselevelm}) {
1416: return $resourcedata{$courselevelm}; }
1.60 www 1417: if ($resourcedata{$courselevel}) { return $resourcedata{$courselevel}; }
1.69 www 1418:
1.63 www 1419: }
1.60 www 1420: # -------------------------------------------------------- second, check course
1421: my $section='';
1422: if ($ENV{'request.course.sec'}) {
1423: $section='_'.$ENV{'request.course.sec'};
1424: }
1425: my $reply=&reply('get:'.
1426: $ENV{'course.'.$ENV{'request.course.id'}.$section.'.domain'}.':'.
1427: $ENV{'course.'.$ENV{'request.course.id'}.$section.'.num'}.
1428: ':resourcedata:'.
1.69 www 1429: escape($seclevelr).':'.escape($seclevelm).':'.escape($seclevel).':'.
1430: escape($courselevelr).':'.escape($courselevelm).':'.escape($courselevel),
1.60 www 1431: $ENV{'course.'.$ENV{'request.course.id'}.$section.'.home'});
1.63 www 1432: if ($reply!~/^error\:/) {
1.60 www 1433: map {
1434: my ($name,$value)=split(/\=/,$_);
1435: $resourcedata{unescape($name)}=unescape($value);
1436: } split(/\&/,$reply);
1.69 www 1437:
1438: if ($resourcedata{$seclevelr}) { return $resourcedata{$seclevelr}; }
1439: if ($resourcedata{$seclevelm}) { return $resourcedata{$seclevelm}; }
1440: if ($resourcedata{$seclevel}) { return $resourcedata{$seclevel}; }
1441:
1442: if ($resourcedata{$courselevelr}) {
1443: return $resourcedata{$courselevelr}; }
1444: if ($resourcedata{$courselevelm}) {
1445: return $resourcedata{$courselevelm}; }
1.60 www 1446: if ($resourcedata{$courselevel}) { return $resourcedata{$courselevel}; }
1.69 www 1447:
1.63 www 1448: }
1.60 www 1449:
1450: # ------------------------------------------------------ third, check map parms
1.65 www 1451: my %parmhash=();
1452: my $thisparm='';
1453: if (tie(%parmhash,'GDBM_File',
1454: $ENV{'request.course.fn'}.'_parms.db',&GDBM_READER,0640)) {
1455: $thisparm=$parmhash{$symbparm};
1456: untie(%parmhash);
1.60 www 1457: }
1.65 www 1458: if ($thisparm) { return $thisparm; }
1.60 www 1459: }
1460:
1461: # --------------------------------------------- last, look in resource metadata
1.71 www 1462:
1463: my $metadata=&metadata($ENV{'request.filename'},$spacequalifierrest);
1464: if ($metadata) { return $metadata; }
1465:
1.48 www 1466: # ---------------------------------------------------- Any other user namespace
1467: } elsif ($realm eq 'environment') {
1468: # ----------------------------------------------------------------- environment
1.57 www 1469: return $ENV{$spacequalifierrest};
1.28 www 1470: } elsif ($realm eq 'system') {
1.48 www 1471: # ----------------------------------------------------------------- system.time
1472: if ($space eq 'time') {
1473: return time;
1474: }
1.28 www 1475: }
1.48 www 1476: return '';
1.61 www 1477: }
1478:
1.71 www 1479: # ---------------------------------------------------------------- Get metadata
1480:
1481: sub metadata {
1482: my ($uri,$what)=@_;
1483: $uri=&declutter($uri);
1.73 www 1484: my $filename=$uri;
1485: $uri=~s/\.meta$//;
1.71 www 1486: unless ($metacache{$uri.':keys'}) {
1.73 www 1487: unless ($filename=~/\.meta$/) { $filename.='.meta'; }
1488: my $metastring=&getfile($perlvar{'lonDocRoot'}.'/res/'.$filename);
1.71 www 1489: my $parser=HTML::TokeParser->new(\$metastring);
1490: my $token;
1491: while ($token=$parser->get_token) {
1492: if ($token->[0] eq 'S') {
1493: my $entry=$token->[1];
1494: my $unikey=$entry;
1.72 www 1495: if (defined($token->[2]->{'part'})) {
1.71 www 1496: $unikey.='_'.$token->[2]->{'part'};
1497: }
1.72 www 1498: if (defined($token->[2]->{'name'})) {
1.71 www 1499: $unikey.='_'.$token->[2]->{'name'};
1500: }
1501: if ($metacache{$uri.':keys'}) {
1502: $metacache{$uri.':keys'}.=','.$unikey;
1503: } else {
1504: $metacache{$uri.':keys'}=$unikey;
1505: }
1506: map {
1507: $metacache{$uri.':'.$unikey.'.'.$_}=$token->[2]->{$_};
1.72 www 1508: } @{$token->[3]};
1.71 www 1509: $metacache{$uri.':'.$unikey}=$parser->get_text('/'.$entry);
1510: }
1511: }
1512: }
1513: return $metacache{$uri.':'.$what};
1514: }
1515:
1.31 www 1516: # ------------------------------------------------- Update symbolic store links
1517:
1518: sub symblist {
1519: my ($mapname,%newhash)=@_;
1520: $mapname=declutter($mapname);
1521: my %hash;
1522: if (($ENV{'request.course.fn'}) && (%newhash)) {
1523: if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db',
1524: &GDBM_WRCREAT,0640)) {
1525: map {
1526: $hash{declutter($_)}=$mapname.'___'.$newhash{$_};
1527: } keys %newhash;
1528: if (untie(%hash)) {
1529: return 'ok';
1530: }
1531: }
1532: }
1533: return 'error';
1534: }
1535:
1536: # ------------------------------------------------------ Return symb list entry
1537:
1538: sub symbread {
1.44 www 1539: my $thisfn=shift;
1540: unless ($thisfn) {
1541: $thisfn=$ENV{'request.filename'};
1542: }
1543: $thisfn=declutter($thisfn);
1.31 www 1544: my %hash;
1.37 www 1545: my %bighash;
1546: my $syval='';
1.45 www 1547: if (($ENV{'request.course.fn'}) && ($thisfn)) {
1.31 www 1548: if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db',
1549: &GDBM_READER,0640)) {
1550: $syval=$hash{$thisfn};
1.37 www 1551: untie(%hash);
1552: }
1553: # ---------------------------------------------------------- There was an entry
1554: if ($syval) {
1555: unless ($syval=~/\_\d+$/) {
1556: unless ($ENV{'form.request.prefix'}=~/\.(\d+)\_$/) {
1.44 www 1557: &appenv('request.ambiguous' => $thisfn);
1.37 www 1558: return '';
1559: }
1560: $syval.=$1;
1561: }
1562: } else {
1563: # ------------------------------------------------------- Was not in symb table
1564: if (tie(%bighash,'GDBM_File',$ENV{'request.course.fn'}.'.db',
1565: &GDBM_READER,0640)) {
1566: # ---------------------------------------------- Get ID(s) for current resource
1567: my $ids=$bighash{'ids_/res/'.$thisfn};
1.65 www 1568: unless ($ids) {
1569: $ids=$bighash{'ids_/'.$thisfn};
1570: }
1.37 www 1571: if ($ids) {
1572: # ------------------------------------------------------------------- Has ID(s)
1573: my @possibilities=split(/\,/,$ids);
1.39 www 1574: if ($#possibilities==0) {
1575: # ----------------------------------------------- There is only one possibility
1.37 www 1576: my ($mapid,$resid)=split(/\./,$ids);
1577: $syval=declutter($bighash{'map_id_'.$mapid}).'___'.$resid;
1578: } else {
1.39 www 1579: # ------------------------------------------ There is more than one possibility
1580: my $realpossible=0;
1581: map {
1582: my $file=$bighash{'src_'.$_};
1583: if (&allowed('bre',$file)) {
1584: my ($mapid,$resid)=split(/\./,$_);
1585: if ($bighash{'map_type_'.$mapid} ne 'page') {
1586: $realpossible++;
1587: $syval=declutter($bighash{'map_id_'.$mapid}).
1588: '___'.$resid;
1589: }
1590: }
1591: } @possibilities;
1592: if ($realpossible!=1) { $syval=''; }
1.37 www 1593: }
1594: }
1595: untie(%bighash)
1596: }
1.31 www 1597: }
1.62 www 1598: if ($syval) {
1599: return $syval.'___'.$thisfn;
1600: }
1.31 www 1601: }
1.44 www 1602: &appenv('request.ambiguous' => $thisfn);
1.31 www 1603: return '';
1604: }
1605:
1606: # ---------------------------------------------------------- Return random seed
1607:
1.32 www 1608: sub numval {
1609: my $txt=shift;
1610: $txt=~tr/A-J/0-9/;
1611: $txt=~tr/a-j/0-9/;
1612: $txt=~tr/K-T/0-9/;
1613: $txt=~tr/k-t/0-9/;
1614: $txt=~tr/U-Z/0-5/;
1615: $txt=~tr/u-z/0-5/;
1616: $txt=~s/\D//g;
1617: return int($txt);
1618: }
1619:
1.31 www 1620: sub rndseed {
1621: my $symb;
1.44 www 1622: unless ($symb=&symbread()) { return time; }
1.32 www 1623: my $symbchck=unpack("%32C*",$symb);
1624: my $symbseed=numval($symb)%$symbchck;
1625: my $namechck=unpack("%32C*",$ENV{'user.name'});
1626: my $nameseed=numval($ENV{'user.name'})%$namechck;
1627: return int( $symbseed
1628: .$nameseed
1629: .unpack("%32C*",$ENV{'user.domain'})
1.33 www 1630: .unpack("%32C*",$ENV{'request.course.id'})
1.32 www 1631: .$namechck
1632: .$symbchck);
1.36 albertel 1633: }
1634:
1635: # ------------------------------------------------------------ Serves up a file
1636: # returns either the contents of the file or a -1
1637: sub getfile {
1638: my $file=shift;
1.37 www 1639: &repcopy($file);
1.36 albertel 1640: if (! -e $file ) { return -1; };
1641: my $fh=Apache::File->new($file);
1642: my $a='';
1643: while (<$fh>) { $a .=$_; }
1644: return $a
1645: }
1646:
1647: sub filelocation {
1648: my ($dir,$file) = @_;
1649: my $location;
1650: $file=~ s/^\s*(\S+)\s*$/$1/; ## strip off leading and trailing spaces
1.59 albertel 1651: if ($file=~m:^/~:) { # is a contruction space reference
1652: $location = $file;
1653: $location =~ s:/~(.*?)/(.*):/home/$1/public_html/$2:;
1.36 albertel 1654: } else {
1.59 albertel 1655: $file=~s/^$perlvar{'lonDocRoot'}//;
1656: $file=~s:^/*res::;
1657: if ( !( $file =~ m:^/:) ) {
1658: $location = $dir. '/'.$file;
1659: } else {
1660: $location = '/home/httpd/html/res'.$file;
1661: }
1.36 albertel 1662: }
1663: $location=~s://+:/:g; # remove duplicate /
1.46 www 1664: while ($location=~m:/\.\./:) {$location=~ s:/[^/]+/\.\./:/:g;} #remove dir/..
1665: return $location;
1666: }
1.36 albertel 1667:
1.46 www 1668: sub hreflocation {
1669: my ($dir,$file)=@_;
1670: unless (($_=~/^http:\/\//i) || ($_=~/^\//)) {
1671: my $finalpath=filelocation($dir,$file);
1672: $finalpath=~s/^\/home\/httpd\/html//;
1673: return $finalpath;
1674: } else {
1675: return $file;
1676: }
1.31 www 1677: }
1678:
1679: # ------------------------------------------------------------- Declutters URLs
1680:
1681: sub declutter {
1682: my $thisfn=shift;
1683: $thisfn=~s/^$perlvar{'lonDocRoot'}//;
1684: $thisfn=~s/^\///;
1685: $thisfn=~s/^res\///;
1686: return $thisfn;
1.12 www 1687: }
1688:
1689: # -------------------------------------------------------- Escape Special Chars
1690:
1691: sub escape {
1692: my $str=shift;
1693: $str =~ s/(\W)/"%".unpack('H2',$1)/eg;
1694: return $str;
1695: }
1696:
1697: # ----------------------------------------------------- Un-Escape Special Chars
1698:
1699: sub unescape {
1700: my $str=shift;
1701: $str =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1702: return $str;
1703: }
1.11 www 1704:
1.1 albertel 1705: # ================================================================ Main Program
1706:
1707: sub BEGIN {
1708: if ($readit ne 'done') {
1709: # ------------------------------------------------------------ Read access.conf
1710: {
1711: my $config=Apache::File->new("/etc/httpd/conf/access.conf");
1712:
1713: while (my $configline=<$config>) {
1714: if ($configline =~ /PerlSetVar/) {
1715: my ($dummy,$varname,$varvalue)=split(/\s+/,$configline);
1.8 www 1716: chomp($varvalue);
1.1 albertel 1717: $perlvar{$varname}=$varvalue;
1718: }
1719: }
1720: }
1721:
1722: # ------------------------------------------------------------- Read hosts file
1723: {
1724: my $config=Apache::File->new("$perlvar{'lonTabDir'}/hosts.tab");
1725:
1726: while (my $configline=<$config>) {
1727: my ($id,$domain,$role,$name,$ip)=split(/:/,$configline);
1728: $hostname{$id}=$name;
1729: $hostdom{$id}=$domain;
1730: if ($role eq 'library') { $libserv{$id}=$name; }
1731: }
1732: }
1733:
1734: # ------------------------------------------------------ Read spare server file
1735: {
1736: my $config=Apache::File->new("$perlvar{'lonTabDir'}/spare.tab");
1737:
1738: while (my $configline=<$config>) {
1739: chomp($configline);
1740: if (($configline) && ($configline ne $perlvar{'lonHostID'})) {
1741: $spareid{$configline}=1;
1742: }
1743: }
1744: }
1.11 www 1745: # ------------------------------------------------------------ Read permissions
1746: {
1747: my $config=Apache::File->new("$perlvar{'lonTabDir'}/roles.tab");
1748:
1749: while (my $configline=<$config>) {
1750: chomp($configline);
1751: my ($role,$perm)=split(/ /,$configline);
1752: if ($perm ne '') { $pr{$role}=$perm; }
1753: }
1754: }
1755:
1756: # -------------------------------------------- Read plain texts for permissions
1757: {
1758: my $config=Apache::File->new("$perlvar{'lonTabDir'}/rolesplain.tab");
1759:
1760: while (my $configline=<$config>) {
1761: chomp($configline);
1762: my ($short,$plain)=split(/:/,$configline);
1763: if ($plain ne '') { $prp{$short}=$plain; }
1.25 www 1764: }
1765: }
1766:
1767: # ------------------------------------------------------------- Read file types
1768: {
1769: my $config=Apache::File->new("$perlvar{'lonTabDir'}/filetypes.tab");
1770:
1771: while (my $configline=<$config>) {
1772: chomp($configline);
1773: my ($ending,$emb,@descr)=split(/\s+/,$configline);
1774: if ($descr[0] ne '') {
1775: $fe{$ending}=$emb;
1776: $fd{$ending}=join(' ',@descr);
1777: }
1.11 www 1778: }
1779: }
1780:
1.71 www 1781: %metacache=();
1.22 www 1782:
1.1 albertel 1783: $readit='done';
1.12 www 1784: &logthis('<font color=yellow>INFO: Read configuration</font>');
1.1 albertel 1785: }
1786: }
1787: 1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to lonnet.pm CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / lonnet / perl