[BACK]Return to lonnet.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / lonnet / perl

Diff for /loncom/lonnet/perl/lonnet.pm between versions 1.25 and 1.50

version 1.25, 2000/08/28 22:21:24 version 1.50, 2000/10/26 10:40:01
Line 6 Line 6
 # plaintext(short)   : plain text explanation of short term  # plaintext(short)   : plain text explanation of short term
 # fileembstyle(ext)  : embed style in page for file extension  # fileembstyle(ext)  : embed style in page for file extension
 # filedescription(ext) : descriptor text for file extension  # filedescription(ext) : descriptor text for file extension
 # allowed(short,url) : returns codes for allowed actions F,R,S,C  # allowed(short,url) : returns codes for allowed actions 
   #                      F: full access
   #                      U,I,K: authentication modes (cxx only)
   #                      '': forbidden
   #                      1: user needs to choose course
   #                      2: browse allowed
 # definerole(rolename,sys,dom,cou) : define a custom role rolename  # definerole(rolename,sys,dom,cou) : define a custom role rolename
 #                      set priviledges in format of lonTabs/roles.tab for  #                      set priviledges in format of lonTabs/roles.tab for
 #                      system, domain and course level,   #                      system, domain and course level, 
Line 20 Line 25
 # revokecustomrole (udom,uname,url,rdom,rnam,rolename) : Revoke a custom role  # revokecustomrole (udom,uname,url,rdom,rnam,rolename) : Revoke a custom role
 # appenv(hash)       : adds hash to session environment  # appenv(hash)       : adds hash to session environment
 # store(hash)        : stores hash permanently for this url  # store(hash)        : stores hash permanently for this url
   # cstore(hash)       : critical store
 # restore            : returns hash for this url  # restore            : returns hash for this url
 # eget(namesp,array) : returns hash with keys from array filled in from namesp  # eget(namesp,array) : returns hash with keys from array filled in from namesp
 # get(namesp,array)  : returns hash with keys from array filled in from namesp  # get(namesp,array)  : returns hash with keys from array filled in from namesp
   # del(namesp,array)  : deletes keys out of array from namesp
 # put(namesp,hash)   : stores hash in namesp  # put(namesp,hash)   : stores hash in namesp
   # cput(namesp,hash)  : critical put
 # dump(namesp)       : dumps the complete namespace into a hash  # dump(namesp)       : dumps the complete namespace into a hash
 # ssi(url,hash)      : does a complete request cycle on url to localhost, posts  # ssi(url,hash)      : does a complete request cycle on url to localhost, posts
 #                      hash  #                      hash
   # coursedescription(id) : returns and caches course description for id
 # repcopy(filename)  : replicate file  # repcopy(filename)  : replicate file
 # dirlist(url)       : gets a directory listing  # dirlist(url)       : gets a directory listing
   # directcondval(index) : reading condition value of single condition from 
   #                        state string
   # condval(index)     : value of condition index based on state
   # varval(name)       : value of a variable
   # refreshstate()     : refresh the state information string
   # symblist(map,hash) : Updates symbolic storage links
   # symbread([filename]) : returns the data handle (filename optional)
   # rndseed()          : returns a random seed  
   # getfile(filename)  : returns the contents of filename, or a -1 if it can't
   #                      be found, replicates and subscribes to the file
   # filelocation(dir,file) : returns a farily clean absolute reference to file 
   #                          from the directory dir
   # hreflocation(dir,file) : same as filelocation, but for hrefs
   # log(domain,user,home,msg) : write to permanent log for user
 #  #
 # 6/1/99,6/2,6/10,6/11,6/12,6/14,6/26,6/28,6/29,6/30,  # 6/1/99,6/2,6/10,6/11,6/12,6/14,6/26,6/28,6/29,6/30,
 # 7/1,7/2,7/9,7/10,7/12,7/14,7/15,7/19,  # 7/1,7/2,7/9,7/10,7/12,7/14,7/15,7/19,
Line 40 Line 63
 # 06/26 Ben Tyszka  # 06/26 Ben Tyszka
 # 06/30,07/15,07/17,07/18,07/20,07/21,07/22,07/25 Gerd Kortemeyer  # 06/30,07/15,07/17,07/18,07/20,07/21,07/22,07/25 Gerd Kortemeyer
 # 08/14 Ben Tyszka  # 08/14 Ben Tyszka
 # 08/22,08/28 Gerd Kortemeyer  # 08/22,08/28,08/31,09/01,09/02,09/04,09/05,09/25,09/28,09/30 Gerd Kortemeyer
   # 10/04 Gerd Kortemeyer
   # 10/04 Guy Albertelli
   # 10/06,10/09,10/10,10/11,10/14,10/20,10/23,10/25,10/26 Gerd Kortemeyer
   
 package Apache::lonnet;  package Apache::lonnet;
   
Line 51  use HTTP::Headers; Line 77  use HTTP::Headers;
 use vars   use vars 
 qw(%perlvar %hostname %homecache %spareid %hostdom %libserv %pr %prp %fe %fd $readit);  qw(%perlvar %hostname %homecache %spareid %hostdom %libserv %pr %prp %fe %fd $readit);
 use IO::Socket;  use IO::Socket;
   use GDBM_File;
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
   
 # --------------------------------------------------------------------- Logging  # --------------------------------------------------------------------- Logging
Line 184  sub critical { Line 211  sub critical {
   
 sub appenv {  sub appenv {
     my %newenv=@_;      my %newenv=@_;
       map {
    if (($newenv{$_}=~/^user\.role/) || ($newenv{$_}=~/^user\.priv/)) {
               &logthis("<font color=blue>WARNING: ".
                   "Attempt to modify environment ".$_." to ".$newenv{$_});
       delete($newenv{$_});
           } else {
               $ENV{$_}=$newenv{$_};
           }
       } keys %newenv;
     my @oldenv;      my @oldenv;
     {      {
      my $fh;       my $fh;
Line 391  sub ssi { Line 427  sub ssi {
   
 sub log {  sub log {
     my ($dom,$nam,$hom,$what)=@_;      my ($dom,$nam,$hom,$what)=@_;
     return reply("log:$dom:$nam:$what",$hom);      return critical("log:$dom:$nam:$what",$hom);
 }  }
   
 # ----------------------------------------------------------------------- Store  # ----------------------------------------------------------------------- Store
   
 sub store {  sub store {
     my %storehash=shift;      my %storehash=@_;
       my $symb;
       unless ($symb=escape(&symbread())) { return ''; }
       my $namespace;
       unless ($namespace=$ENV{'request.course.id'}) { return ''; }
     my $namevalue='';      my $namevalue='';
     map {      map {
         $namevalue.=escape($_).'='.escape($storehash{$_}).'&';          $namevalue.=escape($_).'='.escape($storehash{$_}).'&';
     } keys %storehash;      } keys %storehash;
     $namevalue=~s/\&$//;      $namevalue=~s/\&$//;
     return reply("store:$ENV{'user.domain'}:$ENV{'user.name'}:"      return reply(
                ."$ENV{'user.class'}:$ENV{'request.filename'}:$namevalue",       "store:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb:$namevalue",
    "$ENV{'user.home'}");
   }
   
   # -------------------------------------------------------------- Critical Store
   
   sub cstore {
       my %storehash=@_;
       my $symb;
       unless ($symb=escape(&symbread())) { return ''; }
       my $namespace;
       unless ($namespace=$ENV{'request.course.id'}) { return ''; }
       my $namevalue='';
       map {
           $namevalue.=escape($_).'='.escape($storehash{$_}).'&';
       } keys %storehash;
       $namevalue=~s/\&$//;
       return critical(
        "store:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb:$namevalue",
  "$ENV{'user.home'}");   "$ENV{'user.home'}");
 }  }
   
 # --------------------------------------------------------------------- Restore  # --------------------------------------------------------------------- Restore
   
 sub restore {  sub restore {
     my $answer=reply("restore:$ENV{'user.domain'}:$ENV{'user.name'}:"      my $symb;
                ."$ENV{'user.class'}:$ENV{'request.filename'}",      unless ($symb=escape(&symbread())) { return ''; }
                 "$ENV{'user.home'}");      my $namespace;
       unless ($namespace=$ENV{'request.course.id'}) { return ''; }
       my $answer=reply(
                 "restore:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$symb",
                 "$ENV{'user.home'}");
     my %returnhash=();      my %returnhash=();
     map {      map {
  my ($name,$value)=split(/\=/,$_);   my ($name,$value)=split(/\=/,$_);
         $returnhash{&unescape($name)}=&unescape($value);          $returnhash{&unescape($name)}=&unescape($value);
     } split(/\&/,$answer);      } split(/\&/,$answer);
       map {
           $returnhash{$_}=$returnhash{$returnhash{'version'}.':'.$_};
       } split(/\:/,$returnhash{$returnhash{'version'}.':keys'});
     return %returnhash;      return %returnhash;
 }  }
   
   # ---------------------------------------------------------- Course Description
   
   sub coursedescription {
       my $courseid=shift;
       $courseid=~s/^\///;
       $courseid=~s/\_/\//g;
       my ($cdomain,$cnum)=split(/\//,$courseid);
       my $chome=homeserver($cnum,$cdomain);
       if ($chome ne 'no_host') {
          my $rep=reply("dump:$cdomain:$cnum:environment",$chome);
          if ($rep ne 'con_lost') {
      my %cachehash=();
              my %returnhash=('home'   => $chome, 
                              'domain' => $cdomain,
                              'num'    => $cnum);
              map {
                  my ($name,$value)=split(/\=/,$_);
                  $name=&unescape($name);
                  $value=&unescape($value);
                  $returnhash{$name}=$value;
                  if ($name eq 'description') {
      $cachehash{$courseid}=$value;
                  }
              } split(/\&/,$rep);
              $returnhash{'url'}='/res/'.declutter($returnhash{'url'});
              $returnhash{'fn'}=$perlvar{'lonDaemons'}.'/tmp/'.
          $ENV{'user.name'}.'_'.$cdomain.'_'.$cnum;
      put ('coursedescriptions',%cachehash);
              return %returnhash;
          }
       }
       return ();
   }
   
 # -------------------------------------------------------- Get user priviledges  # -------------------------------------------------------- Get user priviledges
   
 sub rolesinit {  sub rolesinit {
Line 453  sub rolesinit { Line 552  sub rolesinit {
                 }                  }
             }              }
             if (($area ne '') && ($trole ne '')) {              if (($area ne '') && ($trole ne '')) {
          my $spec=$trole.'.'.$area;
                my ($tdummy,$tdomain,$trest)=split(/\//,$area);                 my ($tdummy,$tdomain,$trest)=split(/\//,$area);
                if ($trole =~ /^cr\//) {                 if ($trole =~ /^cr\//) {
    my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$trole);     my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$trole);
Line 464  sub rolesinit { Line 564  sub rolesinit {
                       if (($roledef ne 'con_lost') && ($roledef ne '')) {                        if (($roledef ne 'con_lost') && ($roledef ne '')) {
                          my ($syspriv,$dompriv,$coursepriv)=                           my ($syspriv,$dompriv,$coursepriv)=
      split(/\_/,unescape($roledef));       split(/\_/,unescape($roledef));
                   $allroles{'/'}.=':'.$syspriv;                    $allroles{'cm./'}.=':'.$syspriv;
                            $allroles{$spec.'./'}.=':'.$syspriv;
                          if ($tdomain ne '') {                           if ($tdomain ne '') {
                              $allroles{'/'.$tdomain.'/'}.=':'.$dompriv;                               $allroles{'cm./'.$tdomain.'/'}.=':'.$dompriv;
                                $allroles{$spec.'./'.$tdomain.'/'}.=':'.$dompriv;
                              if ($trest ne '') {                               if ($trest ne '') {
                 $allroles{$area}.=':'.$coursepriv;                  $allroles{'cm.'.$area}.=':'.$coursepriv;
                   $allroles{$spec.'.'.$area}.=':'.$coursepriv;
                              }                               }
                  }                   }
                       }                        }
                    }                     }
                } else {                 } else {
            $allroles{'/'}.=':'.$pr{$trole.':s'};             $allroles{'cm./'}.=':'.$pr{$trole.':s'};
              $allroles{$spec.'./'}.=':'.$pr{$trole.':s'};
                    if ($tdomain ne '') {                     if ($tdomain ne '') {
                       $allroles{'/'.$tdomain.'/'}.=':'.$pr{$trole.':d'};                       $allroles{'cm./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
                        $allroles{$spec.'./'.$tdomain.'/'}.=':'.$pr{$trole.':d'};
                       if ($trest ne '') {                        if ($trest ne '') {
           $allroles{$area}.=':'.$pr{$trole.':c'};            $allroles{'cm.'.$area}.=':'.$pr{$trole.':c'};
             $allroles{$spec.'.'.$area}.=':'.$pr{$trole.':c'};
                       }                        }
            }             }
        }         }
Line 520  sub get { Line 626  sub get {
                  $ENV{'user.home'});                   $ENV{'user.home'});
    my @pairs=split(/\&/,$rep);     my @pairs=split(/\&/,$rep);
    my %returnhash=();     my %returnhash=();
      my $i=0;
    map {     map {
       my ($key,$value)=split(/=/,$_);        $returnhash{$_}=unescape($pairs[$i]);
       $returnhash{unespace($key)}=unescape($value);        $i++;
    } @pairs;     } @storearr;
    return %returnhash;     return %returnhash;
 }  }
   
   # --------------------------------------------------------------- del interface
   
   sub del {
      my ($namespace,@storearr)=@_;
      my $items='';
      map {
          $items.=escape($_).'&';
      } @storearr;
      $items=~s/\&$//;
      return reply("del:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
                    $ENV{'user.home'});
   }
   
 # -------------------------------------------------------------- dump interface  # -------------------------------------------------------------- dump interface
   
 sub dump {  sub dump {
Line 537  sub dump { Line 657  sub dump {
    my %returnhash=();     my %returnhash=();
    map {     map {
       my ($key,$value)=split(/=/,$_);        my ($key,$value)=split(/=/,$_);
       $returnhash{unespace($key)}=unescape($value);        $returnhash{unescape($key)}=unescape($value);
    } @pairs;     } @pairs;
    return %returnhash;     return %returnhash;
 }  }
Line 555  sub put { Line 675  sub put {
                  $ENV{'user.home'});                   $ENV{'user.home'});
 }  }
   
   # ------------------------------------------------------ critical put interface
   
   sub cput {
      my ($namespace,%storehash)=@_;
      my $items='';
      map {
          $items.=escape($_).'='.escape($storehash{$_}).'&';
      } keys %storehash;
      $items=~s/\&$//;
      return critical
              ("put:$ENV{'user.domain'}:$ENV{'user.name'}:$namespace:$items",
                    $ENV{'user.home'});
   }
   
 # -------------------------------------------------------------- eget interface  # -------------------------------------------------------------- eget interface
   
 sub eget {  sub eget {
Line 568  sub eget { Line 702  sub eget {
                  $ENV{'user.home'});                   $ENV{'user.home'});
    my @pairs=split(/\&/,$rep);     my @pairs=split(/\&/,$rep);
    my %returnhash=();     my %returnhash=();
      my $i=0;
    map {     map {
       my ($key,$value)=split(/=/,$_);        $returnhash{$_}=unescape($pairs[$i]);
       $returnhash{unespace($key)}=unescape($value);        $i++;
    } @pairs;     } @storearr;
    return %returnhash;     return %returnhash;
 }  }
   
Line 581  sub allowed { Line 716  sub allowed {
     my ($priv,$uri)=@_;      my ($priv,$uri)=@_;
     $uri=~s/^\/res//;      $uri=~s/^\/res//;
     $uri=~s/^\///;      $uri=~s/^\///;
     if ($uri=~/^adm\//) {  
   # Free bre access to adm resources
   
       if (($uri=~/^adm\//) && ($priv eq 'bre')) {
  return 'F';   return 'F';
     }      }
   
   # Gather priviledges over system and domain
   
     my $thisallowed='';      my $thisallowed='';
     if ($ENV{'user.priv./'}=~/$priv\&([^\:]*)/) {      if ($ENV{'user.priv./'}=~/$priv\&([^\:]*)/) {
        $thisallowed.=$1;         $thisallowed.=$1;
Line 591  sub allowed { Line 732  sub allowed {
     if ($ENV{'user.priv./'.(split(/\//,$uri))[0].'/'}=~/$priv\&([^\:]*)/) {      if ($ENV{'user.priv./'.(split(/\//,$uri))[0].'/'}=~/$priv\&([^\:]*)/) {
        $thisallowed.=$1;         $thisallowed.=$1;
     }      }
     if ($ENV{'user.priv./'.$uri}=~/$priv\&([^\:]*)/) {  
        $thisallowed.=$1;  # Full access at system or domain level? Exit.
   
       if ($thisallowed=~/F/) {
    return 'F';
       }
   
   # The user does not have full access at system or domain level
   # Course level access control
   
   # uri itself refering to a course?
       
       if ($uri=~/\.course$/) {
          if ($ENV{'user.priv./'.$uri}=~/$priv\&([^\:]*)/) {
             $thisallowed.=$1;
          }
   # Full access on course level? Exit.
          if ($thisallowed=~/F/) {
     return 'F';
          }
   
   # uri is refering to an individual resource; user needs to be in a course
   
      } else {
   
          unless(defined($ENV{'request.course.id'})) {
      return '1';
          }
   
   # Get access priviledges for course
   
          if ($ENV{'user.priv./'.$ENV{'request.course.id'}}=~/$priv\&([^\:]*)/) {
             $thisallowed.=$1;
          }
   
   # See if resource or referer is part of this course
             
          my @uriparts=split(/\//,$uri);
          my $urifile=$uriparts[$#uriparts];
          $urifile=~/\.(\w+)$/;
          my $uritype=$1;
          $#uriparts--;
          my $uripath=join('/',@uriparts);
          my $uricond=-1;
          if ($ENV{'acc.res.'.$ENV{'request.course.id'}.'.'.$uripath}=~
      /\&$urifile\:(\d+)\&/) {
      $uricond=$1;
          } elsif (($fe{$uritype} eq 'emb') || ($fe{$uritype} eq 'img')) {
     my $refuri=$ENV{'HTTP_REFERER'};
             $refuri=~s/^\/res//;
             $refuri=~s/^\///;
             @uriparts=split(/\//,$refuri);
             $urifile=$uriparts[$#uriparts];
             $#uriparts--;
             $uripath=join('/',@uriparts);
             if ($ENV{'acc.res.'.$ENV{'request.course.id'}.'.'.$uripath}=~
        /\&$urifile\:(\d+)\&/) {
        $uricond=$1;
     }
          }
   
          if ($uricond>=0) {
   
   # The resource is part of the course
   # If user had full access on course level, go ahead
   
              if ($thisallowed=~/F/) {
          return 'F';
              }
   
   # Restricted by state?
   
              if ($thisallowed=~/X/) {
         if (&condval($uricond)) {
            return '2';
                 } else {
                    return '';
                 }
      }
          }
     }      }
     return $thisallowed;      return $thisallowed;
 }  }
   
   # ---------------------------------------------------------- Refresh State Info
   
   sub refreshstate {
   }
   
 # ----------------------------------------------------------------- Define Role  # ----------------------------------------------------------------- Define Role
   
 sub definerole {  sub definerole {
Line 665  sub filedecription { Line 889  sub filedecription {
 sub assignrole {  sub assignrole {
     my ($udom,$uname,$url,$role,$end,$start)=@_;      my ($udom,$uname,$url,$role,$end,$start)=@_;
     my $mrole;      my $mrole;
       $url=declutter($url);
     if ($role =~ /^cr\//) {      if ($role =~ /^cr\//) {
         unless ($url=~/\.course$/) { return 'invalid'; }          unless ($url=~/\.course$/) { return 'invalid'; }
  unless (allowed('ccr',$url)) { return 'refused'; }   unless (allowed('ccr',$url)) { return 'refused'; }
Line 761  sub dirlist { Line 986  sub dirlist {
    }     }
 }  }
   
   # -------------------------------------------------------- Value of a Condition
   
   sub directcondval {
       my $number=shift;
       if ($ENV{'user.state.'.$ENV{'request.course.id'}}) {
          return substr($ENV{'user.state.'.$ENV{'request.course.id'}},$number,1);
       } else {
          return 2;
       }
   }
   
   sub condval {
       my $condidx=shift;
       my $result=0;
       if ($ENV{'request.course.id'}) {
          if (defined($ENV{'acc.cond.'.$ENV{'request.course.id'}.'.'.$condidx})) {
             my $operand='|';
     my @stack;
             map {
                 if ($_ eq '(') {
                    push @stack,($operand,$result)
                 } elsif ($_ eq ')') {
                     my $before=pop @stack;
     if (pop @stack eq '&') {
         $result=$result>$before?$before:$result;
                     } else {
                         $result=$result>$before?$result:$before;
                     }
                 } elsif (($_ eq '&') || ($_ eq '|')) {
                     $operand=$_;
                 } else {
                     my $new=directcondval($_);
                     if ($operand eq '&') {
                        $result=$result>$new?$new:$result;
                     } else {
                        $result=$result>$new?$result:$new;
                     }                  
                 }
             } ($ENV{'acc.cond.'.$ENV{'request.course.id'}.'.'.$condidx}=~
                /(\d+|\(|\)|\&|\|)/g);
          }
       }
       return $result;
   }
   
   # --------------------------------------------------------- Value of a Variable
   
   sub varval {
       my $varname=shift;
       my ($realm,$space,$qualifier,@therest)=split(/\./,$varname);
       my $rest;
       if ($therest[0]) {
          $rest=join('.',@therest);
       } else {
          $rest='';
       }
       if ($realm eq 'user') {
   # --------------------------------------------------------------- user.resource
    if ($space eq 'resource') {
   # ----------------------------------------------------------------- user.access
           } elsif ($space eq 'access') {
               return &allowed($qualifier,$rest);
   # ------------------------------------------ user.preferences, user.environment
           } elsif (($space eq 'preferences') || ($space eq 'environment')) {
               return $ENV{join('.',('environment',$qualifier,$rest))};
   # ----------------------------------------------------------------- user.course
           } elsif ($space eq 'course') {
               return $ENV{join('.',('request.course',$qualifier))};
   # ------------------------------------------------------------------- user.role
           } elsif ($space eq 'role') {
               my ($role,$where)=split(/\./,$ENV{'request.role'});
               if ($qualifier eq 'value') {
    return $role;
               } elsif ($qualifier eq 'extent') {
                   return $where;
               }
   # ----------------------------------------------------------------- user.domain
           } elsif ($space eq 'domain') {
               return $ENV{'user.domain'};
   # ------------------------------------------------------------------- user.name
           } elsif ($space eq 'name') {
               return $ENV{'user.name'};
   # ---------------------------------------------------- Any other user namespace
           } else {
               my $item=($rest)?$qualifier.'.'.$rest:$qualifier;
               my %reply=&get($space,$item);
               return $reply{$item};
           }
       } elsif ($realm eq 'request') {
   # ------------------------------------------------------------- request.browser
           if ($space eq 'browser') {
       return $ENV{'browser.'.$qualifier};
           } elsif ($space eq 'filename') {
               return $ENV{'request.filename'};
           }
       } elsif ($realm eq 'course') {
   # ---------------------------------------------------------- course.description
           if ($space eq 'description') {
               my %reply=&coursedescription($ENV{'request.course.id'});
               return $reply{'description'};
   # ------------------------------------------------------------------- course.id
           } elsif ($space eq 'id') {
               return $ENV{'request.course.id'};
   # -------------------------------------------------- Any other course namespace
           } else {
       my ($cdom,$cnam)=split(/\_/,$ENV{'request.course.id'});
       my $chome=&homeserver($cnam,$cdom);
               my $item=join('.',($qualifier,$rest));
               return &unescape
                      (&reply('get:'.$cdom.':'.$cnam.':'.&escape($space).':'.
      &escape($item),$chome));
           }
       } elsif ($realm eq 'userdata') {
           my $uhome=&homeserver($qualifier,$space);
   # ----------------------------------------------- userdata.domain.name.resource
   # ---------------------------------------------------- Any other user namespace
       } elsif ($realm eq 'environment') {
   # ----------------------------------------------------------------- environment
           return $ENV{join('.',($space,$qualifier,$rest))};
       } elsif ($realm eq 'system') {
   # ----------------------------------------------------------------- system.time
    if ($space eq 'time') {
       return time;
           }
       }
       return '';
   }
   
   # ------------------------------------------------- Update symbolic store links
   
   sub symblist {
       my ($mapname,%newhash)=@_;
       $mapname=declutter($mapname);
       my %hash;
       if (($ENV{'request.course.fn'}) && (%newhash)) {
           if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db',
                         &GDBM_WRCREAT,0640)) {
       map {
                   $hash{declutter($_)}=$mapname.'___'.$newhash{$_};
               } keys %newhash;
               if (untie(%hash)) {
    return 'ok';
               }
           }
       }
       return 'error';
   }
   
   # ------------------------------------------------------ Return symb list entry
   
   sub symbread {
       my $thisfn=shift;
       unless ($thisfn) {
    $thisfn=$ENV{'request.filename'};
       }
       $thisfn=declutter($thisfn);
       my %hash;
       my %bighash;
       my $syval='';
       if (($ENV{'request.course.fn'}) && ($thisfn)) {
           if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db',
                         &GDBM_READER,0640)) {
       $syval=$hash{$thisfn};
               untie(%hash);
           }
   # ---------------------------------------------------------- There was an entry
           if ($syval) {
              unless ($syval=~/\_\d+$/) {
          unless ($ENV{'form.request.prefix'}=~/\.(\d+)\_$/) {
                     &appenv('request.ambiguous' => $thisfn);
                     return '';
                  }    
                  $syval.=$1;
      }
           } else {
   # ------------------------------------------------------- Was not in symb table
              if (tie(%bighash,'GDBM_File',$ENV{'request.course.fn'}.'.db',
                               &GDBM_READER,0640)) {
   # ---------------------------------------------- Get ID(s) for current resource
                 my $ids=$bighash{'ids_/res/'.$thisfn};
                 if ($ids) {
   # ------------------------------------------------------------------- Has ID(s)
                    my @possibilities=split(/\,/,$ids);
                    if ($#possibilities==0) {
   # ----------------------------------------------- There is only one possibility
        my ($mapid,$resid)=split(/\./,$ids);
                        $syval=declutter($bighash{'map_id_'.$mapid}).'___'.$resid;
                    } else {
   # ------------------------------------------ There is more than one possibility
                        my $realpossible=0;
                        map {
    my $file=$bighash{'src_'.$_};
                            if (&allowed('bre',$file)) {
                my ($mapid,$resid)=split(/\./,$_);
                               if ($bighash{'map_type_'.$mapid} ne 'page') {
    $realpossible++;
                                   $syval=declutter($bighash{'map_id_'.$mapid}).
                                          '___'.$resid;
                               }
    }
                        } @possibilities;
        if ($realpossible!=1) { $syval=''; }
                    }
         }
                 untie(%bighash)
              } 
           }
           if ($syval) { return $syval.'___'.$thisfn; }
       }
       &appenv('request.ambiguous' => $thisfn);
       return '';
   }
   
   # ---------------------------------------------------------- Return random seed
   
   sub numval {
       my $txt=shift;
       $txt=~tr/A-J/0-9/;
       $txt=~tr/a-j/0-9/;
       $txt=~tr/K-T/0-9/;
       $txt=~tr/k-t/0-9/;
       $txt=~tr/U-Z/0-5/;
       $txt=~tr/u-z/0-5/;
       $txt=~s/\D//g;
       return int($txt);
   }    
   
   sub rndseed {
       my $symb;
       unless ($symb=&symbread()) { return time; }
       my $symbchck=unpack("%32C*",$symb);
       my $symbseed=numval($symb)%$symbchck;
       my $namechck=unpack("%32C*",$ENV{'user.name'});
       my $nameseed=numval($ENV{'user.name'})%$namechck;
       return int( $symbseed
          .$nameseed
                  .unpack("%32C*",$ENV{'user.domain'})
                  .unpack("%32C*",$ENV{'request.course.id'})
                  .$namechck
                  .$symbchck);
   }
   
   # ------------------------------------------------------------ Serves up a file
   # returns either the contents of the file or a -1
   sub getfile {
     my $file=shift;
     &repcopy($file);
     if (! -e $file ) { return -1; };
     my $fh=Apache::File->new($file);
     my $a='';
     while (<$fh>) { $a .=$_; }
     return $a
   }
   
   sub filelocation {
     my ($dir,$file) = @_;
     my $location;
     $file=~ s/^\s*(\S+)\s*$/$1/; ## strip off leading and trailing spaces
     $file=~s/^$perlvar{'lonDocRoot'}//;
     $file=~s:^/*res::;
     if ( !( $file =~ m:^/:) ) {
       $location = $dir. '/'.$file;
     } else {
       $location = '/home/httpd/html/res'.$file;
     }
     $location=~s://+:/:g; # remove duplicate /
     while ($location=~m:/\.\./:) {$location=~ s:/[^/]+/\.\./:/:g;} #remove dir/..
     return $location;
   }
   
   sub hreflocation {
       my ($dir,$file)=@_;
       unless (($_=~/^http:\/\//i) || ($_=~/^\//)) {
          my $finalpath=filelocation($dir,$file);
          $finalpath=~s/^\/home\/httpd\/html//;
          return $finalpath;
       } else {
          return $file;
       }
   }
   
   # ------------------------------------------------------------- Declutters URLs
   
   sub declutter {
       my $thisfn=shift;
       $thisfn=~s/^$perlvar{'lonDocRoot'}//;
       $thisfn=~s/^\///;
       $thisfn=~s/^res\///;
       return $thisfn;
   }
   
 # -------------------------------------------------------- Escape Special Chars  # -------------------------------------------------------- Escape Special Chars
   
 sub escape {  sub escape {
Removed from v.1.25  
changed lines
  Added in v.1.50

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