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

1.1       albertel    1: # The LearningOnline Network
                      2: # Cookie Based Access Handler
1.22      www         3: #
1.159.2.16! raeburn     4: # $Id: lonacc.pm,v 1.159.2.15 2020/10/23 21:33:46 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.159.2.15  raeburn   566:         unless (($checkexempt) || (($requrl eq '/adm/switchserver') && (!$r->is_initial_req()))) {
1.138     raeburn   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) {
1.159.2.15  raeburn   571:                 # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    572:                 my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    573:                 if (($found_server) && ($balancer_cookie =~ /^\Q$env{'user.domain'}\E_\Q$env{'user.name'}\E_/)) {
                    574:                     $otherserver = $found_server;
                    575:                 }
                    576:                 unless ($requrl eq '/adm/switchserver') {
                    577:                     $r->set_handlers('PerlResponseHandler'=>
                    578:                                      [\&Apache::switchserver::handler]);
1.159.2.8  raeburn   579:                 }
                    580:                 if ($otherserver ne '') {
                    581:                     $env{'form.otherserver'} = $otherserver;
                    582:                 }
1.159.2.15  raeburn   583:                 unless (($env{'form.origurl'}) || ($r->uri eq '/adm/roles') ||
                    584:                         ($r->uri eq '/adm/switchserver') || ($r->uri eq '/adm/sso')) {
                    585:                     $env{'form.origurl'} = $r->uri;
                    586:                 }
1.152     raeburn   587:             }
1.137     raeburn   588:         }
                    589: 
1.6       www       590: # ---------------------------------------------------------------- Check access
1.92      albertel  591: 	my $now = time;
1.159.2.16! raeburn   592:         my ($check_symb,$check_access);
1.159.2.10  raeburn   593: 	if ($requrl !~ m{^/(?:adm|public|(?:prt|zip)spool)/}
1.95      albertel  594: 	    || $requrl =~ /^\/adm\/.*\/(smppg|bulletinboard)(\?|$ )/x) {
1.159.2.16! raeburn   595:             $check_access = 1;
        !           596:         }
        !           597:         if (($env{'request.course.id'}) && (!$suppext)) {
        !           598:             $requrl=~/\.(\w+)$/;
        !           599:             if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
        !           600:                 ($requrl=~/^\/adm\/.*\/(aboutme|smppg|bulletinboard)(\?|$ )/x) ||
        !           601:                 ($requrl=~/^\/adm\/wrapper\//) ||
        !           602:                 ($requrl=~m|^/adm/coursedocs/showdoc/|) ||
        !           603:                 ($requrl=~m|\.problem/smpedit$|) ||
        !           604:                 ($requrl=~/^\/public\/.*\/syllabus$/) ||
        !           605:                 ($requrl=~/^\/adm\/(viewclasslist|navmaps)$/) ||
        !           606:                 ($requrl=~/^\/adm\/.*\/aboutme\/portfolio(\?|$)/)) {
        !           607:                 $check_symb = 1;
1.159.2.12  raeburn   608:             }
1.159.2.16! raeburn   609:         }
        !           610:         if ($check_access) {
        !           611:             my ($access,$poss_symb);
1.159.2.12  raeburn   612:             if ($check_symb) {
1.159.2.11  raeburn   613:                 if ($env{'form.symb'}) {
                    614:                     $poss_symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.159.2.12  raeburn   615:                 } elsif (($env{'request.course.id'}) && ($r->args ne '')) {
                    616:                     my $query = $r->args;
                    617:                     foreach my $pair (split(/&/,$query)) {
                    618:                         my ($name, $value) = split(/=/,$pair);
1.159.2.13  raeburn   619:                         $name = &unescape($name);
                    620:                         $value =~ tr/+/ /;
                    621:                         $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.159.2.12  raeburn   622:                         if ($name eq 'symb') {
                    623:                             $poss_symb = &Apache::lonnet::symbclean($value);
                    624:                             last;
                    625:                         }
                    626:                     }
1.159.2.11  raeburn   627:                 }
                    628:                 if ($poss_symb) {
                    629:                     my ($possmap,$resid,$url)=&Apache::lonnet::decode_symb($poss_symb);
                    630:                     $url = &Apache::lonnet::clutter($url);
                    631:                     unless (($url eq $requrl) && (&Apache::lonnet::is_on_map($possmap))) {
                    632:                         undef($poss_symb);
                    633:                     }
                    634:                     if ($poss_symb) {
                    635:                         if ((!$env{'request.role.adv'}) && ($env{'acc.randomout'}) &&
                    636:                             ($env{'acc.randomout'}=~/\&\Q$poss_symb\E\&/)) {
                    637:                             undef($poss_symb);
                    638:                         }
                    639:                     }
                    640:                 }
                    641:                 if ($poss_symb) {
                    642:                     $access=&Apache::lonnet::allowed('bre',$requrl,$poss_symb);
                    643:                 } else {
                    644:                     $access=&Apache::lonnet::allowed('bre',$requrl,'','','','',1);
                    645:                 }
                    646:             } else {
                    647:                 $access=&Apache::lonnet::allowed('bre',$requrl);
                    648:             }
1.159     raeburn   649:             if ($handle eq '') {
                    650:                 unless ($access eq 'F') {
                    651:                     if ($requrl =~ m{^/res/$match_domain/$match_username/}) {
                    652:                         $r->log_reason("Cookie not valid", $r->filename);
                    653:                     }
                    654:                 }
                    655:             }
1.92      albertel  656: 	    if ($access eq '1') {
                    657: 		$env{'user.error.msg'}="$requrl:bre:0:0:Choose Course";
                    658: 		return HTTP_NOT_ACCEPTABLE; 
                    659: 	    }
                    660: 	    if ($access eq 'A') {
                    661: 		&Apache::restrictedaccess::setup_handler($r);
                    662: 		return OK;
                    663: 	    }
1.103     raeburn   664:             if ($access eq 'B') {
1.159.2.11  raeburn   665:                 if ($poss_symb) {
                    666:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    667:                         $requrl = $1;
                    668:                     }
                    669:                     if (&Apache::lonnet::symbverify($poss_symb,$requrl)) {
                    670:                         $env{'request.symb'} = $poss_symb;
                    671:                     }
                    672:                 }
1.103     raeburn   673:                 &Apache::blockedaccess::setup_handler($r);
                    674:                 return OK;
                    675:             }
1.92      albertel  676: 	    if (($access ne '2') && ($access ne 'F')) {
1.130     raeburn   677:                 if ($requrl =~ m{^/res/}) {
                    678:                     $access = &Apache::lonnet::allowed('bro',$requrl);
                    679:                     if ($access ne 'F') {
1.132     raeburn   680:                         if ($requrl eq '/res/lib/templates/simpleproblem.problem/smpedit') {
                    681:                             $access = &Apache::lonnet::allowed('bre','/res/lib/templates/simpleproblem.problem');
                    682:                             if ($access ne 'F') {
                    683:                                 $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    684:                                 return HTTP_NOT_ACCEPTABLE;
                    685:                             }
                    686:                         } else {
                    687:                             $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    688:                             return HTTP_NOT_ACCEPTABLE;
                    689:                         }
1.130     raeburn   690:                     }
1.159.2.3  raeburn   691:                 } elsif (($handle =~ /^publicuser_\d+$/) && (&Apache::lonnet::is_portfolio_url($requrl))) {
                    692:                     my $clientip = $r->get_remote_host();
                    693:                     if (&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip) ne 'F') {
                    694:                         $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    695:                         return HTTP_NOT_ACCEPTABLE;
                    696:                     }
1.130     raeburn   697:                 } else {
                    698: 		    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    699: 		    return HTTP_NOT_ACCEPTABLE;
                    700:                 }
1.37      albertel  701: 	    }
1.92      albertel  702: 	}
                    703: 	if ($requrl =~ m|^/prtspool/|) {
                    704: 	    my $start='/prtspool/'.$env{'user.name'}.'_'.
                    705: 		$env{'user.domain'};
                    706: 	    if ($requrl !~ /^\Q$start\E/) {
                    707: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    708: 		return HTTP_NOT_ACCEPTABLE;
1.67      albertel  709: 	    }
1.92      albertel  710: 	}
1.109     banghart  711: 	if ($requrl =~ m|^/zipspool/|) {
1.110     banghart  712: 	    my $start='/zipspool/zipout/'.$env{'user.name'}.":".
1.109     banghart  713: 		$env{'user.domain'};
                    714: 	    if ($requrl !~ /^\Q$start\E/) {
                    715: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    716: 		return HTTP_NOT_ACCEPTABLE;
                    717: 	    }
                    718: 	}
1.92      albertel  719: 	if ($env{'user.name'} eq 'public' && 
                    720: 	    $env{'user.domain'} eq 'public' &&
                    721: 	    $requrl !~ m{^/+(res|public|uploaded)/} &&
                    722: 	    $requrl !~ m{^/adm/[^/]+/[^/]+/aboutme/portfolio$ }x &&
1.159.2.12  raeburn   723:             $requrl !~ m{^/adm/blockingstatus/.*$} &&
1.92      albertel  724: 	    $requrl !~ m{^/+adm/(help|logout|restrictedaccess|randomlabel\.png)}) {
                    725: 	    $env{'request.querystring'}=$r->args;
                    726: 	    $env{'request.firsturl'}=$requrl;
                    727: 	    return FORBIDDEN;
                    728: 	}
1.23      www       729: # ------------------------------------------------------------- This is allowed
1.92      albertel  730: 	if ($env{'request.course.id'}) {
1.24      www       731: 	    &Apache::lonnet::countacc($requrl);
1.125     raeburn   732:             my $query=$r->args;
1.159.2.12  raeburn   733:             if ($check_symb) {
1.23      www       734: # ------------------------------------- This is serious stuff, get symb and log
1.92      albertel  735: 		my $symb;
                    736: 		if ($query) {
1.141     raeburn   737: 		    &Apache::loncommon::get_unprocessed_cgi($query,['symb','folderpath']);
1.92      albertel  738: 		}
                    739: 		if ($env{'form.symb'}) {
1.64      albertel  740: 		    $symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.159.2.9  raeburn   741:                     if ($requrl eq '/adm/navmaps') {
                    742:                         my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
                    743:                         &Apache::lonnet::symblist($map,$murl => [$murl,$mid]);
                    744:                     } elsif ($requrl =~ m|^/adm/wrapper/|
1.72      albertel  745: 			|| $requrl =~ m|^/adm/coursedocs/showdoc/|) {
1.92      albertel  746: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.9  raeburn   747:                         if ($map =~ /\.page$/) {
                    748:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    749:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    750:                         }
1.92      albertel  751: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
1.63      albertel  752: 						  'last_known' =>[$murl,$mid]);
1.92      albertel  753: 		    } elsif ((&Apache::lonnet::symbverify($symb,$requrl)) ||
1.53      albertel  754: 			     (($requrl=~m|(.*)/smpedit$|) &&
1.134     raeburn   755: 			      &Apache::lonnet::symbverify($symb,$1)) ||
                    756:                              (($requrl=~m|(.*/aboutme)/portfolio$|) &&
                    757:                               &Apache::lonnet::symbverify($symb,$1))) {
1.92      albertel  758: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.9  raeburn   759:                         if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    760:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    761:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    762:                         }
1.92      albertel  763: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
                    764: 						  'last_known' =>[$murl,$mid]);
1.31      www       765: 		    } else {
                    766: 			$r->log_reason('Invalid symb for '.$requrl.': '.
1.92      albertel  767: 				       $symb);
                    768: 			$env{'user.error.msg'}=
                    769: 			    "$requrl:bre:1:1:Invalid Access";
                    770: 			return HTTP_NOT_ACCEPTABLE; 
                    771: 		    }
                    772: 		} else {
1.134     raeburn   773:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    774:                         $requrl = $1;
                    775:                     }
1.159.2.12  raeburn   776: 		    $symb=&Apache::lonnet::symbread($requrl);
                    777:                     if (&Apache::lonnet::is_on_map($requrl) && $symb) {
                    778:                         my ($encstate,$invalidsymb);
                    779:                         unless (&Apache::lonnet::symbverify($symb,$requrl,\$encstate)) {
                    780:                             $invalidsymb = 1;
                    781:                             #
1.159.2.14  raeburn   782:                             # If $env{'request.enc'} inconsistent with encryption expected for $symb
                    783:                             # retrieved by lonnet::symbread(), call again to check for an instance of
                    784:                             # $requrl in the course for which expected encryption matches request.enc.
                    785:                             # If symb for different instance passes lonnet::symbverify(), use that as
                    786:                             # the symb for $requrl and call &Apache::lonnet::allowed() for that symb.
                    787:                             # Report invalid symb if there is no other symb. Redirect to /adm/ambiguous
                    788:                             # if multiple possible symbs consistent with request.enc available for $requrl.
1.159.2.12  raeburn   789:                             #
1.159.2.14  raeburn   790:                             if (($env{'request.enc'} && !$encstate) || (!$env{'request.enc'} && $encstate)) {
1.159.2.12  raeburn   791:                                 my %possibles;
                    792:                                 my $nocache = 1;
1.159.2.14  raeburn   793:                                 my $oldsymb = $symb;
1.159.2.12  raeburn   794:                                 $symb = &Apache::lonnet::symbread($requrl,'','','',\%possibles,$nocache);
1.159.2.14  raeburn   795:                                 if (($symb) && ($symb ne $oldsymb)) {
1.159.2.12  raeburn   796:                                     if (&Apache::lonnet::symbverify($symb,$requrl)) {
1.159.2.14  raeburn   797:                                         my $access=&Apache::lonnet::allowed('bre',$requrl,$symb);
                    798:                                         if ($access eq 'B') {
                    799:                                             $env{'request.symb'} = $symb;
                    800:                                             &Apache::blockedaccess::setup_handler($r);
                    801:                                             return OK;
                    802:                                         } elsif (($access eq '2') || ($access eq 'F')) {
                    803:                                             $invalidsymb = '';
                    804:                                         }
1.159.2.11  raeburn   805:                                     }
1.159.2.12  raeburn   806:                                 } elsif (keys(%possibles) > 1) {
                    807:                                     $r->internal_redirect('/adm/ambiguous');
                    808:                                     return OK;
1.159.2.11  raeburn   809:                                 }
1.159.2.12  raeburn   810:                             }
                    811:                             if ($invalidsymb) {
                    812:                                 $r->log_reason('Invalid symb for '.$requrl.': '.$symb);
                    813:                                 $env{'user.error.msg'}=
                    814:                                     "$requrl:bre:1:1:Invalid Access";
                    815:                                 return HTTP_NOT_ACCEPTABLE;
1.159.2.11  raeburn   816:                             }
                    817:                         }
1.159.2.12  raeburn   818:                     }
                    819: 		    if ($symb) {
                    820: 			my ($map,$mid,$murl)=
                    821: 			    &Apache::lonnet::decode_symb($symb);
                    822:                         if ($requrl eq '/adm/navmaps') {
                    823:                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid]);
                    824:                         } else {
                    825:                             if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    826:                                 my $mapsymb = &Apache::lonnet::symbread($map);
                    827:                                 ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
1.159.2.9  raeburn   828:                             }
1.159.2.12  raeburn   829:                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid],
                    830:                                                       'last_known' =>[$murl,$mid]);
                    831:                         }
1.61      albertel  832: 		    }
1.92      albertel  833: 		}
                    834: 		$env{'request.symb'}=$symb;
1.159.2.11  raeburn   835:                 if (($env{'request.symbread.cached.'}) && ($env{'request.symbread.cached.'} ne $symb)) {
                    836:                     $env{'request.symbread.cached.'} = $symb;
                    837:                 }
1.92      albertel  838: 		&Apache::lonnet::courseacclog($symb);
                    839: 	    } else {
1.23      www       840: # ------------------------------------------------------- This is other content
1.92      albertel  841: 		&Apache::lonnet::courseacclog($requrl);    
                    842: 	    }
1.140     raeburn   843:             if ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/(docs|supplemental)/.+\.html?$}) {
1.125     raeburn   844:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    845:                     if ($query) {
                    846:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit']);
                    847:                         if ($env{'form.forceedit'}) {
                    848:                             $env{'request.state'} = 'edit';
                    849:                         }
                    850:                     }
                    851:                 }
1.144     raeburn   852:             } elsif ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/portfolio/syllabus/.+\.html?$}) {
                    853:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    854:                     if ($query) {
                    855:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit','editmode']);
                    856:                         if (($env{'form.forceedit'}) || ($env{'form.editmode'})) {
                    857:                             $env{'request.state'} = 'edit';
                    858:                         }
                    859:                     }
                    860:                 }
1.125     raeburn   861:             }
1.88      albertel  862: 	}
1.92      albertel  863: 	return OK;
1.137     raeburn   864:     } else {
                    865:         my $defdom=$r->dir_config('lonDefDomain');
                    866:         ($is_balancer,$otherserver) =
                    867:             &Apache::lonnet::check_loadbalancing(undef,$defdom);
                    868:         if ($is_balancer) {
                    869:             $r->set_handlers('PerlResponseHandler'=>
                    870:                              [\&Apache::switchserver::handler]);
                    871:             if ($otherserver ne '') {
                    872:                 $env{'form.otherserver'} = $otherserver;
                    873:             }
                    874:         }
1.92      albertel  875:     }
1.21      www       876: # -------------------------------------------- See if this is a public resource
1.68      albertel  877:     if ($requrl=~m|^/+adm/+help/+|) {
1.89      albertel  878:  	return OK;
1.68      albertel  879:     }
1.90      albertel  880: # ------------------------------------ See if this is a viewable portfolio file
1.89      albertel  881:     if (&Apache::lonnet::is_portfolio_url($requrl)) {
1.159.2.3  raeburn   882:         my $clientip = $r->get_remote_host();
                    883: 	my $access=&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip);
1.90      albertel  884: 	if ($access eq 'A') {
                    885: 	    &Apache::restrictedaccess::setup_handler($r);
                    886: 	    return OK;
                    887: 	}
                    888: 	if (($access ne '2') && ($access ne 'F')) {
                    889: 	    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    890: 	    return HTTP_NOT_ACCEPTABLE;
                    891: 	}
1.79      raeburn   892:     }
1.87      albertel  893: 
1.34      www       894: # -------------------------------------------------------------- Not authorized
                    895:     $requrl=~/\.(\w+)$/;
1.62      albertel  896: #    if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    897: #        ($requrl=~/^\/adm\/(roles|logout|email|menu|remote)/) ||
                    898: #        ($requrl=~m|^/prtspool/|)) {
1.34      www       899: # -------------------------- Store where they wanted to go and get login screen
1.64      albertel  900: 	$env{'request.querystring'}=$r->args;
                    901: 	$env{'request.firsturl'}=$requrl;
1.34      www       902:        return FORBIDDEN;
1.62      albertel  903: #   } else {
1.34      www       904: # --------------------------------------------------------------------- Goodbye
1.62      albertel  905: #       return HTTP_BAD_REQUEST;
                    906: #   }
1.1       albertel  907: }
                    908: 
                    909: 1;
                    910: __END__
1.120     jms       911: 
1.121     jms       912: =pod
1.120     jms       913: 
1.121     jms       914: =back
1.120     jms       915: 
1.121     jms       916: =cut
1.120     jms       917: 

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