File:  [LON-CAPA] / loncom / lonnet / perl / lonnet.pm
Revision 1.153: download - view: text, annotated - select for diffs
Sat Aug 18 14:58:15 2001 UTC (22 years, 11 months ago) by www
Branches: MAIN
CVS tags: HEAD
Stores checkin and checkout under resource part 0

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

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