File:  [LON-CAPA] / loncom / lonnet / perl / lonnet.pm
Revision 1.108: download - view: text, annotated - select for diffs
Mon Mar 19 16:46:24 2001 UTC (23 years, 4 months ago) by harris41
Branches: MAIN
CVS tags: HEAD
added in annotation about metadata_query function into the function
glossary at the beginning -Scott

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

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