Annotation of loncom/lonnet/perl/lonnet.pm, revision 1.153

1.1       albertel    1: # The LearningOnline Network
                      2: # TCP networking package
1.12      www         3: #
                      4: # Functions for use by content handlers:
                      5: #
1.112     harris41    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
1.12      www         9: # plaintext(short)   : plain text explanation of short term
1.25      www        10: # fileembstyle(ext)  : embed style in page for file extension
                     11: # filedescription(ext) : descriptor text for file extension
1.29      www        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
1.21      www        18: # definerole(rolename,sys,dom,cou) : define a custom role rolename
1.103     harris41   19: #                      set privileges in format of lonTabs/roles.tab for
1.21      www        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
1.24      www        29: # appenv(hash)       : adds hash to session environment
1.56      www        30: # delenv(varname)    : deletes all environment entries starting with varname
1.124     www        31: # store(hashref,symb,courseid,udom,uname)
1.122     albertel   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
1.124     www        36: # cstore(hashref,symb,courseid,udom,uname)
1.122     albertel   37: #                    : same as store but uses the critical interface to 
                     38: #                      guarentee a store
1.124     www        39: # restore(symb,courseid,udom,uname)
1.122     albertel   40: #                    : returns hash for this symb, all args are optional
1.124     www        41: #                      if they aren't given they will be derived from the 
                     42: #                      current enviroment
1.133     albertel   43: #
                     44: #
1.134     albertel   45: # for the next 6 functions udom and uname are optional
1.133     albertel   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)
1.131     albertel   55: # get(namesp,arrayref,udom,uname)
                     56: #                    : returns hash with keys from array  reference filled
                     57: #                      in from namesp
1.133     albertel   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
1.134     albertel   60: # put(namesp,hash,udom,uname)   : stores hash in namesp
                     61: # cput(namesp,hash,udom,uname)  : critical put
1.133     albertel   62: #
                     63: #
1.23      www        64: # ssi(url,hash)      : does a complete request cycle on url to localhost, posts
                     65: #                      hash
1.34      www        66: # coursedescription(id) : returns and caches course description for id
1.17      www        67: # repcopy(filename)  : replicate file
                     68: # dirlist(url)       : gets a directory listing
1.40      www        69: # directcondval(index) : reading condition value of single condition from 
                     70: #                        state string
1.28      www        71: # condval(index)     : value of condition index based on state
1.58      www        72: # EXT(name)          : value of a variable
1.31      www        73: # symblist(map,hash) : Updates symbolic storage links
1.44      www        74: # symbread([filename]) : returns the data handle (filename optional)
1.76      www        75: # rndseed()          : returns a random seed 
                     76: # receipt()          : returns a receipt to be given out to users 
1.36      albertel   77: # getfile(filename)  : returns the contents of filename, or a -1 if it can't
                     78: #                      be found, replicates and subscribes to the file
1.121     harris41   79: # filelocation(dir,file) : returns a fairly clean absolute reference to file 
1.36      albertel   80: #                          from the directory dir
1.46      www        81: # hreflocation(dir,file) : same as filelocation, but for hrefs
1.47      www        82: # log(domain,user,home,msg) : write to permanent log for user
1.70      www        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
1.73      www        92: # metadata(file,entry): returns the metadata entry for a file. entry='keys'
                     93: #                       returns a comma separated list of keys
1.12      www        94: #
1.1       albertel   95: # 6/1/99,6/2,6/10,6/11,6/12,6/14,6/26,6/28,6/29,6/30,
1.5       www        96: # 7/1,7/2,7/9,7/10,7/12,7/14,7/15,7/19,
1.8       www        97: # 11/8,11/16,11/18,11/22,11/23,12/22,
1.12      www        98: # 01/06,01/13,02/24,02/28,02/29,
                     99: # 03/01,03/02,03/06,03/07,03/13,
1.15      www       100: # 04/05,05/29,05/31,06/01,
                    101: # 06/05,06/26 Gerd Kortemeyer
                    102: # 06/26 Ben Tyszka
1.22      www       103: # 06/30,07/15,07/17,07/18,07/20,07/21,07/22,07/25 Gerd Kortemeyer
1.23      www       104: # 08/14 Ben Tyszka
1.36      albertel  105: # 08/22,08/28,08/31,09/01,09/02,09/04,09/05,09/25,09/28,09/30 Gerd Kortemeyer
1.35      www       106: # 10/04 Gerd Kortemeyer
1.36      albertel  107: # 10/04 Guy Albertelli
1.54      www       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, 
1.71      www       109: # 10/30,10/31,
1.75      www       110: # 11/2,11/14,11/15,11/16,11/20,11/21,11/22,11/25,11/27,
1.83      www       111: # 12/02,12/12,12/13,12/14,12/28,12/29 Gerd Kortemeyer
1.87      www       112: # 05/01/01 Guy Albertelli
1.89      www       113: # 05/01,06/01,09/01 Gerd Kortemeyer
1.92      www       114: # 09/01 Guy Albertelli
1.102     www       115: # 09/01,10/01,11/01 Gerd Kortemeyer
1.103     harris41  116: # 02/27/01 Scott Harrison
1.104     www       117: # 3/2 Gerd Kortemeyer
1.119     harris41  118: # 3/15,3/19 Scott Harrison
1.110     www       119: # 3/19,3/20 Gerd Kortemeyer
1.123     harris41  120: # 3/22,3/27,4/2,4/16,4/17 Scott Harrison
1.125     www       121: # 5/26,5/28 Gerd Kortemeyer
1.127     ng        122: # 5/30 H. K. Ng
1.128     www       123: # 6/1 Gerd Kortemeyer
1.135     www       124: # July Guy Albertelli
1.152     www       125: # 8/4,8/7,8/8,8/9,8/11,8/16,8/17,8/18 Gerd Kortemeyer
1.128     www       126: 
1.1       albertel  127: package Apache::lonnet;
                    128: 
                    129: use strict;
                    130: use Apache::File;
1.8       www       131: use LWP::UserAgent();
1.15      www       132: use HTTP::Headers;
1.11      www       133: use vars 
1.150     www       134: qw(%perlvar %hostname %homecache %hostip %spareid %hostdom %libserv %pr %prp %fe %fd $readit %metacache %packagetab);
1.1       albertel  135: use IO::Socket;
1.31      www       136: use GDBM_File;
1.8       www       137: use Apache::Constants qw(:common :http);
1.71      www       138: use HTML::TokeParser;
1.88      www       139: use Fcntl qw(:flock);
1.1       albertel  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>;
1.9       www       173:     if (!$answer) { $answer="con_lost"; }
1.1       albertel  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); }
1.65      www       182:     if (($answer=~/^refused/) || ($answer=~/^rejected/)) {
1.12      www       183:        &logthis("<font color=blue>WARNING:".
                    184:                 " $cmd to $server returned $answer</font>");
                    185:     }
1.1       albertel  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; }
1.12      www       206:             &logthis(
                    207:   "<font color=blue>WARNING: $peerfile still not there, giving up</font>");
1.1       albertel  208:         } else {
1.12      www       209: 	    &logthis(
                    210:                "<font color=blue>WARNING:".
                    211:                " lonc at pid $loncpid not responding, giving up</font>");
1.1       albertel  212:         }
                    213:     } else {
1.12      www       214:      &logthis('<font color=blue>WARNING: lonc not running, giving up</font>');
1.1       albertel  215:     }
                    216: }
                    217: 
                    218: # ------------------------------------------------------ Critical communication
1.12      www       219: 
1.1       albertel  220: sub critical {
                    221:     my ($cmd,$server)=@_;
1.89      www       222:     unless ($hostname{$server}) {
                    223:         &logthis("<font color=blue>WARNING:".
                    224:                " Critical message to unknown server ($server)</font>");
                    225:         return 'no_such_host';
                    226:     }
1.1       albertel  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;
1.5       www       237:             $middlename=substr($middlename,0,16);
1.1       albertel  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")) {
1.7       www       244:                 print $dfh "$cmd\n";
1.1       albertel  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);
1.7       www       256:             if ($wcmd eq $cmd) {
1.12      www       257: 		&logthis("<font color=blue>WARNING: ".
                    258:                          "Connection buffer $dfilename: $cmd</font>");
1.1       albertel  259:                 &logperm("D:$server:$cmd");
                    260: 	        return 'con_delayed';
                    261:             } else {
1.12      www       262:                 &logthis("<font color=red>CRITICAL:"
                    263:                         ." Critical connection failed: $server $cmd</font>");
1.1       albertel  264:                 &logperm("F:$server:$cmd");
                    265:                 return 'con_failed';
                    266:             }
                    267:         }
                    268:     }
                    269:     return $answer;
                    270: }
                    271: 
1.5       www       272: # ---------------------------------------------------------- Append Environment
                    273: 
                    274: sub appenv {
1.6       www       275:     my %newenv=@_;
1.35      www       276:     map {
                    277: 	if (($newenv{$_}=~/^user\.role/) || ($newenv{$_}=~/^user\.priv/)) {
                    278:             &logthis("<font color=blue>WARNING: ".
1.151     www       279:                 "Attempt to modify environment ".$_." to ".$newenv{$_}
                    280:                 .'</font>');
1.35      www       281: 	    delete($newenv{$_});
                    282:         } else {
                    283:             $ENV{$_}=$newenv{$_};
                    284:         }
                    285:     } keys %newenv;
1.95      www       286: 
                    287:     my $lockfh;
                    288:     unless ($lockfh=Apache::File->new("$ENV{'user.environment'}")) {
1.97      www       289:        return 'error: '.$!;
1.95      www       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: 
1.6       www       298:     my @oldenv;
                    299:     {
                    300:      my $fh;
                    301:      unless ($fh=Apache::File->new("$ENV{'user.environment'}")) {
1.97      www       302: 	return 'error: '.$!;
1.6       www       303:      }
                    304:      @oldenv=<$fh>;
1.89      www       305:      $fh->close();
1.6       www       306:     }
                    307:     for (my $i=0; $i<=$#oldenv; $i++) {
                    308:         chomp($oldenv[$i]);
1.9       www       309:         if ($oldenv[$i] ne '') {
                    310:            my ($name,$value)=split(/=/,$oldenv[$i]);
1.24      www       311:            unless (defined($newenv{$name})) {
                    312: 	      $newenv{$name}=$value;
                    313: 	   }
1.9       www       314:         }
1.6       www       315:     }
                    316:     {
                    317:      my $fh;
                    318:      unless ($fh=Apache::File->new(">$ENV{'user.environment'}")) {
                    319: 	return 'error';
                    320:      }
                    321:      my $newname;
1.93      www       322:      foreach $newname (keys %newenv) {
1.6       www       323: 	 print $fh "$newname=$newenv{$newname}\n";
                    324:      }
1.86      albertel  325:      $fh->close();
1.56      www       326:     }
1.95      www       327: 
                    328:     $lockfh->close();
1.56      www       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:      }
1.89      www       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:      }
1.56      www       353:      @oldenv=<$fh>;
1.89      www       354:      $fh->close();
1.56      www       355:     }
                    356:     {
                    357:      my $fh;
                    358:      unless ($fh=Apache::File->new(">$ENV{'user.environment'}")) {
                    359: 	return 'error';
                    360:      }
1.89      www       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:      }
1.56      www       367:      map {
                    368: 	 unless ($_=~/^$delthis/) { print $fh $_; }
                    369:      } @oldenv;
1.87      www       370:      $fh->close();
1.5       www       371:     }
                    372:     return 'ok';
                    373: }
1.1       albertel  374: 
                    375: # ------------------------------ Find server with least workload from spare.tab
1.11      www       376: 
1.1       albertel  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)
1.11      www       392: 
1.1       albertel  393: sub authenticate {
                    394:     my ($uname,$upass,$udom)=@_;
1.12      www       395:     $upass=escape($upass);
1.1       albertel  396:     if (($perlvar{'lonRole'} eq 'library') && 
                    397:         ($udom eq $perlvar{'lonDefDomain'})) {
1.3       www       398:     my $answer=reply("encrypt:auth:$udom:$uname:$upass",$perlvar{'lonHostID'});
1.2       www       399:         if ($answer =~ /authorized/) {
1.9       www       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:               }
1.2       www       408: 	}
1.1       albertel  409:     }
                    410: 
                    411:     my $tryserver;
                    412:     foreach $tryserver (keys %libserv) {
                    413: 	if ($hostdom{$tryserver} eq $udom) {
1.10      www       414:            my $answer=reply("encrypt:auth:$udom:$uname:$upass",$tryserver);
1.1       albertel  415:            if ($answer =~ /authorized/) {
1.9       www       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:               } 
1.1       albertel  424: 	   }
                    425:        }
1.9       www       426:     }
                    427:     &logthis("User $uname at $udom could not be authenticated");    
1.1       albertel  428:     return 'no_host';
                    429: }
                    430: 
                    431: # ---------------------- Find the homebase for a user from domain's lib servers
1.11      www       432: 
1.1       albertel  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';
1.70      www       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=();
1.76      www       465:           if (($reply ne 'con_lost') && ($reply!~/^error\:/)) {
1.70      www       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;
1.1       albertel  555: }
                    556: 
                    557: # ----------------------------- Subscribe to a resource, return URL if possible
1.11      www       558: 
1.1       albertel  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);
1.64      www       569:     if (($answer eq 'con_lost') || ($answer eq 'rejected')) {
                    570: 	$answer.=' by '.$home;
                    571:     }
1.1       albertel  572:     return $answer;
                    573: }
                    574:     
1.8       www       575: # -------------------------------------------------------------- Replicate file
                    576: 
                    577: sub repcopy {
                    578:     my $filename=shift;
1.23      www       579:     $filename=~s/\/+/\//g;
1.8       www       580:     my $transname="$filename.in.transfer";
1.17      www       581:     if ((-e $filename) || (-e $transname)) { return OK; }
1.8       www       582:     my $remoteurl=subscribe($filename);
1.64      www       583:     if ($remoteurl =~ /^con_lost by/) {
                    584: 	   &logthis("Subscribe returned $remoteurl: $filename");
1.8       www       585:            return HTTP_SERVICE_UNAVAILABLE;
                    586:     } elsif ($remoteurl eq 'not_found') {
                    587: 	   &logthis("Subscribe returned not_found: $filename");
                    588: 	   return HTTP_NOT_FOUND;
1.64      www       589:     } elsif ($remoteurl =~ /^rejected by/) {
                    590: 	   &logthis("Subscribe returned $remoteurl: $filename");
1.8       www       591:            return FORBIDDEN;
1.20      www       592:     } elsif ($remoteurl eq 'directory') {
                    593:            return OK;
1.8       www       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;
1.12      www       614:                &logthis("<font color=blue>WARNING:"
                    615:                        ." LWP get: $message: $filename</font>");
1.8       www       616:                return HTTP_SERVICE_UNAVAILABLE;
                    617:            } else {
1.16      www       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: 	       }
1.8       www       627:                rename($transname,$filename);
                    628:                return OK;
                    629:            }
                    630:     }
                    631: }
                    632: 
1.15      www       633: # --------------------------------------------------------- Server Side Include
                    634: 
                    635: sub ssi {
                    636: 
1.23      www       637:     my ($fn,%form)=@_;
1.15      www       638: 
                    639:     my $ua=new LWP::UserAgent;
1.23      www       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: 
1.15      www       650:     $request->header(Cookie => $ENV{'HTTP_COOKIE'});
                    651:     my $response=$ua->request($request);
                    652: 
                    653:     return $response->content;
                    654: }
                    655: 
1.14      www       656: # ------------------------------------------------------------------------- Log
                    657: 
                    658: sub log {
                    659:     my ($dom,$nam,$hom,$what)=@_;
1.47      www       660:     return critical("log:$dom:$nam:$what",$hom);
1.149     www       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);
1.151     www       676:     if ($token=~/^error\:/) { 
                    677:         &logthis("<font color=blue>WARNING: ".
                    678:                 "Checkout tmpput failed ".$tudom.' - '.$tuname.' - '.$symb.
                    679:                  "</font>");
                    680:         return ''; 
                    681:     }
                    682: 
1.149     www       683:     $token=~s/^(\d+)\_.*\_(\d+)$/$1\*$2\*$lonhost/;
                    684:     $token=~tr/a-z/A-Z/;
                    685: 
1.153   ! www       686:     my %infohash=('resource.0.outtoken' => $token,
        !           687:                   'resource.0.checkouttime' => $now,
        !           688:                   'resource.0.outremote' => $ENV{'REMOTE_ADDR'});
1.149     www       689: 
                    690:     unless (&cstore(\%infohash,$symb,$tcrsid,$tudom,$tuname) eq 'ok') {
                    691:        return '';
1.151     www       692:     } else {
                    693:         &logthis("<font color=blue>WARNING: ".
                    694:                 "Checkout cstore failed ".$tudom.' - '.$tuname.' - '.$symb.
                    695:                  "</font>");
1.149     www       696:     }    
                    697: 
                    698:     if (&log($tudom,$tuname,&homeserver($tuname,$tudom),
                    699:                          &escape('Checkout '.$infostr.' - '.
                    700:                                                  $token)) ne 'ok') {
                    701: 	return '';
1.151     www       702:     } else {
                    703:         &logthis("<font color=blue>WARNING: ".
                    704:                 "Checkout log failed ".$tudom.' - '.$tuname.' - '.$symb.
                    705:                  "</font>");
1.149     www       706:     }
1.151     www       707:     return $token;
1.149     www       708: }
                    709: 
                    710: # ------------------------------------------------------------ Check in an item
                    711: 
                    712: sub checkin {
                    713:     my $token=shift;
1.150     www       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: 
1.153   ! www       722:     my %infohash=('resource.0.intoken' => $token,
        !           723:                   'resource.0.checkintime' => $now,
        !           724:                   'resource.0.inremote' => $ENV{'REMOTE_ADDR'});
1.150     www       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);    
1.110     www       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';
1.14      www       753: }
                    754: 
1.109     www       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=
1.133     albertel  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]);
1.109     www       770:         unless ($status eq 'ok ok') {
                    771:            &logthis('Could not devalidate spreadsheet '.
                    772:                     $ENV{'user.name'}.' at '.$ENV{'user.domain'}.' for '.
                    773: 		    $symb.': '.$status);
1.133     albertel  774:         }
1.109     www       775:     }
                    776: }
                    777: 
1.9       www       778: # ----------------------------------------------------------------------- Store
                    779: 
                    780: sub store {
1.124     www       781:     my ($storehash,$symb,$namespace,$domain,$stuname) = @_;
                    782:     my $home='';
                    783: 
                    784:     if ($stuname) {
                    785: 	$home=&homeserver($stuname,$domain);
                    786:     }
                    787: 
1.122     albertel  788:     if (!$symb) { unless ($symb=&symbread()) { return ''; } }
1.109     www       789: 
                    790:     &devalidate($symb);
                    791: 
                    792:     $symb=escape($symb);
1.122     albertel  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'}; }
1.12      www       797:     my $namevalue='';
                    798:     map {
1.122     albertel  799:         $namevalue.=escape($_).'='.escape($$storehash{$_}).'&';
                    800:     } keys %$storehash;
1.12      www       801:     $namevalue=~s/\&$//;
1.124     www       802:     return reply("store:$domain:$stuname:$namespace:$symb:$namevalue","$home");
1.9       www       803: }
                    804: 
1.47      www       805: # -------------------------------------------------------------- Critical Store
                    806: 
                    807: sub cstore {
1.124     www       808:     my ($storehash,$symb,$namespace,$domain,$stuname) = @_;
                    809:     my $home='';
                    810: 
                    811:     if ($stuname) {
                    812: 	$home=&homeserver($stuname,$domain);
                    813:     }
                    814: 
1.122     albertel  815:     if (!$symb) { unless ($symb=&symbread()) { return ''; } }
1.109     www       816: 
                    817:     &devalidate($symb);
                    818: 
                    819:     $symb=escape($symb);
1.122     albertel  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: 
1.47      www       825:     my $namevalue='';
                    826:     map {
1.122     albertel  827:         $namevalue.=escape($_).'='.escape($$storehash{$_}).'&';
                    828:     } keys %$storehash;
1.47      www       829:     $namevalue=~s/\&$//;
1.122     albertel  830:     return critical("store:$domain:$stuname:$namespace:$symb:$namevalue","$home");
1.47      www       831: }
                    832: 
1.9       www       833: # --------------------------------------------------------------------- Restore
                    834: 
                    835: sub restore {
1.124     www       836:     my ($symb,$namespace,$domain,$stuname) = @_;
                    837:     my $home='';
                    838: 
                    839:     if ($stuname) {
                    840: 	$home=&homeserver($stuname,$domain);
                    841:     }
                    842: 
1.122     albertel  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: 
1.12      www       854:     my %returnhash=();
                    855:     map {
                    856: 	my ($name,$value)=split(/\=/,$_);
                    857:         $returnhash{&unescape($name)}=&unescape($value);
                    858:     } split(/\&/,$answer);
1.75      www       859:     my $version;
                    860:     for ($version=1;$version<=$returnhash{'version'};$version++) {
                    861:        map {
                    862:           $returnhash{$_}=$returnhash{$version.':'.$_};
                    863:        } split(/\:/,$returnhash{$version.':keys'});
                    864:     }
1.13      www       865:     return %returnhash;
1.34      www       866: }
                    867: 
                    868: # ---------------------------------------------------------- Course Description
                    869: 
                    870: sub coursedescription {
                    871:     my $courseid=shift;
                    872:     $courseid=~s/^\///;
1.49      www       873:     $courseid=~s/\_/\//g;
1.34      www       874:     my ($cdomain,$cnum)=split(/\//,$courseid);
1.129     albertel  875:     my $chome=&homeserver($cnum,$cdomain);
1.34      www       876:     if ($chome ne 'no_host') {
1.129     albertel  877:        my %returnhash=&dump('environment',$cdomain,$cnum);
                    878:        if (!exists($returnhash{'con_lost'})) {
1.96      www       879:            my $normalid=$cdomain.'_'.$cnum;
1.53      www       880:            my %envhash=();
1.129     albertel  881:            $returnhash{'home'}= $chome;
                    882: 	   $returnhash{'domain'} = $cdomain;
                    883: 	   $returnhash{'num'} = $cnum;
1.130     albertel  884:            while (my ($name,$value) = each %returnhash) {
1.53      www       885:                $envhash{'course.'.$normalid.'.'.$name}=$value;
1.129     albertel  886:            }
1.34      www       887:            $returnhash{'url'}='/res/'.declutter($returnhash{'url'});
                    888:            $returnhash{'fn'}=$perlvar{'lonDaemons'}.'/tmp/'.
1.38      www       889: 	       $ENV{'user.name'}.'_'.$cdomain.'_'.$cnum;
1.54      www       890:            $envhash{'course.'.$normalid.'.last_cache'}=time;
1.60      www       891:            $envhash{'course.'.$normalid.'.home'}=$chome;
                    892:            $envhash{'course.'.$normalid.'.domain'}=$cdomain;
                    893:            $envhash{'course.'.$normalid.'.num'}=$cnum;
1.53      www       894:            &appenv(%envhash);
1.34      www       895:            return %returnhash;
                    896:        }
                    897:     }
                    898:     return ();
1.9       www       899: }
1.1       albertel  900: 
1.103     harris41  901: # -------------------------------------------------------- Get user privileges
1.11      www       902: 
                    903: sub rolesinit {
                    904:     my ($domain,$username,$authhost)=@_;
                    905:     my $rolesdump=reply("dump:$domain:$username:roles",$authhost);
1.12      www       906:     if (($rolesdump eq 'con_lost') || ($rolesdump eq '')) { return ''; }
1.11      www       907:     my %allroles=();
                    908:     my %thesepriv=();
                    909:     my $now=time;
1.21      www       910:     my $userroles="user.login.time=$now\n";
1.11      www       911:     my $thesestr;
                    912: 
                    913:     if ($rolesdump ne '') {
                    914:         map {
1.21      www       915: 	  if ($_!~/^rolesdef\&/) {
1.11      www       916:             my ($area,$role)=split(/=/,$_);
1.21      www       917:             $area=~s/\_\w\w$//;
1.11      www       918:             my ($trole,$tend,$tstart)=split(/_/,$role);
1.21      www       919:             $userroles.='user.role.'.$trole.'.'.$area.'='.
                    920:                         $tstart.'.'.$tend."\n";
1.11      www       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 '')) {
1.50      www       932: 	       my $spec=$trole.'.'.$area;
1.12      www       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=
1.21      www       939: 			  reply("get:$rdomain:$rauthor:roles:rolesdef_$rrole",
1.12      www       940:                                 $homsvr);
                    941:                       if (($roledef ne 'con_lost') && ($roledef ne '')) {
                    942:                          my ($syspriv,$dompriv,$coursepriv)=
1.21      www       943: 			     split(/\_/,unescape($roledef));
1.50      www       944:  	                 $allroles{'cm./'}.=':'.$syspriv;
                    945:                          $allroles{$spec.'./'}.=':'.$syspriv;
1.12      www       946:                          if ($tdomain ne '') {
1.50      www       947:                              $allroles{'cm./'.$tdomain.'/'}.=':'.$dompriv;
                    948:                              $allroles{$spec.'./'.$tdomain.'/'}.=':'.$dompriv;
1.12      www       949:                              if ($trest ne '') {
1.50      www       950: 		                $allroles{'cm.'.$area}.=':'.$coursepriv;
                    951: 		                $allroles{$spec.'.'.$area}.=':'.$coursepriv;
1.12      www       952:                              }
                    953: 	                 }
                    954:                       }
1.11      www       955:                    }
1.12      www       956:                } else {
1.50      www       957: 	           $allroles{'cm./'}.=':'.$pr{$trole.':s'};
                    958: 	           $allroles{$spec.'./'}.=':'.$pr{$trole.':s'};
1.12      www       959:                    if ($tdomain ne '') {
1.50      www       960:                      $allroles{'cm./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
                    961:                      $allroles{$spec.'./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
1.12      www       962:                       if ($trest ne '') {
1.50      www       963: 		          $allroles{'cm.'.$area}.=':'.$pr{$trole.':c'};
                    964: 		          $allroles{$spec.'.'.$area}.=':'.$pr{$trole.':c'};
1.12      www       965:                       }
                    966: 	           }
1.11      www       967: 	       }
1.12      www       968:             }
                    969:           } 
1.11      www       970:         } split(/&/,$rolesdump);
1.125     www       971:         my $adv=0;
1.128     www       972:         my $author=0;
1.11      www       973:         map {
                    974:             %thesepriv=();
1.146     www       975:             if (($_!~/^st/) && ($_!~/^ta/) && ($_!~/^cm/)) { $adv=1; }
1.128     www       976:             if (($_=~/^au/) || ($_=~/^ca/)) { $author=1; }
1.11      www       977:             map {
                    978:                 if ($_ ne '') {
1.103     harris41  979: 		    my ($privilege,$restrictions)=split(/&/,$_);
1.11      www       980:                     if ($restrictions eq '') {
1.103     harris41  981: 			$thesepriv{$privilege}='F';
1.11      www       982:                     } else {
1.103     harris41  983:                         if ($thesepriv{$privilege} ne 'F') {
                    984: 			    $thesepriv{$privilege}.=$restrictions;
1.11      www       985:                         }
                    986:                     }
                    987:                 }
                    988:             } split(/:/,$allroles{$_});
                    989:             $thesestr='';
                    990:             map { $thesestr.=':'.$_.'&'.$thesepriv{$_}; } keys %thesepriv;
                    991:             $userroles.='user.priv.'.$_.'='.$thesestr."\n";
                    992:         } keys %allroles;            
1.128     www       993:         $userroles.='user.adv='.$adv."\n".
                    994: 	            'user.author='.$author."\n";
1.126     www       995:         $ENV{'user.adv'}=$adv;
1.11      www       996:     }
                    997:     return $userroles;  
                    998: }
                    999: 
1.12      www      1000: # --------------------------------------------------------------- get interface
                   1001: 
                   1002: sub get {
1.131     albertel 1003:    my ($namespace,$storearr,$udomain,$uname)=@_;
1.12      www      1004:    my $items='';
                   1005:    map {
                   1006:        $items.=escape($_).'&';
1.131     albertel 1007:    } @$storearr;
1.12      www      1008:    $items=~s/\&$//;
1.131     albertel 1009:    if (!$udomain) { $udomain=$ENV{'user.domain'}; }
                   1010:    if (!$uname) { $uname=$ENV{'user.name'}; }
                   1011:    my $uhome=&homeserver($uname,$udomain);
                   1012: 
1.133     albertel 1013:    my $rep=&reply("get:$udomain:$uname:$namespace:$items",$uhome);
1.15      www      1014:    my @pairs=split(/\&/,$rep);
                   1015:    my %returnhash=();
1.42      www      1016:    my $i=0;
1.15      www      1017:    map {
1.42      www      1018:       $returnhash{$_}=unescape($pairs[$i]);
                   1019:       $i++;
1.131     albertel 1020:    } @$storearr;
1.15      www      1021:    return %returnhash;
1.27      www      1022: }
                   1023: 
                   1024: # --------------------------------------------------------------- del interface
                   1025: 
                   1026: sub del {
1.133     albertel 1027:    my ($namespace,$storearr,$udomain,$uname)=@_;
1.27      www      1028:    my $items='';
                   1029:    map {
                   1030:        $items.=escape($_).'&';
1.133     albertel 1031:    } @$storearr;
1.27      www      1032:    $items=~s/\&$//;
1.133     albertel 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);
1.15      www      1038: }
                   1039: 
                   1040: # -------------------------------------------------------------- dump interface
                   1041: 
                   1042: sub dump {
1.129     albertel 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);
1.12      www      1048:    my @pairs=split(/\&/,$rep);
                   1049:    my %returnhash=();
                   1050:    map {
                   1051:       my ($key,$value)=split(/=/,$_);
1.29      www      1052:       $returnhash{unescape($key)}=unescape($value);
1.12      www      1053:    } @pairs;
                   1054:    return %returnhash;
                   1055: }
                   1056: 
                   1057: # --------------------------------------------------------------- put interface
                   1058: 
                   1059: sub put {
1.134     albertel 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);
1.12      www      1064:    my $items='';
                   1065:    map {
1.134     albertel 1066:        $items.=&escape($_).'='.&escape($$storehash{$_}).'&';
                   1067:    } keys %$storehash;
1.12      www      1068:    $items=~s/\&$//;
1.134     albertel 1069:    return &reply("put:$udomain:$uname:$namespace:$items",$uhome);
1.47      www      1070: }
                   1071: 
                   1072: # ------------------------------------------------------ critical put interface
                   1073: 
                   1074: sub cput {
1.134     albertel 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);
1.47      www      1079:    my $items='';
                   1080:    map {
1.134     albertel 1081:        $items.=escape($_).'='.escape($$storehash{$_}).'&';
                   1082:    } keys %$storehash;
1.47      www      1083:    $items=~s/\&$//;
1.134     albertel 1084:    return &critical("put:$udomain:$uname:$namespace:$items",$uhome);
1.12      www      1085: }
                   1086: 
                   1087: # -------------------------------------------------------------- eget interface
                   1088: 
                   1089: sub eget {
1.133     albertel 1090:    my ($namespace,$storearr,$udomain,$uname)=@_;
1.12      www      1091:    my $items='';
                   1092:    map {
                   1093:        $items.=escape($_).'&';
1.133     albertel 1094:    } @$storearr;
1.12      www      1095:    $items=~s/\&$//;
1.133     albertel 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);
1.12      www      1100:    my @pairs=split(/\&/,$rep);
                   1101:    my %returnhash=();
1.42      www      1102:    my $i=0;
1.12      www      1103:    map {
1.42      www      1104:       $returnhash{$_}=unescape($pairs[$i]);
                   1105:       $i++;
1.133     albertel 1106:    } @$storearr;
1.12      www      1107:    return %returnhash;
                   1108: }
                   1109: 
1.103     harris41 1110: # ------------------------------------------------- Check for a user privilege
1.12      www      1111: 
                   1112: sub allowed {
                   1113:     my ($priv,$uri)=@_;
1.152     www      1114: 
                   1115:     my $orguri=$uri;
1.52      www      1116:     $uri=&declutter($uri);
1.29      www      1117: 
1.54      www      1118: # Free bre access to adm and meta resources
1.29      www      1119: 
1.54      www      1120:     if ((($uri=~/^adm\//) || ($uri=~/\.meta$/)) && ($priv eq 'bre')) {
1.14      www      1121: 	return 'F';
                   1122:     }
1.29      www      1123: 
1.52      www      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:     }
1.29      www      1133: 
1.52      www      1134: # Domain
                   1135: 
                   1136:     if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.(split(/\//,$uri))[0].'/'}
                   1137:        =~/$priv\&([^\:]*)/) {
1.12      www      1138:        $thisallowed.=$1;
                   1139:     }
1.52      www      1140: 
                   1141: # Course: uri itself is a course
1.66      www      1142:     my $courseuri=$uri;
                   1143:     $courseuri=~s/\_(\d)/\/$1/;
1.83      www      1144:     $courseuri=~s/^([^\/])/\/$1/;
1.81      www      1145: 
1.83      www      1146:     if ($ENV{'user.priv.'.$ENV{'request.role'}.'.'.$courseuri}
1.52      www      1147:        =~/$priv\&([^\:]*)/) {
1.12      www      1148:        $thisallowed.=$1;
                   1149:     }
1.29      www      1150: 
1.52      www      1151: # Full access at system, domain or course-wide level? Exit.
1.29      www      1152: 
                   1153:     if ($thisallowed=~/F/) {
                   1154: 	return 'F';
                   1155:     }
                   1156: 
1.52      www      1157: # If this is generating or modifying users, exit with special codes
1.29      www      1158: 
1.52      www      1159:     if (':csu:cdc:ccc:cin:cta:cep:ccr:cst:cad:cli:cau:cdg:'=~/\:$priv\:/) {
                   1160: 	return $thisallowed;
                   1161:     }
                   1162: #
1.103     harris41 1163: # Gathered so far: system, domain and course wide privileges
1.52      www      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}=~
1.54      www      1180:            /\&$filename\:([\d\|]+)\&/) {
1.52      www      1181:            $statecond=$1;
                   1182:            if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.$courseprivid}
                   1183:                =~/$priv\&([^\:]*)/) {
                   1184:                $thisallowed.=$1;
                   1185:                $checkreferer=0;
                   1186:            }
1.29      www      1187:        }
1.83      www      1188:        
1.148     www      1189:        if ($checkreferer) {
1.152     www      1190: 	  my $refuri=$ENV{'httpref.'.$orguri};
1.148     www      1191: 
                   1192:             unless ($refuri) {
                   1193:                 map {
                   1194: 		    if ($_=~/^httpref\..*\*/) {
                   1195: 			my $pattern=$_;
                   1196:                         $pattern=~s/\*/\[\^\/\]\+/g;
                   1197:                         $pattern=~s/\//\\\//g;
1.152     www      1198:                         if ($orguri=~/$pattern/) {
1.148     www      1199: 			    $refuri=$ENV{$_};
                   1200:                         }
                   1201:                     }
                   1202:                 } keys %ENV;
                   1203:             }
                   1204:          if ($refuri) { 
1.152     www      1205: 	  $refuri=&declutter($refuri);
1.53      www      1206:           my @uriparts=split(/\//,$refuri);
1.52      www      1207:           my $filename=$uriparts[$#uriparts];
1.53      www      1208:           my $pathname=$refuri;
1.52      www      1209:           $pathname=~s/\/$filename$//;
1.53      www      1210:             if ($ENV{'acc.res.'.$ENV{'request.course.id'}.'.'.$pathname}=~
1.54      www      1211:               /\&$filename\:([\d\|]+)\&/) {
1.53      www      1212:               my $refstatecond=$1;
1.52      www      1213:               if ($ENV{'user.priv.'.$ENV{'request.role'}.'./'.$courseprivid}
                   1214:                   =~/$priv\&([^\:]*)/) {
                   1215:                   $thisallowed.=$1;
1.53      www      1216:                   $uri=$refuri;
                   1217:                   $statecond=$refstatecond;
1.52      www      1218:               }
                   1219:           }
1.148     www      1220:         }
1.29      www      1221:        }
1.52      www      1222:    }
1.29      www      1223: 
1.52      www      1224: #
1.103     harris41 1225: # Gathered now: all privileges that could apply, and condition number
1.52      www      1226: # 
                   1227: #
                   1228: # Full or no access?
                   1229: #
1.29      www      1230: 
1.52      www      1231:     if ($thisallowed=~/F/) {
                   1232: 	return 'F';
                   1233:     }
1.29      www      1234: 
1.52      www      1235:     unless ($thisallowed) {
                   1236:         return '';
                   1237:     }
1.29      www      1238: 
1.52      www      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
1.54      www      1248: # Locks might take effect only after 10 minutes cache expiration for other
                   1249: # courses, and 2 minutes for current course
1.52      www      1250: 
                   1251:     my $envkey;
                   1252:     if ($thisallowed=~/L/) {
                   1253:         foreach $envkey (keys %ENV) {
1.54      www      1254:            if ($envkey=~/^user\.role\.(st|ta)\.([^\.]*)/) {
                   1255:                my $courseid=$2;
                   1256:                my $roleid=$1.'.'.$2;
1.92      www      1257:                $courseid=~s/^\///;
1.54      www      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) {
1.57      www      1270:                        &log($ENV{'user.domain'},$ENV{'user.name'},
                   1271:                             $ENV{'user.host'},
                   1272:                             'Locked by res: '.$priv.' for '.$uri.' due to '.
1.52      www      1273:                             $cdom.'/'.$cnum.'/'.$csec.' expire '.
1.54      www      1274:                             $ENV{$prefix.'priv.'.$priv.'.lock.expire'});
1.52      www      1275: 		       return '';
                   1276:                    }
                   1277:                }
1.54      www      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) {
1.57      www      1281:                        &log($ENV{'user.domain'},$ENV{'user.name'},
                   1282:                             $ENV{'user.host'},
                   1283:                             'Locked by priv: '.$priv.' for '.$uri.' due to '.
1.52      www      1284:                             $cdom.'/'.$cnum.'/'.$csec.' expire '.
1.54      www      1285:                             $ENV{$prefix.'priv.'.$priv.'.lock.expire'});
1.52      www      1286: 		       return '';
                   1287:                    }
                   1288:                }
                   1289: 	   }
1.29      www      1290:        }
1.52      www      1291:     }
                   1292:    
                   1293: #
                   1294: # Rest of the restrictions depend on selected course
                   1295: #
                   1296: 
                   1297:     unless ($ENV{'request.course.id'}) {
                   1298:        return '1';
                   1299:     }
1.29      www      1300: 
1.52      www      1301: #
                   1302: # Now user is definitely in a course
                   1303: #
1.53      www      1304: 
                   1305: 
                   1306: # Course preferences
                   1307: 
                   1308:    if ($thisallowed=~/C/) {
1.54      www      1309:        my $rolecode=(split(/\./,$ENV{'request.role'}))[0];
                   1310:        if ($ENV{'course.'.$ENV{'request.course.id'}.'.'.$priv.'.roles.denied'}
                   1311: 	   =~/\,$rolecode\,/) {
1.57      www      1312:            &log($ENV{'user.domain'},$ENV{'user.name'},$ENV{'user.host'},
                   1313:                 'Denied by role: '.$priv.' for '.$uri.' as '.$rolecode.' in '.
1.54      www      1314:                 $ENV{'request.course.id'});
                   1315:            return '';
                   1316:        }
1.53      www      1317:    }
                   1318: 
                   1319: # Resource preferences
                   1320: 
                   1321:    if ($thisallowed=~/R/) {
1.54      www      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\>/) {
1.57      www      1332: 	       &log($ENV{'user.domain'},$ENV{'user.name'},$ENV{'user.host'},
                   1333:                     'Denied by role: '.$priv.' for '.$uri.' as '.$rolecode);
1.54      www      1334:            return '';
                   1335: 
                   1336:            }
                   1337:        }
1.53      www      1338:    }
1.30      www      1339: 
1.52      www      1340: # Restricted by state?
1.30      www      1341: 
1.52      www      1342:    if ($thisallowed=~/X/) {
                   1343:       if (&condval($statecond)) {
                   1344: 	 return '2';
                   1345:       } else {
                   1346:          return '';
                   1347:       }
                   1348:    }
1.30      www      1349: 
1.52      www      1350:    return 'F';
1.12      www      1351: }
                   1352: 
                   1353: # ----------------------------------------------------------------- Define Role
                   1354: 
                   1355: sub definerole {
                   1356:   if (allowed('mcr','/')) {
                   1357:     my ($rolename,$sysrole,$domrole,$courole)=@_;
1.21      www      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);
1.12      www      1385:     my $command="encrypt:rolesput:$ENV{'user.domain'}:$ENV{'user.name'}:".
                   1386:                 "$ENV{'user.domain'}:$ENV{'user.name'}:".
1.21      www      1387: 	        "rolesdef_$rolename=".
                   1388:                 escape($sysrole.'_'.$domrole.'_'.$courole);
1.12      www      1389:     return reply($command,$ENV{'user.home'});
                   1390:   } else {
                   1391:     return 'refused';
                   1392:   }
1.105     harris41 1393: }
                   1394: 
                   1395: # ---------------- Make a metadata query against the network of library servers
                   1396: 
                   1397: sub metadata_query {
1.116     harris41 1398:     my ($query,$custom,$customshow)=@_;
1.118     harris41 1399:     # need to put in a library server loop here and return a hash
1.120     harris41 1400:     my %rhash;
1.123     harris41 1401:     for my $server (keys %libserv) {
1.118     harris41 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: 	}
1.112     harris41 1412:     }
1.118     harris41 1413:     return \%rhash;
1.12      www      1414: }
                   1415: 
                   1416: # ------------------------------------------------------------------ Plain Text
                   1417: 
                   1418: sub plaintext {
1.22      www      1419:     my $short=shift;
                   1420:     return $prp{$short};
1.12      www      1421: }
                   1422: 
1.25      www      1423: # ------------------------------------------------------------------ Plain Text
                   1424: 
                   1425: sub fileembstyle {
                   1426:     my $ending=shift;
                   1427:     return $fe{$ending};
                   1428: }
                   1429: 
                   1430: # ------------------------------------------------------------ Description Text
                   1431: 
1.74      www      1432: sub filedescription {
1.25      www      1433:     my $ending=shift;
                   1434:     return $fd{$ending};
                   1435: }
                   1436: 
1.12      www      1437: # ----------------------------------------------------------------- Assign Role
                   1438: 
                   1439: sub assignrole {
1.21      www      1440:     my ($udom,$uname,$url,$role,$end,$start)=@_;
                   1441:     my $mrole;
                   1442:     if ($role =~ /^cr\//) {
1.104     www      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:         }
1.21      www      1449:         $mrole='cr';
                   1450:     } else {
1.82      www      1451:         my $cwosec=$url;
1.83      www      1452:         $cwosec=~s/^\/(\w+)\/(\w+)\/.*/$1\/$2/;
1.104     www      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:         }
1.21      www      1459:         $mrole=$role;
                   1460:     }
                   1461:     my $command="encrypt:rolesput:$ENV{'user.domain'}:$ENV{'user.name'}:".
                   1462:                 "$udom:$uname:$url".'_'."$mrole=$role";
1.81      www      1463:     if ($end) { $command.='_'.$end; }
1.21      www      1464:     if ($start) {
                   1465: 	if ($end) { 
1.81      www      1466:            $command.='_'.$start; 
1.21      www      1467:         } else {
1.81      www      1468:            $command.='_0_'.$start;
1.21      www      1469:         }
                   1470:     }
                   1471:     return &reply($command,&homeserver($uname,$udom));
1.80      www      1472: }
                   1473: 
1.81      www      1474: # --------------------------------------------------------------- Modify a user
1.80      www      1475: 
                   1476: 
1.81      www      1477: sub modifyuser {
1.80      www      1478:     my ($udom,$uname,$uid,$umode,$upass,$first,$middle,$last,$gene)=@_;
1.81      www      1479:     &logthis('Call to modify user '.$udom.', '.$uname.', '.$uid.', '.
1.80      www      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
1.81      www      1485:     if (($uhome eq 'no_host') && ($umode) && ($upass)) {
1.80      www      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;
1.81      www      1491:             my $loadm=10000000;
1.80      www      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
1.134     albertel 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; }
1.81      www      1537:     &logthis('Success modifying user '.$udom.', '.$uname.', '.$uid.', '.
1.80      www      1538:              $umode.', '.$first.', '.$middle.', '.
                   1539: 	     $last.', '.$gene.' by '.
                   1540:              $ENV{'user.name'}.' at '.$ENV{'user.domain'});
1.134     albertel 1541:     return 'ok';
1.80      www      1542: }
                   1543: 
1.81      www      1544: # -------------------------------------------------------------- Modify student
1.80      www      1545: 
1.81      www      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'}) {
1.80      www      1551: 	return 'not_in_class';
                   1552:     }
                   1553: # --------------------------------------------------------------- Make the user
1.81      www      1554:     my $reply=&modifyuser
1.80      www      1555: 	($udom,$uname,$uid,$umode,$upass,$first,$middle,$last,$gene);
                   1556:     unless ($reply eq 'ok') { return $reply; }
1.81      www      1557:     my $uhome=&homeserver($uname,$udom);
                   1558:     if (($uhome eq '') || ($uhome eq 'no_host')) { 
                   1559: 	return 'error: no such user';
                   1560:     }
1.80      www      1561: # -------------------------------------------------- Add student to course list
1.81      www      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:     }
1.80      www      1570: # ---------------------------------------------------- Add student role to user
1.83      www      1571:     my $uurl='/'.$cid;
1.81      www      1572:     $uurl=~s/\_/\//g;
                   1573:     if ($usec) {
                   1574: 	$uurl.='/'.$usec;
                   1575:     }
                   1576:     return &assignrole($udom,$uname,$uurl,'st',$end,$start);
1.21      www      1577: }
                   1578: 
1.84      www      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: 
1.21      www      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);
1.17      www      1659: }
                   1660: 
                   1661: # ------------------------------------------------------------ Directory lister
                   1662: 
                   1663: sub dirlist {
                   1664:     my $uri=shift;
1.18      www      1665:     $uri=~s/^\///;
                   1666:     $uri=~s/\/$//;
1.19      www      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:    }
1.26      www      1709: }
                   1710: 
                   1711: # -------------------------------------------------------- Value of a Condition
                   1712: 
1.40      www      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: 
1.26      www      1722: sub condval {
                   1723:     my $condidx=shift;
                   1724:     my $result=0;
1.54      www      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/\|$//;
1.33      www      1733:     if ($ENV{'request.course.id'}) {
1.54      www      1734:        if ($allpathcond) {
1.26      www      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 {
1.40      www      1750:                   my $new=directcondval($_);
1.26      www      1751:                   if ($operand eq '&') {
                   1752:                      $result=$result>$new?$new:$result;
                   1753:                   } else {
                   1754:                      $result=$result>$new?$result:$new;
                   1755:                   }                  
                   1756:               }
1.54      www      1757:           } ($allpathcond=~/(\d+|\(|\)|\&|\|)/g);
1.26      www      1758:        }
                   1759:     }
                   1760:     return $result;
1.28      www      1761: }
                   1762: 
                   1763: # --------------------------------------------------------- Value of a Variable
                   1764: 
1.58      www      1765: sub EXT {
1.147     www      1766:     my ($varname,$symbparm)=@_;
1.68      www      1767:     unless ($varname) { return ''; }
1.48      www      1768:     my ($realm,$space,$qualifier,@therest)=split(/\./,$varname);
                   1769:     my $rest;
                   1770:     if ($therest[0]) {
                   1771:        $rest=join('.',@therest);
                   1772:     } else {
                   1773:        $rest='';
                   1774:     }
1.57      www      1775:     my $qualifierrest=$qualifier;
                   1776:     if ($rest) { $qualifierrest.='.'.$rest; }
                   1777:     my $spacequalifierrest=$space;
                   1778:     if ($qualifierrest) { $spacequalifierrest.='.'.$qualifierrest; }
1.28      www      1779:     if ($realm eq 'user') {
1.48      www      1780: # --------------------------------------------------------------- user.resource
                   1781: 	if ($space eq 'resource') {
1.122     albertel 1782: 	    my %restored=&restore();
1.57      www      1783:             return $restored{$qualifierrest};
1.48      www      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')) {
1.57      www      1789:             return $ENV{join('.',('environment',$qualifierrest))};
1.48      www      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
1.29      www      1808:         } else {
1.48      www      1809:             my $item=($rest)?$qualifier.'.'.$rest:$qualifier;
1.131     albertel 1810:             my %reply=&get($space,[$item]);
1.48      www      1811:             return $reply{$item};
                   1812:         }
                   1813:     } elsif ($realm eq 'request') {
                   1814: # ------------------------------------------------------------- request.browser
                   1815:         if ($space eq 'browser') {
                   1816: 	    return $ENV{'browser.'.$qualifier};
1.57      www      1817: # ------------------------------------------------------------ request.filename
                   1818:         } else {
                   1819:             return $ENV{'request.'.$spacequalifierrest};
1.29      www      1820:         }
1.28      www      1821:     } elsif ($realm eq 'course') {
1.48      www      1822: # ---------------------------------------------------------- course.description
1.127     ng       1823:         return $ENV{'course.'.$ENV{'request.course.id'}.'.'.
1.57      www      1824:                               $spacequalifierrest};
                   1825:     } elsif ($realm eq 'resource') {
1.127     ng       1826:        if ($ENV{'request.course.id'}) {
1.145     www      1827: 
                   1828: #	   print '<br>'.$space.' - '.$qualifier.' - '.$spacequalifierrest;
                   1829: 
                   1830: 
1.60      www      1831: # ----------------------------------------------------- Cascading lookup scheme
1.147     www      1832:          my $symbp;
                   1833:          if ($symbparm) {
                   1834:             $symbp=$symbparm;
                   1835: 	 } else {
                   1836:             $symbp=&symbread();
                   1837:          }            
1.127     ng       1838:          my $mapp=(split(/\_\_\_/,$symbp))[0];
1.69      www      1839: 
1.127     ng       1840:          my $symbparm=$symbp.'.'.$spacequalifierrest;
                   1841:          my $mapparm=$mapp.'___(all).'.$spacequalifierrest;
1.69      www      1842: 
1.127     ng       1843:          my $seclevel=
1.69      www      1844:             $ENV{'request.course.id'}.'.['.
                   1845: 		$ENV{'request.course.sec'}.'].'.$spacequalifierrest;
1.127     ng       1846:          my $seclevelr=
1.69      www      1847:             $ENV{'request.course.id'}.'.['.
                   1848: 		$ENV{'request.course.sec'}.'].'.$symbparm;
1.127     ng       1849:          my $seclevelm=
1.69      www      1850:             $ENV{'request.course.id'}.'.['.
                   1851: 		$ENV{'request.course.sec'}.'].'.$mapparm;
                   1852: 
1.127     ng       1853:          my $courselevel=
1.60      www      1854:             $ENV{'request.course.id'}.'.'.$spacequalifierrest;
1.127     ng       1855:          my $courselevelr=
1.69      www      1856:             $ENV{'request.course.id'}.'.'.$symbparm;
1.127     ng       1857:          my $courselevelm=
1.69      www      1858:             $ENV{'request.course.id'}.'.'.$mapparm;
                   1859: 
1.60      www      1860: # ----------------------------------------------------------- first, check user
1.127     ng       1861:          my %resourcedata=get('resourcedata',
1.131     albertel 1862:                            [$courselevelr,$courselevelm,$courselevel]);
1.127     ng       1863:          if (($resourcedata{$courselevelr}!~/^error\:/) &&
                   1864:              ($resourcedata{$courselevelr}!~/^con_lost/)) {
1.69      www      1865: 
1.127     ng       1866:          if ($resourcedata{$courselevelr}) { 
                   1867:             return $resourcedata{$courselevelr}; }
                   1868:          if ($resourcedata{$courselevelm}) { 
                   1869:             return $resourcedata{$courselevelm}; }
                   1870:          if ($resourcedata{$courselevel}) { return $resourcedata{$courselevel}; }
1.69      www      1871: 
1.94      www      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: 	  }
1.63      www      1879:       }
1.95      www      1880: 
1.60      www      1881: # -------------------------------------------------------- second, check course
1.96      www      1882: 
1.60      www      1883:         my $reply=&reply('get:'.
1.96      www      1884:               $ENV{'course.'.$ENV{'request.course.id'}.'.domain'}.':'.
                   1885:               $ENV{'course.'.$ENV{'request.course.id'}.'.num'}.
1.79      www      1886: 	      ':resourcedata:'.
                   1887:    &escape($seclevelr).'&'.&escape($seclevelm).'&'.&escape($seclevel).'&'.
                   1888:    &escape($courselevelr).'&'.&escape($courselevelm).'&'.&escape($courselevel),
1.96      www      1889: 		   $ENV{'course.'.$ENV{'request.course.id'}.'.home'});
1.63      www      1890:       if ($reply!~/^error\:/) {
1.79      www      1891: 	  map {
                   1892: 	      if ($_) { return &unescape($_); }
                   1893:           } split(/\&/,$reply);
1.63      www      1894:       }
1.94      www      1895:       if (($reply=~/^con_lost/) || ($reply=~/^error\:/)) {
                   1896: 	  &logthis("<font color=blue>WARNING:".
1.95      www      1897:                 " Getting ".$reply." asking for ".$varname." for ".
1.96      www      1898:                 $ENV{'course.'.$ENV{'request.course.id'}.'.num'}.
1.95      www      1899:                 ' at '.
1.96      www      1900:                 $ENV{'course.'.$ENV{'request.course.id'}.'.domain'}.
1.95      www      1901:                 ' from '.
1.96      www      1902:                 $ENV{'course.'.$ENV{'request.course.id'}.'.home'}.
1.94      www      1903:                  "</font>");
                   1904:       }
1.60      www      1905: # ------------------------------------------------------ third, check map parms
1.65      www      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);
1.60      www      1912:        }
1.65      www      1913:        if ($thisparm) { return $thisparm; }
1.60      www      1914:      }
                   1915:      
                   1916: # --------------------------------------------- last, look in resource metadata
1.71      www      1917: 
1.78      www      1918:       $spacequalifierrest=~s/\./\_/;
1.71      www      1919:       my $metadata=&metadata($ENV{'request.filename'},$spacequalifierrest);
                   1920:       if ($metadata) { return $metadata; }
1.78      www      1921:       $metadata=&metadata($ENV{'request.filename'},
                   1922:                                          'parameter_'.$spacequalifierrest);
                   1923:       if ($metadata) { return $metadata; }
1.142     www      1924: 
1.145     www      1925: # ------------------------------------------------------------------ Cascade up
                   1926: 
                   1927:       unless ($space eq '0') {
                   1928:           my ($part,$id)=split(/\_/,$space);
                   1929:           if ($id) {
1.147     www      1930: 	      my $partgeneral=&EXT('resource.'.$part.'.'.$qualifierrest,
                   1931:                                    $symbparm);
1.145     www      1932:               if ($partgeneral) { return $partgeneral; }
                   1933:           } else {
1.147     www      1934:               my $resourcegeneral=&EXT('resource.0.'.$qualifierrest,
                   1935:                                        $symbparm);
1.145     www      1936:               if ($resourcegeneral) { return $resourcegeneral; }
                   1937:           }
                   1938:       }
1.71      www      1939: 
1.48      www      1940: # ---------------------------------------------------- Any other user namespace
                   1941:     } elsif ($realm eq 'environment') {
                   1942: # ----------------------------------------------------------------- environment
1.127     ng       1943:         return $ENV{'environment.'.$spacequalifierrest};
1.28      www      1944:     } elsif ($realm eq 'system') {
1.48      www      1945: # ----------------------------------------------------------------- system.time
                   1946: 	if ($space eq 'time') {
                   1947: 	    return time;
                   1948:         }
1.28      www      1949:     }
1.48      www      1950:     return '';
1.61      www      1951: }
                   1952: 
1.71      www      1953: # ---------------------------------------------------------------- Get metadata
                   1954: 
                   1955: sub metadata {
                   1956:     my ($uri,$what)=@_;
1.78      www      1957: 
1.71      www      1958:     $uri=&declutter($uri);
1.73      www      1959:     my $filename=$uri;
                   1960:     $uri=~s/\.meta$//;
1.71      www      1961:     unless ($metacache{$uri.':keys'}) {
1.140     www      1962:         my %metathesekeys=();
1.73      www      1963:         unless ($filename=~/\.meta$/) { $filename.='.meta'; }
                   1964: 	my $metastring=&getfile($perlvar{'lonDocRoot'}.'/res/'.$filename);
1.71      www      1965:         my $parser=HTML::TokeParser->new(\$metastring);
                   1966:         my $token;
1.140     www      1967:         undef %metathesekeys;
1.71      www      1968:         while ($token=$parser->get_token) {
                   1969:            if ($token->[0] eq 'S') {
1.135     www      1970: 	     if (defined($token->[2]->{'package'})) {
1.136     www      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: 	      }
1.137     www      1984:               map {
                   1985: 		  if ($_=~/^$package\&/) {
                   1986: 		      my ($pack,$name,$subp)=split(/\&/,$_);
1.139     www      1987:                       my $value=$packagetab{$_};
1.144     www      1988: 		      my $part=$keyroot;
                   1989:                       $part=~s/^\_//;
1.139     www      1990:                       if ($subp eq 'display') {
                   1991: 			  $value.=' [Part: '.$part.']';
                   1992:                       }
                   1993:                       my $unikey='parameter'.$keyroot.'_'.$name;
1.140     www      1994:                       $metathesekeys{$unikey}=1;
1.144     www      1995:                       $metacache{$uri.':'.$unikey.'.part'}=$part;
1.141     www      1996:                       unless 
                   1997:                        (defined($metacache{$uri.':'.$unikey.'.'.$subp})) {
                   1998:                          $metacache{$uri.':'.$unikey.'.'.$subp}=$value;
                   1999: 		      }
1.137     www      2000:                   }
                   2001:               } keys %packagetab;
1.135     www      2002:              } else {
1.71      www      2003: 	      my $entry=$token->[1];
                   2004:               my $unikey=$entry;
1.72      www      2005:               if (defined($token->[2]->{'part'})) { 
1.71      www      2006:                  $unikey.='_'.$token->[2]->{'part'}; 
1.136     www      2007: 	      }
                   2008:               if (defined($token->[2]->{'id'})) { 
                   2009:                  $unikey.='_'.$token->[2]->{'id'}; 
1.71      www      2010: 	      }
1.72      www      2011:               if (defined($token->[2]->{'name'})) { 
1.71      www      2012:                  $unikey.='_'.$token->[2]->{'name'}; 
                   2013: 	      }
1.140     www      2014:               $metathesekeys{$unikey}=1;
1.71      www      2015:               map {
                   2016: 		  $metacache{$uri.':'.$unikey.'.'.$_}=$token->[2]->{$_};
1.72      www      2017:               } @{$token->[3]};
1.78      www      2018:               unless (
                   2019:                  $metacache{$uri.':'.$unikey}=$parser->get_text('/'.$entry)
                   2020: 		      ) { $metacache{$uri.':'.$unikey}=
                   2021: 			      $metacache{$uri.':'.$unikey.'.default'};
                   2022: 		      }
1.135     www      2023: 	    }
1.140     www      2024: 	 }
1.71      www      2025:        }
1.140     www      2026:        $metacache{$uri.':keys'}=join(',',keys %metathesekeys);
1.71      www      2027:     }
                   2028:     return $metacache{$uri.':'.$what};
                   2029: }
                   2030: 
1.31      www      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 {
1.44      www      2054:     my $thisfn=shift;
                   2055:     unless ($thisfn) {
                   2056: 	$thisfn=$ENV{'request.filename'};
                   2057:     }
                   2058:     $thisfn=declutter($thisfn);
1.31      www      2059:     my %hash;
1.37      www      2060:     my %bighash;
                   2061:     my $syval='';
1.45      www      2062:     if (($ENV{'request.course.fn'}) && ($thisfn)) {
1.31      www      2063:         if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db',
                   2064:                       &GDBM_READER,0640)) {
                   2065: 	    $syval=$hash{$thisfn};
1.37      www      2066:             untie(%hash);
                   2067:         }
                   2068: # ---------------------------------------------------------- There was an entry
                   2069:         if ($syval) {
                   2070:            unless ($syval=~/\_\d+$/) {
                   2071: 	       unless ($ENV{'form.request.prefix'}=~/\.(\d+)\_$/) {
1.44      www      2072:                   &appenv('request.ambiguous' => $thisfn);
1.37      www      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};
1.65      www      2083:               unless ($ids) { 
                   2084:                  $ids=$bighash{'ids_/'.$thisfn};
                   2085:               }
1.37      www      2086:               if ($ids) {
                   2087: # ------------------------------------------------------------------- Has ID(s)
                   2088:                  my @possibilities=split(/\,/,$ids);
1.39      www      2089:                  if ($#possibilities==0) {
                   2090: # ----------------------------------------------- There is only one possibility
1.37      www      2091: 		     my ($mapid,$resid)=split(/\./,$ids);
                   2092:                      $syval=declutter($bighash{'map_id_'.$mapid}).'___'.$resid;
                   2093:                  } else {
1.39      www      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=''; }
1.37      www      2108:                  }
                   2109: 	      }
                   2110:               untie(%bighash)
                   2111:            } 
1.31      www      2112:         }
1.62      www      2113:         if ($syval) {
                   2114:            return $syval.'___'.$thisfn; 
                   2115:         }
1.31      www      2116:     }
1.44      www      2117:     &appenv('request.ambiguous' => $thisfn);
1.31      www      2118:     return '';
                   2119: }
                   2120: 
                   2121: # ---------------------------------------------------------- Return random seed
                   2122: 
1.32      www      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: 
1.31      www      2135: sub rndseed {
                   2136:     my $symb;
1.44      www      2137:     unless ($symb=&symbread()) { return time; }
1.98      albertel 2138:     { 
                   2139:       use integer;
                   2140:       my $symbchck=unpack("%32C*",$symb) << 27;
1.100     albertel 2141:       my $symbseed=numval($symb) << 22;
1.98      albertel 2142:       my $namechck=unpack("%32C*",$ENV{'user.name'}) << 17;
1.100     albertel 2143:       my $nameseed=numval($ENV{'user.name'}) << 12;
1.98      albertel 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;
1.99      albertel 2147:       #uncommenting these lines can break things!
                   2148:       #&Apache::lonxml::debug("$symbseed:$nameseed;$domainseed|$courseseed;$namechck:$symbchck");
                   2149:       #&Apache::lonxml::debug("rndseed :$num:$symb");
1.98      albertel 2150:       return $num;
                   2151:     }
1.36      albertel 2152: }
                   2153: 
1.76      www      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);
1.77      www      2160:     my $cunique=unpack("%32C*",$perlvar{'lonReceipt'});
1.76      www      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:   
1.36      albertel 2175: # ------------------------------------------------------------ Serves up a file
                   2176: # returns either the contents of the file or a -1
                   2177: sub getfile {
                   2178:   my $file=shift;
1.37      www      2179:   &repcopy($file);
1.36      albertel 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
1.59      albertel 2191:   if ($file=~m:^/~:) { # is a contruction space reference
                   2192:     $location = $file;
                   2193:     $location =~ s:/~(.*?)/(.*):/home/$1/public_html/$2:;
1.36      albertel 2194:   } else {
1.59      albertel 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:     }
1.36      albertel 2202:   }
                   2203:   $location=~s://+:/:g; # remove duplicate /
1.46      www      2204:   while ($location=~m:/\.\./:) {$location=~ s:/[^/]+/\.\./:/:g;} #remove dir/..
                   2205:   return $location;
                   2206: }
1.36      albertel 2207: 
1.46      www      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:     }
1.31      www      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;
1.12      www      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: }
1.11      www      2244: 
1.1       albertel 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);
1.8       www      2256:            chomp($varvalue);
1.1       albertel 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;
1.150     www      2270:        $hostip{$id}=$ip;
1.1       albertel 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: }
1.11      www      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; }
1.135     www      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);
1.143     www      2315:        my ($pack,$name)=split(/\&/,$short);
                   2316:        if ($plain ne '') {
                   2317:           $packagetab{$pack.'&'.$name.'&name'}=$name; 
                   2318:           $packagetab{$short}=$plain; 
                   2319:        }
1.25      www      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:        }
1.11      www      2334:     }
                   2335: }
                   2336: 
1.71      www      2337: %metacache=();
1.22      www      2338: 
1.1       albertel 2339: $readit='done';
1.12      www      2340: &logthis('<font color=yellow>INFO: Read configuration</font>');
1.1       albertel 2341: }
                   2342: }
                   2343: 1;

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