--- loncom/lonnet/perl/lonnet.pm 2014/02/24 03:09:05 1.1172.2.40 +++ loncom/lonnet/perl/lonnet.pm 2012/10/31 12:54:23 1.1193 @@ -1,7 +1,7 @@ # The LearningOnline Network # TCP networking package # -# $Id: lonnet.pm,v 1.1172.2.40 2014/02/24 03:09:05 raeburn Exp $ +# $Id: lonnet.pm,v 1.1193 2012/10/31 12:54:23 raeburn Exp $ # # Copyright Michigan State University Board of Trustees # @@ -75,6 +75,9 @@ use LWP::UserAgent(); use HTTP::Date; use Image::Magick; + +use Encode; + use vars qw(%perlvar %spareid %pr %prp $memcache %packagetab $tmpdir $_64bit %env %protocol %loncaparevs %serverhomeIDs %needsrelease %managerstab); @@ -109,6 +112,7 @@ require Exporter; our @ISA = qw (Exporter); our @EXPORT = qw(%env); + # ------------------------------------ Logging (parameters, docs, slots, roles) { my $logid; @@ -123,19 +127,19 @@ our @EXPORT = qw(%env); $logid ++; my $now = time(); my $id=$now.'00000'.$$.'00000'.$logid; - my $logentry = { - $id => { - 'exe_uname' => $env{'user.name'}, - 'exe_udom' => $env{'user.domain'}, - 'exe_time' => $now, - 'exe_ip' => $ENV{'REMOTE_ADDR'}, - 'delflag' => $delflag, - 'logentry' => $storehash, - 'uname' => $uname, - 'udom' => $udom, - } + my $logentry = { + $id => { + 'exe_uname' => $env{'user.name'}, + 'exe_udom' => $env{'user.domain'}, + 'exe_time' => $now, + 'exe_ip' => $ENV{'REMOTE_ADDR'}, + 'delflag' => $delflag, + 'logentry' => $storehash, + 'uname' => $uname, + 'udom' => $udom, + } }; - return &put('nohist_'.$hash_name,$logentry,$cdom,$cnum); + return &put('nohist_'.$hash_name,$logentry,$cdom,$cnum); } } @@ -352,11 +356,9 @@ sub get_remote_globals { } sub remote_devalidate_cache { - my ($lonhost,$cachekeys) = @_; - my $items; - return unless (ref($cachekeys) eq 'ARRAY'); - my $cachestr = join('&',@{$cachekeys}); - return &reply('devalidatecache:'.&escape($cachestr),$lonhost); + my ($lonhost,$name,$id) = @_; + my $response = &reply('devalidatecache:'.&escape($name).':'.&escape($id),$lonhost); + return $response; } # -------------------------------------------------- Non-critical communication @@ -601,7 +603,7 @@ sub transfer_profile_to_env { # ---------------------------------------------------- Check for valid session sub check_for_valid_session { - my ($r,$name,$userhashref) = @_; + my ($r,$name) = @_; my %cookies=CGI::Cookie->parse($r->header_in('Cookie')); if ($name eq '') { $name = 'lonID'; @@ -632,12 +634,6 @@ sub check_for_valid_session { || !defined($disk_env{'user.domain'})) { return undef; } - - if (ref($userhashref) eq 'HASH') { - $userhashref->{'name'} = $disk_env{'user.name'}; - $userhashref->{'domain'} = $disk_env{'user.domain'}; - } - return $handle; } @@ -671,7 +667,7 @@ sub appenv { if (($key =~ /^user\.role/) || ($key =~ /^user\.priv/)) { $refused = 1; if (ref($roles) eq 'ARRAY') { - my ($type,$role) = ($key =~ m{^user\.(role|priv)\.(.+?)\./}); + my ($type,$role) = ($key =~ /^user\.(role|priv)\.([^.]+)\./); if (grep(/^\Q$role\E$/,@{$roles})) { $refused = 0; } @@ -1270,7 +1266,7 @@ sub check_loadbalancing { } } if (ref($result) eq 'HASH') { - ($is_balancer,$currtargets,$currrules) = + ($is_balancer,$currtargets,$currrules) = &check_balancer_result($result,@hosts); if ($is_balancer) { if (ref($currrules) eq 'HASH') { @@ -1320,7 +1316,7 @@ sub check_loadbalancing { } } } elsif (($homeintdom) && ($udom ne $serverhomedom)) { - ($result,$cached)=&is_cached_new('loadbalancing',$serverhomedom); + my ($result,$cached)=&is_cached_new('loadbalancing',$serverhomedom); unless (defined($cached)) { my %domconfig = &Apache::lonnet::get_dom('configuration',['loadbalancing'],$serverhomedom); @@ -1329,7 +1325,7 @@ sub check_loadbalancing { } } if (ref($result) eq 'HASH') { - ($is_balancer,$currtargets,$currrules) = + ($is_balancer,$currtargets,$currrules) = &check_balancer_result($result,@hosts); if ($is_balancer) { if (ref($currrules) eq 'HASH') { @@ -1385,8 +1381,8 @@ sub check_loadbalancing { $is_balancer = 0; if ($uname ne '' && $udom ne '') { if (($env{'user.name'} eq $uname) && ($env{'user.domain'} eq $udom)) { - - &appenv({'user.loadbalexempt' => $lonhost, + + &appenv({'user.loadbalexempt' => $lonhost, 'user.loadbalcheck.time' => time}); } } @@ -1575,36 +1571,6 @@ sub idput { } } -# ---------------------------------------- Delete unwanted IDs from ids.db file - -sub iddel { - my ($udom,$idshashref,$uhome)=@_; - my %result=(); - unless (ref($idshashref) eq 'HASH') { - return %result; - } - my %servers=(); - while (my ($id,$uname) = each(%{$idshashref})) { - my $uhom; - if ($uhome) { - $uhom = $uhome; - } else { - $uhom=&homeserver($uname,$udom); - } - if ($uhom ne 'no_host') { - if ($servers{$uhom}) { - $servers{$uhom}.='&'.&escape($id); - } else { - $servers{$uhom}=&escape($id); - } - } - } - foreach my $server (keys(%servers)) { - $result{$server} = &critical('iddel:'.$udom.':'.$servers{$server},$uhome); - } - return %result; -} - # ------------------------------dump from db file owned by domainconfig user sub dump_dom { my ($namespace, $udom, $regexp) = @_; @@ -1981,15 +1947,12 @@ sub inst_userrules { # ------------- Get Authentication, Language and User Tools Defaults for Domain sub get_domain_defaults { - my ($domain,$ignore_cache) = @_; - return if (($domain eq '') || ($domain eq 'public')); + my ($domain) = @_; my $cachetime = 60*60*24; - unless ($ignore_cache) { - my ($result,$cached)=&is_cached_new('domdefaults',$domain); - if (defined($cached)) { - if (ref($result) eq 'HASH') { - return %{$result}; - } + my ($result,$cached)=&is_cached_new('domdefaults',$domain); + if (defined($cached)) { + if (ref($result) eq 'HASH') { + return %{$result}; } } my %domdefaults; @@ -2015,19 +1978,16 @@ sub get_domain_defaults { $domdefaults{'defaultquota'} = $domconfig{'quotas'}{'defaultquota'}; } else { $domdefaults{'defaultquota'} = $domconfig{'quotas'}; - } + } my @usertools = ('aboutme','blog','webdav','portfolio'); foreach my $item (@usertools) { if (ref($domconfig{'quotas'}{$item}) eq 'HASH') { $domdefaults{$item} = $domconfig{'quotas'}{$item}; } } - if (ref($domconfig{'quotas'}{'authorquota'}) eq 'HASH') { - $domdefaults{'authorquota'} = $domconfig{'quotas'}{'authorquota'}; - } } if (ref($domconfig{'requestcourses'}) eq 'HASH') { - foreach my $item ('official','unofficial','community','textbook') { + foreach my $item ('official','unofficial','community') { $domdefaults{$item} = $domconfig{'requestcourses'}{$item}; } } @@ -2040,16 +2000,8 @@ sub get_domain_defaults { } } if (ref($domconfig{'coursedefaults'}) eq 'HASH') { - if (ref($domconfig{'coursedefaults'}{'coursecredits'}) eq 'HASH') { - $domdefaults{'officialcredits'} = $domconfig{'coursedefaults'}{'coursecredits'}{'official'}; - $domdefaults{'unofficialcredits'} = $domconfig{'coursedefaults'}{'coursecredits'}{'unofficial'}; - $domdefaults{'textbookcredits'} = $domconfig{'coursedefaults'}{'coursecredits'}{'textbook'}; - } - if (ref($domconfig{'coursedefaults'}{'uploadquota'}) eq 'HASH') { - $domdefaults{'officialquota'} = $domconfig{'coursedefaults'}{'uploadquota'}{'official'}; - $domdefaults{'unofficialquota'} = $domconfig{'coursedefaults'}{'uploadquota'}{'unofficial'}; - $domdefaults{'communityquota'} = $domconfig{'coursedefaults'}{'uploadquota'}{'community'}; - $domdefaults{'textbookquota'} = $domconfig{'coursedefaults'}{'uploadquota'}{'textbook'}; + foreach my $item ('canuse_pdfforms') { + $domdefaults{$item} = $domconfig{'coursedefaults'}{$item}; } } if (ref($domconfig{'usersessions'}) eq 'HASH') { @@ -2060,7 +2012,8 @@ sub get_domain_defaults { $domdefaults{'hostedsessions'} = $domconfig{'usersessions'}{'hosted'}; } } - &do_cache_new('domdefaults',$domain,\%domdefaults,$cachetime); + &Apache::lonnet::do_cache_new('domdefaults',$domain,\%domdefaults, + $cachetime); return %domdefaults; } @@ -2657,10 +2610,13 @@ sub ssi { $request->header(Cookie => $ENV{'HTTP_COOKIE'}); my $response= $ua->request($request); + my $content = $response->content; + + if (wantarray) { - return ($response->content, $response); + return ($content, $response); } else { - return $response->content; + return $content; } } @@ -2692,176 +2648,34 @@ sub allowuploaded { # # Determine if the current user should be able to edit a particular resource, # when viewing in course context. -# (a) When viewing resource used to determine if "Edit" item is included in +# (a) When viewing resource used to determine if "Edit" item is included in # Functions. # (b) When displaying folder contents in course editor, used to determine if # "Edit" link will be displayed alongside resource. # -# input: six args -- filename (decluttered), course number, course domain, -# url, symb (if registered) and group (if this is a group -# item -- e.g., bulletin board, group page etc.). -# output: array of five scalars -- +# input: 3 args -- filename (decluttered), course number and course domain. +# output: array of four scalars -- # $cfile -- url for file editing if editable on current server # $home -- homeserver of resource (i.e., for author if published, # or course if uploaded.). # $switchserver -- 1 if server switch will be needed. -# $forceedit -- 1 if icon/link should be to go to edit mode -# $forceview -- 1 if icon/link should be to go to view mode +# $uploaded -- 1 if resource is a file uploaded to a course. # sub can_edit_resource { - my ($file,$cnum,$cdom,$resurl,$symb,$group) = @_; - my ($cfile,$home,$switchserver,$forceedit,$forceview,$uploaded,$incourse); -# -# For aboutme pages user can only edit his/her own. -# - if ($resurl =~ m{^/?adm/($match_domain)/($match_username)/aboutme$}) { - my ($sdom,$sname) = ($1,$2); - if (($sdom eq $env{'user.domain'}) && ($sname eq $env{'user.name'})) { - $home = $env{'user.home'}; - $cfile = $resurl; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - return ($cfile,$home,$switchserver,$forceedit,$forceview); - } else { - return; - } - } - - if ($env{'request.course.id'}) { - my $crsedit = &Apache::lonnet::allowed('mdc',$env{'request.course.id'}); - if ($group ne '') { -# if this is a group homepage or group bulletin board, check group privs - my $allowed = 0; - if ($resurl =~ m{^/?adm/$cdom/$cnum/$group/smppg$}) { - if ((&allowed('mdg',$env{'request.course.id'}. - ($env{'request.course.sec'}?'/'.$env{'request.course.sec'}:''))) || - (&allowed('mgh',$env{'request.course.id'}.'/'.$group)) || $crsedit) { - $allowed = 1; - } - } elsif ($resurl =~ m{^/?adm/$cdom/$cnum/\d+/bulletinboard$}) { - if ((&allowed('mdg',$env{'request.course.id'}.($env{'request.course.sec'}?'/'.$env{'request.course.sec'}:''))) || - (&allowed('cgb',$env{'request.course.id'}.'/'.$group)) || $crsedit) { - $allowed = 1; - } - } - if ($allowed) { - $home=&homeserver($cnum,$cdom); - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = $resurl; - } else { - return; - } - } else { - if ($resurl =~ m{^/?adm/viewclasslist$}) { - unless (&Apache::lonnet::allowed('opa',$env{'request.course.id'})) { - return; - } - } elsif (!$crsedit) { -# -# No edit allowed where CC has switched to student role. -# - return; - } - } - } - + my ($file,$cnum,$cdom) = @_; + my ($cfile,$home,$switchserver,$uploaded); if ($file ne '') { if (($cnum =~ /$match_courseid/) && ($cdom =~ /$match_domain/)) { - if (&is_course_upload($file,$cnum,$cdom)) { - $uploaded = 1; - $incourse = 1; + $uploaded = &is_course_upload($file,$cnum,$cdom); + if ($uploaded) { + $home=&homeserver($cnum,$cdom); if ($file =~/\.(htm|html|css|js|txt)$/) { $cfile = &hreflocation('',$file); - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } } - } elsif ($resurl =~ m{^/public/$cdom/$cnum/syllabus}) { - $incourse = 1; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = $resurl; - } elsif (($resurl ne '') && (&is_on_map($resurl))) { - if ($resurl =~ m{^/adm/$match_domain/$match_username/\d+/smppg|bulletinboard$}) { - $incourse = 1; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = $resurl; - } elsif ($resurl eq '/res/lib/templates/simpleproblem.problem') { - $incourse = 1; - $cfile = $resurl.'/smpedit'; - } elsif ($resurl =~ m{^/adm/wrapper/ext/}) { - $incourse = 1; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = $resurl; - } elsif ($resurl =~ m{^/?adm/viewclasslist$}) { - $incourse = 1; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = ($resurl =~ m{^/} ? $resurl : "/$resurl"); - } - } elsif ($resurl eq '/res/lib/templates/simpleproblem.problem/smpedit') { - my $template = '/res/lib/templates/simpleproblem.problem'; - if (&is_on_map($template)) { - $incourse = 1; - $forceview = 1; - $cfile = $template; - } - } elsif (($resurl =~ m{^/adm/wrapper/ext/}) && ($env{'form.folderpath'} =~ /^supplemental/)) { - $incourse = 1; - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = $resurl; - } elsif (($resurl eq '/adm/extresedit') && ($symb || $env{'form.folderpath'})) { - $incourse = 1; - $forceview = 1; - if ($symb) { - my ($map,$id,$res)=&decode_symb($symb); - $env{'request.symb'} = $symb; - $cfile = &clutter($res); - } else { - $cfile = $env{'form.suppurl'}; - $cfile =~ s{^http://}{}; - $cfile = '/adm/wrapper/ext/'.$cfile; - } - } elsif ($resurl =~ m{^/?adm/viewclasslist$}) { - if ($env{'form.forceedit'}) { - $forceview = 1; - } else { - $forceedit = 1; - } - $cfile = ($resurl =~ m{^/} ? $resurl : "/$resurl"); } } - if ($uploaded || $incourse) { - $home=&homeserver($cnum,$cdom); - } elsif ($file !~ m{/$}) { + unless ($uploaded) { $file=~s{^(priv/$match_domain/$match_username)}{/$1}; $file=~s{^($match_domain/$match_username)}{/priv/$1}; # Check that the user has permission to edit this resource @@ -2872,81 +2686,27 @@ sub can_edit_resource { $cfile=$file; } } - if (($cfile ne '') && (!$incourse || $uploaded) && - (($home ne '') && ($home ne 'no_host'))) { + if (($cfile ne '') && (($home ne '') && ($home ne 'no_host'))) { my @ids=¤t_machine_ids(); unless (grep(/^\Q$home\E$/,@ids)) { $switchserver=1; } } } - return ($cfile,$home,$switchserver,$forceedit,$forceview); + return ($cfile,$home,$switchserver,$uploaded); } sub is_course_upload { my ($file,$cnum,$cdom) = @_; my $uploadpath = &LONCAPA::propath($cdom,$cnum); $uploadpath =~ s{^\/}{}; - if (($file =~ m{^\Q$uploadpath\E/userfiles/(docs|supplemental)/}) || - ($file =~ m{^userfiles/\Q$cdom\E/\Q$cnum\E/(docs|supplemental)/})) { + if (($file =~ m{^\Q$uploadpath\E/userfiles/docs/}) || + ($file =~ m{^userfiles/\Q$cdom\E/\Q$cnum\E/docs/})) { return 1; } return; } -sub in_course { - my ($udom,$uname,$cdom,$cnum,$type,$hideprivileged) = @_; - if ($hideprivileged) { - my $skipuser; - my %coursehash = &coursedescription($cdom.'_'.$cnum); - my @possdoms = ($cdom); - if ($coursehash{'checkforpriv'}) { - push(@possdoms,split(/,/,$coursehash{'checkforpriv'})); - } - if (&privileged($uname,$udom,\@possdoms)) { - $skipuser = 1; - if ($coursehash{'nothideprivileged'}) { - foreach my $item (split(/\s*\,\s*/,$coursehash{'nothideprivileged'})) { - my $user; - if ($item =~ /:/) { - $user = $item; - } else { - $user = join(':',split(/[\@]/,$item)); - } - if ($user eq $uname.':'.$udom) { - undef($skipuser); - last; - } - } - } - if ($skipuser) { - return 0; - } - } - } - $type ||= 'any'; - if (!defined($cdom) || !defined($cnum)) { - my $cid = $env{'request.course.id'}; - $cdom = $env{'course.'.$cid.'.domain'}; - $cnum = $env{'course.'.$cid.'.num'}; - } - my $typesref; - if (($type eq 'any') || ($type eq 'all')) { - $typesref = ['active','previous','future']; - } elsif ($type eq 'previous' || $type eq 'future') { - $typesref = [$type]; - } - my %roles = &get_my_roles($uname,$udom,'userroles', - $typesref,undef,[$cdom]); - my ($tmp) = keys(%roles); - return 0 if ($tmp =~ /^(con_lost|error|no_such_host)/i); - my @course_roles = grep(/^\Q$cnum\E:\Q$cdom\E:/, keys(%roles)); - if (@course_roles > 0) { - return 1; - } - return 0; -} - # --------- File operations in /home/httpd/html/userfiles/$domain/1/2/3/$course # input: action, courseID, current domain, intended # path to file, source of file, instruction to parse file for objects, @@ -3237,9 +2997,7 @@ sub userfileupload { $codebase,$thumbwidth,$thumbheight, $resizewidth,$resizeheight,$context,$mimetype); } else { - if ($env{'form.folder'}) { - $fname=$env{'form.folder'}.'/'.$fname; - } + $fname=$env{'form.folder'}.'/'.$fname; return &process_coursefile('uploaddoc',$docuname,$docudom, $fname,$formname,$parser, $allfiles,$codebase,$mimetype); @@ -3254,7 +3012,7 @@ sub userfileupload { } else { my $docuname=$env{'user.name'}; my $docudom=$env{'user.domain'}; - if ((exists($env{'form.group'})) || ($context eq 'syllabus')) { + if (exists($env{'form.group'})) { $docuname=$env{'course.'.$env{'request.course.id'}.'.num'}; $docudom=$env{'course.'.$env{'request.course.id'}.'.domain'}; } @@ -3404,9 +3162,7 @@ sub extract_embedded_items { &add_filetype($allfiles,$attr->{'src'},'src'); } if (lc($tagname) eq 'a') { - unless (($attr->{'href'} =~ /^#/) || ($attr->{'href'} eq '')) { - &add_filetype($allfiles,$attr->{'href'},'href'); - } + &add_filetype($allfiles,$attr->{'href'},'href'); } if (lc($tagname) eq 'script') { my $src; @@ -3494,26 +3250,8 @@ sub extract_embedded_items { } } } - if (lc($tagname) eq 'iframe') { - my $src = $attr->{'src'} ; - if (($src ne '') && ($src !~ m{^(/|https?://)})) { - &add_filetype($allfiles,$src,'src'); - } elsif ($src =~ m{^/}) { - if ($env{'request.course.id'}) { - my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; - my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; - my $url = &hreflocation('',$fullpath); - if ($url =~ m{^/uploaded/$cdom/$cnum/docs/(\w+/\d+)/}) { - my $relpath = $1; - if ($src =~ m{^/uploaded/$cdom/$cnum/docs/\Q$relpath\E/(.+)$}) { - &add_filetype($allfiles,$1,'src'); - } - } - } - } - } if ($t->[4] =~ m{/>$}) { - pop(@state); + pop(@state); } } elsif ($t->[0] eq 'E') { my ($tagname) = ($t->[1]); @@ -3955,10 +3693,6 @@ sub get_course_adv_roles { $nothide{$user}=1; } } - my @possdoms = ($coursehash{'domain'}); - if ($coursehash{'checkforpriv'}) { - push(@possdoms,split(/,/,$coursehash{'checkforpriv'})); - } my %returnhash=(); my %dumphash= &dump('nohist_userroles',$coursehash{'domain'},$coursehash{'num'}); @@ -3971,7 +3705,20 @@ sub get_course_adv_roles { if (($tstart) && ($now<$tstart)) { next; } my ($role,$username,$domain,$section)=split(/\:/,$entry); if ($username eq '' || $domain eq '') { next; } - if ((&privileged($username,$domain,\@possdoms)) && + unless (ref($privileged{$domain}) eq 'HASH') { + my %dompersonnel = + &Apache::lonnet::get_domain_roles($domain,['dc'],$now,$now); + $privileged{$domain} = {}; + foreach my $server (keys(%dompersonnel)) { + if (ref($dompersonnel{$server}) eq 'HASH') { + foreach my $user (keys(%{$dompersonnel{$server}})) { + my ($trole,$uname,$udom) = split(/:/,$user); + $privileged{$udom}{$uname} = 1; + } + } + } + } + if ((exists($privileged{$domain}{$username})) && (!$nothide{$username.':'.$domain})) { next; } if ($role eq 'cr') { next; } if ($codes) { @@ -4002,7 +3749,8 @@ sub get_my_roles { if ($context eq 'userroles') { %dumphash = &dump('roles',$udom,$uname); } else { - %dumphash = &dump('nohist_userroles',$udom,$uname); + %dumphash= + &dump('nohist_userroles',$udom,$uname); if ($hidepriv) { my %coursehash=&coursedescription($udom.'_'.$uname); foreach my $user (split(/\s*\,\s*/,$coursehash{'nothideprivileged'})) { @@ -4070,15 +3818,28 @@ sub get_my_roles { } } if ($hidepriv) { - my @privroles = ('dc','su'); if ($context eq 'userroles') { - next if (grep(/^\Q$role\E$/,@privroles)); + if ((&privileged($username,$domain)) && + (!$nothide{$username.':'.$domain})) { + next; + } } else { - my $possdoms = [$domain]; - if (ref($roledoms) eq 'ARRAY') { - push(@{$possdoms},@{$roledoms}); + unless (ref($privileged{$domain}) eq 'HASH') { + my %dompersonnel = + &Apache::lonnet::get_domain_roles($domain,['dc'],$now,$now); + $privileged{$domain} = {}; + if (keys(%dompersonnel)) { + foreach my $server (keys(%dompersonnel)) { + if (ref($dompersonnel{$server}) eq 'HASH') { + foreach my $user (keys(%{$dompersonnel{$server}})) { + my ($trole,$uname,$udom) = split(/:/,$user); + $privileged{$udom}{$uname} = $trole; + } + } + } + } } - if (&privileged($username,$domain,$possdoms,\@privroles)) { + if (exists($privileged{$domain}{$username})) { if (!$nothide{$username.':'.$domain}) { next; } @@ -4170,8 +3931,7 @@ sub courseiddump { my ($domfilter,$descfilter,$sincefilter,$instcodefilter,$ownerfilter, $coursefilter,$hostidflag,$hostidref,$typefilter,$regexp_ok, $selfenrollonly,$catfilter,$showhidden,$caller,$cloner,$cc_clone, - $cloneonly,$createdbefore,$createdafter,$creationcontext,$domcloner, - $hasuniquecode)=@_; + $cloneonly,$createdbefore,$createdafter,$creationcontext,$domcloner)=@_; my $as_hash = 1; my %returnhash; if (!$domfilter) { $domfilter=''; } @@ -4184,17 +3944,17 @@ sub courseiddump { if (($domfilter eq '') || (&host_domain($tryserver) eq $domfilter)) { my $rep; - if (grep { $_ eq $tryserver } ¤t_machine_ids()) { - $rep = &LONCAPA::Lond::dump_course_id_handler( - join(":", (&host_domain($tryserver), $sincefilter, - &escape($descfilter), &escape($instcodefilter), + if (grep { $_ eq $tryserver } current_machine_ids()) { + $rep = LONCAPA::Lond::dump_course_id_handler( + join(":", (&host_domain($tryserver), $sincefilter, + &escape($descfilter), &escape($instcodefilter), &escape($ownerfilter), &escape($coursefilter), - &escape($typefilter), &escape($regexp_ok), - $as_hash, &escape($selfenrollonly), - &escape($catfilter), $showhidden, $caller, - &escape($cloner), &escape($cc_clone), $cloneonly, - &escape($createdbefore), &escape($createdafter), - &escape($creationcontext), $domcloner, $hasuniquecode))); + &escape($typefilter), &escape($regexp_ok), + $as_hash, &escape($selfenrollonly), + &escape($catfilter), $showhidden, $caller, + &escape($cloner), &escape($cc_clone), $cloneonly, + &escape($createdbefore), &escape($createdafter), + &escape($creationcontext), $domcloner))); } else { $rep = &reply('courseiddump:'.&host_domain($tryserver).':'. $sincefilter.':'.&escape($descfilter).':'. @@ -4205,10 +3965,10 @@ sub courseiddump { $showhidden.':'.$caller.':'.&escape($cloner).':'. &escape($cc_clone).':'.$cloneonly.':'. &escape($createdbefore).':'.&escape($createdafter).':'. - &escape($creationcontext).':'.$domcloner.':'.$hasuniquecode, + &escape($creationcontext).':'.$domcloner, $tryserver); } - + my @pairs=split(/\&/,$rep); foreach my $item (@pairs) { my ($key,$value)=split(/\=/,$item,2); @@ -4314,7 +4074,7 @@ sub get_domain_roles { } my $rolelist; if (ref($roles) eq 'ARRAY') { - $rolelist = join('&',@{$roles}); + $rolelist = join(':',@{$roles}); } my %personnel = (); @@ -4407,92 +4167,6 @@ sub set_first_access { return 'already_set'; } } - -sub checkout { - my ($symb,$tuname,$tudom,$tcrsid)=@_; - my $now=time; - my $lonhost=$perlvar{'lonHostID'}; - my $infostr=&escape( - 'CHECKOUTTOKEN&'. - $tuname.'&'. - $tudom.'&'. - $tcrsid.'&'. - $symb.'&'. - $now.'&'.$ENV{'REMOTE_ADDR'}); - my $token=&reply('tmpput:'.$infostr,$lonhost); - if ($token=~/^error\:/) { - &logthis("WARNING: ". - "Checkout tmpput failed ".$tudom.' - '.$tuname.' - '.$symb. - ""); - return ''; - } - - $token=~s/^(\d+)\_.*\_(\d+)$/$1\*$2\*$lonhost/; - $token=~tr/a-z/A-Z/; - - my %infohash=('resource.0.outtoken' => $token, - 'resource.0.checkouttime' => $now, - 'resource.0.outremote' => $ENV{'REMOTE_ADDR'}); - - unless (&cstore(\%infohash,$symb,$tcrsid,$tudom,$tuname) eq 'ok') { - return ''; - } else { - &logthis("WARNING: ". - "Checkout cstore failed ".$tudom.' - '.$tuname.' - '.$symb. - ""); - } - - if (&log($tudom,$tuname,&homeserver($tuname,$tudom), - &escape('Checkout '.$infostr.' - '. - $token)) ne 'ok') { - return ''; - } else { - &logthis("WARNING: ". - "Checkout log failed ".$tudom.' - '.$tuname.' - '.$symb. - ""); - } - return $token; -} - -# ------------------------------------------------------------ Check in an item - -sub checkin { - my $token=shift; - my $now=time; - my ($ta,$tb,$lonhost)=split(/\*/,$token); - $lonhost=~tr/A-Z/a-z/; - my $dtoken=$ta.'_'.&hostname($lonhost).'_'.$tb; - $dtoken=~s/\W/\_/g; - my ($dummy,$tuname,$tudom,$tcrsid,$symb,$chtim,$rmaddr)= - split(/\&/,&unescape(&reply('tmpget:'.$dtoken,$lonhost))); - - unless (($tuname) && ($tudom)) { - &logthis('Check in '.$token.' ('.$dtoken.') failed'); - return ''; - } - - unless (&allowed('mgr',$tcrsid)) { - &logthis('Check in '.$token.' ('.$dtoken.') unauthorized: '. - $env{'user.name'}.' - '.$env{'user.domain'}); - return ''; - } - - my %infohash=('resource.0.intoken' => $token, - 'resource.0.checkintime' => $now, - 'resource.0.inremote' => $ENV{'REMOTE_ADDR'}); - - unless (&cstore(\%infohash,$symb,$tcrsid,$tudom,$tuname) eq 'ok') { - return ''; - } - - if (&log($tudom,$tuname,&homeserver($tuname,$tudom), - &escape('Checkin - '.$token)) ne 'ok') { - return ''; - } - - return ($symb,$tuname,$tudom,$tcrsid); -} - # --------------------------------------------- Set Expire Date for Spreadsheet sub expirespread { @@ -4942,12 +4616,9 @@ sub restore { if ($stuname) { $home=&homeserver($stuname,$domain); } if (!$symb) { - return if ($namespace eq 'courserequests'); - unless ($symb=escape(&symbread())) { return ''; } + unless ($symb=escape(&symbread())) { return ''; } } else { - unless ($namespace eq 'courserequests') { - $symb=&escape(&symbclean($symb)); - } + $symb=&escape(&symbclean($symb)); } if (!$namespace) { unless ($namespace=$env{'request.course.id'}) { @@ -5082,93 +4753,20 @@ sub update_released_required { # -------------------------------------------------See if a user is privileged sub privileged { - my ($username,$domain,$possdomains,$possroles)=@_; + my ($username,$domain)=@_; + + my %rolesdump = &dump("roles", $domain, $username) or return 0; my $now = time; - my $roles; - if (ref($possroles) eq 'ARRAY') { - $roles = $possroles; - } else { - $roles = ['dc','su']; - } - if (ref($possdomains) eq 'ARRAY') { - my %privileged = &privileged_by_domain($possdomains,$roles); - foreach my $dom (@{$possdomains}) { - if (($username =~ /^$match_username$/) && ($domain =~ /^$match_domain$/) && - (ref($privileged{$dom}) eq 'HASH')) { - foreach my $role (@{$roles}) { - if (ref($privileged{$dom}{$role}) eq 'HASH') { - if (exists($privileged{$dom}{$role}{$username.':'.$domain})) { - my ($end,$start) = split(/:/,$privileged{$dom}{$role}{$username.':'.$domain}); - return 1 unless (($end && $end < $now) || - ($start && $start > $now)); - } - } - } - } - } - } else { - my %rolesdump = &dump("roles", $domain, $username) or return 0; - my $now = time; - for my $role (@rolesdump{grep { ! /^rolesdef_/ } keys %rolesdump}) { + for my $role (@rolesdump{grep { ! /^rolesdef_/ } keys %rolesdump}) { my ($trole, $tend, $tstart) = split(/_/, $role); - if (grep(/^\Q$trole\E$/,@{$roles})) { - return 1 unless ($tend && $tend < $now) - or ($tstart && $tstart > $now); + if (($trole eq 'dc') || ($trole eq 'su')) { + return 1 unless ($tend && $tend < $now) + or ($tstart && $tstart > $now); } - } - } - return 0; -} + } -sub privileged_by_domain { - my ($domains,$roles) = @_; - my %privileged = (); - my $cachetime = 60*60*24; - my $now = time; - unless ((ref($domains) eq 'ARRAY') && (ref($roles) eq 'ARRAY')) { - return %privileged; - } - foreach my $dom (@{$domains}) { - next if (ref($privileged{$dom}) eq 'HASH'); - my $needroles; - foreach my $role (@{$roles}) { - my ($result,$cached)=&is_cached_new('priv_'.$role,$dom); - if (defined($cached)) { - if (ref($result) eq 'HASH') { - $privileged{$dom}{$role} = $result; - } - } else { - $needroles = 1; - } - } - if ($needroles) { - my %dompersonnel = &get_domain_roles($dom,$roles); - $privileged{$dom} = {}; - foreach my $server (keys(%dompersonnel)) { - if (ref($dompersonnel{$server}) eq 'HASH') { - foreach my $item (keys(%{$dompersonnel{$server}})) { - my ($trole,$uname,$udom,$rest) = split(/:/,$item,4); - my ($end,$start) = split(/:/,$dompersonnel{$server}{$item}); - next if ($end && $end < $now); - $privileged{$dom}{$trole}{$uname.':'.$udom} = - $dompersonnel{$server}{$item}; - } - } - } - if (ref($privileged{$dom}) eq 'HASH') { - foreach my $role (@{$roles}) { - if (ref($privileged{$dom}{$role}) eq 'HASH') { - &do_cache_new('priv_'.$role,$dom,$privileged{$dom}{$role},$cachetime); - } else { - my %hash = (); - &do_cache_new('priv_'.$role,$dom,\%hash,$cachetime); - } - } - } - } - } - return %privileged; + return 0; } # -------------------------------------------------------- Get user privileges @@ -5280,18 +4878,16 @@ sub rolesinit { } sub set_arearole { - my ($trole,$area,$tstart,$tend,$domain,$username,$nolog) = @_; - unless ($nolog) { + my ($trole,$area,$tstart,$tend,$domain,$username) = @_; # log the associated role with the area - &userrolelog($trole,$username,$domain,$area,$tstart,$tend); - } + &userrolelog($trole,$username,$domain,$area,$tstart,$tend); return ('user.role.'.$trole.'.'.$area => $tstart.'.'.$tend); } sub custom_roleprivs { my ($allroles,$trole,$tdomain,$trest,$spec,$area) = @_; my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$trole); - my $homsvr = &homeserver($rauthor,$rdomain); + my $homsvr=homeserver($rauthor,$rdomain); if (&hostname($homsvr) ne '') { my ($rdummy,$roledef)= &get('roles',["rolesdef_$rrole"],$rdomain,$rauthor); @@ -5412,11 +5008,11 @@ sub set_userprivs { sub role_status { my ($rolekey,$update,$refresh,$now,$role,$where,$trolecode,$tstatus,$tstart,$tend) = @_; + my @pwhere = (); if (exists($env{$rolekey}) && $env{$rolekey} ne '') { - my ($one,$two) = split(m{\./},$rolekey,2); - (undef,undef,$$role) = split(/\./,$one,3); + (undef,undef,$$role,@pwhere)=split(/\./,$rolekey); unless (!defined($$role) || $$role eq '') { - $$where = '/'.$two; + $$where=join('.',@pwhere); $$trolecode=$$role.'.'.$$where; ($$tstart,$$tend)=split(/\./,$env{$rolekey}); $$tstatus='is'; @@ -5553,7 +5149,7 @@ sub set_adhoc_privileges { my $area = '/'.$dcdom.'/'.$pickedcourse; my $spec = $role.'.'.$area; my %userroles = &set_arearole($role,$area,'','',$env{'user.domain'}, - $env{'user.name'},1); + $env{'user.name'}); my %ccrole = (); &standard_roleprivs(\%ccrole,$role,$dcdom,$spec,$pickedcourse,$area); my ($author,$adv)= &set_userprivs(\%userroles,\%ccrole); @@ -5622,14 +5218,15 @@ sub unserialize { return {} if $rep =~ /^error/; my %returnhash=(); - foreach my $item (split(/\&/,$rep)) { - my ($key, $value) = split(/=/, $item, 2); - $key = unescape($key) unless $escapedkeys; - next if $key =~ /^error: 2 /; - $returnhash{$key} = &thaw_unescape($value); - } + foreach my $item (split /\&/, $rep) { + my ($key, $value) = split(/=/, $item, 2); + $key = unescape($key) unless $escapedkeys; + next if $key =~ /^error: 2 /; + $returnhash{$key} = Apache::lonnet::thaw_unescape($value); + } + #return %returnhash; return \%returnhash; -} +} # see Lond::dump_with_regexp # if $escapedkeys hash keys won't get unescaped. @@ -5640,11 +5237,11 @@ sub dump { my $uhome=&homeserver($uname,$udomain); my $reply; - if (grep { $_ eq $uhome } ¤t_machine_ids()) { + if (grep { $_ eq $uhome } current_machine_ids()) { # user is hosted on this machine - $reply = LONCAPA::Lond::dump_with_regexp(join(':', ($udomain, - $uname, $namespace, $regexp, $range)), $perlvar{'lonVersion'}); - return %{&unserialize($reply, $escapedkeys)}; + $reply = LONCAPA::Lond::dump_with_regexp(join(":", ($udomain, + $uname, $namespace, $regexp, $range)), $loncaparevs{$uhome}); + return %{unserialize($reply, $escapedkeys)}; } if ($regexp) { $regexp=&escape($regexp); @@ -5657,7 +5254,8 @@ sub dump { if (!($rep =~ /^error/ )) { foreach my $item (@pairs) { my ($key,$value)=split(/=/,$item,2); - $key = &unescape($key) unless ($escapedkeys); + $key = unescape($key) unless $escapedkeys; + #$key = &unescape($key); next if ($key =~ /^error: 2 /); $returnhash{$key}=&thaw_unescape($value); } @@ -5698,7 +5296,15 @@ sub currentdump { $sdom = $env{'user.domain'} if (! defined($sdom)); $sname = $env{'user.name'} if (! defined($sname)); my $uhome = &homeserver($sname,$sdom); - my $rep=reply('currentdump:'.$sdom.':'.$sname.':'.$courseid,$uhome); + my $rep; + + if (grep { $_ eq $uhome } current_machine_ids()) { + $rep = LONCAPA::Lond::dump_profile_database(join(":", ($sdom, $sname, + $courseid))); + } else { + $rep = reply('currentdump:'.$sdom.':'.$sname.':'.$courseid,$uhome); + } + return if ($rep =~ /^(error:|no_such_host)/); # my %returnhash=(); @@ -5941,88 +5547,6 @@ sub tmpdel { return &reply("tmpdel:$token",$server); } -# ------------------------------------------------------------ get_timebased_id - -sub get_timebased_id { - my ($prefix,$keyid,$namespace,$cdom,$cnum,$idtype,$who,$locktries, - $maxtries) = @_; - my ($newid,$error,$dellock); - unless (($prefix =~ /^\w+$/) && ($keyid =~ /^\w+$/) && ($namespace ne '')) { - return ('','ok','invalid call to get suffix'); - } - -# set defaults for any optional args for which values were not supplied - if ($who eq '') { - $who = $env{'user.name'}.':'.$env{'user.domain'}; - } - if (!$locktries) { - $locktries = 3; - } - if (!$maxtries) { - $maxtries = 10; - } - - if (($cdom eq '') || ($cnum eq '')) { - if ($env{'request.course.id'}) { - $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; - $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; - } - if (($cdom eq '') || ($cnum eq '')) { - return ('','ok','call to get suffix not in course context'); - } - } - -# construct locking item - my $lockhash = { - $prefix."\0".'locked_'.$keyid => $who, - }; - my $tries = 0; - -# attempt to get lock on nohist_$namespace file - my $gotlock = &Apache::lonnet::newput('nohist_'.$namespace,$lockhash,$cdom,$cnum); - while (($gotlock ne 'ok') && $tries <$locktries) { - $tries ++; - sleep 1; - $gotlock = &Apache::lonnet::newput('nohist_'.$namespace,$lockhash,$cdom,$cnum); - } - -# attempt to get unique identifier, based on current timestamp - if ($gotlock eq 'ok') { - my %inuse = &Apache::lonnet::dump('nohist_'.$namespace,$cdom,$cnum,$prefix); - my $id = time; - $newid = $id; - my $idtries = 0; - while (exists($inuse{$prefix."\0".$newid}) && $idtries < $maxtries) { - if ($idtype eq 'concat') { - $newid = $id.$idtries; - } else { - $newid ++; - } - $idtries ++; - } - if (!exists($inuse{$prefix."\0".$newid})) { - my %new_item = ( - $prefix."\0".$newid => $who, - ); - my $putresult = &Apache::lonnet::put('nohist_'.$namespace,\%new_item, - $cdom,$cnum); - if ($putresult ne 'ok') { - undef($newid); - $error = 'error saving new item: '.$putresult; - } - } else { - $error = ('error: no unique suffix available for the new item '); - } -# remove lock - my @del_lock = ($prefix."\0".'locked_'.$keyid); - $dellock = &Apache::lonnet::del('nohist_'.$namespace,\@del_lock,$cdom,$cnum); - } else { - $error = "error: could not obtain lockfile\n"; - $dellock = 'ok'; - } - return ($newid,$dellock,$error); -} - # -------------------------------------------------- portfolio access checking sub portfolio_access { @@ -6277,7 +5801,6 @@ sub usertools_access { official => 1, unofficial => 1, community => 1, - textbook => 1, ); } elsif ($context eq 'requestauthor') { %tools = ( @@ -6293,7 +5816,7 @@ sub usertools_access { } return if (!defined($tools{$tool})); - if (($udom eq '') || ($uname eq '')) { + if ((!defined($udom)) || (!defined($uname))) { $udom = $env{'user.domain'}; $uname = $env{'user.name'}; } @@ -6312,7 +5835,7 @@ sub usertools_access { my ($toolstatus,$inststatus,$envkey); if ($context eq 'requestauthor') { - $envkey = $context; + $envkey = $context; } else { $envkey = $context.'.'.$tool; } @@ -7103,7 +6626,7 @@ sub constructaccess { if (($allowed eq 'F') || ($allowed eq 'U')) { # Grant temporary access my $then=$env{'user.login.time'}; - my $update=$env{'user.update.time'}; + my $update==$env{'user.update.time'}; if (!$update) { $update = $then; } my $refresh=$env{'user.refresh.time'}; if (!$refresh) { $refresh = $update; } @@ -7384,23 +6907,19 @@ sub definerole { # ---------------- Make a metadata query against the network of library servers sub metadata_query { - my ($query,$custom,$customshow,$server_array,$domains_hash)=@_; + my ($query,$custom,$customshow,$server_array)=@_; my %rhash; my %libserv = &all_library(); my @server_list = (defined($server_array) ? @$server_array : keys(%libserv) ); for my $server (@server_list) { - my $domains = ''; - if (ref($domains_hash) eq 'HASH') { - $domains = $domains_hash->{$server}; - } unless ($custom or $customshow) { - my $reply=&reply("querysend:".&escape($query).':::'.&escape($domains),$server); + my $reply=&reply("querysend:".&escape($query),$server); $rhash{$server}=$reply; } else { my $reply=&reply("querysend:".&escape($query).':'. - &escape($custom).':'.&escape($customshow).':'.&escape($domains), + &escape($custom).':'.&escape($customshow), $server); $rhash{$server}=$reply; } @@ -7646,8 +7165,8 @@ sub auto_validate_instcode { } $response=&unescape(&reply('autovalidateinstcode:'.$cdom.':'. &escape($instcode).':'.&escape($owner),$homeserver)); - my ($outcome,$description,$defaultcredits) = map { &unescape($_); } split('&',$response,3); - return ($outcome,$description,$defaultcredits); + my ($outcome,$description) = map { &unescape($_); } split('&',$response,2); + return ($outcome,$description); } sub auto_create_password { @@ -7918,33 +7437,6 @@ sub auto_validate_class_sec { return $response; } -sub auto_crsreq_update { - my ($cdom,$cnum,$crstype,$action,$ownername,$ownerdomain,$fullname,$title, - $code,$inbound) = @_; - my ($homeserver,%crsreqresponse); - if ($cdom =~ /^$match_domain$/) { - $homeserver = &domain($cdom,'primary'); - } - unless (($homeserver eq 'no_host') || ($homeserver eq '')) { - my $info; - if (ref($inbound) eq 'HASH') { - $info = &freeze_escape($inbound); - } - my $response=&reply('autocrsrequpdate:'.$cdom.':'.$cnum.':'.&escape($crstype). - ':'.&escape($action).':'.&escape($ownername).':'. - &escape($ownerdomain).':'.&escape($fullname).':'. - &escape($title).':'.&escape($code).':'.$info,$homeserver); - unless ($response =~ /(con_lost|error|no_such_host|refused)/) { - my @items = split(/&/,$response); - foreach my $item (@items) { - my ($key,$value) = split('=',$item); - $crsreqresponse{&unescape($key)} = &thaw_unescape($value); - } - } - } - return \%crsreqresponse; -} - # ------------------------------------------------------- Course Group routines sub get_coursegroups { @@ -8213,7 +7705,7 @@ sub assignrole { } } } elsif ($context eq 'requestauthor') { - if (($udom eq $env{'user.domain'}) && ($uname eq $env{'user.name'}) && + if (($udom eq $env{'user.domain'}) && ($uname eq $env{'user.name'}) && ($url eq '/'.$udom.'/') && ($role eq 'au')) { if ($env{'environment.requestauthor'} eq 'automatic') { $refused = ''; @@ -8221,13 +7713,13 @@ sub assignrole { my %domdefaults = &get_domain_defaults($udom); if (ref($domdefaults{'requestauthor'}) eq 'HASH') { my $checkbystatus; - if ($env{'user.adv'}) { + if ($env{'user.adv'}) { my $disposition = $domdefaults{'requestauthor'}{'_LC_adv'}; if ($disposition eq 'automatic') { $refused = ''; } elsif ($disposition eq '') { $checkbystatus = 1; - } + } } else { $checkbystatus = 1; } @@ -8296,16 +7788,16 @@ sub assignrole { # log new user role if status is ok if ($answer eq 'ok') { &userrolelog($role,$uname,$udom,$url,$start,$end); +# for course roles, perform group memberships changes triggered by role change. + unless ($role =~ /^gr/) { + &Apache::longroup::group_changes($udom,$uname,$url,$role,$origend, + $origstart,$selfenroll,$context); + } if (($role eq 'cc') || ($role eq 'in') || ($role eq 'ep') || ($role eq 'ad') || ($role eq 'ta') || ($role eq 'st') || ($role=~/^cr/) || ($role eq 'gr') || ($role eq 'co')) { -# for course roles, perform group memberships changes triggered by role change. - unless ($role =~ /^gr/) { - &Apache::longroup::group_changes($udom,$uname,$url,$role,$origend, - $origstart,$selfenroll,$context); - } &courserolelog($role,$uname,$udom,$url,$origstart,$origend,$delflag, $selfenroll,$context); } elsif (($role eq 'li') || ($role eq 'dg') || ($role eq 'sc') || @@ -8314,7 +7806,7 @@ sub assignrole { $context); } elsif (($role eq 'ca') || ($role eq 'aa')) { &coauthorrolelog($role,$uname,$udom,$url,$origstart,$origend,$delflag, - $context); + $context); } if ($role eq 'cc') { &autoupdate_coowners($url,$end,$start,$uname,$udom); @@ -8614,7 +8106,7 @@ sub modifyuser { sub modifystudent { my ($udom,$uname,$uid,$umode,$upass,$first,$middle,$last,$gene,$usec, $end,$start,$forceid,$desiredhome,$email,$type,$locktype,$cid, - $selfenroll,$context,$inststatus,$credits)=@_; + $selfenroll,$context,$inststatus)=@_; if (!$cid) { unless ($cid=$env{'request.course.id'}) { return 'not_in_class'; @@ -8626,17 +8118,15 @@ sub modifystudent { $desiredhome,$email,$inststatus); unless ($reply eq 'ok') { return $reply; } # This will cause &modify_student_enrollment to get the uid from the - # student's environment + # students environment $uid = undef if (!$forceid); $reply = &modify_student_enrollment($udom,$uname,$uid,$first,$middle,$last, - $gene,$usec,$end,$start,$type,$locktype, - $cid,$selfenroll,$context,$credits); + $gene,$usec,$end,$start,$type,$locktype,$cid,$selfenroll,$context); return $reply; } sub modify_student_enrollment { - my ($udom,$uname,$uid,$first,$middle,$last,$gene,$usec,$end,$start,$type, - $locktype,$cid,$selfenroll,$context,$credits) = @_; + my ($udom,$uname,$uid,$first,$middle,$last,$gene,$usec,$end,$start,$type,$locktype,$cid,$selfenroll,$context) = @_; my ($cdom,$cnum,$chome); if (!$cid) { unless ($cid=$env{'request.course.id'}) { @@ -8683,7 +8173,7 @@ sub modify_student_enrollment { my %old_entry = &Apache::lonnet::get('classlist',[$user],$cdom,$cnum); my $reply=cput('classlist', {$user => - join(':',$end,$start,$uid,$usec,$fullname,$type,$locktype,$credits) }, + join(':',$end,$start,$uid,$usec,$fullname,$type,$locktype) }, $cdom,$cnum); if (($reply eq 'ok') || ($reply eq 'delayed')) { &devalidate_getsection_cache($udom,$uname,$cid); @@ -8912,7 +8402,7 @@ sub is_course { my %courses = &courseiddump($cdom, '.', 1, '.', '.', $cnum, undef, undef, '.'); - return unless(exists($courses{$cdom.'_'.$cnum})); + return unless exists($courses{$cdom.'_'.$cnum}); return wantarray ? ($cdom, $cnum) : $cdom.'_'.$cnum; } @@ -8937,9 +8427,6 @@ sub store_userdata { $namevalue.=&escape($key).'='.&freeze_escape($$storehash{$key}).'&'; } $namevalue=~s/\&$//; - unless ($namespace eq 'courserequests') { - $datakey = &escape($datakey); - } $result = &reply("store:$udom:$uname:$namespace:$datakey:". $namevalue,$uhome); } @@ -9762,26 +9249,6 @@ sub resdata { return undef; } -sub get_numsuppfiles { - my ($cnum,$cdom,$ignorecache)=@_; - my $hashid=$cnum.':'.$cdom; - my ($suppcount,$cached); - unless ($ignorecache) { - ($suppcount,$cached) = &is_cached_new('suppcount',$hashid); - } - unless (defined($cached)) { - my $chome=&homeserver($cnum,$cdom); - unless ($chome eq 'no_host') { - ($suppcount,my $errors) = (0,0); - my $suppmap = 'supplemental.sequence'; - ($suppcount,$errors) = - &Apache::loncommon::recurse_supplemental($cnum,$cdom,$suppmap,$suppcount,$errors); - } - &do_cache_new('suppcount',$hashid,$suppcount,600); - } - return $suppcount; -} - # # EXT resource caching routines # @@ -9810,7 +9277,7 @@ sub EXT_cache_set { # --------------------------------------------------------- Value of a Variable sub EXT { - my ($varname,$symbparm,$udom,$uname,$usection,$recurse,$cid)=@_; + my ($varname,$symbparm,$udom,$uname,$usection,$recurse)=@_; unless ($varname) { return ''; } #get real user name/domain, courseid and symb my $courseid; @@ -9925,51 +9392,26 @@ sub EXT { if (!$symbparm) { $symbparm=&symbread(); } } - if ($qualifier eq '') { - if ($space eq 'title') { - if (!$symbparm) { $symbparm = $env{'request.filename'}; } - return &gettitle($symbparm); - } + if ($space eq 'title') { + if (!$symbparm) { $symbparm = $env{'request.filename'}; } + return &gettitle($symbparm); + } - if ($space eq 'map') { - my ($map) = &decode_symb($symbparm); - return &symbread($map); - } - if ($space eq 'maptitle') { - my ($map) = &decode_symb($symbparm); - return &gettitle($map); - } - if ($space eq 'filename') { - if ($symbparm) { - return &clutter((&decode_symb($symbparm))[2]); - } - return &hreflocation('',$env{'request.filename'}); + if ($space eq 'map') { + my ($map) = &decode_symb($symbparm); + return &symbread($map); + } + if ($space eq 'filename') { + if ($symbparm) { + return &clutter((&decode_symb($symbparm))[2]); } - - if ((defined($courseid)) && ($courseid eq $env{'request.course.id'}) && $symbparm) { - if ($space eq 'visibleparts') { - my $navmap = Apache::lonnavmaps::navmap->new(); - my $item; - if (ref($navmap)) { - my $res = $navmap->getBySymb($symbparm); - my $parts = $res->parts(); - if (ref($parts) eq 'ARRAY') { - $item = join(',',@{$parts}); - } - undef($navmap); - } - return $item; - } - } - } + return &hreflocation('',$env{'request.filename'}); + } my ($section, $group, @groups); my ($courselevelm,$courselevel); - if (($courseid eq '') && ($cid)) { - $courseid = $cid; - } - if (($symbparm && $courseid) && - (($courseid eq $env{'request.course.id'}) || ($courseid eq $cid))) { + if ($symbparm && defined($courseid) && + $courseid eq $env{'request.course.id'}) { #print '
'.$space.' - '.$qualifier.' - '.$spacequalifierrest; @@ -10216,7 +9658,7 @@ sub metadata { # if it is a non metadata possible uri return quickly if (($uri eq '') || (($uri =~ m|^/*adm/|) && - ($uri !~ m|^adm/includes|) && ($uri !~ m{/(smppg|bulletinboard)$})) || + ($uri !~ m|^adm/includes|) && ($uri !~ m|/bulletinboard$|)) || ($uri =~ m|/$|) || ($uri =~ m|/.meta$|) || ($uri =~ m{^/*uploaded/.+\.sequence$})) { return undef; } @@ -10647,7 +10089,7 @@ sub get_course_slots { my %slots=&Apache::lonnet::dump('slots',$cdom,$cnum); my ($tmp) = keys(%slots); if ($tmp !~ /^(con_lost|error|no_such_host)/i) { - &do_cache_new('allslots',$hashid,\%slots,600); + &Apache::lonnet::do_cache_new('allslots',$hashid,\%slots,600); return %slots; } } @@ -10741,46 +10183,34 @@ sub symbverify { if (tie(%bighash,'GDBM_File',$env{'request.course.fn'}.'.db', &GDBM_READER(),0640)) { - my $noclutter; if (($thisurl =~ m{^/adm/wrapper/ext/}) || ($thisurl =~ m{^ext/})) { $thisurl =~ s/\?.+$//; - if ($map =~ m{^uploaded/.+\.page$}) { - $thisurl =~ s{^(/adm/wrapper|)/ext/}{http://}; - $thisurl =~ s{^\Qhttp://https://\E}{https://}; - $noclutter = 1; - } - } - my $ids; - if ($noclutter) { - $ids=$bighash{'ids_'.$thisurl}; - } else { - $ids=$bighash{'ids_'.&clutter($thisurl)}; } + my $ids=$bighash{'ids_'.&clutter($thisurl)}; unless ($ids) { - my $idkey = 'ids_'.($thisurl =~ m{^/}? '' : '/').$thisurl; + my $idkey = 'ids_'.($thisurl =~ m{^/}? '' : '/').$thisurl; $ids=$bighash{$idkey}; } if ($ids) { # ------------------------------------------------------------------- Has ID(s) - if ($thisfn =~ m{^/adm/wrapper/ext/}) { - $symb =~ s/\?.+$//; - } foreach my $id (split(/\,/,$ids)) { my ($mapid,$resid)=split(/\./,$id); + if ($thisfn =~ m{^/adm/wrapper/ext/}) { + $symb =~ s/\?.+$//; + } if ( &symbclean(&declutter($bighash{'map_id_'.$mapid}).'___'.$resid.'___'.$thisfn) eq $symb) { if (ref($encstate)) { $$encstate = $bighash{'encrypted_'.$id}; } - if (($env{'request.role.adv'}) || - ($bighash{'encrypted_'.$id} eq $env{'request.enc'}) || + if (($env{'request.role.adv'}) || + ($bighash{'encrypted_'.$id} eq $env{'request.enc'}) || ($thisurl eq '/adm/navmaps')) { - $okay=1; - last; - } - } - } + $okay=1; + } + } + } } untie(%bighash); } @@ -10853,18 +10283,18 @@ sub deversion { sub symbread { my ($thisfn,$donotrecurse)=@_; - my $cache_str; - if ($thisfn ne '') { - $cache_str='request.symbread.cached.'.$thisfn; - if ($env{$cache_str} ne '') { + my $cache_str='request.symbread.cached.'.$thisfn; + if (defined($env{$cache_str})) { + if (($thisfn) || ($env{$cache_str} ne '')) { return $env{$cache_str}; } - } else { + } # no filename provided? try from environment + unless ($thisfn) { if ($env{'request.symb'}) { - return $env{$cache_str}=&symbclean($env{'request.symb'}); - } - $thisfn=$env{'request.filename'}; + return $env{$cache_str}=&symbclean($env{'request.symb'}); + } + $thisfn=$env{'request.filename'}; } if ($thisfn=~m|^/enc/|) { $thisfn=&Apache::lonenc::unencrypted($thisfn); } # is that filename actually a symb? Verify, clean, and return @@ -11092,6 +10522,7 @@ sub rndseed { $which =&get_rand_alg($courseid); } if (defined(&getCODE())) { + if ($which eq '64bit5') { return &rndseed_CODE_64bit5($symb,$courseid,$domain,$username); } elsif ($which eq '64bit4') { @@ -11774,12 +11205,12 @@ sub goodbye { } sub get_dns { - my ($url,$func,$ignore_cache,$nocache,$hashref) = @_; + my ($url,$func,$ignore_cache) = @_; if (!$ignore_cache) { my ($content,$cached)= &Apache::lonnet::is_cached_new('dns',$url); if ($cached) { - &$func($content,$hashref); + &$func($content); return; } } @@ -11804,10 +11235,8 @@ sub get_dns { delete($alldns{$dns}); next if ($response->is_error()); my @content = split("\n",$response->content); - unless ($nocache) { - &do_cache_new('dns',$url,\@content,30*24*60*60); - } - &$func(\@content,$hashref); + &Apache::lonnet::do_cache_new('dns',$url,\@content,30*24*60*60); + &$func(\@content); return; } close($config); @@ -11815,47 +11244,9 @@ sub get_dns { &logthis("unable to contact DNS defaulting to on disk file dns_$which.tab\n"); open($config,"<$perlvar{'lonTabDir'}/dns_$which.tab"); my @content = <$config>; - &$func(\@content,$hashref); + &$func(\@content); return; } - -# ------------------------------------------------------Get DNS checksums file -sub parse_dns_checksums_tab { - my ($lines,$hashref) = @_; - my $machine_dom = &Apache::lonnet::host_domain($perlvar{'lonHostID'}); - my $loncaparev = &get_server_loncaparev($machine_dom); - my ($release,$timestamp) = split(/\-/,$loncaparev); - my (%chksum,%revnum); - if (ref($lines) eq 'ARRAY') { - chomp(@{$lines}); - my $version = shift(@{$lines}); - if ($version eq $release) { - foreach my $line (@{$lines}) { - my ($file,$version,$shasum) = split(/,/,$line); - $chksum{$file} = $shasum; - $revnum{$file} = $version; - } - if (ref($hashref) eq 'HASH') { - %{$hashref} = ( - sums => \%chksum, - versions => \%revnum, - ); - } - } - } - return; -} - -sub fetch_dns_checksums { - my %checksums; - my $machine_dom = &Apache::lonnet::host_domain($perlvar{'lonHostID'}); - my $loncaparev = &get_server_loncaparev($machine_dom); - my ($release,$timestamp) = split(/\-/,$loncaparev); - &get_dns("/adm/dns/checksums/$release",\&parse_dns_checksums_tab,1,1, - \%checksums); - return \%checksums; -} - # ------------------------------------------------------------ Read domain file { my $loaded; @@ -12165,9 +11556,9 @@ sub fetch_dns_checksums { } push(@{$iphost{$ip}},@{$name_to_host{$name}}); } - &do_cache_new('iphost','iphost', - [\%iphost,\%name_to_ip,\%lonid_to_ip], - 48*60*60); + &Apache::lonnet::do_cache_new('iphost','iphost', + [\%iphost,\%name_to_ip,\%lonid_to_ip], + 48*60*60); return %iphost; } @@ -12223,48 +11614,15 @@ sub fetch_dns_checksums { } $seen{$prim_ip} = 1; } - return &do_cache_new('internetnames',$lonid,\@idns,12*60*60); + return &Apache::lonnet::do_cache_new('internetnames',$lonid,\@idns,12*60*60); } } sub all_loncaparevs { - return qw(1.1 1.2 1.3 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10 2.11); + return qw(1.1 1.2 1.3 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10); } -# ------------------------------------------------------- Read loncaparev table -{ - sub load_loncaparevs { - if (-e "$perlvar{'lonTabDir'}/loncaparevs.tab") { - if (open(my $config,"<$perlvar{'lonTabDir'}/loncaparevs.tab")) { - while (my $configline=<$config>) { - chomp($configline); - my ($hostid,$loncaparev)=split(/:/,$configline); - $loncaparevs{$hostid}=$loncaparev; - } - close($config); - } - } - } -} - -# ----------------------------------------------------- Read serverhostID table -{ - sub load_serverhomeIDs { - if (-e "$perlvar{'lonTabDir'}/serverhomeIDs.tab") { - if (open(my $config,"<$perlvar{'lonTabDir'}/serverhomeIDs.tab")) { - while (my $configline=<$config>) { - chomp($configline); - my ($name,$id)=split(/:/,$configline); - $serverhomeIDs{$name}=$id; - } - close($config); - } - } - } -} - - BEGIN { # ----------------------------------- Read loncapa.conf and loncapa_apache.conf @@ -12340,15 +11698,34 @@ BEGIN { close($config); } -# --------------------------------------------------------- Read loncaparev table - -&load_loncaparevs(); - -# ------------------------------------------------------- Read serverhostID table +# ---------------------------------------------------------- Read loncaparev table +{ + if (-e "$perlvar{'lonTabDir'}/loncaparevs.tab") { + if (open(my $config,"<$perlvar{'lonTabDir'}/loncaparevs.tab")) { + while (my $configline=<$config>) { + chomp($configline); + my ($hostid,$loncaparev)=split(/:/,$configline); + $loncaparevs{$hostid}=$loncaparev; + } + close($config); + } + } +} -&load_serverhomeIDs(); +# ---------------------------------------------------------- Read serverhostID table +{ + if (-e "$perlvar{'lonTabDir'}/serverhomeIDs.tab") { + if (open(my $config,"<$perlvar{'lonTabDir'}/serverhomeIDs.tab")) { + while (my $configline=<$config>) { + chomp($configline); + my ($name,$id)=split(/:/,$configline); + $serverhomeIDs{$name}=$id; + } + close($config); + } + } +} -# ---------------------------------------------------------- Read releaseslist XML { my $file = $Apache::lonnet::perlvar{'lonTabDir'}.'/releaseslist.xml'; if (-e $file) { @@ -12547,8 +11924,8 @@ were new keys. I.E. 1:foo will become 1: Calling convention: - my %record=&Apache::lonnet::restore($symb,$courseid,$domain,$uname); - &Apache::lonnet::cstore(\%newrecord,$symb,$courseid,$domain,$uname); + my %record=&Apache::lonnet::restore($symb,$courseid,$domain,$uname,$home); + &Apache::lonnet::cstore(\%newrecord,$symb,$courseid,$domain,$uname,$home); For more detailed information, see lonnet specific documentation. @@ -12725,7 +12102,7 @@ environment). If no custom name is defi =item * -get_my_roles($uname,$udom,$context,$types,$roles,$roledoms,$withsec,$hidepriv) : +get_my_roles($uname,$udom,$context,$types,$roles,$roledoms,$withsec) : All arguments are optional. Returns a hash of a roles, either for co-author/assistant author roles for a user's Construction Space (default), or if $context is 'userroles', roles for the user himself, @@ -12739,41 +12116,6 @@ of role statuses (active, future or prev to restrict the list of roles reported. If no array ref is provided for types, will default to return only active roles. -=item * - -in_course($udom,$uname,$cdom,$cnum,$type,$hideprivileged) : determine if -user: $uname:$udom has a role in the course: $cdom_$cnum. - -Additional optional arguments are: $type (if role checking is to be restricted -to certain user status types -- previous (expired roles), active (currently -available roles) or future (roles available in the future), and -$hideprivileged -- if true will not report course roles for users who -have active Domain Coordinator role in course's domain or in additional -domains (specified in 'Domains to check for privileged users' in course -environment -- set via: Course Settings -> Classlists and staff listing). - -=item * - -privileged($username,$domain,$possdomains,$possroles) : returns 1 if user -$username:$domain is a privileged user (e.g., Domain Coordinator or Super User) -$possdomains and $possroles are optional array refs -- to domains to check and -roles to check. If $possdomains is not specified, a dump will be done of the -users' roles.db to check for a dc or su role in any domain. This can be -time consuming if &privileged is called repeatedly (e.g., when displaying a -classlist), so in such cases, supplying a $possdomains array is preferred, as -this then allows &privileged_by_domain() to be used, which caches the identity -of privileged users, eliminating the need for repeated calls to &dump(). - -=item * - -privileged_by_domain($possdomains,$roles) : returns a hash of a hash of a hash, -where the outer hash keys are domains specified in the $possdomains array ref, -next inner hash keys are privileged roles specified in the $roles array ref, -and the innermost hash contains key = value pairs for username:domain = end:start -for active or future "privileged" users with that role in that domain. To avoid -repeated dumps of domain roles -- via &get_domain_roles() -- contents of the -innerhash are cached using priv_$role and $dom as the identifiers. - =back =head2 User Modification @@ -12815,8 +12157,8 @@ or when Autoupdate.pl is run by cron in modifystudent modify a student's enrollment and identification information. -The course id is resolved based on the current user's environment. -This means the invoking user must be a course coordinator or otherwise +The course id is resolved based on the current users environment. +This means the envoking user must be a course coordinator or otherwise associated with a course. This call is essentially a wrapper for lonnet::modifyuser and @@ -12866,9 +12208,7 @@ Inputs: =item B<$context> role change context (shown in User Management Logs display in a course) -=item B<$inststatus> institutional status of user - : separated string of escaped status types - -=item B<$credits> Number of credits student will earn from this class - only needs to be supplied if value needs to be different from default credits for class. +=item B<$inststatus> institutional status of user - : separated string of escaped status types =back @@ -12876,20 +12216,20 @@ Inputs: modify_student_enrollment -Change a student's enrollment status in a class. The environment variable +Change a students enrollment status in a class. The environment variable 'role.request.course' must be defined for this function to proceed. Inputs: =over 4 -=item $udom, student's domain +=item $udom, students domain -=item $uname, student's name +=item $uname, students name -=item $uid, student's user id +=item $uid, students user id -=item $first, student's first name +=item $first, students first name =item $middle @@ -12913,8 +12253,6 @@ Inputs: =item $context -=item $credits, number of credits student will earn from this class - =back @@ -12971,7 +12309,7 @@ If defined, the supplied username is use resdata($name,$domain,$type,@which) : request for current parameter setting for a specific $type, where $type is either 'course' or 'user', @what should be a list of parameters to ask about. This routine caches -answers for 10 minutes. +answers for 5 minutes. =item * @@ -12980,9 +12318,6 @@ data base, returning a hash that is keye values that are the resource value. I believe that the timestamps and versions are also returned. -get_numsuppfiles($cnum,$cdom) : retrieve number of files in a course's -supplemental content area. This routine caches the number of files for -10 minutes. =back @@ -13043,15 +12378,10 @@ resource. Expects the local filesystem p =item * -EXT($varname,$symb,$udom,$uname,$usection,$recurse,$cid) : evaluates -and returns the value of a variety of different possible values, -$varname should be a request string, and the other parameters can be -used to specify who and what one is asking about. Ordinarily, $cid -does not need to be specified, as it is retrived from -$env{'request.course.id'}, but &Apache::lonnet::EXT() is called -within lonuserstate::loadmap() when initializing a course, before -$env{'request.course.id'} has been set, so it needs to be provided -in that one case. +EXT($varname,$symb,$udom,$uname) : evaluates and returns the value of +a vairety of different possible values, $varname should be a request +string, and the other parameters can be used to specify who and what +one is asking about. Possible values for $varname are environment.lastname (or other item from the envirnment hash), user.name (or someother aspect about the @@ -13094,9 +12424,9 @@ and is a possible symb for the URL in $t resource that the user accessed using /enc/ returns a 1 on success, 0 on failure, user must be in a course, as it assumes the existence of the course initial hash, and uses $env('request.course.id'}. The third -arg is an optional reference to a scalar. If this arg is passed in the +arg is an optional reference to a scalar. If this arg is passed in the call to symbverify, it will be set to 1 if the symb has been set to be -encrypted; otherwise it will be null. +encrypted; otherwise it will be null. =item * @@ -13149,34 +12479,6 @@ expirespread($uname,$udom,$stype,$usymb) devalidate($symb) : devalidate temporary spreadsheet calculations, forcing spreadsheet to reevaluate the resource scores next time. -=item * - -can_edit_resource($file,$cnum,$cdom,$resurl,$symb,$group) : determine if current user can edit a particular resource, -when viewing in course context. - - input: six args -- filename (decluttered), course number, course domain, - url, symb (if registered) and group (if this is a - group item -- e.g., bulletin board, group page etc.). - - output: array of five scalars -- - $cfile -- url for file editing if editable on current server - $home -- homeserver of resource (i.e., for author if published, - or course if uploaded.). - $switchserver -- 1 if server switch will be needed. - $forceedit -- 1 if icon/link should be to go to edit mode - $forceview -- 1 if icon/link should be to go to view mode - -=item * - -is_course_upload($file,$cnum,$cdom) - -Used in course context to determine if current file was uploaded to -the course (i.e., would be found in /userfiles/docs on the course's -homeserver. - - input: 3 args -- filename (decluttered), course number and course domain. - output: boolean -- 1 if file was uploaded. - =back =head2 Storing/Retreiving Data @@ -13329,90 +12631,15 @@ server ($udom and $uhome are optional) =item * -get_domain_defaults($target_domain,$ignore_cache) : returns hash with defaults -for: authentication, language, quotas, timezone, date locale, and portal URL in -the target domain. - -May also include additional key => value pairs for the following groups: - -=over - -=item -disk quotas (MB allocated by default to portfolios and authoring spaces). - -=over - -=item defaultquota, authorquota - -=back - -=item -tools (availability of aboutme page, blog, webDAV access for authoring spaces, -portfolio for users). - -=over +get_domain_defaults($target_domain) : returns hash with defaults for +authentication and language in the domain. Keys are: auth_def, auth_arg_def, +lang_def; corresponsing values are authentication type (internal, krb4, krb5, +or localauth), initial password or a kerberos realm, language (e.g., en-us). +Values are retrieved from cache (if current), or from domain's configuration.db +(if available), or lastly from values in lonTabs/dns_domain,tab, +or lonTabs/domain.tab. -=item -aboutme, blog, webdav, portfolio - -=back - -=item -requestcourses: ability to request courses, and how requests are processed. - -=over - -=item -official, unofficial, community, textbook - -=back - -=item -inststatus: types of institutional affiliation, and order in which they are displayed. - -=over - -=item -inststatustypes, inststatusorder - -=back - -=item -coursedefaults: can PDF forms can be created, default credits for courses, default quotas (MB) -for course's uploaded content. - -=over - -=item -canuse_pdfforms, officialcredits, unofficialcredits, textbookcredits, officialquota, unofficialquota, communityquota, textbookquota - -=back - -=item -usersessions: set options for hosting of your users in other domains, and hosting of users from other domains -on your servers. - -=over - -=item -remotesessions, hostedsessions - -=back - -=back - -In cases where a domain coordinator has never used the "Set Domain Configuration" -utility to create a configuration.db file on a domain's primary library server -only the following domain defaults: auth_def, auth_arg_def, lang_def --- corresponding values are authentication type (internal, krb4, krb5, -or localauth), initial password or a kerberos realm, language (e.g., en-us) -- -will be available. Values are retrieved from cache (if current), unless the -optional $ignore_cache arg is true, or from domain's configuration.db (if available), -or lastly from values in lonTabs/dns_domain,tab, or lonTabs/domain.tab. - -Typical usage: - -%domdefaults = &get_domain_defaults($target_domain); +%domdefaults = &get_auth_defaults($target_domain); =back @@ -13807,8 +13034,6 @@ Internal notes: Locks on files (resulting from submission of portfolio file to a homework problem stored in array of arrays. -=item * - modify_access_controls(): Modifies access controls for a portfolio file @@ -13826,51 +13051,7 @@ Returns: 3. reference to hash of any new or updated access controls. 4. reference to hash used to map incoming IDs to uniqueIDs assigned to control. key = integer (inbound ID) - value = uniqueID - -=item * - -get_timebased_id(): - -Attempts to get a unique timestamp-based suffix for use with items added to a -course via the Course Editor (e.g., folders, composite pages, -group bulletin boards). - -Args: (first three required; six others optional) - -1. prefix (alphanumeric): of keys in hash, e.g., suppsequence, docspage, - docssequence, or name of group - -2. keyid (alphanumeric): name of temporary locking key in hash, - e.g., num, boardids - -3. namespace: name of gdbm file used to store suffixes already assigned; - file will be named nohist_namespace.db - -4. cdom: domain of course; default is current course domain from %env - -5. cnum: course number; default is current course number from %env - -6. idtype: set to concat if an additional digit is to be appended to the - unix timestamp to form the suffix, if the plain timestamp is already - in use. Default is to not do this, but simply increment the unix - timestamp by 1 until a unique key is obtained. - -7. who: holder of locking key; defaults to user:domain for user. - -8. locktries: number of attempts to obtain a lock (sleep of 1s before - retrying); default is 3. - -9. maxtries: number of attempts to obtain a unique suffix; default is 20. - -Returns: - -1. suffix obtained (numeric) - -2. result of deleting locking key (ok if deleted, or lock never obtained) - -3. error: contains (localized) error message if an error occurred. - + value = uniqueID =back