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

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

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