File:  [LON-CAPA] / loncom / lonnet / perl / lonnet.pm
Revision 1.88: download - view: text, annotated - select for diffs
Sat Jan 6 16:08:24 2001 UTC (23 years, 6 months ago) by www
Branches: MAIN
CVS tags: HEAD
Get flock constants from Fcntl

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

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