Annotation of loncom/auth/lonacc.pm, revision 1.159.2.14

1.1       albertel    1: # The LearningOnline Network
                      2: # Cookie Based Access Handler
1.22      www         3: #
1.159.2.14! raeburn     4: # $Id: lonacc.pm,v 1.159.2.13 2020/10/01 10:42:56 raeburn Exp $
1.22      www         5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
1.25      harris41   28: ###
1.1       albertel   29: 
1.121     jms        30: =head1 NAME
                     31: 
                     32: Apache::lonacc - Cookie Based Access Handler
                     33: 
                     34: =head1 SYNOPSIS
                     35: 
                     36: Invoked (for various locations) by /etc/httpd/conf/srm.conf:
                     37: 
                     38:  PerlAccessHandler       Apache::lonacc
                     39: 
                     40: =head1 INTRODUCTION
                     41: 
                     42: This module enables cookie based authentication and is used
                     43: to control access for many different LON-CAPA URIs.
                     44: 
                     45: Whenever the client sends the cookie back to the server, 
                     46: this cookie is handled by either lonacc.pm or loncacc.pm
                     47: (see srm.conf for what is invoked when).  If
                     48: the cookie is missing or invalid, the user is re-challenged
                     49: for login information.
                     50: 
                     51: This is part of the LearningOnline Network with CAPA project
                     52: described at http://www.lon-capa.org.
                     53: 
                     54: =head1 HANDLER SUBROUTINE
                     55: 
                     56: This routine is called by Apache and mod_perl.
                     57: 
                     58: =over 4
                     59: 
                     60: =item *
                     61: 
                     62: transfer profile into environment
                     63: 
                     64: =item *
                     65: 
                     66: load POST parameters
                     67: 
                     68: =item *
                     69: 
                     70: check access
                     71: 
                     72: =item *
                     73: 
                     74: if allowed, get symb, log, generate course statistics if applicable
                     75: 
                     76: =item *
                     77: 
                     78: otherwise return error
                     79: 
                     80: =item *
                     81: 
                     82: see if public resource
                     83: 
                     84: =item *
                     85: 
                     86: store attempted access
                     87: 
                     88: =back
                     89: 
                     90: =head1 NOTABLE SUBROUTINES
                     91: 
                     92: =cut
                     93: 
1.119     jms        94: 
1.1       albertel   95: package Apache::lonacc;
                     96: 
                     97: use strict;
1.8       www        98: use Apache::Constants qw(:common :http :methods);
1.2       www        99: use Apache::File;
1.6       www       100: use Apache::lonnet;
1.25      harris41  101: use Apache::loncommon();
1.47      www       102: use Apache::lonlocal;
1.86      albertel  103: use Apache::restrictedaccess();
1.148     raeburn   104: use Apache::blockedaccess();
1.16      www       105: use Fcntl qw(:flock);
1.141     raeburn   106: use LONCAPA qw(:DEFAULT :match);
1.1       albertel  107: 
1.75      albertel  108: sub cleanup {
                    109:     my ($r)=@_;
                    110:     if (! $r->is_initial_req()) { return DECLINED; }
                    111:     &Apache::lonnet::save_cache();
                    112:     return OK;
                    113: }
                    114: 
                    115: sub goodbye {
                    116:     my ($r)=@_;
                    117:     &Apache::lonnet::goodbye();
                    118:     return DONE;
                    119: }
                    120: 
1.76      albertel  121: ###############################################
                    122: 
                    123: sub get_posted_cgi {
1.114     raeburn   124:     my ($r,$fields) = @_;
1.76      albertel  125: 
                    126:     my $buffer;
                    127:     if ($r->header_in('Content-length')) {
                    128: 	$r->read($buffer,$r->header_in('Content-length'),0);
                    129:     }
1.113     albertel  130:     my $content_type = $r->header_in('Content-type');
                    131:     if ($content_type !~ m{^multipart/form-data}) {
1.76      albertel  132: 	my @pairs=split(/&/,$buffer);
                    133: 	my $pair;
                    134: 	foreach $pair (@pairs) {
                    135: 	    my ($name,$value) = split(/=/,$pair);
                    136: 	    $value =~ tr/+/ /;
                    137: 	    $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
                    138: 	    $name  =~ tr/+/ /;
                    139: 	    $name  =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.114     raeburn   140:             if (ref($fields) eq 'ARRAY') {
                    141:                 next if (!grep(/^\Q$name\E$/,@{$fields}));
                    142:             }
1.77      albertel  143: 	    &Apache::loncommon::add_to_env("form.$name",$value);
1.76      albertel  144: 	}
                    145:     } else {
1.113     albertel  146: 	my ($contentsep) = ($content_type =~ /boundary=\"?([^\";,]+)\"?/);
1.76      albertel  147: 	my @lines = split (/\n/,$buffer);
                    148: 	my $name='';
                    149: 	my $value='';
                    150: 	my $fname='';
                    151: 	my $fmime='';
                    152: 	my $i;
                    153: 	for ($i=0;$i<=$#lines;$i++) {
1.113     albertel  154: 	    if ($lines[$i]=~/^--\Q$contentsep\E/) {
1.76      albertel  155: 		if ($name) {
1.139     raeburn   156:                     chomp($value);
                    157:                     if (($r->uri eq '/adm/portfolio') && 
                    158:                         ($name eq 'uploaddoc')) {
                    159:                         if (length($value) == 1) {
                    160:                             $value=~s/[\r\n]$//;
                    161:                         }
1.159.2.6  raeburn   162:                     } elsif ($fname =~ /\.(xls|doc|ppt)(x|m)$/i) {
1.154     raeburn   163:                         $value=~s/[\r\n]$//;
1.139     raeburn   164:                     }
1.114     raeburn   165:                     if (ref($fields) eq 'ARRAY') {
                    166:                         next if (!grep(/^\Q$name\E$/,@{$fields}));
                    167:                     }
1.118     raeburn   168:                     if ($fname) {
                    169:                         if ($env{'form.symb'} ne '') {
                    170:                             my $size = (length($value))/(1024.0 * 1024.0);
                    171:                             if (&upload_size_allowed($name,$size,$fname) eq 'ok') {
                    172:                                 $env{"form.$name.filename"}=$fname;
                    173:                                 $env{"form.$name.mimetype"}=$fmime;
                    174:                                 &Apache::loncommon::add_to_env("form.$name",$value);
                    175:                             }
                    176:                         } else {
                    177:                             $env{"form.$name.filename"}=$fname;
                    178:                             $env{"form.$name.mimetype"}=$fmime;
                    179:                             &Apache::loncommon::add_to_env("form.$name",$value);
                    180:                         }
                    181:                     } else {
                    182:                         $value=~s/\s+$//s;
                    183:                         &Apache::loncommon::add_to_env("form.$name",$value);
                    184:                     }
1.76      albertel  185: 		}
                    186: 		if ($i<$#lines) {
                    187: 		    $i++;
                    188: 		    $lines[$i]=~
                    189: 		/Content\-Disposition\:\s*form\-data\;\s*name\=\"([^\"]+)\"/i;
                    190: 		    $name=$1;
                    191: 		    $value='';
                    192: 		    if ($lines[$i]=~/filename\=\"([^\"]+)\"/i) {
                    193: 			$fname=$1;
                    194: 			if 
                    195:                             ($lines[$i+1]=~/Content\-Type\:\s*([\w\-\/]+)/i) {
                    196: 				$fmime=$1;
                    197: 				$i++;
                    198: 			    } else {
                    199: 				$fmime='';
                    200: 			    }
                    201: 		    } else {
                    202: 			$fname='';
                    203: 			$fmime='';
                    204: 		    }
                    205: 		    $i++;
                    206: 		}
                    207: 	    } else {
                    208: 		$value.=$lines[$i]."\n";
                    209: 	    }
                    210: 	}
                    211:     }
                    212: #
                    213: # Digested POSTed values
                    214: #
                    215: # Remember the way this was originally done (GET or POST)
                    216: #
                    217:     $env{'request.method'}=$ENV{'REQUEST_METHOD'};
                    218: #
                    219: # There may also be stuff in the query string
                    220: # Tell subsequent handlers that this was GET, not POST, so they can access query string.
                    221: # Also, unset POSTed content length to cover all tracks.
                    222: #
                    223: 
                    224:     $r->method_number(M_GET);
                    225: 
                    226:     $r->method('GET');
                    227:     $r->headers_in->unset('Content-length');
                    228: }
                    229: 
1.121     jms       230: =pod
                    231: 
1.146     raeburn   232: =over
                    233: 
1.121     jms       234: =item upload_size_allowed()
                    235: 
                    236: 	Perform size checks for file uploads to essayresponse items in course context.
                    237: 	
                    238: 	Add form.HWFILESIZE.$part_$id to %env with file size (MB)
                    239: 	If file exceeds maximum allowed size, add form.HWFILETOOBIG.$part_$id to %env.
                    240: 
                    241: =cut
1.118     raeburn   242:  
                    243: sub upload_size_allowed {
                    244:     my ($name,$size,$fname) = @_;
                    245:     if ($name =~ /^HWFILE(\w+)$/) {
                    246:         my $ident = $1;
                    247:         my $item = 'HWFILESIZE'.$ident;
1.122     raeburn   248:         my $savesize = sprintf("%.6f",$size);
                    249:         &Apache::loncommon::add_to_env("form.$item",$savesize);
1.118     raeburn   250:         my $maxsize= &Apache::lonnet::EXT("resource.$ident.maxfilesize");
                    251:         if (!$maxsize) {
1.123     raeburn   252:             $maxsize = 10.0; # FIXME This should become a domain configuration.
1.118     raeburn   253:         }
                    254:         if ($size > $maxsize) {
                    255:             my $warn = 'HWFILETOOBIG'.$ident;
                    256:             &Apache::loncommon::add_to_env("form.$warn",$fname);
                    257:             return;
                    258:         }
                    259:     }
                    260:     return 'ok';
                    261: }
                    262: 
1.121     jms       263: =pod
                    264: 
                    265: =item sso_login()
                    266: 
                    267: 	handle the case of the single sign on user, at this point $r->user 
1.150     raeburn   268: 	will be set and valid; now need to find the loncapa user info, and possibly
1.149     raeburn   269: 	balance them. If $r->user() is set this means either it was either set by
1.150     raeburn   270:         SSO or by checkauthen.pm, if a valid cookie was found. The latter case can
                    271:         be identified by the third arg ($usename), except when lonacc is called in 
                    272:         an internal redirect to /adm/switchserver (e.g., load-balancing following
                    273:         successful authentication) -- no cookie set yet.  For that particular case
                    274:         simply skip the call to sso_login(). 
1.149     raeburn   275: 
                    276: 	returns OK if it was SSO and user was handled.
                    277:         returns undef if not SSO or no means to handle the user.
1.121     jms       278:         
                    279: =cut
1.117     jms       280: 
1.94      albertel  281: sub sso_login {
1.149     raeburn   282:     my ($r,$handle,$username) = @_;
1.94      albertel  283: 
1.156     raeburn   284:     if (($r->user eq '') || ($username ne '') || ($r->user eq 'public:public') ||
1.143     raeburn   285:         (defined($env{'user.name'}) && (defined($env{'user.domain'}))
                    286: 	  && ($handle ne ''))) {
1.94      albertel  287: 	# not an SSO case or already logged in
                    288: 	return undef;
                    289:     }
                    290: 
1.159.2.1  raeburn   291:     my ($user) = ($r->user =~ m/^($match_username)$/);
                    292:     if ($user eq '') {
                    293:         return undef;
                    294:     }
1.97      albertel  295: 
1.126     raeburn   296:     my $query = $r->args;
                    297:     my %form;
                    298:     if ($query) {
1.145     raeburn   299:         my @items = ('role','symb','iptoken');
1.127     raeburn   300:         &Apache::loncommon::get_unprocessed_cgi($query,\@items);
                    301:         foreach my $item (@items) {
                    302:             if (defined($env{'form.'.$item})) {
                    303:                 $form{$item} = $env{'form.'.$item};
1.126     raeburn   304:             }
                    305:         }
                    306:     }
                    307: 
1.145     raeburn   308:     my %sessiondata;
                    309:     if ($form{'iptoken'}) {
                    310:         %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});
1.158     raeburn   311:         my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});
                    312:         unless ($sessiondata{'sessionserver'}) {
                    313:             delete($form{'iptoken'});
                    314:         }
1.145     raeburn   315:     }
                    316: 
1.136     raeburn   317:     my $domain = $r->dir_config('lonSSOUserDomain');
                    318:     if ($domain eq '') {
                    319:         $domain = $r->dir_config('lonDefDomain');
                    320:     }
1.97      albertel  321:     my $home=&Apache::lonnet::homeserver($user,$domain);
1.94      albertel  322:     if ($home !~ /(con_lost|no_host|no_such_host)/) {
1.107     albertel  323: 	&Apache::lonnet::logthis(" SSO authorized user $user ");
1.145     raeburn   324:         my ($is_balancer,$otherserver,$hosthere);
                    325:         if ($form{'iptoken'}) {
1.158     raeburn   326:             if (($sessiondata{'domain'} eq $domain) &&
                    327:                 ($sessiondata{'username'} eq $user)) {
1.145     raeburn   328:                 $hosthere = 1;
                    329:             }
                    330:         }
                    331:         unless ($hosthere) {
                    332:             ($is_balancer,$otherserver) =
1.159.2.5  raeburn   333:                 &Apache::lonnet::check_loadbalancing($user,$domain,'login');
                    334:             if ($is_balancer) {
1.159.2.8  raeburn   335:                 # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    336:                 my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    337:                 if (($found_server) && ($balancer_cookie =~ /^\Q$domain\E_\Q$user\E_/)) {
                    338:                     $otherserver = $found_server;
                    339:                 } elsif ($otherserver eq '') {
1.159.2.5  raeburn   340:                     my $lowest_load;
                    341:                     ($otherserver,undef,undef,undef,$lowest_load) = &Apache::lonnet::choose_server($domain);
                    342:                     if ($lowest_load > 100) {
                    343:                         $otherserver = &Apache::lonnet::spareserver($lowest_load,$lowest_load,1,$domain);
                    344:                     }
1.159.2.8  raeburn   345:                     if ($otherserver ne '') {
                    346:                         my @hosts = &Apache::lonnet::current_machine_ids();
                    347:                         if (grep(/^\Q$otherserver\E$/,@hosts)) {
                    348:                             $hosthere = $otherserver;
                    349:                         }
1.159.2.5  raeburn   350:                     }
                    351:                 }
                    352:             }
1.145     raeburn   353:         }
1.159.2.5  raeburn   354: 	if (($is_balancer) && (!$hosthere)) {
1.136     raeburn   355: 	    # login but immediately go to switch server to find us a new 
1.94      albertel  356: 	    # machine
1.127     raeburn   357: 	    &Apache::lonauth::success($r,$user,$domain,$home,'noredirect');
1.105     raeburn   358:             $env{'request.sso.login'} = 1;
1.106     raeburn   359:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    360:                 $env{'request.sso.reloginserver'} =
                    361:                     $r->dir_config('lonSSOReloginServer');
                    362:             }
1.137     raeburn   363:             my $redirecturl = '/adm/switchserver';
                    364:             if ($otherserver ne '') {
                    365:                 $redirecturl .= '?otherserver='.$otherserver;
                    366:             }
                    367: 	    $r->internal_redirect($redirecturl);
1.101     albertel  368: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  369: 	} else {
                    370: 	    # need to login them in, so generate the need data that
                    371: 	    # migrate expects to do login
1.159.2.4  raeburn   372:             my $ip = $r->get_remote_host();
1.147     raeburn   373: 	    my %info=('ip'        => $ip,
1.94      albertel  374: 		      'domain'    => $domain,
1.97      albertel  375: 		      'username'  => $user,
1.94      albertel  376: 		      'server'    => $r->dir_config('lonHostID'),
                    377: 		      'sso.login' => 1
                    378: 		      );
1.158     raeburn   379:             foreach my $item ('role','symb','iptoken') {
1.126     raeburn   380:                 if (exists($form{$item})) {
                    381:                     $info{$item} = $form{$item};
                    382:                 }
                    383:             }
1.151     raeburn   384:             unless ($info{'symb'}) {
1.152     raeburn   385:                 unless (($r->uri eq '/adm/roles') || ($r->uri eq '/adm/sso')) {
1.151     raeburn   386:                     $info{'origurl'} = $r->uri; 
                    387:                 }
                    388:             }
1.116     raeburn   389:             if ($r->dir_config("ssodirecturl") == 1) {
                    390:                 $info{'origurl'} = $r->uri;
                    391:             }
1.106     raeburn   392:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    393:                 $info{'sso.reloginserver'} = 
                    394:                     $r->dir_config('lonSSOReloginServer'); 
                    395:             }
1.159.2.5  raeburn   396:             if (($is_balancer) && ($hosthere)) {
                    397:                 $info{'noloadbalance'} = $hosthere;
                    398:             }
1.94      albertel  399: 	    my $token = 
                    400: 		&Apache::lonnet::tmpput(\%info,
                    401: 					$r->dir_config('lonHostID'));
                    402: 	    $env{'form.token'} = $token;
                    403: 	    $r->internal_redirect('/adm/migrateuser');
1.101     albertel  404: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  405: 	}
                    406: 	return OK;
1.155     raeburn   407:     } else {
1.107     albertel  408: 	&Apache::lonnet::logthis(" SSO authorized unknown user $user ");
1.115     raeburn   409:         my @cancreate;
                    410:         my %domconfig =
                    411:             &Apache::lonnet::get_dom('configuration',['usercreation'],$domain);
                    412:         if (ref($domconfig{'usercreation'}) eq 'HASH') {
                    413:             if (ref($domconfig{'usercreation'}{'cancreate'}) eq 'HASH') {
                    414:                 if (ref($domconfig{'usercreation'}{'cancreate'}{'selfcreate'}) eq 'ARRAY') {
                    415:                     @cancreate = @{$domconfig{'usercreation'}{'cancreate'}{'selfcreate'}};
                    416:                 } elsif (($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne 'none') && 
                    417:                          ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne '')) {
                    418:                     @cancreate = ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'});
                    419:                 }
                    420:             }
                    421:         }
1.155     raeburn   422:         if ((grep(/^sso$/,@cancreate)) || (defined($r->dir_config('lonSSOUserUnknownRedirect')))) {
                    423:             $r->subprocess_env->set('SSOUserUnknown' => $user);
                    424:             $r->subprocess_env->set('SSOUserDomain' => $domain);
                    425:             if (grep(/^sso$/,@cancreate)) {
                    426:                 $r->set_handlers('PerlHandler'=> [\&Apache::createaccount::handler]);
                    427:                 $r->handler('perl-script');
                    428:             } else {
                    429: 	        $r->internal_redirect($r->dir_config('lonSSOUserUnknownRedirect'));
                    430:                 $r->set_handlers('PerlHandler'=> undef);
                    431:             }
                    432: 	    return OK;
1.115     raeburn   433:         }
1.94      albertel  434:     }
                    435:     return undef;
                    436: }
                    437: 
1.1       albertel  438: sub handler {
                    439:     my $r = shift;
                    440:     my $requrl=$r->uri;
1.149     raeburn   441: 
                    442:     if ($requrl =~ m{^/res/adm/pages/[^/]+\.(gif|png)$}) {
1.108     raeburn   443:         return OK;
                    444:     }
1.70      albertel  445: 
1.149     raeburn   446:     if (&Apache::lonnet::is_domainimage($requrl)) {
1.124     raeburn   447:         return OK;
                    448:     }
                    449: 
1.149     raeburn   450:     my %user;
                    451:     my $handle = &Apache::lonnet::check_for_valid_session($r,undef,\%user);
1.93      albertel  452: 
1.150     raeburn   453:     unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    454:         my $result = &sso_login($r,$handle,$user{'name'});
                    455:         if (defined($result)) {
                    456: 	    return $result;
                    457:         }
1.70      albertel  458:     }
                    459: 
1.137     raeburn   460:     my ($is_balancer,$otherserver);
1.142     raeburn   461: 
1.92      albertel  462:     if ($handle eq '') {
1.159     raeburn   463:         unless ((($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) ||
                    464:                 ($requrl =~ m{^/public/$match_domain/$match_courseid/syllabus}) ||
                    465:                 ($requrl =~ m{^/adm/help/}) ||
                    466:                 ($requrl =~ m{^/res/$match_domain/$match_username/})) {
1.149     raeburn   467: 	    $r->log_reason("Cookie not valid", $r->filename);
1.142     raeburn   468:         }
1.111     albertel  469:     } elsif ($handle ne '') {
1.6       www       470: 
1.46      www       471: # ------------------------------------------------------ Initialize Environment
1.111     albertel  472: 	my $lonidsdir=$r->dir_config('lonIDsDir');
1.92      albertel  473: 	&Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
1.47      www       474: 
                    475: # --------------------------------------------------------- Initialize Language
                    476: 
1.92      albertel  477: 	&Apache::lonlocal::get_language_handle($r);
                    478: 
                    479:     }
1.46      www       480: 
1.92      albertel  481: # -------------------------------------------------- Should be a valid user now
                    482:     if ($env{'user.name'} ne '' && $env{'user.domain'} ne '') {
1.46      www       483: # -------------------------------------------------------------- Resource State
1.6       www       484: 
1.141     raeburn   485:         my ($cdom,$cnum);
                    486:         if ($env{'request.course.id'}) {
                    487:             $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
                    488:             $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
                    489:         }
1.92      albertel  490: 	if ($requrl=~/^\/+(res|uploaded)\//) {
                    491: 	    $env{'request.state'} = "published";
                    492: 	} else {
                    493: 	    $env{'request.state'} = 'unknown';
                    494: 	}
                    495: 	$env{'request.filename'} = $r->filename;
                    496: 	$env{'request.noversionuri'} = &Apache::lonnet::deversion($requrl);
1.157     raeburn   497:         my ($suppext,$checkabsolute);
1.129     raeburn   498:         if ($requrl =~ m{^/adm/wrapper/ext/}) {
                    499:             my $query = $r->args;
                    500:             if ($query) {
                    501:                 my $preserved;
                    502:                 foreach my $pair (split(/&/,$query)) {
                    503:                     my ($name, $value) = split(/=/,$pair);
1.159.2.7  raeburn   504:                     unless (($name eq 'symb') || ($name eq 'usehttp')) {
1.129     raeburn   505:                         $preserved .= $pair.'&';
                    506:                     }
1.141     raeburn   507:                     if (($env{'request.course.id'}) && ($name eq 'folderpath')) {
                    508:                         if ($value =~ /^supplemental/) {
                    509:                             $suppext = 1;
                    510:                         }
                    511:                     }
1.129     raeburn   512:                 }
                    513:                 $preserved =~ s/\&$//;
                    514:                 if ($preserved) {
                    515:                     $env{'request.external.querystring'} = $preserved;
                    516:                 }
                    517:             }
1.157     raeburn   518:             if ($env{'request.course.id'}) {
                    519:                 $checkabsolute = 1;
                    520:             }
1.141     raeburn   521:         } elsif ($env{'request.course.id'} &&
                    522:                  (($requrl =~ m{^/adm/$match_domain/$match_username/aboutme$}) ||
                    523:                   ($requrl =~ m{^/public/$cdom/$cnum/syllabus$}))) {
                    524:             my $query = $r->args;
                    525:             if ($query) {
                    526:                 foreach my $pair (split(/&/,$query)) {
                    527:                     my ($name, $value) = split(/=/,$pair);
                    528:                     if ($name eq 'folderpath') {
                    529:                         if ($value =~ /^supplemental/) {
                    530:                             $suppext = 1;
                    531:                         }
1.159.2.12  raeburn   532:                         last;
1.141     raeburn   533:                     }
                    534:                 }
                    535:             }
1.157     raeburn   536:             if ($requrl =~ m{^/public/$cdom/$cnum/syllabus$}) {
                    537:                 $checkabsolute = 1;
                    538:             }
                    539:         }
                    540:         if ($checkabsolute) {
                    541:             my $hostname = $r->hostname();
                    542:             my $lonhost = &Apache::lonnet::host_from_dns($hostname);
                    543:             if ($lonhost) {
                    544:                 my $actual = &Apache::lonnet::absolute_url($hostname);
                    545:                 my $expected = $Apache::lonnet::protocol{$lonhost}.'://'.$hostname;
                    546:                 unless ($actual eq $expected) {
                    547:                     $env{'request.use_absolute'} = $expected;
                    548:                 }
                    549:             }
1.129     raeburn   550:         }
1.6       www       551: # -------------------------------------------------------- Load POST parameters
                    552: 
1.92      albertel  553: 	&Apache::lonacc::get_posted_cgi($r);
1.6       www       554: 
1.137     raeburn   555: # ------------------------------------------------------ Check if load balancer 
                    556: 
1.138     raeburn   557:         my $checkexempt;
                    558:         if ($env{'user.loadbalexempt'} eq $r->dir_config('lonHostID')) {
                    559:             if ($env{'user.loadbalcheck.time'} + 600 > time) {
1.159.2.8  raeburn   560:                 $checkexempt = 1;
1.138     raeburn   561:             }
                    562:         }
1.145     raeburn   563:         if ($env{'user.noloadbalance'} eq $r->dir_config('lonHostID')) {
                    564:             $checkexempt = 1;
                    565:         }
1.138     raeburn   566:         unless ($checkexempt) {
                    567:             ($is_balancer,$otherserver) =
                    568:                 &Apache::lonnet::check_loadbalancing($env{'user.name'},
                    569:                                                      $env{'user.domain'});
1.159.2.8  raeburn   570:             if ($is_balancer) {
                    571:                 unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    572:                     # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    573:                     my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    574:                     if (($found_server) && ($balancer_cookie =~ /^\Q$env{'user.domain'}\E_\Q$env{'user.name'}\E_/)) {
                    575:                         $otherserver = $found_server;
                    576:                     }
                    577:                 }
                    578:             }
1.138     raeburn   579:         }
1.137     raeburn   580:         if ($is_balancer) {
1.159.2.8  raeburn   581:             unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    582:                 $r->set_handlers('PerlResponseHandler'=>
                    583:                                  [\&Apache::switchserver::handler]);
                    584:                 if ($otherserver ne '') {
                    585:                     $env{'form.otherserver'} = $otherserver;
                    586:                 }
1.137     raeburn   587:             }
1.152     raeburn   588:             unless (($env{'form.origurl'}) || ($r->uri eq '/adm/roles') ||
                    589:                     ($r->uri eq '/adm/switchserver') || ($r->uri eq '/adm/sso')) {
                    590:                 $env{'form.origurl'} = $r->uri;
                    591:             }
1.137     raeburn   592:         }
                    593: 
1.6       www       594: # ---------------------------------------------------------------- Check access
1.92      albertel  595: 	my $now = time;
1.159.2.12  raeburn   596:         my $check_symb;
1.159.2.10  raeburn   597: 	if ($requrl !~ m{^/(?:adm|public|(?:prt|zip)spool)/}
1.95      albertel  598: 	    || $requrl =~ /^\/adm\/.*\/(smppg|bulletinboard)(\?|$ )/x) {
1.159.2.11  raeburn   599:             my ($access,$poss_symb);
1.159.2.12  raeburn   600:             if (($env{'request.course.id'}) && (!$suppext)) {
                    601:                 $requrl=~/\.(\w+)$/;
                    602:                 if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    603:                     ($requrl=~/^\/adm\/.*\/(aboutme|smppg|bulletinboard)(\?|$ )/x) ||
                    604:                     ($requrl=~/^\/adm\/wrapper\//) ||
                    605:                     ($requrl=~m|^/adm/coursedocs/showdoc/|) ||
                    606:                     ($requrl=~m|\.problem/smpedit$|) ||
                    607:                     ($requrl=~/^\/public\/.*\/syllabus$/) ||
                    608:                     ($requrl=~/^\/adm\/(viewclasslist|navmaps)$/) ||
                    609:                     ($requrl=~/^\/adm\/.*\/aboutme\/portfolio(\?|$)/)) {
                    610:                     $check_symb = 1;
1.159.2.11  raeburn   611:                 }
1.159.2.12  raeburn   612:             }
                    613:             if ($check_symb) {
1.159.2.11  raeburn   614:                 if ($env{'form.symb'}) {
                    615:                     $poss_symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.159.2.12  raeburn   616:                 } elsif (($env{'request.course.id'}) && ($r->args ne '')) {
                    617:                     my $query = $r->args;
                    618:                     foreach my $pair (split(/&/,$query)) {
                    619:                         my ($name, $value) = split(/=/,$pair);
1.159.2.13  raeburn   620:                         $name = &unescape($name);
                    621:                         $value =~ tr/+/ /;
                    622:                         $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.159.2.12  raeburn   623:                         if ($name eq 'symb') {
                    624:                             $poss_symb = &Apache::lonnet::symbclean($value);
                    625:                             last;
                    626:                         }
                    627:                     }
1.159.2.11  raeburn   628:                 }
                    629:                 if ($poss_symb) {
                    630:                     my ($possmap,$resid,$url)=&Apache::lonnet::decode_symb($poss_symb);
                    631:                     $url = &Apache::lonnet::clutter($url);
                    632:                     unless (($url eq $requrl) && (&Apache::lonnet::is_on_map($possmap))) {
                    633:                         undef($poss_symb);
                    634:                     }
                    635:                     if ($poss_symb) {
                    636:                         if ((!$env{'request.role.adv'}) && ($env{'acc.randomout'}) &&
                    637:                             ($env{'acc.randomout'}=~/\&\Q$poss_symb\E\&/)) {
                    638:                             undef($poss_symb);
                    639:                         }
                    640:                     }
                    641:                 }
                    642:                 if ($poss_symb) {
                    643:                     $access=&Apache::lonnet::allowed('bre',$requrl,$poss_symb);
                    644:                 } else {
                    645:                     $access=&Apache::lonnet::allowed('bre',$requrl,'','','','',1);
                    646:                 }
                    647:             } else {
                    648:                 $access=&Apache::lonnet::allowed('bre',$requrl);
                    649:             }
1.159     raeburn   650:             if ($handle eq '') {
                    651:                 unless ($access eq 'F') {
                    652:                     if ($requrl =~ m{^/res/$match_domain/$match_username/}) {
                    653:                         $r->log_reason("Cookie not valid", $r->filename);
                    654:                     }
                    655:                 }
                    656:             }
1.92      albertel  657: 	    if ($access eq '1') {
                    658: 		$env{'user.error.msg'}="$requrl:bre:0:0:Choose Course";
                    659: 		return HTTP_NOT_ACCEPTABLE; 
                    660: 	    }
                    661: 	    if ($access eq 'A') {
                    662: 		&Apache::restrictedaccess::setup_handler($r);
                    663: 		return OK;
                    664: 	    }
1.103     raeburn   665:             if ($access eq 'B') {
1.159.2.11  raeburn   666:                 if ($poss_symb) {
                    667:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    668:                         $requrl = $1;
                    669:                     }
                    670:                     if (&Apache::lonnet::symbverify($poss_symb,$requrl)) {
                    671:                         $env{'request.symb'} = $poss_symb;
                    672:                     }
                    673:                 }
1.103     raeburn   674:                 &Apache::blockedaccess::setup_handler($r);
                    675:                 return OK;
                    676:             }
1.92      albertel  677: 	    if (($access ne '2') && ($access ne 'F')) {
1.130     raeburn   678:                 if ($requrl =~ m{^/res/}) {
                    679:                     $access = &Apache::lonnet::allowed('bro',$requrl);
                    680:                     if ($access ne 'F') {
1.132     raeburn   681:                         if ($requrl eq '/res/lib/templates/simpleproblem.problem/smpedit') {
                    682:                             $access = &Apache::lonnet::allowed('bre','/res/lib/templates/simpleproblem.problem');
                    683:                             if ($access ne 'F') {
                    684:                                 $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    685:                                 return HTTP_NOT_ACCEPTABLE;
                    686:                             }
                    687:                         } else {
                    688:                             $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    689:                             return HTTP_NOT_ACCEPTABLE;
                    690:                         }
1.130     raeburn   691:                     }
1.159.2.3  raeburn   692:                 } elsif (($handle =~ /^publicuser_\d+$/) && (&Apache::lonnet::is_portfolio_url($requrl))) {
                    693:                     my $clientip = $r->get_remote_host();
                    694:                     if (&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip) ne 'F') {
                    695:                         $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    696:                         return HTTP_NOT_ACCEPTABLE;
                    697:                     }
1.130     raeburn   698:                 } else {
                    699: 		    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    700: 		    return HTTP_NOT_ACCEPTABLE;
                    701:                 }
1.37      albertel  702: 	    }
1.92      albertel  703: 	}
                    704: 	if ($requrl =~ m|^/prtspool/|) {
                    705: 	    my $start='/prtspool/'.$env{'user.name'}.'_'.
                    706: 		$env{'user.domain'};
                    707: 	    if ($requrl !~ /^\Q$start\E/) {
                    708: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    709: 		return HTTP_NOT_ACCEPTABLE;
1.67      albertel  710: 	    }
1.92      albertel  711: 	}
1.109     banghart  712: 	if ($requrl =~ m|^/zipspool/|) {
1.110     banghart  713: 	    my $start='/zipspool/zipout/'.$env{'user.name'}.":".
1.109     banghart  714: 		$env{'user.domain'};
                    715: 	    if ($requrl !~ /^\Q$start\E/) {
                    716: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    717: 		return HTTP_NOT_ACCEPTABLE;
                    718: 	    }
                    719: 	}
1.92      albertel  720: 	if ($env{'user.name'} eq 'public' && 
                    721: 	    $env{'user.domain'} eq 'public' &&
                    722: 	    $requrl !~ m{^/+(res|public|uploaded)/} &&
                    723: 	    $requrl !~ m{^/adm/[^/]+/[^/]+/aboutme/portfolio$ }x &&
1.159.2.12  raeburn   724:             $requrl !~ m{^/adm/blockingstatus/.*$} &&
1.92      albertel  725: 	    $requrl !~ m{^/+adm/(help|logout|restrictedaccess|randomlabel\.png)}) {
                    726: 	    $env{'request.querystring'}=$r->args;
                    727: 	    $env{'request.firsturl'}=$requrl;
                    728: 	    return FORBIDDEN;
                    729: 	}
1.23      www       730: # ------------------------------------------------------------- This is allowed
1.92      albertel  731: 	if ($env{'request.course.id'}) {
1.24      www       732: 	    &Apache::lonnet::countacc($requrl);
1.125     raeburn   733:             my $query=$r->args;
1.159.2.12  raeburn   734:             if ($check_symb) {
1.23      www       735: # ------------------------------------- This is serious stuff, get symb and log
1.92      albertel  736: 		my $symb;
                    737: 		if ($query) {
1.141     raeburn   738: 		    &Apache::loncommon::get_unprocessed_cgi($query,['symb','folderpath']);
1.92      albertel  739: 		}
                    740: 		if ($env{'form.symb'}) {
1.64      albertel  741: 		    $symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.159.2.9  raeburn   742:                     if ($requrl eq '/adm/navmaps') {
                    743:                         my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
                    744:                         &Apache::lonnet::symblist($map,$murl => [$murl,$mid]);
                    745:                     } elsif ($requrl =~ m|^/adm/wrapper/|
1.72      albertel  746: 			|| $requrl =~ m|^/adm/coursedocs/showdoc/|) {
1.92      albertel  747: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.9  raeburn   748:                         if ($map =~ /\.page$/) {
                    749:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    750:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    751:                         }
1.92      albertel  752: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
1.63      albertel  753: 						  'last_known' =>[$murl,$mid]);
1.92      albertel  754: 		    } elsif ((&Apache::lonnet::symbverify($symb,$requrl)) ||
1.53      albertel  755: 			     (($requrl=~m|(.*)/smpedit$|) &&
1.134     raeburn   756: 			      &Apache::lonnet::symbverify($symb,$1)) ||
                    757:                              (($requrl=~m|(.*/aboutme)/portfolio$|) &&
                    758:                               &Apache::lonnet::symbverify($symb,$1))) {
1.92      albertel  759: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.9  raeburn   760:                         if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    761:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    762:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    763:                         }
1.92      albertel  764: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
                    765: 						  'last_known' =>[$murl,$mid]);
1.31      www       766: 		    } else {
                    767: 			$r->log_reason('Invalid symb for '.$requrl.': '.
1.92      albertel  768: 				       $symb);
                    769: 			$env{'user.error.msg'}=
                    770: 			    "$requrl:bre:1:1:Invalid Access";
                    771: 			return HTTP_NOT_ACCEPTABLE; 
                    772: 		    }
                    773: 		} else {
1.134     raeburn   774:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    775:                         $requrl = $1;
                    776:                     }
1.159.2.12  raeburn   777: 		    $symb=&Apache::lonnet::symbread($requrl);
                    778:                     if (&Apache::lonnet::is_on_map($requrl) && $symb) {
                    779:                         my ($encstate,$invalidsymb);
                    780:                         unless (&Apache::lonnet::symbverify($symb,$requrl,\$encstate)) {
                    781:                             $invalidsymb = 1;
                    782:                             #
1.159.2.14! raeburn   783:                             # If $env{'request.enc'} inconsistent with encryption expected for $symb
        !           784:                             # retrieved by lonnet::symbread(), call again to check for an instance of
        !           785:                             # $requrl in the course for which expected encryption matches request.enc.
        !           786:                             # If symb for different instance passes lonnet::symbverify(), use that as
        !           787:                             # the symb for $requrl and call &Apache::lonnet::allowed() for that symb.
        !           788:                             # Report invalid symb if there is no other symb. Redirect to /adm/ambiguous
        !           789:                             # if multiple possible symbs consistent with request.enc available for $requrl.
1.159.2.12  raeburn   790:                             #
1.159.2.14! raeburn   791:                             if (($env{'request.enc'} && !$encstate) || (!$env{'request.enc'} && $encstate)) {
1.159.2.12  raeburn   792:                                 my %possibles;
                    793:                                 my $nocache = 1;
1.159.2.14! raeburn   794:                                 my $oldsymb = $symb;
1.159.2.12  raeburn   795:                                 $symb = &Apache::lonnet::symbread($requrl,'','','',\%possibles,$nocache);
1.159.2.14! raeburn   796:                                 if (($symb) && ($symb ne $oldsymb)) {
1.159.2.12  raeburn   797:                                     if (&Apache::lonnet::symbverify($symb,$requrl)) {
1.159.2.14! raeburn   798:                                         my $access=&Apache::lonnet::allowed('bre',$requrl,$symb);
        !           799:                                         if ($access eq 'B') {
        !           800:                                             $env{'request.symb'} = $symb;
        !           801:                                             &Apache::blockedaccess::setup_handler($r);
        !           802:                                             return OK;
        !           803:                                         } elsif (($access eq '2') || ($access eq 'F')) {
        !           804:                                             $invalidsymb = '';
        !           805:                                         }
1.159.2.11  raeburn   806:                                     }
1.159.2.12  raeburn   807:                                 } elsif (keys(%possibles) > 1) {
                    808:                                     $r->internal_redirect('/adm/ambiguous');
                    809:                                     return OK;
1.159.2.11  raeburn   810:                                 }
1.159.2.12  raeburn   811:                             }
                    812:                             if ($invalidsymb) {
                    813:                                 $r->log_reason('Invalid symb for '.$requrl.': '.$symb);
                    814:                                 $env{'user.error.msg'}=
                    815:                                     "$requrl:bre:1:1:Invalid Access";
                    816:                                 return HTTP_NOT_ACCEPTABLE;
1.159.2.11  raeburn   817:                             }
                    818:                         }
1.159.2.12  raeburn   819:                     }
                    820: 		    if ($symb) {
                    821: 			my ($map,$mid,$murl)=
                    822: 			    &Apache::lonnet::decode_symb($symb);
                    823:                         if ($requrl eq '/adm/navmaps') {
                    824:                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid]);
                    825:                         } else {
                    826:                             if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    827:                                 my $mapsymb = &Apache::lonnet::symbread($map);
                    828:                                 ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
1.159.2.9  raeburn   829:                             }
1.159.2.12  raeburn   830:                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid],
                    831:                                                       'last_known' =>[$murl,$mid]);
                    832:                         }
1.61      albertel  833: 		    }
1.92      albertel  834: 		}
                    835: 		$env{'request.symb'}=$symb;
1.159.2.11  raeburn   836:                 if (($env{'request.symbread.cached.'}) && ($env{'request.symbread.cached.'} ne $symb)) {
                    837:                     $env{'request.symbread.cached.'} = $symb;
                    838:                 }
1.92      albertel  839: 		&Apache::lonnet::courseacclog($symb);
                    840: 	    } else {
1.23      www       841: # ------------------------------------------------------- This is other content
1.92      albertel  842: 		&Apache::lonnet::courseacclog($requrl);    
                    843: 	    }
1.140     raeburn   844:             if ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/(docs|supplemental)/.+\.html?$}) {
1.125     raeburn   845:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    846:                     if ($query) {
                    847:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit']);
                    848:                         if ($env{'form.forceedit'}) {
                    849:                             $env{'request.state'} = 'edit';
                    850:                         }
                    851:                     }
                    852:                 }
1.144     raeburn   853:             } elsif ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/portfolio/syllabus/.+\.html?$}) {
                    854:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    855:                     if ($query) {
                    856:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit','editmode']);
                    857:                         if (($env{'form.forceedit'}) || ($env{'form.editmode'})) {
                    858:                             $env{'request.state'} = 'edit';
                    859:                         }
                    860:                     }
                    861:                 }
1.125     raeburn   862:             }
1.88      albertel  863: 	}
1.92      albertel  864: 	return OK;
1.137     raeburn   865:     } else {
                    866:         my $defdom=$r->dir_config('lonDefDomain');
                    867:         ($is_balancer,$otherserver) =
                    868:             &Apache::lonnet::check_loadbalancing(undef,$defdom);
                    869:         if ($is_balancer) {
                    870:             $r->set_handlers('PerlResponseHandler'=>
                    871:                              [\&Apache::switchserver::handler]);
                    872:             if ($otherserver ne '') {
                    873:                 $env{'form.otherserver'} = $otherserver;
                    874:             }
                    875:         }
1.92      albertel  876:     }
1.21      www       877: # -------------------------------------------- See if this is a public resource
1.68      albertel  878:     if ($requrl=~m|^/+adm/+help/+|) {
1.89      albertel  879:  	return OK;
1.68      albertel  880:     }
1.90      albertel  881: # ------------------------------------ See if this is a viewable portfolio file
1.89      albertel  882:     if (&Apache::lonnet::is_portfolio_url($requrl)) {
1.159.2.3  raeburn   883:         my $clientip = $r->get_remote_host();
                    884: 	my $access=&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip);
1.90      albertel  885: 	if ($access eq 'A') {
                    886: 	    &Apache::restrictedaccess::setup_handler($r);
                    887: 	    return OK;
                    888: 	}
                    889: 	if (($access ne '2') && ($access ne 'F')) {
                    890: 	    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    891: 	    return HTTP_NOT_ACCEPTABLE;
                    892: 	}
1.79      raeburn   893:     }
1.87      albertel  894: 
1.34      www       895: # -------------------------------------------------------------- Not authorized
                    896:     $requrl=~/\.(\w+)$/;
1.62      albertel  897: #    if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    898: #        ($requrl=~/^\/adm\/(roles|logout|email|menu|remote)/) ||
                    899: #        ($requrl=~m|^/prtspool/|)) {
1.34      www       900: # -------------------------- Store where they wanted to go and get login screen
1.64      albertel  901: 	$env{'request.querystring'}=$r->args;
                    902: 	$env{'request.firsturl'}=$requrl;
1.34      www       903:        return FORBIDDEN;
1.62      albertel  904: #   } else {
1.34      www       905: # --------------------------------------------------------------------- Goodbye
1.62      albertel  906: #       return HTTP_BAD_REQUEST;
                    907: #   }
1.1       albertel  908: }
                    909: 
                    910: 1;
                    911: __END__
1.120     jms       912: 
1.121     jms       913: =pod
1.120     jms       914: 
1.121     jms       915: =back
1.120     jms       916: 
1.121     jms       917: =cut
1.120     jms       918: 

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