File:  [LON-CAPA] / loncom / lonnet / perl / lonnet.pm
Revision 1.168: download - view: text, annotated - select for diffs
Mon Nov 5 22:48:19 2001 UTC (22 years, 8 months ago) by albertel
Branches: MAIN
CVS tags: stable_2001_fall, HEAD
- added tmpstore/tmprestore/tmpreset functions create and deate hash values from a tmp hash, works well with construction space data

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

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