[BACK]Return to lonuserstate.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / rat

Diff for /rat/lonuserstate.pm between versions 1.27 and 1.129

version 1.27, 2002/06/05 12:52:05 version 1.129, 2008/11/18 19:13:37
Line 25 Line 25
 #  #
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Server for RAT Maps  
 #  
 # (Edit Handler for RAT Maps  
 # (TeX Content Handler  
 #  
 # YEAR=2000  
 # 05/29/00,05/30 Gerd Kortemeyer)  
 # 7/1 Gerd Kortemeyer)  
 # 7/1,7/3,7/4,7/7,7/8,7/10 Gerd Kortemeyer)  
 #  
 # 7/15,7/17,7/18,8/1,8/2,8/4,8/5,8/21,8/22,8/23,8/30,  
 # 9/2,9/4,9/29,9/30,10/2,10/11,10/30,10/31,  
 # 11/1,11/2,11/14,11/16,11/22,12/28,  
 # YEAR=2001  
 # 07/05/01,08/30,08/31 Gerd Kortemeyer  
 # 12/16 Scott Harrison  
 #  
 ###  ###
   
 package Apache::lonuserstate;  package Apache::lonuserstate;
   
 # ------------------------------------------------- modules used by this module  # ------------------------------------------------- modules used by this module
 use strict;  use strict;
 use Apache::Constants qw(:common :http);  
 use Apache::File;  
 use HTML::TokeParser;  use HTML::TokeParser;
 use Apache::lonnet();  use Apache::lonnet;
   use Apache::lonlocal;
 use Apache::loncommon();  use Apache::loncommon();
 use GDBM_File;  use GDBM_File;
 use Apache::lonmsg;  use Apache::lonmsg;
 use Safe;  use Safe;
 use Safe::Hole;  use Safe::Hole;
 use Opcode;  use Opcode;
   use Apache::lonenc;
   use Fcntl qw(:flock);
   use LONCAPA;
    
   
 # ---------------------------------------------------- Globals for this package  # ---------------------------------------------------- Globals for this package
   
Line 66  my %hash;    # The big tied hash Line 52  my %hash;    # The big tied hash
 my %parmhash;# The hash with the parameters  my %parmhash;# The hash with the parameters
 my @cond;    # Array with all of the conditions  my @cond;    # Array with all of the conditions
 my $errtext; # variable with all errors  my $errtext; # variable with all errors
 my $retfurl; # variable with the very first URL in the course  my $retfrid; # variable with the very first RID in the course
   my $retfurl; # first URL
   my %randompick; # randomly picked resources
   my %randompickseed; # optional seed for randomly picking resources
   my %randomorder; # maps to order contents randomly
   my %encurl; # URLs in this folder are supposed to be encrypted
   my %hiddenurl; # this URL (or complete folder) is supposed to be hidden
   
 # --------------------------------------------------------- Loads map from disk  # ----------------------------------- Remove version from URL and store in hash
   
 sub loadmap {   sub versiontrack {
     my $uri=shift;      my $uri=shift;
     if ($hash{'map_pc_'.$uri}) { return OK; }      if ($uri=~/\.(\d+)\.\w+$/) {
    my $version=$1;
    $uri=~s/\.\d+\.(\w+)$/\.$1/;
           unless ($hash{'version_'.$uri}) {
       $hash{'version_'.$uri}=$version;
    }
       }
       return $uri;
   }
   
   # -------------------------------------------------------------- Put in version
   
   sub putinversion {
       my $uri=shift;
       my $key=$env{'request.course.id'}.'_'.&Apache::lonnet::clutter($uri);
       if ($hash{'version_'.$uri}) {
    my $version=$hash{'version_'.$uri};
    if ($version eq 'mostrecent') { return $uri; }
    if ($version eq &Apache::lonnet::getversion(
    &Apache::lonnet::filelocation('',$uri))) 
                { return $uri; }
    $uri=~s/\.(\w+)$/\.$version\.$1/;
       }
       &Apache::lonnet::do_cache_new('courseresversion',$key,&Apache::lonnet::declutter($uri),600);
       return $uri;
   }
   
   # ----------------------------------------- Processing versions file for course
   
   sub processversionfile {
       my %cenv=@_;
       my %versions=&Apache::lonnet::dump('resourceversions',
          $cenv{'domain'},
          $cenv{'num'});
       foreach my $ver (keys(%versions)) {
    if ($ver=~/^error\:/) { return; }
    $hash{'version_'.$ver}=$versions{$ver};
       }
   }
   
   # --------------------------------------------------------- Loads map from disk
   
   sub loadmap { 
       my ($uri,$parent_rid)=@_;
       if ($hash{'map_pc_'.$uri}) { 
    $errtext.='<p class="LC_error">'.
       &mt('Multiple use of sequence/page [_1]! The course will not function properly.','<tt>'.$uri.'</tt>').
       '</p>';
    return; 
       }
     $pc++;      $pc++;
     my $lpc=$pc;      my $lpc=$pc;
     $hash{'map_pc_'.$uri}=$lpc;      $hash{'map_pc_'.$uri}=$lpc;
     $hash{'map_id_'.$lpc}=$uri;      $hash{'map_id_'.$lpc}=$uri;
   
     my $fn='/home/httpd/html'.$uri;  # Determine and check filename
       my $fn=&Apache::lonnet::filelocation('',&putinversion($uri));
   
       my $ispage=($fn=~/\.page$/);
   
     unless (($fn=~/\.sequence$/) ||      unless (($fn=~/\.sequence$/) ||
             ($fn=~/\.page$/)) {               ($fn=~/\.page$/)) { 
        $errtext.="Invalid map: $fn\n";   $errtext.=&mt("<br />Invalid map: <tt>[_1]</tt>",$fn);
        return OK;    return; 
     }      }
   
     my $ispage=($fn=~/\.page$/);      my $instr=&Apache::lonnet::getfile($fn);
   
     unless (-e $fn) {      if ($instr eq -1) {
  my $returned=Apache::lonnet::repcopy($fn);          $errtext.=&mt('<br />Map not loaded: The file <tt>[_1]</tt> does not exist.',$fn);
         unless ($returned eq OK) {   return;
            $errtext.="Could not import: $fn - ";  
            if ($returned eq HTTP_SERVICE_UNAVAILABLE) {  
       $errtext.="Server unavailable\n";  
            }  
            if ($returned eq HTTP_NOT_FOUND) {  
       $errtext.="File not found\n";  
            }  
            if ($returned eq FORBIDDEN) {  
       $errtext.="Access forbidden\n";  
            }  
            return OK;  
        }  
     }      }
   
     if (-e $fn) {  # Successfully got file, parse it
         my @content;  
         {  
     my $fh=Apache::File->new($fn);  
             @content=<$fh>;  
         }  
         my $instr=join('',@content);  
         my $parser = HTML::TokeParser->new(\$instr);  
         my $token;  
   
         my $linkpc=0;      my $parser = HTML::TokeParser->new(\$instr);
       $parser->attr_encoded(1);
       # first get all parameters
       while (my $token = $parser->get_token) {
    next if ($token->[0] ne 'S');
    if ($token->[1] eq 'param') {
       &parse_param($token,$lpc);
    } 
       }
       #reset parser
       $parser = HTML::TokeParser->new(\$instr);
       $parser->attr_encoded(1);
   
         $fn=~/\.(\w+)$/;      my $linkpc=0;
   
         $hash{'map_type_'.$lpc}=$1;      $fn=~/\.(\w+)$/;
   
         while ($token = $parser->get_token) {      $hash{'map_type_'.$lpc}=$1;
     if ($token->[0] eq 'S') {  
                 if ($token->[1] eq 'resource') {  
 # -------------------------------------------------------------------- Resource  
   
                     my $rid=$lpc.'.'.$token->[2]->{'id'};      my $randomize = ($randomorder{$parent_rid} =~ /^yes$/i);
   
                     $hash{'kind_'.$rid}='res';      my @map_ids;
                     $hash{'title_'.$rid}=$token->[2]->{'title'};      while (my $token = $parser->get_token) {
                     my $turi=$token->[2]->{'src'};   next if ($token->[0] ne 'S');
                     unless ($ispage) {   if ($token->[1] eq 'resource') {
                         $turi=~/\.(\w+)$/;      push(@map_ids,&parse_resource($token,$lpc,$ispage,$uri));
                         my $embstyle=&Apache::loncommon::fileembstyle($1);   } elsif ($token->[1] eq 'link' && !$randomize) {
                         if ($token->[2]->{'external'} eq 'true') {  # ----------------------------------------------------------------------- Links
                             $turi=~s/^http\:\/\//\/adm\/wrapper\/ext\//;      &make_link(++$linkpc,$lpc,$token->[2]->{'to'},
                         } else {         $token->[2]->{'from'},
                            my $embstyle=&Apache::loncommon::fileembstyle($1);         $token->[2]->{'condition'});
                            if (($embstyle eq 'img') || ($embstyle eq 'emb')) {   } elsif ($token->[1] eq 'condition' && !$randomize) {
        $turi='/adm/wrapper'.$turi;      &parse_condition($token,$lpc);
                            }   }
                         }      }
     }  
                     $hash{'src_'.$rid}=$turi;  
   
                     if (defined($hash{'ids_'.$turi})) {      if ($randomize) {
                         $hash{'ids_'.$turi}.=','.$rid;   if (!$env{'request.role.adv'}) {
                     } else {      my $seed;
                         $hash{'ids_'.$turi}=''.$rid;      if (defined($randompickseed{$parent_rid})) {
                     }   $seed = $randompickseed{$parent_rid};
       } else {
                     if ($token->[2]->{'external'} eq 'true') {   my ($mapid,$resid)=split(/\./,$parent_rid);
                         $hash{'ext_'.$rid}='true:';   my $symb=
                     } else {      &Apache::lonnet::encode_symb($hash{'map_id_'.$mapid},
                         $hash{'ext_'.$rid}='false:';   $resid,$hash{'src_'.$parent_rid});
                     }  
                     if ($token->[2]->{'type'}) {   $seed = $symb;
  $hash{'type_'.$rid}=$token->[2]->{'type'};      }
                         if ($token->[2]->{'type'} eq 'start') {  
     $hash{'map_start_'.$uri}="$rid";      my $rndseed=&Apache::lonnet::rndseed($seed);
                         }      &Apache::lonnet::setup_random_from_rndseed($rndseed);
                         if ($token->[2]->{'type'} eq 'finish') {      @map_ids=&Math::Random::random_permutation(@map_ids);
     $hash{'map_finish_'.$uri}="$rid";   }
                         }   my $from = shift(@map_ids);
                     }  else {   my $from_rid = $lpc.'.'.$from;
                         $hash{'type_'.$rid}='normal';   $hash{'map_start_'.$uri} = $from_rid;
                     }   $hash{'type_'.$from_rid}='start';
   
                     if (($turi=~/\.sequence$/) ||   while (my $to = shift(@map_ids)) {
                         ($turi=~/\.page$/)) {      &make_link(++$linkpc,$lpc,$to,$from);
                         $hash{'is_map_'.$rid}=1;      my $to_rid =  $lpc.'.'.$to;
                         &loadmap($turi);      $hash{'type_'.$to_rid}='normal';
                     }       $from = $to;
                           $from_rid = $to_rid;
                 } elsif ($token->[1] eq 'condition') {   }
 # ------------------------------------------------------------------- Condition  
   
                     my $rid=$lpc.'.'.$token->[2]->{'id'};   $hash{'map_finish_'.$uri}= $from_rid;
    $hash{'type_'.$from_rid}='finish';
       }
   
                     $hash{'kind_'.$rid}='cond';      $parser = HTML::TokeParser->new(\$instr);
                     $cond[$#cond+1]=$token->[2]->{'value'};      $parser->attr_encoded(1);
                     $hash{'condid_'.$rid}=$#cond;      # last parse out the mapalias params so as to ignore anything
                     if ($token->[2]->{'type'}) {      # refering to non-existant resources
                         $cond[$#cond].=':'.$token->[2]->{'type'};      while (my $token = $parser->get_token) {
                     }  else {   next if ($token->[0] ne 'S');
                         $cond[$#cond].=':normal';   if ($token->[1] eq 'param') {
                     }      &parse_mapalias_param($token,$lpc);
    } 
       }
   }
   
                 } elsif ($token->[1] eq 'link') {  
 # ----------------------------------------------------------------------- Links  
   
                     $linkpc++;  # -------------------------------------------------------------------- Resource
                     my $linkid=$lpc.'.'.$linkpc;  sub parse_resource {
       my ($token,$lpc,$ispage,$uri) = @_;
       if ($token->[2]->{'type'} eq 'zombie') { next; }
       my $rid=$lpc.'.'.$token->[2]->{'id'};
       
       $hash{'kind_'.$rid}='res';
       $hash{'title_'.$rid}=$token->[2]->{'title'};
       my $turi=&versiontrack($token->[2]->{'src'});
       if ($token->[2]->{'version'}) {
    unless ($hash{'version_'.$turi}) {
       $hash{'version_'.$turi}=$1;
    }
       }
       my $title=$token->[2]->{'title'};
       $title=~s/\&colon\;/\:/gs;
   #   my $symb=&Apache::lonnet::encode_symb($uri,
   #  $token->[2]->{'id'},
   #  $turi);
   #   &Apache::lonnet::do_cache_new('title',$symb,$title);
       unless ($ispage) {
    $turi=~/\.(\w+)$/;
    my $embstyle=&Apache::loncommon::fileembstyle($1);
    if ($token->[2]->{'external'} eq 'true') { # external
       $turi=~s/^http\:\/\//\/adm\/wrapper\/ext\//;
    } elsif ($turi=~/^\/*uploaded\//) { # uploaded
       if (($embstyle eq 'img') 
    || ($embstyle eq 'emb')
    || ($embstyle eq 'wrp')) {
    $turi='/adm/wrapper'.$turi;
       } elsif ($embstyle eq 'ssi') {
    #do nothing with these
       } elsif ($turi!~/\.(sequence|page)$/) {
    $turi='/adm/coursedocs/showdoc'.$turi;
       }
    } elsif ($turi=~/\S/) { # normal non-empty internal resource
       my $mapdir=$uri;
       $mapdir=~s/[^\/]+$//;
       $turi=&Apache::lonnet::hreflocation($mapdir,$turi);
       if (($embstyle eq 'img') 
    || ($embstyle eq 'emb')
    || ($embstyle eq 'wrp')) {
    $turi='/adm/wrapper'.$turi;
       }
    }
       }
   # Store reverse lookup, remove query string
       my $idsuri=$turi;
       $idsuri=~s/\?.+$//;
       if (defined($hash{'ids_'.$idsuri})) {
    $hash{'ids_'.$idsuri}.=','.$rid;
       } else {
    $hash{'ids_'.$idsuri}=''.$rid;
       }
       
       if ($turi=~/\/(syllabus|aboutme|navmaps|smppg|bulletinboard)$/) {
    $turi.='?register=1';
       }
       
       $hash{'src_'.$rid}=$turi;
       
       if ($token->[2]->{'external'} eq 'true') {
    $hash{'ext_'.$rid}='true:';
       } else {
    $hash{'ext_'.$rid}='false:';
       }
       if ($token->[2]->{'type'}) {
    $hash{'type_'.$rid}=$token->[2]->{'type'};
    if ($token->[2]->{'type'} eq 'start') {
       $hash{'map_start_'.$uri}="$rid";
    }
    if ($token->[2]->{'type'} eq 'finish') {
       $hash{'map_finish_'.$uri}="$rid";
    }
       }  else {
    $hash{'type_'.$rid}='normal';
       }
       
       if (($turi=~/\.sequence$/) ||
    ($turi=~/\.page$/)) {
    $hash{'is_map_'.$rid}=1;
    &loadmap($turi,$rid);
       } 
       return $token->[2]->{'id'};
   }
   
                     my $goesto=$lpc.'.'.$token->[2]->{'to'};  sub make_link {
                     my $comesfrom=$lpc.'.'.$token->[2]->{'from'};      my ($linkpc,$lpc,$to,$from,$condition) = @_;
                     my $undercond=0;      
       my $linkid=$lpc.'.'.$linkpc;
                     if ($token->[2]->{'condition'}) {      my $goesto=$lpc.'.'.$to;
  $undercond=$lpc.'.'.$token->[2]->{'condition'};      my $comesfrom=$lpc.'.'.$from;
                     }      my $undercond=0;
   
                     $hash{'goesto_'.$linkid}=$goesto;  
                     $hash{'comesfrom_'.$linkid}=$comesfrom;  
                     $hash{'undercond_'.$linkid}=$undercond;  
   
                     if (defined($hash{'to_'.$comesfrom})) {  
                         $hash{'to_'.$comesfrom}.=','.$linkid;  
                     } else {  
                         $hash{'to_'.$comesfrom}=''.$linkid;  
                     }  
                     if (defined($hash{'from_'.$goesto})) {  
                         $hash{'from_'.$goesto}.=','.$linkid;  
                     } else {  
                         $hash{'from_'.$goesto}=''.$linkid;  
                     }  
                 } elsif ($token->[1] eq 'param') {  
 # ------------------------------------------------------------------- Parameter  
   
                     my $referid=$lpc.'.'.$token->[2]->{'to'};      if ($condition) {
                     my $part=$token->[2]->{'part'};   $undercond=$lpc.'.'.$condition;
                     unless ($part) { $part=0; }      }
                     my $newparam=  
  &Apache::lonnet::escape($token->[2]->{'type'}).':'.  
  &Apache::lonnet::escape($part.'.'.  
                          $token->[2]->{'name'}).'='.  
  &Apache::lonnet::escape($token->[2]->{'value'});  
                     if (defined($hash{'param_'.$referid})) {  
                         $hash{'param_'.$referid}.='&'.$newparam;  
                     } else {  
                         $hash{'param_'.$referid}=''.$newparam;  
                     }  
   
                 }       $hash{'goesto_'.$linkid}=$goesto;
       $hash{'comesfrom_'.$linkid}=$comesfrom;
       $hash{'undercond_'.$linkid}=$undercond;
   
             }      if (defined($hash{'to_'.$comesfrom})) {
         }   $hash{'to_'.$comesfrom}.=','.$linkid;
       } else {
    $hash{'to_'.$comesfrom}=''.$linkid;
       }
       if (defined($hash{'from_'.$goesto})) {
    $hash{'from_'.$goesto}.=','.$linkid;
       } else {
    $hash{'from_'.$goesto}=''.$linkid;
       }
   }
   
   # ------------------------------------------------------------------- Condition
   sub parse_condition {
       my ($token,$lpc) = @_;
       my $rid=$lpc.'.'.$token->[2]->{'id'};
       
       $hash{'kind_'.$rid}='cond';
   
       my $condition = $token->[2]->{'value'};
       $condition =~ s/[\n\r]+/ /gs;
       push(@cond, $condition);
       $hash{'condid_'.$rid}=$#cond;
       if ($token->[2]->{'type'}) {
    $cond[$#cond].=':'.$token->[2]->{'type'};
       }  else {
    $cond[$#cond].=':normal';
       }
   }
   
   # ------------------------------------------------------------------- Parameter
   
   sub parse_param {
       my ($token,$lpc) = @_;
       my $referid=$lpc.'.'.$token->[2]->{'to'};
       my $name=$token->[2]->{'name'};
       my $part;
       if ($name=~/^parameter_(.*)_/) {
    $part=$1;
       } else {
    $part=0;
       }
       $name=~s/^.*_([^_]*)$/$1/;
       my $newparam=
    &escape($token->[2]->{'type'}).':'.
    &escape($part.'.'.$name).'='.
    &escape($token->[2]->{'value'});
       if (defined($hash{'param_'.$referid})) {
    $hash{'param_'.$referid}.='&'.$newparam;
     } else {      } else {
         $errtext.='Map not loaded: The file does not exist. ';   $hash{'param_'.$referid}=''.$newparam;
       }
       if ($token->[2]->{'name'}=~/^parameter_(0_)*randompick$/) {
    $randompick{$referid}=$token->[2]->{'value'};
       }
       if ($token->[2]->{'name'}=~/^parameter_(0_)*randompickseed$/) {
    $randompickseed{$referid}=$token->[2]->{'value'};
       }
       if ($token->[2]->{'name'}=~/^parameter_(0_)*randomorder$/) {
    $randomorder{$referid}=$token->[2]->{'value'};
       }
       if ($token->[2]->{'name'}=~/^parameter_(0_)*encrypturl$/) {
    if ($token->[2]->{'value'}=~/^yes$/i) {
       $encurl{$referid}=1;
    }
       }
       if ($token->[2]->{'name'}=~/^parameter_(0_)*hiddenresource$/) {
    if ($token->[2]->{'value'}=~/^yes$/i) {
       $hiddenurl{$referid}=1;
    }
       }
   }
   
   sub parse_mapalias_param {
       my ($token,$lpc) = @_;
       my $referid=$lpc.'.'.$token->[2]->{'to'};
       return if (!exists($hash{'src_'.$referid}));
   
       if ($token->[2]->{'name'}=~/^parameter_(0_)*mapalias$/) {
    &count_mapalias($token->[2]->{'value'},$referid);
    $hash{'mapalias_'.$token->[2]->{'value'}}=$referid;
     }      }
 }  }
   
 # --------------------------------------------------------- Simplify expression  # --------------------------------------------------------- Simplify expression
   
 sub simplify {  sub simplify {
    my $expression=shift;      my $expression=shift;
   # (0&1) = 1
       $expression=~s/\(0\&([_\.\d]+)\)/$1/g;
 # (8)=8  # (8)=8
    $expression=~s/\((\d+)\)/$1/g;      $expression=~s/\(([_\.\d]+)\)/$1/g;
 # 8&8=8  # 8&8=8
    $expression=~s/(\D)(\d+)\&\2(\D)/$1$2$3/g;      $expression=~s/([^_\.\d])([_\.\d]+)\&\2([^_\.\d])/$1$2$3/g;
 # 8|8=8  # 8|8=8
    $expression=~s/(\D)(\d+)\|\2(\D)/$1$2$3/g;      $expression=~s/([^_\.\d])([_\.\d]+)\|\2([^_\.\d])/$1$2$3/g;
 # (5&3)&4=5&3&4  # (5&3)&4=5&3&4
    $expression=~s/\((\d+)((?:\&\d+)+)\)\&(\d+\D)/$1$2\&$3/g;      $expression=~s/\(([_\.\d]+)((?:\&[_\.\d]+)+)\)\&([_\.\d]+[^_\.\d])/$1$2\&$3/g;
 # (((5&3)|(4&6)))=((5&3)|(4&6))  # (((5&3)|(4&6)))=((5&3)|(4&6))
    $expression=~      $expression=~
        s/\((\(\(\d+(?:\&\d+)*\)(?:\|\(\d+(?:\&\d+)*\))+\))\)/$1/g;   s/\((\(\([_\.\d]+(?:\&[_\.\d]+)*\)(?:\|\([_\.\d]+(?:\&[_\.\d]+)*\))+\))\)/$1/g;
 # ((5&3)|(4&6))|(1&2)=(5&3)|(4&6)|(1&2)  # ((5&3)|(4&6))|(1&2)=(5&3)|(4&6)|(1&2)
    $expression=~      $expression=~
        s/\((\(\d+(?:\&\d+)*\))((?:\|\(\d+(?:\&\d+)*\))+)\)\|(\(\d+(?:\&\d+)*\))/\($1$2\|$3\)/g;   s/\((\([_\.\d]+(?:\&[_\.\d]+)*\))((?:\|\([_\.\d]+(?:\&[_\.\d]+)*\))+)\)\|(\([_\.\d]+(?:\&[_\.\d]+)*\))/\($1$2\|$3\)/g;
    return $expression;      return $expression;
 }  }
   
 # -------------------------------------------------------- Build condition hash  # -------------------------------------------------------- Build condition hash
   
 sub traceroute {  sub traceroute {
     my ($sofar,$rid,$beenhere)=@_;      my ($sofar,$rid,$beenhere,$encflag,$hdnflag)=@_;
     $sofar=simplify($sofar);      my $newsofar=$sofar=simplify($sofar);
     unless ($beenhere=~/\&$rid\&/) {      unless ($beenhere=~/\&\Q$rid\E\&/) {
        $beenhere.=$rid.'&';     $beenhere.=$rid.'&';  
        if ($retfurl eq '') {   my ($mapid,$resid)=split(/\./,$rid);
            $retfurl=$hash{'src_'.$rid};   my $symb=&Apache::lonnet::encode_symb($hash{'map_id_'.$mapid},$resid,$hash{'src_'.$rid});
        }   my $hidden=&Apache::lonnet::EXT('resource.0.hiddenresource',$symb);
        if (defined($hash{'conditions_'.$rid})) {  
    $hash{'conditions_'.$rid}=simplify(   if ($hdnflag || lc($hidden) eq 'yes') {
       $hiddenurl{$rid}=1;
    }
    if (!$hdnflag && lc($hidden) eq 'no') {
       delete($hiddenurl{$rid});
    }
   
    my $encrypt=&Apache::lonnet::EXT('resource.0.encrypturl',$symb);
    if ($encflag || lc($encrypt) eq 'yes') { $encurl{$rid}=1; }
    if (($retfrid eq '') && ($hash{'src_'.$rid})
       && ($hash{'src_'.$rid}!~/\.sequence$/)) {
       $retfrid=$rid;
    }
    if (defined($hash{'conditions_'.$rid})) {
       $hash{'conditions_'.$rid}=simplify(
            '('.$hash{'conditions_'.$rid}.')|('.$sofar.')');             '('.$hash{'conditions_'.$rid}.')|('.$sofar.')');
        } else {   } else {
            $hash{'conditions_'.$rid}=$sofar;      $hash{'conditions_'.$rid}=$sofar;
        }   }
        if (defined($hash{'is_map_'.$rid})) {  
            if (defined($hash{'map_start_'.$hash{'src_'.$rid}})) {   # if the expression is just the 0th condition keep it
        &traceroute($sofar,$hash{'map_start_'.$hash{'src_'.$rid}},'&');   # otherwise leave a pointer to this condition expression
                if (defined($hash{'map_finish_'.$hash{'src_'.$rid}})) {   $newsofar = ($sofar eq '0') ? $sofar : '_'.$rid;
    $sofar=  
                   $hash{'conditions_'.$hash{'map_finish_'.$hash{'src_'.$rid}}};   if (defined($hash{'is_map_'.$rid})) {
                }      if (defined($hash{'map_start_'.$hash{'src_'.$rid}})) {
            }   $sofar=$newsofar=
        }      &traceroute($sofar,
        if (defined($hash{'to_'.$rid})) {   $hash{'map_start_'.$hash{'src_'.$rid}},
           foreach (split(/\,/,$hash{'to_'.$rid})) {   $beenhere,
    $encflag || $encurl{$rid},
    $hdnflag || $hiddenurl{$rid});
       }
    }
    if (defined($hash{'to_'.$rid})) {
       foreach my $id (split(/\,/,$hash{'to_'.$rid})) {
  my $further=$sofar;   my $further=$sofar;
                 if ($hash{'undercond_'.$_}) {                  if ($hash{'undercond_'.$id}) {
    if (defined($hash{'condid_'.$hash{'undercond_'.$_}})) {      if (defined($hash{'condid_'.$hash{'undercond_'.$id}})) {
         $further=simplify('('.$further.')&('.   $further=simplify('('.'_'.$rid.')&('.
                               $hash{'condid_'.$hash{'undercond_'.$_}}.')');    $hash{'condid_'.$hash{'undercond_'.$id}}.')');
    } else {      } else {
                        $errtext.='Undefined condition ID: '   $errtext.=&mt('<br />Undefined condition ID: [_1]',$hash{'undercond_'.$id});
                                  .$hash{'undercond_'.$_}.'. ';      }
                    }  
                 }                  }
                 &traceroute($further,$hash{'goesto_'.$_},$beenhere);                  $newsofar=&traceroute($further,$hash{'goesto_'.$id},$beenhere,
           }        $encflag,$hdnflag);
        }      }
    }
     }      }
       return $newsofar;
 }  }
   
 # ------------------------------ Cascading conditions, quick access, parameters  # ------------------------------ Cascading conditions, quick access, parameters
Line 316  sub accinit { Line 504  sub accinit {
     my %captured=();      my %captured=();
     my $condcounter=0;      my $condcounter=0;
     $acchash{'acc.cond.'.$short.'.0'}=0;      $acchash{'acc.cond.'.$short.'.0'}=0;
     foreach (keys %hash) {      foreach my $key (keys(%hash)) {
        if ($_=~/^conditions/) {   if ($key=~/^conditions/) {
   my $expr=$hash{$_};      my $expr=$hash{$key};
          foreach ($expr=~m/(\(\(\d+(?:\&\d+)+\)(?:\|\(\d+(?:\&\d+)+\))+\))/g) {      # try to find and factor out common sub-expressions
              my $sub=$_;      foreach my $sub ($expr=~m/(\(\([_\.\d]+(?:\&[_\.\d]+)+\)(?:\|\([_\.\d]+(?:\&[_\.\d]+)+\))+\))/g) {
              my $orig=$_;   my $orig=$sub;
       $sub=~/\(\((\d+\&(:?\d+\&)*)(?:\d+\&*)+\)(?:\|\(\1(?:\d+\&*)+\))+\)/;  
              my $factor=$1;   my ($factor) = ($sub=~/\(\(([_\.\d]+\&(:?[_\.\d]+\&)*)(?:[_\.\d]+\&*)+\)(?:\|\(\1(?:[_\.\d]+\&*)+\))+\)/);
              $sub=~s/$factor//g;   next if (!defined($factor));
              $sub=~s/^\(/\($factor\(/;  
      $sub.=')';   $sub=~s/\Q$factor\E//g;
              $sub=simplify($sub);   $sub=~s/^\(/\($factor\(/;
              $orig=~s/(\W)/\\$1/g;   $sub.=')';
       $expr=~s/$orig/$sub/;   $sub=simplify($sub);
   }   $expr=~s/\Q$orig\E/$sub/;
           $hash{$_}=$expr;      }
           unless (defined($captured{$expr})) {      $hash{$key}=$expr;
       $condcounter++;      unless (defined($captured{$expr})) {
               $captured{$expr}=$condcounter;   $condcounter++;
               $acchash{'acc.cond.'.$short.'.'.$condcounter}=$expr;   $captured{$expr}=$condcounter;
           }    $acchash{'acc.cond.'.$short.'.'.$condcounter}=$expr;
        } elsif ($_=~/^param_(\d+)\.(\d+)/) {      } 
           my $prefix=&Apache::lonnet::declutter($hash{'map_id_'.$1}).   } elsif ($key=~/^param_(\d+)\.(\d+)/) {
       '___'.$2.'___'.&Apache::lonnet::declutter($hash{'src_'.$1.'.'.$2});      my $prefix=&Apache::lonnet::encode_symb($hash{'map_id_'.$1},$2,
           foreach (split(/\&/,$hash{$_})) {      $hash{'src_'.$1.'.'.$2});
      my ($typename,$value)=split(/\=/,$_);      foreach my $param (split(/\&/,$hash{$key})) {
              my ($type,$name)=split(/\:/,$typename);   my ($typename,$value)=split(/\=/,$param);
              $parmhash{$prefix.'.'.&Apache::lonnet::unescape($name)}=   my ($type,$name)=split(/\:/,$typename);
                                    &Apache::lonnet::unescape($value);   $parmhash{$prefix.'.'.&unescape($name)}=
      $parmhash{$prefix.'.'.&Apache::lonnet::unescape($name).'.type'}=      &unescape($value);
                                    &Apache::lonnet::unescape($type);   $parmhash{$prefix.'.'.&unescape($name).'.type'}=
           }      &unescape($type);
        }      }
     }   }
     foreach (keys %hash) {      }
  if ($_=~/^ids/) {      foreach my $key (keys(%hash)) {
   foreach (split(/\,/,$hash{$_})) {   if ($key=~/^ids/) {
     my $resid=$_;      foreach my $resid (split(/\,/,$hash{$key})) {
             my $uri=$hash{'src_'.$resid};   my $uri=$hash{'src_'.$resid};
             $uri=~s/^\/adm\/wrapper//;   my ($uripath,$urifile) =
             my @uriparts=split(/\//,$uri);      &Apache::lonnet::split_uri_for_cond($uri);
             my $urifile=$uriparts[$#uriparts];   if ($uripath) {
             $#uriparts--;      my $uricond='0';
             my $uripath=join('/',@uriparts);      if (defined($hash{'conditions_'.$resid})) {
             $uripath=~s/^\/res\///;   $uricond=$captured{$hash{'conditions_'.$resid}};
            if ($uripath) {      }
             my $uricond='0';      if (defined($acchash{'acc.res.'.$short.'.'.$uripath})) {
             if (defined($hash{'conditions_'.$resid})) {   if ($acchash{'acc.res.'.$short.'.'.$uripath}=~
   $uricond=$captured{$hash{'conditions_'.$resid}};      /(\&\Q$urifile\E\:[^\&]*)/) {
             }      my $replace=$1;
             if (defined($acchash{'acc.res.'.$short.'.'.$uripath})) {      my $regexp=$replace;
                 if ($acchash{'acc.res.'.$short.'.'.$uripath}=~      #$regexp=~s/\|/\\\|/g;
                    /(\&$urifile\:[^\&]*)/) {      $acchash{'acc.res.'.$short.'.'.$uripath} =~
     my $replace=$1;   s/\Q$regexp\E/$replace\|$uricond/;
                     my $regexp=$replace;   } else {
                     $regexp=~s/\|/\\\|/g;      $acchash{'acc.res.'.$short.'.'.$uripath}.=
                     $acchash{'acc.res.'.$short.'.'.$uripath}   $urifile.':'.$uricond.'&';
                      =~s/$regexp/$replace\|$uricond/;   }
                 } else {      } else {
    $acchash{'acc.res.'.$short.'.'.$uripath}.=   $acchash{'acc.res.'.$short.'.'.$uripath}=
                      $urifile.':'.$uricond.'&';      '&'.$urifile.':'.$uricond.'&';
         }      }
             } else {   } 
                 $acchash{'acc.res.'.$short.'.'.$uripath}=      }
                  '&'.$urifile.':'.$uricond.'&';   }
             }  
            }   
          }  
       }  
     }      }
     $acchash{'acc.res.'.$short.'.'}='&:0&';      $acchash{'acc.res.'.$short.'.'}='&:0&';
     my $courseuri=$uri;      my $courseuri=$uri;
     $courseuri=~s/^\/res\///;      $courseuri=~s/^\/res\///;
     &Apache::lonnet::delenv('(acc\.|httpref\.)');      &Apache::lonnet::delenv('(acc\.|httpref\.)');
     &Apache::lonnet::appenv(%acchash,      &Apache::lonnet::appenv(\%acchash);
                             "request.course.id"  => $short,  }
                             "request.course.fn"  => $fn,  
                             "request.course.uri" => $courseuri);   # ---------------- Selectively delete from randompick maps and hidden url parms
   
   sub hiddenurls {
       my $randomoutentry='';
       foreach my $rid (keys %randompick) {
           my $rndpick=$randompick{$rid};
           my $mpc=$hash{'map_pc_'.$hash{'src_'.$rid}};
   # ------------------------------------------- put existing resources into array
           my @currentrids=();
           foreach my $key (sort(keys(%hash))) {
       if ($key=~/^src_($mpc\.\d+)/) {
    if ($hash{'src_'.$1}) { push @currentrids, $1; }
               }
           }
    # rids are number.number and we want to numercially sort on 
           # the second number
    @currentrids=sort {
       my (undef,$aid)=split(/\./,$a);
       my (undef,$bid)=split(/\./,$b);
       $aid <=> $bid;
    } @currentrids;
           next if ($#currentrids<$rndpick);
   # -------------------------------- randomly eliminate the ones that should stay
    my (undef,$id)=split(/\./,$rid);
           if ($randompickseed{$rid}) { $id=$randompickseed{$rid}; }
    my $rndseed=&Apache::lonnet::rndseed($id); # use id instead of symb
    &Apache::lonnet::setup_random_from_rndseed($rndseed);
    my @whichids=&Math::Random::random_permuted_index($#currentrids+1);
           for (my $i=1;$i<=$rndpick;$i++) { $currentrids[$whichids[$i]]=''; }
    #&Apache::lonnet::logthis("$id,$rndseed,".join(':',@whichids));
   # -------------------------------------------------------- delete the leftovers
           for (my $k=0; $k<=$#currentrids; $k++) {
               if ($currentrids[$k]) {
    $hash{'randomout_'.$currentrids[$k]}=1;
                   my ($mapid,$resid)=split(/\./,$currentrids[$k]);
                   $randomoutentry.='&'.
       &Apache::lonnet::encode_symb($hash{'map_id_'.$mapid},
    $resid,
    $hash{'src_'.$currentrids[$k]}
    ).'&';
               }
           }
       }
   # ------------------------------ take care of explicitly hidden urls or folders
       foreach my $rid (keys %hiddenurl) {
    $hash{'randomout_'.$rid}=1;
    my ($mapid,$resid)=split(/\./,$rid);
    $randomoutentry.='&'.
       &Apache::lonnet::encode_symb($hash{'map_id_'.$mapid},$resid,
    $hash{'src_'.$rid}).'&';
       }
   # --------------------------------------- append randomout entry to environment
       if ($randomoutentry) {
    &Apache::lonnet::appenv({'acc.randomout' => $randomoutentry});
       }
 }  }
   
 # ---------------------------------------------------- Read map and all submaps  # ---------------------------------------------------- Read map and all submaps
   
 sub readmap {  sub readmap {
    my $short=shift;      my $short=shift;
    $short=~s/^\///;      $short=~s/^\///;
    my %cenv=&Apache::lonnet::coursedescription($short);      my %cenv=&Apache::lonnet::coursedescription($short,{'freshen_cache'=>1});
    my $fn=$cenv{'fn'};      my $fn=$cenv{'fn'};
    my $uri;      my $uri;
    $short=~s/\//\_/g;      $short=~s/\//\_/g;
    unless ($uri=$cenv{'url'}) {       unless ($uri=$cenv{'url'}) { 
       &Apache::lonnet::logthis("<font color=blue>WARNING: ".   &Apache::lonnet::logthis("<font color=blue>WARNING: ".
                        "Could not load course $short.</font>");    "Could not load course $short.</font>"); 
       return 'No course data available.';   return ('',&mt('No course data available.'));;
    }      }
    @cond=('true:normal');      @cond=('true:normal');
    unlink($fn.'.db');  
    unlink($fn.'_symb.db');      open(LOCKFILE,">$fn.db.lock");
    unlink($fn.'.state');      my $lock=0;
    unlink($fn.'parms.db');      if (flock(LOCKFILE,LOCK_EX|LOCK_NB)) {
    $retfurl='';   $lock=1;
    if ((tie(%hash,'GDBM_File',"$fn.db",&GDBM_WRCREAT,0640)) &&   unlink($fn.'.db');
        (tie(%parmhash,'GDBM_File',$fn.'_parms.db',&GDBM_WRCREAT,0640))) {   unlink($fn.'_symb.db');
     %hash=();   unlink($fn.'.state');
     %parmhash=();   unlink($fn.'parms.db');
     $errtext='';      }
     $pc=0;      undef %randompick;
     loadmap($uri);      undef %hiddenurl;
     if (defined($hash{'map_start_'.$uri})) {      undef %encurl;
         &traceroute('0',$hash{'map_start_'.$uri},'&');      $retfrid='';
         &accinit($uri,$short,$fn);      if ($lock && (tie(%hash,'GDBM_File',"$fn.db",&GDBM_WRCREAT(),0640)) &&
     }   (tie(%parmhash,'GDBM_File',$fn.'_parms.db',&GDBM_WRCREAT(),0640))) {
     unless ((untie(%hash)) && (untie(%parmhash))) {   %hash=();
       &Apache::lonnet::logthis("<font color=blue>WARNING: ".   %parmhash=();
                        "Could not untie coursemap $fn for $uri.</font>");    $errtext='';
     }   $pc=0;
     {   &clear_mapalias_count();
      my $cfh;   &processversionfile(%cenv);
      if ($cfh=Apache::File->new(">$fn.state")) {   my $furi=&Apache::lonnet::clutter($uri);
         print $cfh join("\n",@cond);   $hash{'src_0.0'}=&versiontrack($furi);
      } else {   $hash{'title_0.0'}=&Apache::lonnet::metadata($uri,'title');
       &Apache::lonnet::logthis("<font color=blue>WARNING: ".   $hash{'ids_'.$furi}='0.0';
                        "Could not write statemap $fn for $uri.</font>");    $hash{'is_map_0.0'}=1;
      }   loadmap($uri,'0.0');
     }     if (defined($hash{'map_start_'.$uri})) {
    } else {      &Apache::lonnet::appenv({"request.course.id"  => $short,
       &Apache::lonnet::logthis("<font color=blue>WARNING: ".       "request.course.fn"  => $fn,
                        "Could not tie coursemap $fn for $uri.</font>");        "request.course.uri" => $uri});
    }      $env{'request.course.id'}=$short;
    &Apache::lonmsg::author_res_msg($ENV{'request.course.uri'},$errtext);      &traceroute('0',$hash{'map_start_'.$uri},'&');
    return ($retfurl,$errtext);      &accinit($uri,$short,$fn);
       &hiddenurls();
    }
    $errtext .= &get_mapalias_errors();
   # ------------------------------------------------------- Put versions into src
    foreach my $key (keys(%hash)) {
       if ($key=~/^src_/) {
    $hash{$key}=&putinversion($hash{$key});
       } elsif ($key =~ /^(map_(?:start|finish|pc)_)(.*)/) {
    my ($type, $url) = ($1,$2);
    my $value = $hash{$key};
    $hash{$type.&putinversion($url)}=$value;
       }
    }
   # ---------------------------------------------------------------- Encrypt URLs
    foreach my $id (keys(%encurl)) {
   #    $hash{'src_'.$id}=&Apache::lonenc::encrypted($hash{'src_'.$id});
       $hash{'encrypted_'.$id}=1;
    }
   # ----------------------------------------------- Close hashes to finally store
   # --------------------------------- Routine must pass this point, no early outs
    $hash{'first_rid'}=$retfrid;
    my ($mapid,$resid)=split(/\./,$retfrid);
    $hash{'first_mapurl'}=$hash{'map_id_'.$mapid};
    my $symb=&Apache::lonnet::encode_symb($hash{'map_id_'.$mapid},$resid,$hash{'src_'.$retfrid});
    $retfurl=&add_get_param($hash{'src_'.$retfrid},{ 'symb' => $symb });
    if ($hash{'encrypted_'.$retfrid}) {
       $retfurl=&Apache::lonenc::encrypted($retfurl,(&Apache::lonnet::allowed('adv') ne 'F'));
    }
    $hash{'first_url'}=$retfurl;
    unless ((untie(%hash)) && (untie(%parmhash))) {
       &Apache::lonnet::logthis("<font color=blue>WARNING: ".
        "Could not untie coursemap $fn for $uri.</font>"); 
    }
   # ---------------------------------------------------- Store away initial state
    {
       my $cfh;
       if (open($cfh,">$fn.state")) {
    print $cfh join("\n",@cond);
       } else {
    &Apache::lonnet::logthis("<font color=blue>WARNING: ".
    "Could not write statemap $fn for $uri.</font>"); 
       }
    }
    flock(LOCKFILE,LOCK_UN);
    close(LOCKFILE);
       } else {
    # if we are here it is likely because we are already trying to 
    # initialize the course in another child, busy wait trying to 
    # tie the hashes for the next 90 seconds, if we succeed forward 
    # them on to navmaps, if we fail, throw up the Could not init 
    # course screen
    if ($lock) {
       # Got the lock but not the DB files
       flock(LOCKFILE,LOCK_UN);
    }
    untie(%hash);
    untie(%parmhash);
    &Apache::lonnet::logthis("<font color=blue>WARNING: ".
    "Could not tie coursemap $fn for $uri.</font>"); 
    my $i=0;
    while($i<90) {
       $i++;
       sleep(1);
       if (flock(LOCKFILE,LOCK_EX|LOCK_NB) &&
    (tie(%hash,'GDBM_File',"$fn.db",&GDBM_READER(),0640))) {
    if (tie(%parmhash,'GDBM_File',$fn.'_parms.db',&GDBM_READER(),0640)) {
       $retfurl='/adm/navmaps';
       &Apache::lonnet::appenv({"request.course.id"  => $short,
        "request.course.fn"  => $fn,
        "request.course.uri" => $uri});
       untie(%hash);
       untie(%parmhash);
       last;
    }
       }
       untie(%hash);
       untie(%parmhash);
    }
    flock(LOCKFILE,LOCK_UN);
    close(LOCKFILE);
       }
       &Apache::lonmsg::author_res_msg($env{'request.course.uri'},$errtext);
   # ------------------------------------------------- Check for critical messages
   
       my @what=&Apache::lonnet::dump('critical',$env{'user.domain'},
      $env{'user.name'});
       if ($what[0]) {
    if (($what[0] ne 'con_lost') && ($what[0]!~/^error\:/)) {
       $retfurl='/adm/email?critical=display';
           }
       }
       return ($retfurl,$errtext);
 }  }
   
 # ------------------------------------------------------- Evaluate state string  # ------------------------------------------------------- Evaluate state string
   
 sub evalstate {  sub evalstate {
       my $fn=$env{'request.course.fn'}.'.state';
     my $fn=$ENV{'request.course.fn'}.'.state';      my $state='';
     my $state='2';  
     if (-e $fn) {      if (-e $fn) {
        my @conditions=();   my @conditions=();
        {   {
         my $fh=Apache::File->new($fn);      open(my $fh,"<$fn");
         @conditions=<$fh>;      @conditions=<$fh>;
        }                close($fh);
        my $safeeval = new Safe;   }  
        my $safehole = new Safe::Hole;   my $safeeval = new Safe;
        $safeeval->permit("entereval");   my $safehole = new Safe::Hole;
        $safeeval->permit(":base_math");   $safeeval->permit("entereval");
        $safeeval->deny(":base_io");   $safeeval->permit(":base_math");
        $safehole->wrap(\&Apache::lonnet::EXT,$safeeval,'&EXT');   $safeeval->deny(":base_io");
        foreach (@conditions) {   $safehole->wrap(\&Apache::lonnet::EXT,$safeeval,'&EXT');
    my $line=$_;   foreach my $line (@conditions) {
            chomp($line);      chomp($line);
    my ($condition,$weight)=split(/\:/,$_);      my ($condition,$weight)=split(/\:/,$line);
            if ($safeeval->reval($condition)) {      if ($safeeval->reval($condition)) {
        if ($weight eq 'force') {   if ($weight eq 'force') {
    $state.='3';      $state.='3';
                } else {   } else {
                    $state.='2';      $state.='2';
                }   }
            } else {      } else {
                if ($weight eq 'stop') {   if ($weight eq 'stop') {
    $state.='0';      $state.='0';
                } else {   } else {
                    $state.='1';      $state.='1';
                }   }
            }      }
        }   }
     }      }
     &Apache::lonnet::appenv('user.state.'.$ENV{'request.course.id'} => $state);      &Apache::lonnet::appenv({'user.state.'.$env{'request.course.id'} => $state});
     return $state;      return $state;
 }  }
   
   {
       my %mapalias_cache;
       sub count_mapalias {
    my ($value,$resid) = @_;
     push(@{ $mapalias_cache{$value} }, $resid);
       }
   
       sub get_mapalias_errors {
    my $error_text;
    foreach my $mapalias (sort(keys(%mapalias_cache))) {
       next if (scalar(@{ $mapalias_cache{$mapalias} } ) == 1);
       my $count;
       my $which =
    join('</li><li>', 
        map {
    my $id = $_;
    if (exists($hash{'src_'.$id})) {
        $count++;
    }
    my ($mapid) = split(/\./,$id);
                            &mt('Resource "[_1]" <br /> in Map "[_2]"',
        $hash{'title_'.$id},
        $hash{'title_'.$hash{'ids_'.$hash{'map_id_'.$mapid}}});
        } (@{ $mapalias_cache{$mapalias} }));
       next if ($count < 2);
       $error_text .= '<div class="LC_error">'.
    &mt('Error: Found the mapalias "[_1]" defined multiple times.',
       $mapalias).
    '</div><ul><li>'.$which.'</li></ul>';
    }
    &clear_mapalias_count();
    return $error_text;
       }
       sub clear_mapalias_count {
    undef(%mapalias_cache);
       }
   }
 1;  1;
 __END__  __END__
   
Line 511  of course for user. Line 877  of course for user.
 This is part of the LearningOnline Network with CAPA project  This is part of the LearningOnline Network with CAPA project
 described at http://www.lon-capa.org.  described at http://www.lon-capa.org.
   
 =head1 HANDLER SUBROUTINE  =head1 SUBROUTINES
   
 There is no handler subroutine.  
   
 =head1 OTHER SUBROUTINES  
   
 =over 4  =over
   
 =item *  =item loadmap()
   
 loadmap() : Loads map from disk  Loads map from disk
   
 =item *  =item simplify()
   
 simplify() : Simplify expression  Simplify expression
   
 =item *  =item traceroute()
   
 traceroute() : Build condition hash  Build condition hash
   
 =item *  =item accinit()
   
 accinit() : Cascading conditions, quick access, parameters  Cascading conditions, quick access, parameters
   
 =item *  =item readmap()
   
 readmap() : Read map and all submaps  Read map and all submaps
   
 =item *  =item evalstate()
   
 evalstate() : Evaluate state string  Evaluate state string
   
 =back  =back
   
Removed from v.1.27  
changed lines
  Added in v.1.129

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