File:  [LON-CAPA] / loncom / lonnet / perl / lonnet.pm
Revision 1.89: download - view: text, annotated - select for diffs
Tue Jan 9 19:55:31 2001 UTC (23 years, 6 months ago) by www
Branches: MAIN
CVS tags: HEAD
Locks on reading part of appenv and delenv, error check

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>