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

1.1       albertel    1: # The LearningOnline Network
                      2: # Cookie Based Access Handler
1.22      www         3: #
1.159.2.8.2.5! (raeburn    4:: # $Id: lonacc.pm,v 1.159.2.8.2.4 2020/09/30 20:03:12 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.159.2.8.2.1  (raeburn  358::             foreach my $item (keys(%form)) {
                    359::                 $env{'form.'.$item} = $form{$item};
                    360::             }
                    361::             unless ($form{'symb'}) {
                    362::                 unless (($r->uri eq '/adm/roles') || ($r->uri eq '/adm/sso')) {
                    363::                     $env{'form.origurl'} = $r->uri;
                    364::                 }
                    365::             }
1.105     raeburn   366:             $env{'request.sso.login'} = 1;
1.106     raeburn   367:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    368:                 $env{'request.sso.reloginserver'} =
                    369:                     $r->dir_config('lonSSOReloginServer');
                    370:             }
1.137     raeburn   371:             my $redirecturl = '/adm/switchserver';
                    372:             if ($otherserver ne '') {
                    373:                 $redirecturl .= '?otherserver='.$otherserver;
                    374:             }
                    375: 	    $r->internal_redirect($redirecturl);
1.101     albertel  376: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  377: 	} else {
                    378: 	    # need to login them in, so generate the need data that
                    379: 	    # migrate expects to do login
1.159.2.4  raeburn   380:             my $ip = $r->get_remote_host();
1.147     raeburn   381: 	    my %info=('ip'        => $ip,
1.94      albertel  382: 		      'domain'    => $domain,
1.97      albertel  383: 		      'username'  => $user,
1.94      albertel  384: 		      'server'    => $r->dir_config('lonHostID'),
                    385: 		      'sso.login' => 1
                    386: 		      );
1.158     raeburn   387:             foreach my $item ('role','symb','iptoken') {
1.126     raeburn   388:                 if (exists($form{$item})) {
                    389:                     $info{$item} = $form{$item};
                    390:                 }
                    391:             }
1.151     raeburn   392:             unless ($info{'symb'}) {
1.152     raeburn   393:                 unless (($r->uri eq '/adm/roles') || ($r->uri eq '/adm/sso')) {
1.151     raeburn   394:                     $info{'origurl'} = $r->uri; 
                    395:                 }
                    396:             }
1.116     raeburn   397:             if ($r->dir_config("ssodirecturl") == 1) {
                    398:                 $info{'origurl'} = $r->uri;
                    399:             }
1.106     raeburn   400:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    401:                 $info{'sso.reloginserver'} = 
                    402:                     $r->dir_config('lonSSOReloginServer'); 
                    403:             }
1.159.2.5  raeburn   404:             if (($is_balancer) && ($hosthere)) {
                    405:                 $info{'noloadbalance'} = $hosthere;
                    406:             }
1.94      albertel  407: 	    my $token = 
                    408: 		&Apache::lonnet::tmpput(\%info,
                    409: 					$r->dir_config('lonHostID'));
                    410: 	    $env{'form.token'} = $token;
                    411: 	    $r->internal_redirect('/adm/migrateuser');
1.101     albertel  412: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  413: 	}
                    414: 	return OK;
1.155     raeburn   415:     } else {
1.107     albertel  416: 	&Apache::lonnet::logthis(" SSO authorized unknown user $user ");
1.115     raeburn   417:         my @cancreate;
                    418:         my %domconfig =
                    419:             &Apache::lonnet::get_dom('configuration',['usercreation'],$domain);
                    420:         if (ref($domconfig{'usercreation'}) eq 'HASH') {
                    421:             if (ref($domconfig{'usercreation'}{'cancreate'}) eq 'HASH') {
                    422:                 if (ref($domconfig{'usercreation'}{'cancreate'}{'selfcreate'}) eq 'ARRAY') {
                    423:                     @cancreate = @{$domconfig{'usercreation'}{'cancreate'}{'selfcreate'}};
                    424:                 } elsif (($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne 'none') && 
                    425:                          ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne '')) {
                    426:                     @cancreate = ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'});
                    427:                 }
                    428:             }
                    429:         }
1.155     raeburn   430:         if ((grep(/^sso$/,@cancreate)) || (defined($r->dir_config('lonSSOUserUnknownRedirect')))) {
                    431:             $r->subprocess_env->set('SSOUserUnknown' => $user);
                    432:             $r->subprocess_env->set('SSOUserDomain' => $domain);
                    433:             if (grep(/^sso$/,@cancreate)) {
                    434:                 $r->set_handlers('PerlHandler'=> [\&Apache::createaccount::handler]);
                    435:                 $r->handler('perl-script');
                    436:             } else {
                    437: 	        $r->internal_redirect($r->dir_config('lonSSOUserUnknownRedirect'));
                    438:                 $r->set_handlers('PerlHandler'=> undef);
                    439:             }
                    440: 	    return OK;
1.115     raeburn   441:         }
1.94      albertel  442:     }
                    443:     return undef;
                    444: }
                    445: 
1.1       albertel  446: sub handler {
                    447:     my $r = shift;
                    448:     my $requrl=$r->uri;
1.149     raeburn   449: 
                    450:     if ($requrl =~ m{^/res/adm/pages/[^/]+\.(gif|png)$}) {
1.108     raeburn   451:         return OK;
                    452:     }
1.70      albertel  453: 
1.149     raeburn   454:     if (&Apache::lonnet::is_domainimage($requrl)) {
1.124     raeburn   455:         return OK;
                    456:     }
                    457: 
1.149     raeburn   458:     my %user;
                    459:     my $handle = &Apache::lonnet::check_for_valid_session($r,undef,\%user);
1.93      albertel  460: 
1.150     raeburn   461:     unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    462:         my $result = &sso_login($r,$handle,$user{'name'});
                    463:         if (defined($result)) {
                    464: 	    return $result;
                    465:         }
1.70      albertel  466:     }
                    467: 
1.137     raeburn   468:     my ($is_balancer,$otherserver);
1.142     raeburn   469: 
1.92      albertel  470:     if ($handle eq '') {
1.159     raeburn   471:         unless ((($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) ||
                    472:                 ($requrl =~ m{^/public/$match_domain/$match_courseid/syllabus}) ||
                    473:                 ($requrl =~ m{^/adm/help/}) ||
                    474:                 ($requrl =~ m{^/res/$match_domain/$match_username/})) {
1.149     raeburn   475: 	    $r->log_reason("Cookie not valid", $r->filename);
1.142     raeburn   476:         }
1.111     albertel  477:     } elsif ($handle ne '') {
1.6       www       478: 
1.46      www       479: # ------------------------------------------------------ Initialize Environment
1.111     albertel  480: 	my $lonidsdir=$r->dir_config('lonIDsDir');
1.92      albertel  481: 	&Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
1.47      www       482: 
                    483: # --------------------------------------------------------- Initialize Language
                    484: 
1.92      albertel  485: 	&Apache::lonlocal::get_language_handle($r);
                    486: 
                    487:     }
1.46      www       488: 
1.92      albertel  489: # -------------------------------------------------- Should be a valid user now
                    490:     if ($env{'user.name'} ne '' && $env{'user.domain'} ne '') {
1.46      www       491: # -------------------------------------------------------------- Resource State
1.6       www       492: 
1.141     raeburn   493:         my ($cdom,$cnum);
                    494:         if ($env{'request.course.id'}) {
                    495:             $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
                    496:             $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
                    497:         }
1.92      albertel  498: 	if ($requrl=~/^\/+(res|uploaded)\//) {
                    499: 	    $env{'request.state'} = "published";
                    500: 	} else {
                    501: 	    $env{'request.state'} = 'unknown';
                    502: 	}
                    503: 	$env{'request.filename'} = $r->filename;
                    504: 	$env{'request.noversionuri'} = &Apache::lonnet::deversion($requrl);
1.157     raeburn   505:         my ($suppext,$checkabsolute);
1.129     raeburn   506:         if ($requrl =~ m{^/adm/wrapper/ext/}) {
                    507:             my $query = $r->args;
                    508:             if ($query) {
                    509:                 my $preserved;
                    510:                 foreach my $pair (split(/&/,$query)) {
                    511:                     my ($name, $value) = split(/=/,$pair);
1.159.2.7  raeburn   512:                     unless (($name eq 'symb') || ($name eq 'usehttp')) {
1.129     raeburn   513:                         $preserved .= $pair.'&';
                    514:                     }
1.141     raeburn   515:                     if (($env{'request.course.id'}) && ($name eq 'folderpath')) {
                    516:                         if ($value =~ /^supplemental/) {
                    517:                             $suppext = 1;
                    518:                         }
                    519:                     }
1.129     raeburn   520:                 }
                    521:                 $preserved =~ s/\&$//;
                    522:                 if ($preserved) {
                    523:                     $env{'request.external.querystring'} = $preserved;
                    524:                 }
                    525:             }
1.157     raeburn   526:             if ($env{'request.course.id'}) {
                    527:                 $checkabsolute = 1;
                    528:             }
1.141     raeburn   529:         } elsif ($env{'request.course.id'} &&
                    530:                  (($requrl =~ m{^/adm/$match_domain/$match_username/aboutme$}) ||
                    531:                   ($requrl =~ m{^/public/$cdom/$cnum/syllabus$}))) {
                    532:             my $query = $r->args;
                    533:             if ($query) {
                    534:                 foreach my $pair (split(/&/,$query)) {
                    535:                     my ($name, $value) = split(/=/,$pair);
                    536:                     if ($name eq 'folderpath') {
                    537:                         if ($value =~ /^supplemental/) {
                    538:                             $suppext = 1;
                    539:                         }
1.159.2.8.2.4  (raeburn  540::                         last;
1.141     raeburn   541:                     }
                    542:                 }
                    543:             }
1.157     raeburn   544:             if ($requrl =~ m{^/public/$cdom/$cnum/syllabus$}) {
                    545:                 $checkabsolute = 1;
                    546:             }
                    547:         }
                    548:         if ($checkabsolute) {
                    549:             my $hostname = $r->hostname();
                    550:             my $lonhost = &Apache::lonnet::host_from_dns($hostname);
                    551:             if ($lonhost) {
                    552:                 my $actual = &Apache::lonnet::absolute_url($hostname);
1.159.2.8.2.1  (raeburn  553::                 my $exphostname = &Apache::lonnet::hostname($lonhost);
1.157     raeburn   554:                 my $expected = $Apache::lonnet::protocol{$lonhost}.'://'.$hostname;
                    555:                 unless ($actual eq $expected) {
                    556:                     $env{'request.use_absolute'} = $expected;
                    557:                 }
                    558:             }
1.129     raeburn   559:         }
1.6       www       560: # -------------------------------------------------------- Load POST parameters
                    561: 
1.92      albertel  562: 	&Apache::lonacc::get_posted_cgi($r);
1.6       www       563: 
1.137     raeburn   564: # ------------------------------------------------------ Check if load balancer 
                    565: 
1.138     raeburn   566:         my $checkexempt;
                    567:         if ($env{'user.loadbalexempt'} eq $r->dir_config('lonHostID')) {
                    568:             if ($env{'user.loadbalcheck.time'} + 600 > time) {
1.159.2.8  raeburn   569:                 $checkexempt = 1;
1.138     raeburn   570:             }
                    571:         }
1.145     raeburn   572:         if ($env{'user.noloadbalance'} eq $r->dir_config('lonHostID')) {
                    573:             $checkexempt = 1;
                    574:         }
1.138     raeburn   575:         unless ($checkexempt) {
                    576:             ($is_balancer,$otherserver) =
                    577:                 &Apache::lonnet::check_loadbalancing($env{'user.name'},
                    578:                                                      $env{'user.domain'});
1.159.2.8  raeburn   579:             if ($is_balancer) {
                    580:                 unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    581:                     # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    582:                     my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    583:                     if (($found_server) && ($balancer_cookie =~ /^\Q$env{'user.domain'}\E_\Q$env{'user.name'}\E_/)) {
                    584:                         $otherserver = $found_server;
                    585:                     }
                    586:                 }
                    587:             }
1.138     raeburn   588:         }
1.137     raeburn   589:         if ($is_balancer) {
1.159.2.8  raeburn   590:             unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    591:                 $r->set_handlers('PerlResponseHandler'=>
                    592:                                  [\&Apache::switchserver::handler]);
                    593:                 if ($otherserver ne '') {
                    594:                     $env{'form.otherserver'} = $otherserver;
                    595:                 }
1.137     raeburn   596:             }
1.152     raeburn   597:             unless (($env{'form.origurl'}) || ($r->uri eq '/adm/roles') ||
                    598:                     ($r->uri eq '/adm/switchserver') || ($r->uri eq '/adm/sso')) {
                    599:                 $env{'form.origurl'} = $r->uri;
                    600:             }
1.137     raeburn   601:         }
1.159.2.8.2.1  (raeburn  602::         if ($requrl=~m{^/+tiny/+$match_domain/+\w+$}) {
1.159.2.8.2.3  (raeburn  603::             if ($env{'user.name'} eq 'public' &&
                    604::                 $env{'user.domain'} eq 'public') {
                    605::                 $env{'request.firsturl'}=$requrl;
                    606::                 return FORBIDDEN;
                    607::             } else {
                    608::                 return OK;
                    609::             }
1.159.2.8.2.1  (raeburn  610::         }
1.137     raeburn   611: 
1.6       www       612: # ---------------------------------------------------------------- Check access
1.92      albertel  613: 	my $now = time;
1.159.2.8.2.4  (raeburn  614::         my $check_symb;
1.159.2.8.2.2  (raeburn  615:: 	if ($requrl !~ m{^/(?:adm|public|(?:prt|zip)spool)/}
1.95      albertel  616: 	    || $requrl =~ /^\/adm\/.*\/(smppg|bulletinboard)(\?|$ )/x) {
1.159.2.8.2.4  (raeburn  617::             my ($access,$poss_symb);
                    618::             if (($env{'request.course.id'}) && (!$suppext)) {
                    619::                 $requrl=~/\.(\w+)$/;
                    620::                 if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    621::                     ($requrl=~/^\/adm\/.*\/(aboutme|smppg|bulletinboard)(\?|$ )/x) ||
                    622::                     ($requrl=~/^\/adm\/wrapper\//) ||
                    623::                     ($requrl=~m|^/adm/coursedocs/showdoc/|) ||
                    624::                     ($requrl=~m|\.problem/smpedit$|) ||
                    625::                     ($requrl=~/^\/public\/.*\/syllabus$/) ||
                    626::                     ($requrl=~/^\/adm\/(viewclasslist|navmaps)$/) ||
                    627::                     ($requrl=~/^\/adm\/.*\/aboutme\/portfolio(\?|$)/)) {
                    628::                     $check_symb = 1;
                    629::                 }
                    630::             }
                    631::             if ($check_symb) {
                    632::                 if ($env{'form.symb'}) {
                    633::                     $poss_symb=&Apache::lonnet::symbclean($env{'form.symb'});
                    634::                 } elsif (($env{'request.course.id'}) && ($r->args ne '')) {
                    635::                     my $query = $r->args;
                    636::                     foreach my $pair (split(/&/,$query)) {
                    637::                         my ($name, $value) = split(/=/,$pair);
1.159.2.8.2.5! (raeburn  638::                         $name = &unescape($name);
        !           639::                         $value =~ tr/+/ /;
        !           640::                         $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.159.2.8.2.4  (raeburn  641::                         if ($name eq 'symb') {
                    642::                             $poss_symb = &Apache::lonnet::symbclean($value);
                    643::                             last;
                    644::                         }
                    645::                     }
                    646::                 }
                    647::                 if ($poss_symb) {
                    648::                     my ($possmap,$resid,$url)=&Apache::lonnet::decode_symb($poss_symb);
                    649::                     $url = &Apache::lonnet::clutter($url);
                    650::                     unless (($url eq $requrl) && (&Apache::lonnet::is_on_map($possmap))) {
                    651::                         undef($poss_symb);
                    652::                     }
                    653::                     if ($poss_symb) {
                    654::                         if ((!$env{'request.role.adv'}) && ($env{'acc.randomout'}) &&
                    655::                             ($env{'acc.randomout'}=~/\&\Q$poss_symb\E\&/)) {
                    656::                             undef($poss_symb);
                    657::                         }
                    658::                     }
                    659::                 }
                    660::                 if ($poss_symb) {
                    661::                     $access=&Apache::lonnet::allowed('bre',$requrl,$poss_symb);
                    662::                 } else {
                    663::                     $access=&Apache::lonnet::allowed('bre',$requrl,'','','','',1);
                    664::                 }
                    665::             } else {
                    666::                 $access=&Apache::lonnet::allowed('bre',$requrl);
                    667::             }
1.159     raeburn   668:             if ($handle eq '') {
                    669:                 unless ($access eq 'F') {
                    670:                     if ($requrl =~ m{^/res/$match_domain/$match_username/}) {
                    671:                         $r->log_reason("Cookie not valid", $r->filename);
                    672:                     }
                    673:                 }
                    674:             }
1.92      albertel  675: 	    if ($access eq '1') {
                    676: 		$env{'user.error.msg'}="$requrl:bre:0:0:Choose Course";
                    677: 		return HTTP_NOT_ACCEPTABLE; 
                    678: 	    }
                    679: 	    if ($access eq 'A') {
                    680: 		&Apache::restrictedaccess::setup_handler($r);
                    681: 		return OK;
                    682: 	    }
1.103     raeburn   683:             if ($access eq 'B') {
1.159.2.8.2.4  (raeburn  684::                 if ($poss_symb) {
                    685::                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    686::                         $requrl = $1;
                    687::                     }
                    688::                     if (&Apache::lonnet::symbverify($poss_symb,$requrl)) {
                    689::                         $env{'request.symb'} = $poss_symb;
                    690::                     }
                    691::                 }
1.103     raeburn   692:                 &Apache::blockedaccess::setup_handler($r);
                    693:                 return OK;
                    694:             }
1.92      albertel  695: 	    if (($access ne '2') && ($access ne 'F')) {
1.130     raeburn   696:                 if ($requrl =~ m{^/res/}) {
                    697:                     $access = &Apache::lonnet::allowed('bro',$requrl);
                    698:                     if ($access ne 'F') {
1.132     raeburn   699:                         if ($requrl eq '/res/lib/templates/simpleproblem.problem/smpedit') {
                    700:                             $access = &Apache::lonnet::allowed('bre','/res/lib/templates/simpleproblem.problem');
                    701:                             if ($access ne 'F') {
                    702:                                 $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    703:                                 return HTTP_NOT_ACCEPTABLE;
                    704:                             }
                    705:                         } else {
                    706:                             $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    707:                             return HTTP_NOT_ACCEPTABLE;
                    708:                         }
1.130     raeburn   709:                     }
1.159.2.3  raeburn   710:                 } elsif (($handle =~ /^publicuser_\d+$/) && (&Apache::lonnet::is_portfolio_url($requrl))) {
                    711:                     my $clientip = $r->get_remote_host();
                    712:                     if (&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip) ne 'F') {
                    713:                         $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    714:                         return HTTP_NOT_ACCEPTABLE;
                    715:                     }
1.130     raeburn   716:                 } else {
                    717: 		    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    718: 		    return HTTP_NOT_ACCEPTABLE;
                    719:                 }
1.37      albertel  720: 	    }
1.92      albertel  721: 	}
                    722: 	if ($requrl =~ m|^/prtspool/|) {
                    723: 	    my $start='/prtspool/'.$env{'user.name'}.'_'.
                    724: 		$env{'user.domain'};
                    725: 	    if ($requrl !~ /^\Q$start\E/) {
                    726: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    727: 		return HTTP_NOT_ACCEPTABLE;
1.67      albertel  728: 	    }
1.92      albertel  729: 	}
1.109     banghart  730: 	if ($requrl =~ m|^/zipspool/|) {
1.110     banghart  731: 	    my $start='/zipspool/zipout/'.$env{'user.name'}.":".
1.109     banghart  732: 		$env{'user.domain'};
                    733: 	    if ($requrl !~ /^\Q$start\E/) {
                    734: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    735: 		return HTTP_NOT_ACCEPTABLE;
                    736: 	    }
                    737: 	}
1.92      albertel  738: 	if ($env{'user.name'} eq 'public' && 
                    739: 	    $env{'user.domain'} eq 'public' &&
                    740: 	    $requrl !~ m{^/+(res|public|uploaded)/} &&
                    741: 	    $requrl !~ m{^/adm/[^/]+/[^/]+/aboutme/portfolio$ }x &&
1.159.2.8.2.4  (raeburn  742::             $requrl !~ m{^/adm/blockingstatus/.*$} &&
1.92      albertel  743: 	    $requrl !~ m{^/+adm/(help|logout|restrictedaccess|randomlabel\.png)}) {
                    744: 	    $env{'request.querystring'}=$r->args;
                    745: 	    $env{'request.firsturl'}=$requrl;
                    746: 	    return FORBIDDEN;
                    747: 	}
1.23      www       748: # ------------------------------------------------------------- This is allowed
1.92      albertel  749: 	if ($env{'request.course.id'}) {
1.24      www       750: 	    &Apache::lonnet::countacc($requrl);
1.125     raeburn   751:             my $query=$r->args;
1.159.2.8.2.4  (raeburn  752::             if ($check_symb) {
1.23      www       753: # ------------------------------------- This is serious stuff, get symb and log
1.92      albertel  754: 		my $symb;
                    755: 		if ($query) {
1.141     raeburn   756: 		    &Apache::loncommon::get_unprocessed_cgi($query,['symb','folderpath']);
1.92      albertel  757: 		}
                    758: 		if ($env{'form.symb'}) {
1.64      albertel  759: 		    $symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.159.2.8.2.2  (raeburn  760::                     if ($requrl eq '/adm/navmaps') {
                    761::                         my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
                    762::                         &Apache::lonnet::symblist($map,$murl => [$murl,$mid]);
                    763::                     } elsif ($requrl =~ m|^/adm/wrapper/|
1.72      albertel  764: 			|| $requrl =~ m|^/adm/coursedocs/showdoc/|) {
1.92      albertel  765: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.8.2.2  (raeburn  766::                         if ($map =~ /\.page$/) {
                    767::                             my $mapsymb = &Apache::lonnet::symbread($map);
                    768::                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    769::                         }
1.92      albertel  770: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
1.63      albertel  771: 						  'last_known' =>[$murl,$mid]);
1.92      albertel  772: 		    } elsif ((&Apache::lonnet::symbverify($symb,$requrl)) ||
1.53      albertel  773: 			     (($requrl=~m|(.*)/smpedit$|) &&
1.134     raeburn   774: 			      &Apache::lonnet::symbverify($symb,$1)) ||
                    775:                              (($requrl=~m|(.*/aboutme)/portfolio$|) &&
                    776:                               &Apache::lonnet::symbverify($symb,$1))) {
1.92      albertel  777: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.159.2.8.2.2  (raeburn  778::                         if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    779::                             my $mapsymb = &Apache::lonnet::symbread($map);
                    780::                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    781::                         }
1.92      albertel  782: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
                    783: 						  'last_known' =>[$murl,$mid]);
1.31      www       784: 		    } else {
                    785: 			$r->log_reason('Invalid symb for '.$requrl.': '.
1.92      albertel  786: 				       $symb);
                    787: 			$env{'user.error.msg'}=
                    788: 			    "$requrl:bre:1:1:Invalid Access";
                    789: 			return HTTP_NOT_ACCEPTABLE; 
                    790: 		    }
                    791: 		} else {
1.134     raeburn   792:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    793:                         $requrl = $1;
                    794:                     }
1.159.2.8.2.4  (raeburn  795:: 		    $symb=&Apache::lonnet::symbread($requrl);
                    796::                     if (&Apache::lonnet::is_on_map($requrl) && $symb) {
                    797::                         my ($encstate,$invalidsymb);
                    798::                         unless (&Apache::lonnet::symbverify($symb,$requrl,\$encstate)) {
                    799::                             $invalidsymb = 1;
                    800::                             #
                    801::                             # If $env{'request.enc'} is true, but no encryption for $symb retrieved
                    802::                             # by original lonnet::symbread() call, call again to check for an instance
                    803::                             # of $requrl in the course which has encryption, and set that as the symb.
                    804::                             # If there is no such symb, or symbverify() fails for the new symb proceed
                    805::                             # to report invalid symb.
                    806::                             #
                    807::                             if ($env{'request.enc'} && !$encstate) {
                    808::                                 my %possibles;
                    809::                                 my $nocache = 1;
                    810::                                 $symb = &Apache::lonnet::symbread($requrl,'','','',\%possibles,$nocache);
                    811::                                 if ($symb) {
                    812::                                     if (&Apache::lonnet::symbverify($symb,$requrl)) {
                    813::                                         $invalidsymb = '';
                    814::                                     }
                    815::                                 } elsif (keys(%possibles) > 1) {
                    816::                                     $r->internal_redirect('/adm/ambiguous');
                    817::                                     return OK;
1.159.2.8.2.2  (raeburn  818::                                 }
                    819::                             }
1.159.2.8.2.4  (raeburn  820::                             if ($invalidsymb) {
                    821::                                 $r->log_reason('Invalid symb for '.$requrl.': '.$symb);
                    822::                                 $env{'user.error.msg'}=
                    823::                                     "$requrl:bre:1:1:Invalid Access";
                    824::                                 return HTTP_NOT_ACCEPTABLE;
                    825::                             }
                    826::                         }
                    827::                     }
                    828:: 		    if ($symb) {
                    829:: 			my ($map,$mid,$murl)=
                    830:: 			    &Apache::lonnet::decode_symb($symb);
                    831::                         if ($requrl eq '/adm/navmaps') {
                    832::                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid]);
                    833::                         } else {
                    834::                             if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    835::                                 my $mapsymb = &Apache::lonnet::symbread($map);
                    836::                                 ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    837::                             }
                    838::                             &Apache::lonnet::symblist($map,$murl =>[$murl,$mid],
                    839::                                                       'last_known' =>[$murl,$mid]);
                    840::                         }
1.61      albertel  841: 		    }
1.92      albertel  842: 		}
                    843: 		$env{'request.symb'}=$symb;
1.159.2.8.2.4  (raeburn  844::                 if (($env{'request.symbread.cached.'}) && ($env{'request.symbread.cached.'} ne $symb)) {
                    845::                     $env{'request.symbread.cached.'} = $symb;
                    846::                 }
1.92      albertel  847: 		&Apache::lonnet::courseacclog($symb);
                    848: 	    } else {
1.23      www       849: # ------------------------------------------------------- This is other content
1.92      albertel  850: 		&Apache::lonnet::courseacclog($requrl);    
                    851: 	    }
1.140     raeburn   852:             if ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/(docs|supplemental)/.+\.html?$}) {
1.125     raeburn   853:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    854:                     if ($query) {
                    855:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit']);
                    856:                         if ($env{'form.forceedit'}) {
                    857:                             $env{'request.state'} = 'edit';
                    858:                         }
                    859:                     }
                    860:                 }
1.144     raeburn   861:             } elsif ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/portfolio/syllabus/.+\.html?$}) {
                    862:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    863:                     if ($query) {
                    864:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit','editmode']);
                    865:                         if (($env{'form.forceedit'}) || ($env{'form.editmode'})) {
                    866:                             $env{'request.state'} = 'edit';
                    867:                         }
                    868:                     }
                    869:                 }
1.125     raeburn   870:             }
1.88      albertel  871: 	}
1.92      albertel  872: 	return OK;
1.137     raeburn   873:     } else {
                    874:         my $defdom=$r->dir_config('lonDefDomain');
                    875:         ($is_balancer,$otherserver) =
                    876:             &Apache::lonnet::check_loadbalancing(undef,$defdom);
                    877:         if ($is_balancer) {
                    878:             $r->set_handlers('PerlResponseHandler'=>
                    879:                              [\&Apache::switchserver::handler]);
                    880:             if ($otherserver ne '') {
                    881:                 $env{'form.otherserver'} = $otherserver;
                    882:             }
                    883:         }
1.92      albertel  884:     }
1.21      www       885: # -------------------------------------------- See if this is a public resource
1.68      albertel  886:     if ($requrl=~m|^/+adm/+help/+|) {
1.89      albertel  887:  	return OK;
1.68      albertel  888:     }
1.90      albertel  889: # ------------------------------------ See if this is a viewable portfolio file
1.89      albertel  890:     if (&Apache::lonnet::is_portfolio_url($requrl)) {
1.159.2.3  raeburn   891:         my $clientip = $r->get_remote_host();
                    892: 	my $access=&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip);
1.90      albertel  893: 	if ($access eq 'A') {
                    894: 	    &Apache::restrictedaccess::setup_handler($r);
                    895: 	    return OK;
                    896: 	}
                    897: 	if (($access ne '2') && ($access ne 'F')) {
                    898: 	    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    899: 	    return HTTP_NOT_ACCEPTABLE;
                    900: 	}
1.79      raeburn   901:     }
1.87      albertel  902: 
1.34      www       903: # -------------------------------------------------------------- Not authorized
                    904:     $requrl=~/\.(\w+)$/;
1.62      albertel  905: #    if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    906: #        ($requrl=~/^\/adm\/(roles|logout|email|menu|remote)/) ||
                    907: #        ($requrl=~m|^/prtspool/|)) {
1.34      www       908: # -------------------------- Store where they wanted to go and get login screen
1.64      albertel  909: 	$env{'request.querystring'}=$r->args;
                    910: 	$env{'request.firsturl'}=$requrl;
1.34      www       911:        return FORBIDDEN;
1.62      albertel  912: #   } else {
1.34      www       913: # --------------------------------------------------------------------- Goodbye
1.62      albertel  914: #       return HTTP_BAD_REQUEST;
                    915: #   }
1.1       albertel  916: }
                    917: 
                    918: 1;
                    919: __END__
1.120     jms       920: 
1.121     jms       921: =pod
1.120     jms       922: 
1.121     jms       923: =back
1.120     jms       924: 
1.121     jms       925: =cut
1.120     jms       926: 

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