--- loncom/lonnet/perl/lonnet.pm 2013/02/08 16:12:10 1.1172.2.18
+++ loncom/lonnet/perl/lonnet.pm 2012/06/24 17:54:59 1.1178
@@ -1,7 +1,7 @@
# The LearningOnline Network
# TCP networking package
#
-# $Id: lonnet.pm,v 1.1172.2.18 2013/02/08 16:12:10 raeburn Exp $
+# $Id: lonnet.pm,v 1.1178 2012/06/24 17:54:59 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -75,7 +75,9 @@ use LWP::UserAgent();
use HTTP::Date;
use Image::Magick;
-use vars qw(%perlvar %spareid %pr %prp $memcache %packagetab $tmpdir $apache
+use Encode;
+
+use vars qw(%perlvar %spareid %pr %prp $memcache %packagetab $tmpdir
$_64bit %env %protocol %loncaparevs %serverhomeIDs %needsrelease
%managerstab);
@@ -97,6 +99,7 @@ use File::MMagic;
use LONCAPA qw(:DEFAULT :match);
use LONCAPA::Configuration;
use LONCAPA::lonmetadata;
+use LONCAPA::Lond;
use File::Copy;
@@ -108,33 +111,31 @@ require Exporter;
our @ISA = qw (Exporter);
our @EXPORT = qw(%env);
-# ------------------------------------ Logging (parameters, docs, slots, roles)
+
+# --------------------------------------------------------------------- Logging
{
my $logid;
- sub write_log {
- my ($context,$hash_name,$storehash,$delflag,$uname,$udom,$cnum,$cdom)=@_;
- if ($context eq 'course') {
- if (($cnum eq '') || ($cdom eq '')) {
- $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
- $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
- }
+ sub instructor_log {
+ my ($hash_name,$storehash,$delflag,$uname,$udom,$cnum,$cdom)=@_;
+ if (($cnum eq '') || ($cdom eq '')) {
+ $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
+ $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
}
- $logid ++;
+ $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,
- }
- };
- return &put('nohist_'.$hash_name,$logentry,$cdom,$cnum);
+ return &Apache::lonnet::put('nohist_'.$hash_name,
+ { $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,
+ }
+ },$cdom,$cnum);
}
}
@@ -629,15 +630,6 @@ sub check_for_valid_session {
|| !defined($disk_env{'user.domain'})) {
return undef;
}
-
- if (($r->user() eq '') && ($apache >= 2.4)) {
- if ($disk_env{'user.domain'} eq $r->dir_config('lonDefDomain')) {
- $r->user($disk_env{'user.name'});
- } else {
- $r->user($disk_env{'user.name'}.':'.$disk_env{'user.domain'});
- }
- }
-
return $handle;
}
@@ -1244,8 +1236,8 @@ sub get_lonbalancer_config {
sub check_loadbalancing {
my ($uname,$udom) = @_;
- my ($is_balancer,$currtargets,$currrules,$dom_in_use,$homeintdom,
- $rule_in_effect,$offloadto,$otherserver);
+ my ($is_balancer,$dom_in_use,$homeintdom,$rule_in_effect,
+ $offloadto,$otherserver);
my $lonhost = $perlvar{'lonHostID'};
my @hosts = ¤t_machine_ids();
my $uprimary_id = &Apache::lonnet::domain($udom,'primary');
@@ -1270,8 +1262,14 @@ sub check_loadbalancing {
}
}
if (ref($result) eq 'HASH') {
- ($is_balancer,$currtargets,$currrules) =
- &check_balancer_result($result,@hosts);
+ my $currbalancer = $result->{'lonhost'};
+ my $currtargets = $result->{'targets'};
+ my $currrules = $result->{'rules'};
+ if ($currbalancer ne '') {
+ if (grep(/^\Q$currbalancer\E$/,@hosts)) {
+ $is_balancer = 1;
+ }
+ }
if ($is_balancer) {
if (ref($currrules) eq 'HASH') {
if ($homeintdom) {
@@ -1329,9 +1327,12 @@ sub check_loadbalancing {
}
}
if (ref($result) eq 'HASH') {
- ($is_balancer,$currtargets,$currrules) =
- &check_balancer_result($result,@hosts);
- if ($is_balancer) {
+ my $currbalancer = $result->{'lonhost'};
+ my $currtargets = $result->{'targets'};
+ my $currrules = $result->{'rules'};
+
+ if ($currbalancer eq $lonhost) {
+ $is_balancer = 1;
if (ref($currrules) eq 'HASH') {
if ($currrules->{'_LC_internetdom'} ne '') {
$rule_in_effect = $currrules->{'_LC_internetdom'};
@@ -1385,8 +1386,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});
}
}
@@ -1395,32 +1396,6 @@ sub check_loadbalancing {
return ($is_balancer,$otherserver);
}
-sub check_balancer_result {
- my ($result,@hosts) = @_;
- my ($is_balancer,$currtargets,$currrules);
- if (ref($result) eq 'HASH') {
- if ($result->{'lonhost'} ne '') {
- my $currbalancer = $result->{'lonhost'};
- if (grep(/^\Q$currbalancer\E$/,@hosts)) {
- $is_balancer = 1;
- $currtargets = $result->{'targets'};
- $currrules = $result->{'rules'};
- }
- } else {
- foreach my $key (keys(%{$result})) {
- if (($key ne '') && (grep(/^\Q$key\E$/,@hosts)) &&
- (ref($result->{$key}) eq 'HASH')) {
- $is_balancer = 1;
- $currrules = $result->{$key}{'rules'};
- $currtargets = $result->{$key}{'targets'};
- last;
- }
- }
- }
- }
- return ($is_balancer,$currtargets,$currrules);
-}
-
sub get_loadbalancer_targets {
my ($rule_in_effect,$currtargets,$uname,$udom) = @_;
my $offloadto;
@@ -1963,8 +1938,7 @@ sub get_domain_defaults {
my %domconfig =
&Apache::lonnet::get_dom('configuration',['defaults','quotas',
'requestcourses','inststatus',
- 'coursedefaults','usersessions',
- 'requestauthor'],$domain);
+ 'coursedefaults','usersessions'],$domain);
if (ref($domconfig{'defaults'}) eq 'HASH') {
$domdefaults{'lang_def'} = $domconfig{'defaults'}{'lang_def'};
$domdefaults{'auth_def'} = $domconfig{'defaults'}{'auth_def'};
@@ -1995,9 +1969,6 @@ sub get_domain_defaults {
$domdefaults{$item} = $domconfig{'requestcourses'}{$item};
}
}
- if (ref($domconfig{'requestauthor'}) eq 'HASH') {
- $domdefaults{'requestauthor'} = $domconfig{'requestauthor'};
- }
if (ref($domconfig{'inststatus'}) eq 'HASH') {
foreach my $item ('inststatustypes','inststatusorder') {
$domdefaults{$item} = $domconfig{'inststatus'}{$item};
@@ -2427,7 +2398,7 @@ sub chatsend {
sub getversion {
my $fname=&clutter(shift);
- unless ($fname=~m{^(/adm/wrapper|)/res/}) { return -1; }
+ unless ($fname=~/^\/res\//) { return -1; }
return ¤tversion(&filelocation('',$fname));
}
@@ -2614,10 +2585,11 @@ sub ssi {
$request->header(Cookie => $ENV{'HTTP_COOKIE'});
my $response= $ua->request($request);
+ my $content = Encode::decode_utf8($response->content);
if (wantarray) {
- return ($response->content, $response);
+ return ($content, $response);
} else {
- return $response->content;
+ return $content;
}
}
@@ -2646,253 +2618,6 @@ sub allowuploaded {
&Apache::lonnet::appenv(\%httpref);
}
-#
-# 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
-# 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 --
-# $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
-#
-
-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;
- }
- }
- }
-
- if ($file ne '') {
- if (($cnum =~ /$match_courseid/) && ($cdom =~ /$match_domain/)) {
- if (&is_course_upload($file,$cnum,$cdom)) {
- $uploaded = 1;
- $incourse = 1;
- 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;
- }
- }
- }
- if ($uploaded || $incourse) {
- $home=&homeserver($cnum,$cdom);
- } elsif ($file !~ m{/$}) {
- $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
- my $setpriv = 1;
- my ($cfuname,$cfudom)=&constructaccess($file,$setpriv);
- if (defined($cfudom)) {
- $home=&homeserver($cfuname,$cfudom);
- $cfile=$file;
- }
- }
- if (($cfile ne '') && (!$incourse || $uploaded) &&
- (($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);
-}
-
-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)/})) {
- return 1;
- }
- return;
-}
-
-sub in_course {
- my ($udom,$uname,$cdom,$cnum,$type,$hideprivileged) = @_;
- if ($hideprivileged) {
- my $skipuser;
- if (&privileged($uname,$udom)) {
- $skipuser = 1;
- my %coursehash = &coursedescription($cdom.'_'.$cnum);
- 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,
@@ -3802,70 +3527,38 @@ sub userrolelog {
sub courserolelog {
my ($trole,$username,$domain,$area,$tstart,$tend,$delflag,$selfenroll,$context)=@_;
- if ($area =~ m-^/($match_domain)/($match_courseid)/?([^/]*)-) {
- my $cdom = $1;
- my $cnum = $2;
- my $sec = $3;
- my $namespace = 'rolelog';
- my %storehash = (
- role => $trole,
- start => $tstart,
- end => $tend,
- selfenroll => $selfenroll,
- context => $context,
- );
- if ($trole eq 'gr') {
- $namespace = 'groupslog';
- $storehash{'group'} = $sec;
- } else {
- $storehash{'section'} = $sec;
- }
- &write_log('course',$namespace,\%storehash,$delflag,$username,
- $domain,$cnum,$cdom);
- if (($trole ne 'st') || ($sec ne '')) {
- &devalidate_cache_new('getcourseroles',$cdom.'_'.$cnum);
+ if (($trole eq 'cc') || ($trole eq 'in') ||
+ ($trole eq 'ep') || ($trole eq 'ad') ||
+ ($trole eq 'ta') || ($trole eq 'st') ||
+ ($trole=~/^cr/) || ($trole eq 'gr') ||
+ ($trole eq 'co')) {
+ if ($area =~ m-^/($match_domain)/($match_courseid)/?([^/]*)-) {
+ my $cdom = $1;
+ my $cnum = $2;
+ my $sec = $3;
+ my $namespace = 'rolelog';
+ my %storehash = (
+ role => $trole,
+ start => $tstart,
+ end => $tend,
+ selfenroll => $selfenroll,
+ context => $context,
+ );
+ if ($trole eq 'gr') {
+ $namespace = 'groupslog';
+ $storehash{'group'} = $sec;
+ } else {
+ $storehash{'section'} = $sec;
+ }
+ &instructor_log($namespace,\%storehash,$delflag,$username,$domain,$cnum,$cdom);
+ if (($trole ne 'st') || ($sec ne '')) {
+ &devalidate_cache_new('getcourseroles',$cdom.'_'.$cnum);
+ }
}
}
return;
}
-sub domainrolelog {
- my ($trole,$username,$domain,$area,$tstart,$tend,$delflag,$context)=@_;
- if ($area =~ m{^/($match_domain)/$}) {
- my $cdom = $1;
- my $domconfiguser = &Apache::lonnet::get_domainconfiguser($cdom);
- my $namespace = 'rolelog';
- my %storehash = (
- role => $trole,
- start => $tstart,
- end => $tend,
- context => $context,
- );
- &write_log('domain',$namespace,\%storehash,$delflag,$username,
- $domain,$domconfiguser,$cdom);
- }
- return;
-
-}
-
-sub coauthorrolelog {
- my ($trole,$username,$domain,$area,$tstart,$tend,$delflag,$context)=@_;
- if ($area =~ m{^/($match_domain)/($match_username)$}) {
- my $audom = $1;
- my $auname = $2;
- my $namespace = 'rolelog';
- my %storehash = (
- role => $trole,
- start => $tstart,
- end => $tend,
- context => $context,
- );
- &write_log('author',$namespace,\%storehash,$delflag,$username,
- $domain,$auname,$audom);
- }
- return;
-}
-
sub get_course_adv_roles {
my ($cid,$codes) = @_;
$cid=$env{'request.course.id'} unless (defined($cid));
@@ -3978,7 +3671,7 @@ sub get_my_roles {
}
my ($rolecode,$username,$domain,$section,$area);
if ($context eq 'userroles') {
- ($area,$rolecode) = ($entry =~ /^(.+)_([^_]+)$/);
+ ($area,$rolecode) = split(/_/,$entry);
(undef,$domain,$username,$section) = split(/\//,$area);
} else {
($role,$username,$domain,$section) = split(/\:/,$entry);
@@ -5300,19 +4993,15 @@ sub delete_env_groupprivs {
sub check_adhoc_privs {
my ($cdom,$cnum,$update,$refresh,$now,$checkrole,$caller) = @_;
my $cckey = 'user.role.'.$checkrole.'./'.$cdom.'/'.$cnum;
- my $setprivs;
if ($env{$cckey}) {
my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend);
&role_status($cckey,$update,$refresh,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
unless (($tstatus eq 'is') || ($tstatus eq 'will_not')) {
&set_adhoc_privileges($cdom,$cnum,$checkrole,$caller);
- $setprivs = 1;
}
} else {
&set_adhoc_privileges($cdom,$cnum,$checkrole,$caller);
- $setprivs = 1;
}
- return $setprivs;
}
sub set_adhoc_privileges {
@@ -5699,88 +5388,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 {
@@ -6036,10 +5643,6 @@ sub usertools_access {
unofficial => 1,
community => 1,
);
- } elsif ($context eq 'requestauthor') {
- %tools = (
- requestauthor => 1,
- );
} else {
%tools = (
aboutme => 1,
@@ -6059,32 +5662,25 @@ sub usertools_access {
if ($action ne 'reload') {
if ($context eq 'requestcourses') {
return $env{'environment.canrequest.'.$tool};
- } elsif ($context eq 'requestauthor') {
- return $env{'environment.canrequest.author'};
} else {
return $env{'environment.availabletools.'.$tool};
}
}
}
- my ($toolstatus,$inststatus,$envkey);
- if ($context eq 'requestauthor') {
- $envkey = $context;
- } else {
- $envkey = $context.'.'.$tool;
- }
+ my ($toolstatus,$inststatus);
if (($udom eq $env{'user.domain'}) && ($uname eq $env{'user.name'}) &&
($action ne 'reload')) {
- $toolstatus = $env{'environment.'.$envkey};
+ $toolstatus = $env{'environment.'.$context.'.'.$tool};
$inststatus = $env{'environment.inststatus'};
} else {
if (ref($userenvref) eq 'HASH') {
- $toolstatus = $userenvref->{$envkey};
+ $toolstatus = $userenvref->{$context.'.'.$tool};
$inststatus = $userenvref->{'inststatus'};
} else {
- my %userenv = &userenvironment($udom,$uname,$envkey,'inststatus');
- $toolstatus = $userenv{$envkey};
+ my %userenv = &userenvironment($udom,$uname,$context.'.'.$tool,'inststatus');
+ $toolstatus = $userenv{$context.'.'.$tool};
$inststatus = $userenv{'inststatus'};
}
}
@@ -6807,73 +6403,6 @@ sub allowed {
return 'F';
}
-# ------------------------------------------- Check construction space access
-
-sub constructaccess {
- my ($url,$setpriv)=@_;
-
-# We do not allow editing of previous versions of files
- if ($url=~/\.(\d+)\.(\w+)$/) { return ''; }
-
-# Get username and domain from URL
- my ($ownername,$ownerdomain,$ownerhome);
-
- ($ownerdomain,$ownername) =
- ($url=~ m{^(?:\Q$perlvar{'lonDocRoot'}\E|)/priv/($match_domain)/($match_username)/});
-
-# The URL does not really point to any authorspace, forget it
- unless (($ownername) && ($ownerdomain)) { return ''; }
-
-# Now we need to see if the user has access to the authorspace of
-# $ownername at $ownerdomain
-
- if (($ownername eq $env{'user.name'}) && ($ownerdomain eq $env{'user.domain'})) {
-# Real author for this?
- $ownerhome = $env{'user.home'};
- if (exists($env{'user.priv.au./'.$ownerdomain.'/./'})) {
- return ($ownername,$ownerdomain,$ownerhome);
- }
- } else {
-# Co-author for this?
- if (exists($env{'user.priv.ca./'.$ownerdomain.'/'.$ownername.'./'}) ||
- exists($env{'user.priv.aa./'.$ownerdomain.'/'.$ownername.'./'}) ) {
- $ownerhome = &homeserver($ownername,$ownerdomain);
- return ($ownername,$ownerdomain,$ownerhome);
- }
- }
-
-# We don't have any access right now. If we are not possibly going to do anything about this,
-# we might as well leave
- unless ($setpriv) { return ''; }
-
-# Backdoor access?
- my $allowed=&allowed('eco',$ownerdomain);
-# Nope
- unless ($allowed) { return ''; }
-# Looks like we may have access, but could be locked by the owner of the construction space
- if ($allowed eq 'U') {
- my %blocked=&get('environment',['domcoord.author'],
- $ownerdomain,$ownername);
-# Is blocked by owner
- if ($blocked{'domcoord.author'} eq 'blocked') { return ''; }
- }
- if (($allowed eq 'F') || ($allowed eq 'U')) {
-# Grant temporary access
- my $then=$env{'user.login.time'};
- my $update=$env{'user.update.time'};
- if (!$update) { $update = $then; }
- my $refresh=$env{'user.refresh.time'};
- if (!$refresh) { $refresh = $update; }
- my $now = time;
- &check_adhoc_privs($ownerdomain,$ownername,$update,$refresh,
- $now,'ca','constructaccess');
- $ownerhome = &homeserver($ownername,$ownerdomain);
- return($ownername,$ownerdomain,$ownerhome);
- }
-# No business here
- return '';
-}
-
sub get_comm_blocks {
my ($cdom,$cnum) = @_;
if ($cdom eq '' || $cnum eq '') {
@@ -7938,41 +7467,6 @@ sub assignrole {
}
}
}
- } elsif ($context eq 'requestauthor') {
- if (($udom eq $env{'user.domain'}) && ($uname eq $env{'user.name'}) &&
- ($url eq '/'.$udom.'/') && ($role eq 'au')) {
- if ($env{'environment.requestauthor'} eq 'automatic') {
- $refused = '';
- } else {
- my %domdefaults = &get_domain_defaults($udom);
- if (ref($domdefaults{'requestauthor'}) eq 'HASH') {
- my $checkbystatus;
- if ($env{'user.adv'}) {
- my $disposition = $domdefaults{'requestauthor'}{'_LC_adv'};
- if ($disposition eq 'automatic') {
- $refused = '';
- } elsif ($disposition eq '') {
- $checkbystatus = 1;
- }
- } else {
- $checkbystatus = 1;
- }
- if ($checkbystatus) {
- if ($env{'environment.inststatus'}) {
- my @inststatuses = split(/,/,$env{'environment.inststatus'});
- foreach my $type (@inststatuses) {
- if (($type ne '') &&
- ($domdefaults{'requestauthor'}{$type} eq 'automatic')) {
- $refused = '';
- }
- }
- } elsif ($domdefaults{'requestauthor'}{'default'} eq 'automatic') {
- $refused = '';
- }
- }
- }
- }
- }
}
if ($refused) {
&logthis('Refused assignrole: '.$udom.' '.$uname.' '.$url.
@@ -8022,25 +7516,11 @@ sub assignrole {
# log new user role if status is ok
if ($answer eq 'ok') {
&userrolelog($role,$uname,$udom,$url,$start,$end);
- 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') ||
- ($role eq 'au') || ($role eq 'dc')) {
- &domainrolelog($role,$uname,$udom,$url,$origstart,$origend,$delflag,
- $context);
- } elsif (($role eq 'ca') || ($role eq 'aa')) {
- &coauthorrolelog($role,$uname,$udom,$url,$origstart,$origend,$delflag,
- $context);
+ &courserolelog($role,$uname,$udom,$url,$origstart,$origend,$delflag,$selfenroll,$context);
+ unless ($role =~ /^gr/) {
+ &Apache::longroup::group_changes($udom,$uname,$url,$role,$origend,
+ $origstart,$selfenroll,$context);
}
if ($role eq 'cc') {
&autoupdate_coowners($url,$end,$start,$uname,$udom);
@@ -10270,78 +9750,6 @@ sub gettitle {
return $title;
}
-sub getdocspath {
- my ($symb) = @_;
- my $path;
- if ($symb) {
- my ($mapurl,$id,$resurl) = &decode_symb($symb);
- if ($resurl=~/\.(sequence|page)$/) {
- $mapurl=$resurl;
- } elsif ($resurl eq 'adm/navmaps') {
- $mapurl=$env{'course.'.$env{'request.course.id'}.'.url'};
- }
- my $mapresobj;
- my $navmap = Apache::lonnavmaps::navmap->new();
- if (ref($navmap)) {
- $mapresobj = $navmap->getResourceByUrl($mapurl);
- }
- $mapurl=~s{^.*/([^/]+)\.(\w+)$}{$1};
- my $type=$2;
- if (ref($mapresobj)) {
- my $pcslist = $mapresobj->map_hierarchy();
- if ($pcslist ne '') {
- foreach my $pc (split(/,/,$pcslist)) {
- next if ($pc <= 1);
- my $res = $navmap->getByMapPc($pc);
- if (ref($res)) {
- my $thisurl = $res->src();
- $thisurl=~s{^.*/([^/]+)\.\w+$}{$1};
- my $thistitle = $res->title();
- $path .= '&'.
- &Apache::lonhtmlcommon::entity_encode($thisurl).'&'.
- &Apache::lonhtmlcommon::entity_encode($thistitle).
- ':'.$res->randompick().
- ':'.$res->randomout().
- ':'.$res->encrypted().
- ':'.$res->randomorder().
- ':'.$res->is_page();
- }
- }
- }
- $path =~ s/^\&//;
- my $maptitle = $mapresobj->title();
- if ($mapurl eq 'default') {
- $maptitle = 'Main Course Documents';
- }
- $path .= ($path ne '')? '&' : ''.
- &Apache::lonhtmlcommon::entity_encode($mapurl).'&'.
- &Apache::lonhtmlcommon::entity_encode($maptitle).
- ':'.$mapresobj->randompick().
- ':'.$mapresobj->randomout().
- ':'.$mapresobj->encrypted().
- ':'.$mapresobj->randomorder().
- ':'.$mapresobj->is_page();
- } else {
- my $maptitle = &gettitle($mapurl);
- my $ispage;
- if ($mapurl =~ /\.page$/) {
- $ispage = 1;
- }
- if ($mapurl eq 'default') {
- $maptitle = 'Main Course Documents';
- }
- $path = &Apache::lonhtmlcommon::entity_encode($mapurl).'&'.
- &Apache::lonhtmlcommon::entity_encode($maptitle).':::::'.$ispage;
- }
- unless ($mapurl eq 'default') {
- $path = 'default&'.
- &Apache::lonhtmlcommon::entity_encode('Main Course Documents').
- ':::::&'.$path;
- }
- }
- return $path;
-}
-
sub get_slot {
my ($which,$cnum,$cdom)=@_;
if (!$cnum || !$cdom) {
@@ -10408,41 +9816,6 @@ sub devalidate_slots_cache {
&devalidate_cache_new('allslots',$hashid);
}
-sub get_coursechange {
- my ($cdom,$cnum) = @_;
- if ($cdom eq '' || $cnum eq '') {
- return unless ($env{'request.course.id'});
- $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
- $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
- }
- my $hashid=$cdom.'_'.$cnum;
- my ($change,$cached)=&is_cached_new('crschange',$hashid);
- if ((defined($cached)) && ($change ne '')) {
- return $change;
- } else {
- my %crshash;
- %crshash = &get('environment',['internal.contentchange'],$cdom,$cnum);
- if ($crshash{'internal.contentchange'} eq '') {
- $change = $env{'course.'.$cdom.'_'.$cnum.'.internal.created'};
- if ($change eq '') {
- %crshash = &get('environment',['internal.created'],$cdom,$cnum);
- $change = $crshash{'internal.created'};
- }
- } else {
- $change = $crshash{'internal.contentchange'};
- }
- my $cachetime = 600;
- &do_cache_new('crschange',$hashid,$change,$cachetime);
- }
- return $change;
-}
-
-sub devalidate_coursechange_cache {
- my ($cnum,$cdom)=@_;
- my $hashid=$cnum.':'.$cdom;
- &devalidate_cache_new('crschange',$hashid);
-}
-
# ------------------------------------------------- Update symbolic store links
sub symblist {
@@ -10470,7 +9843,7 @@ sub symblist {
# --------------------------------------------------------------- Verify a symb
sub symbverify {
- my ($symb,$thisurl,$encstate)=@_;
+ my ($symb,$thisurl)=@_;
my $thisfn=$thisurl;
$thisfn=&declutter($thisfn);
# direct jump to resource in page or to a sequence - will construct own symbs
@@ -10489,46 +9862,31 @@ 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'}) ||
+ eq $symb) {
+ if (($env{'request.role.adv'}) ||
+ ($bighash{'encrypted_'.$id} eq $env{'request.enc'}) ||
($thisurl eq '/adm/navmaps')) {
- $okay=1;
- last;
- }
- }
- }
+ $okay=1;
+ }
+ }
+ }
}
untie(%bighash);
}
@@ -10601,18 +9959,14 @@ sub deversion {
sub symbread {
my ($thisfn,$donotrecurse)=@_;
- my $cache_str;
- if ($thisfn ne '') {
- $cache_str='request.symbread.cached.'.$thisfn;
- if ($env{$cache_str} ne '') {
- return $env{$cache_str};
- }
- } else {
+ my $cache_str='request.symbread.cached.'.$thisfn;
+ if (defined($env{$cache_str})) { return $env{$cache_str}; }
# 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
@@ -10840,6 +10194,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') {
@@ -11522,12 +10877,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;
}
}
@@ -11552,10 +10907,8 @@ sub get_dns {
delete($alldns{$dns});
next if ($response->is_error());
my @content = split("\n",$response->content);
- unless ($nocache) {
- &Apache::lonnet::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);
@@ -11563,62 +10916,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);
- 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 $versions = shift(@{$lines});
- my %supported;
- if ($versions =~ /^VERSIONS\:([\w\.\,]+)$/) {
- my $releaseslist = $1;
- if ($releaseslist =~ /,/) {
- map { $supported{$_} = 1; } split(/,/,$releaseslist);
- } elsif ($releaseslist) {
- $supported{$releaseslist} = 1;
- }
- }
- if ($supported{$release}) {
- my $matchthis = 0;
- foreach my $line (@{$lines}) {
- if ($line =~ /^(\d[\w\.]+)$/) {
- if ($matchthis) {
- last;
- } elsif ($1 eq $release) {
- $matchthis = 1;
- }
- } elsif ($matchthis) {
- my ($file,$version,$shasum) = split(/,/,$line);
- $chksum{$file} = $shasum;
- $revnum{$file} = $version;
- }
- }
- if (ref($hashref) eq 'HASH') {
- %{$hashref} = (
- sums => \%chksum,
- versions => \%revnum,
- );
- }
- }
- }
+ &$func(\@content);
return;
}
-
-sub fetch_dns_checksums {
- my %checksums;
- &get_dns('/adm/dns/checksums',\&parse_dns_checksums_tab,1,1,
- \%checksums);
- return \%checksums;
-}
-
# ------------------------------------------------------------ Read domain file
{
my $loaded;
@@ -12156,17 +11456,6 @@ $readit=1;
if ($test != 0) { $_64bit=1; } else { $_64bit=0; }
&logthis(" Detected 64bit platform ($_64bit)");
}
-
- {
- eval {
- ($apache) =
- (Apache2::ServerUtil::get_server_version() =~ m{Apache/(\d+\.\d+)});
- };
- if ($@) {
- $apache = 1.3;
- }
- }
-
}
}
@@ -12454,21 +11743,6 @@ allowed($priv,$uri,$symb,$role) : check
=item *
-constructaccess($url,$setpriv) : check for access to construction space URL
-
-See if the owner domain and name in the URL match those in the
-expected environment. If so, return three element list
-($ownername,$ownerdomain,$ownerhome).
-
-Otherwise return the null string.
-
-If second argument 'setpriv' is true, it assigns the privileges,
-and returns the same three element list, unless the owner has
-blocked "ad hoc" Domain Coordinator access to the Author Space,
-in which case the null string is returned.
-
-=item *
-
definerole($rolename,$sysrole,$domrole,$courole) : define role; define a custom
role rolename set privileges in format of lonTabs/roles.tab for system, domain,
and course level
@@ -12499,17 +11773,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 or Super User roles.
-
=back
=head2 User Modification
@@ -12712,6 +11975,7 @@ data base, returning a hash that is keye
values that are the resource value. I believe that the timestamps and
versions are also returned.
+
=back
=head2 Course Modification
@@ -12812,14 +12076,12 @@ returns the data handle
=item *
-symbverify($symb,$thisfn,$encstate) : verifies that $symb actually exists
-and is a possible symb for the URL in $thisfn, and if is an encrypted
+symbverify($symb,$thisfn) : verifies that $symb actually exists and is
+a possible symb for the URL in $thisfn, and if is an encryypted
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
-call to symbverify, it will be set to 1 if the symb has been set to be
-encrypted; otherwise it will be null.
+on failure, user must be in a course, as it assumes the existance of
+the course initial hash, and uses $env('request.course.id'}
+
=item *
@@ -12872,34 +12134,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
@@ -13455,8 +12689,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
@@ -13474,51 +12706,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